Estratégias de Assinatura
Quem coleta cada assinatura: a da autorização Dataprev e a do contrato (CCB). As duas são configuradas de forma independente, por originador, no onboarding.
Autorização Dataprev
Sempre o originador: você coleta o aceite (termo em PDF ou opt-in em trilha) e envia à Giro
Contrato (CCB)
GIRO (a Giro.Tech coleta a assinatura) ou ORIGINATOR_MANAGED (você coleta no seu provedor)
Autorização Dataprev
Você sempre coleta o aceite. O que muda é a forma do lastro, e a escolha é por trabalhador (os dois caminhos convivem):
Termo em Trilha Opt-In
Trilha de aceite (IP, timestamp, sessão, fingerprint), sem PDF
Nos dois, o resultado é o trabalhador autorizado na Dataprev e o webhook AUTHORIZATION_COMPLETED.
Termo em PDF — quem gera o documento
Termo próprio (1 chamada) —
POST /api/v1/originator/employees/{publicId}/signed-authorizationsVocê gera o termo, coleta a assinatura e envia o PDF assinado em base64. A chamada gera o NSU e a autorização segue à Dataprev. Ver Enviar Termo Assinado.Termo gerado pela Giro (3 chamadas) — ver Termo Gerado pela Giro:
Criar documento —
POST /api/v1/originator/employees/{publicId}/authorization-documentsReserva o NSU e gera o PDF. Nenhum link é enviado ao trabalhador.Upload do assinado —
POST /api/v1/originator/employees/{publicId}/authorization/{nsu}/upload-signedEnvie o PDF assinado (multipartsignedDocument); a autorização segue à Dataprev.Consultar status —
GET /api/v1/originator/employees/{publicId}/authorization/statusAcompanhe atéAUTHORIZED. Ao fim chegaAUTHORIZATION_COMPLETED. Se a Dataprev recusar em definitivo (CPF/vínculo inelegível ou tentativas esgotadas), chegaAUTHORIZATION_FAILEDe o documento ficaINELIGIBLE.
Termo em Trilha Opt-In
Você coleta o opt-in no seu canal digital (app/site) e envia a trilha de aceite por API, sem PDF. A Giro custodia a trilha como lastro e autoriza na Dataprev pelo canal digital Web Correspondente.
Exige o originador habilitado como ORIGINATOR_MANAGED em authorizationSignatureStrategy; sem isso, 403 ORIGINATOR_OPT_IN_NOT_ENABLED.
O trabalhador aceita o opt-in no seu canal.
Você monta a trilha: IP, timestamp, sessão, fingerprint e, opcionalmente, a timeline
events[]em texto livre.Chame
POST /api/v1/originator/employees/{publicId}/authorization-trails(Criar Trilha de Autorização).A Giro confere o CPF da trilha contra o do employee (divergente:
422 CPF_MISMATCH), guarda a trilha amarrada ao NSU e envia a autorização à Dataprev.Chegam
AUTHORIZATION_COMPLETEDe, em seguida,MARGIN_QUERY_COMPLETED.
Responsabilidade probatória. Na trilha, você atesta que coletou o aceite e responde pela robustez da trilha. A Giro custodia o lastro, amarrado ao NSU. A trilha não vai para a Dataprev, que recebe só canal, data/hora, NSU e CPF. Ver Trilha de Auditoria.
Diferença entre os dois caminhos
Quem coleta o aceite
O originador, no provedor de assinatura dele
O originador, no canal digital dele
Documento PDF
Sim
Não
Quem gera o termo
A Giro ou o originador
Não se aplica
Endpoint
POST .../signed-authorizations ou POST .../authorization-documents + upload
POST .../employees/{publicId}/authorization-trails
Evidência (lastro)
PDF assinado + metadados
Trilha: IP, timestamp, sessão, fingerprint, device
Canal Dataprev
Web Cliente / Agência
Web Correspondente (canal 4)
Responsabilidade probatória
Compartilhada (Giro custodia o termo)
Do originador; a Giro custodia a trilha
Latência
Maior (PDF + espera da assinatura)
Menor
Estado final
Employee autorizado + AUTHORIZATION_COMPLETED
Idêntico
Contrato (CCB)
Estratégia GIRO (padrão)
A Giro.Tech coleta a assinatura da CCB; você não implementa fluxo de assinatura.
Você consome a signUrl (no webhook CONTRACT_DOCUMENT_READY) e o webhook CONTRACT_SIGNED.
suppressNotification: true na criação do contrato: a plataforma não envia o WhatsApp ao trabalhador. O link chega só na signUrl do CONTRACT_DOCUMENT_READY, e notificar o trabalhador passa a ser seu.
Criar contrato
POST /proposals/{proposalPublicId}/contracts
Reenviar link de assinatura
POST /contracts/{requestNumber}/resend
Estratégia ORIGINATOR_MANAGED
Você coleta a assinatura da CCB no seu provedor. O GTPayroll gera o documento, mas não envia para assinatura.
Criar contrato —
POST /api/v1/originator/proposals/{proposalPublicId}/contractsO GTPayroll gera o PDF e envia o webhookCONTRACT_DOCUMENT_READYcomrequestNumber,contractNumber,nsuepresignedUrldo PDF.Baixar documento (opcional) —
GET /api/v1/originator/contracts/{requestNumber}/documentMetadados e novapresignedUrl(ex.: a do webhook expirou).Upload do assinado —
POST /api/v1/originator/contracts/{requestNumber}/upload-signedPDF assinado em multipartsignedDocument. O contrato segue para averbação e, conforme a estratégia de formalização, para desembolso ou conclusão.
Comparativo (contrato)
Geração do PDF
GTPayroll
GTPayroll
Envio para assinatura e notificação
Giro (WhatsApp)
Originador
Recebimento do assinado
Automático
Upload via API
Webhook CONTRACT_SIGNED
Sim (inscrição no evento)
Não aplicável
Reenvio de link
API resend
Webhook para o originador
Esforço de integração
Baixo
Médio-alto
Controle sobre a experiência do trabalhador
Limitado
Total
Sem provedor de assinatura próprio, use GIRO. Se já tem provedor, precisa de um específico por compliance ou quer controlar a experiência, use ORIGINATOR_MANAGED.
Estratégia de Formalização
Define como a CCB é processada após a averbação. É independente da estratégia de assinatura e também configurada no onboarding.
GTBANKER
Formalização da CCB e desembolso pela plataforma de correspondente bancário da Giro
ORIGINATOR_MANAGED
Originador gerencia a formalização
Atualizado