> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao.md).

# Autorização

O trabalhador precisa autorizar a consulta dos seus dados na Dataprev antes de qualquer consulta de margem. Há dois caminhos, escolhidos **por trabalhador** (os dois convivem):

* [**Termo em PDF**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf.md) — termo em PDF, gerado pela Giro ou pelo seu sistema; você coleta a assinatura no seu provedor e envia o assinado à Giro.
* [**Termo em Trilha Opt-In**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-trilha-opt-in.md) — sem PDF: você coleta o opt-in no seu canal digital e envia a trilha de aceite via API.

Nos dois, o envio à Dataprev é automático e o resultado é o mesmo: o trabalhador fica autorizado e a Giro emite o webhook `AUTHORIZATION_COMPLETED`.

{% hint style="info" %}
Depois de autorizado, use [Consultas Dataprev (sob demanda)](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/consultas-dataprev.md) para vínculos e margem por vínculo (`bondPublicId`). Após o contrato, [Dataprev (contábil)](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/dataprev.md) traz transferências e lançamentos.
{% endhint %}

## Os dois caminhos, lado a lado

| Aspecto                         | Termo em PDF                                                                                   | Termo em Trilha Opt-In                                               |
| ------------------------------- | ---------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| **Quem gera o termo**           | A Giro ou o originador                                                                         | Não há termo                                                         |
| **Como o trabalhador aceita**   | Assina o termo no provedor do originador                                                       | Aceita o opt-in no app/site do originador                            |
| **Endpoint**                    | `POST .../signed-authorizations` (envio direto) ou `POST .../authorization-documents` + upload | `POST .../employees/{publicId}/authorization-trails`                 |
| **Evidência (lastro)**          | O PDF assinado + metadados                                                                     | A 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, que atesta o aceite digital; a Giro custodia a trilha |

## Termo em PDF — quem gera o documento

| Quem gera o termo | Caminho                                                                                                                                                             | Chamadas |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| **Você**          | [Enviar Termo Assinado (envio direto)](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/enviar-termo-assinado-direto.md) | 1        |
| **A Giro**        | [Termo Gerado pela Giro](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro.md)                     | 3        |

Só use o termo gerado pela Giro se quiser o termo da plataforma ou precisar do `NSU` reservado antes da assinatura (por exemplo, para carimbá-lo no documento). Ver [Quando usar cada um](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/enviar-termo-assinado-direto.md#quando-usar-cada-um).

## Status da autorização

[Consultar Status](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/consultar-status-autorizacao.md) (`GET /api/v1/originator/employees/{publicId}/authorization/status`) vale para todos os caminhos.

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
