> 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/termo-em-pdf/termo-gerado-pela-giro.md).

# Termo Gerado pela Giro

A Giro gera o termo de autorização em PDF; você coleta a assinatura no seu provedor e devolve o assinado, que a Giro envia à Dataprev automaticamente. Se o termo é do seu sistema, use [Enviar Termo Assinado (envio direto)](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/enviar-termo-assinado-direto.md).

## Quando usar

* Você quer o termo padrão da plataforma, sem manter template próprio.
* Você precisa do `NSU` reservado antes da assinatura, por exemplo para carimbá-lo no documento.

## Sequência de chamadas

1. [**Criar Documento de Autorização**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro/criar-documento-autorizacao.md) (`POST .../authorization-documents`) — reserva o `NSU` e dispara a geração do PDF. Responde `201` com `status: PENDING`: o termo ainda não existe.
2. Aguarde o webhook **`AUTHORIZATION_DOCUMENT_READY`**, que traz a `presignedUrl` do termo. Se a URL expirar, use [**Baixar Documento de Autorização**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro/baixar-documento-autorizacao.md).
3. Colete a assinatura do trabalhador no seu provedor.
4. [**Upload de Documento Assinado**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro/upload-documento-assinado.md) (`POST .../authorization/{nsu}/upload-signed`) — a Giro envia a autorização à Dataprev.
5. [**Consultar Status**](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/consultar-status-autorizacao.md) até `AUTHORIZED`, ou aguarde o webhook `AUTHORIZATION_COMPLETED`.

{% hint style="warning" %}
Não faça o upload antes do webhook `AUTHORIZATION_DOCUMENT_READY`: a geração é assíncrona, e o documento enviado precisa ser o termo que a Giro gerou.
{% endhint %}

## Operações deste fluxo

| Operação                                                                                                                                                                              | Método | Endpoint                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | --------------------------------------------------------------------------- |
| [Criar Documento de Autorização](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro/criar-documento-autorizacao.md)   | `POST` | `/api/v1/originator/employees/{publicId}/authorization-documents`           |
| [Baixar Documento de Autorização](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro/baixar-documento-autorizacao.md) | `GET`  | `/api/v1/originator/employees/{publicId}/authorization/{nsu}/document`      |
| [Upload de Documento Assinado](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao/termo-em-pdf/termo-gerado-pela-giro/upload-documento-assinado.md)       | `POST` | `/api/v1/originator/employees/{publicId}/authorization/{nsu}/upload-signed` |

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