> 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/contratos/assinatura-originador/baixar-documento-contrato.md).

# Baixar Documento do Contrato

Retorna o status do documento do contrato (PDF) e uma URL temporária de download.

Use para obter o PDF na estratégia **ORIGINATOR\_MANAGED** (alternativa ao webhook `CONTRACT_DOCUMENT_READY`), consultar o NSU, ou gerar nova URL quando a anterior expirou.

## Request

`GET /api/v1/originator/contracts/{publicId}/document`

Autenticação: `Authorization: Bearer {originatorToken}`.

### Parâmetros

| Parâmetro  | Local | Tipo     | Descrição                                                       |
| ---------- | ----- | -------- | --------------------------------------------------------------- |
| `publicId` | path  | `string` | `publicId` ou `requestNumber` do contrato (ex.: `GTAB12CD34EF`) |

## Response (200)

| Campo            | Tipo     | Descrição                                                                                                                                                                                                                    |
| ---------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `requestNumber`  | `string` | Número da requisição do contrato                                                                                                                                                                                             |
| `nsu`            | `string` | NSU do documento do contrato (rastreio)                                                                                                                                                                                      |
| `documentStatus` | `string` | Status do documento (`PENDING`, `GENERATED`, `PENDING_SIGNATURE`, `SIGNATURE_PENDING_RETRY`, `SIGNED`, `REJECTED`, `EXPIRED`, `CANCELLED`, `FAILED`, `PROCESSED` ou `NOT_AVAILABLE` quando o documento ainda não possui PDF) |
| `presignedUrl`   | `string` | URL temporária de download do PDF. **Ausente** quando `documentStatus` é `NOT_AVAILABLE`                                                                                                                                     |

## Exemplo

```http
GET /api/v1/originator/contracts/GTAB12CD34EF/document
Authorization: Bearer {originatorToken}
```

Resposta:

```json
{
  "requestNumber": "GTAB12CD34EF",
  "nsu": "1234567890123456789",
  "documentStatus": "GENERATED",
  "presignedUrl": "https://files.example.com/contract-doc.pdf?signature=..."
}
```

## Erros

| Código | `errorCode` | Situação                                          |
| ------ | ----------- | ------------------------------------------------- |
| 404    | —           | Contrato não encontrado ou de outro originador    |
| 429    | —           | Mais de 100 requisições por segundo               |
| 502    | —           | Falha ao gerar a URL de download. Tente novamente |

Erros comuns a todos os endpoints — `401`, `403` de token, `409` de `Idempotency-Key` em processamento, `500` e `503` — e o formato `ProblemDetail` estão em [Erros da API](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.md).

## Obter Documento do Contrato

> Retorna \*\*metadados e URL de download\*\* (presigned) do documento do contrato.\
> Útil para:\
> \- \*\*ORIGINATOR\_MANAGED:\*\* baixar o PDF gerado pelo sistema (enviado também via webhook \`CONTRACT\_DOCUMENT\_READY\`) para exibir/assinatura.\
> \- Verificar status do documento (\`documentStatus\`) e NSU.\
> Quando o documento ainda não está disponível, retorna \`documentStatus: NOT\_AVAILABLE\` e sem \`presignedUrl\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"GT Payroll Originator API","version":"1.1.0"},"tags":[{"name":"Contracts","description":"Contratos de empréstimo"}],"servers":[{"url":"https://ingress.gtpayroll.staging.giro.tech","description":"Ambiente de Staging"},{"url":"https://ingress.gtpayroll.giro.tech","description":"Ambiente de Produção"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"JWT token fornecido pelo administrador"}}},"paths":{"/api/v1/originator/contracts/{publicId}/document":{"get":{"summary":"Obter Documento do Contrato","description":"Retorna **metadados e URL de download** (presigned) do documento do contrato.\nÚtil para:\n- **ORIGINATOR_MANAGED:** baixar o PDF gerado pelo sistema (enviado também via webhook `CONTRACT_DOCUMENT_READY`) para exibir/assinatura.\n- Verificar status do documento (`documentStatus`) e NSU.\nQuando o documento ainda não está disponível, retorna `documentStatus: NOT_AVAILABLE` e sem `presignedUrl`.\n","tags":["Contracts"],"parameters":[{"name":"publicId","in":"path","required":true,"description":"Identificador do contrato — aceita o publicId opaco ou o requestNumber.","schema":{"type":"string","maxLength":36}}],"responses":{"200":{"description":"Metadados e presigned URL do documento (ou NOT_AVAILABLE)","content":{"application/json":{"schema":{"type":"object","description":"Metadados e URL de download do documento do contrato (PDF).\nUsado para **baixar o documento** gerado (original ou assinado) via presigned URL.\n","properties":{"publicId":{"type":"string","maxLength":36,"description":"Identificador público do contrato. Pode vir omitido (ausente no JSON) em contratos antigos."},"requestNumber":{"type":"string","maxLength":36,"description":"Número da requisição do contrato. Contratos criados a partir da adoção do `publicId` nascem com o mesmo valor dele (UUID de 36 caracteres); anteriores mantêm o formato legado GT + 10 alfanuméricos maiúsculos. Ex. GTAB12CD34EF"},"nsu":{"type":"string","maxLength":19,"description":"NSU do documento do contrato."},"documentStatus":{"type":"string","enum":["PENDING","GENERATED","PENDING_SIGNATURE","SIGNATURE_PENDING_RETRY","SIGNED","REJECTED","EXPIRED","CANCELLED","FAILED","PROCESSED","NOT_AVAILABLE"],"description":"Status do documento. `NOT_AVAILABLE` quando o documento ainda não existe ou não possui PDF.\nDemais valores iguais ao DocumentStatus do contrato (PENDING, GENERATED, PENDING_SIGNATURE, SIGNATURE_PENDING_RETRY, SIGNED, REJECTED, EXPIRED, CANCELLED, FAILED, PROCESSED).\n"},"presignedUrl":{"type":"string","format":"uri","description":"URL pré-assinada para download do PDF. Expira após o tempo configurado.\nAusente quando `documentStatus` é `NOT_AVAILABLE`.\n"}}}}}},"401":{"description":"Não autenticado","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro de autenticação (HTTP 401). Token ausente, com prefixo diferente de `Bearer `, expirado, revogado ou inválido.","required":["type","title","status"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"403":{"description":"Permissão insuficiente","content":{"application/problem+json":{"schema":{"type":"object","description":"Erro de autorização (HTTP 403). Token válido de outro perfil, sem permissão de originador.\nRecusas de permissão por regra de negócio (ex.: `ORIGINATOR_OPT_IN_NOT_ENABLED`) usam\n`#business-rule-violation` com `properties.errorCode`.\n","required":["type","title","status"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"404":{"description":"Contrato não encontrado ou de outro originador.","content":{"application/problem+json":{"schema":{"type":"object","description":"Resposta de erro no formato RFC 7807 (Problem Details). Os campos extras **não** vêm na raiz:\nficam dentro de `properties` (`message`, `errorCode`, `errors`, `retryAfter`…).\n\nIdentifique o erro por `status` + `properties.errorCode`. O `type` agrupa famílias e sozinho não\nidentifica o erro: `#business-rule-violation` aparece com 400, 403, 404, 409, 413, 422 e 503.\nCatálogo completo em https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.\n","required":["type","title","status"],"properties":{"type":{"type":"string","description":"URL do guia de erros com o fragmento da família: `validation-error`, `not-authenticated`,\n`forbidden`, `resource-not-found`, `conflict`, `business-rule-violation`,\n`dataprev-suspension-window`, `rate-limit-exceeded`, `internal-error`, `upstream-error`,\n`service-unavailable`. Corpo ilegível, parâmetro de tipo errado, rota inexistente, `405` e\n`415` vêm como `about:blank`, sem `properties`.\n"},"title":{"type":"string","description":"Resumo curto. Na maioria dos casos é a frase padrão do status HTTP."},"status":{"type":"integer","description":"Código HTTP do erro"},"detail":{"type":"string","description":"Mensagem legível desta ocorrência. Pode mudar de texto; use `properties.errorCode` para automação."},"instance":{"type":"string","description":"Path da requisição que falhou"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"429":{"description":"Mais de 100 requisições por segundo. Aguarde o header `Retry-After` e reenvie com **nova** `Idempotency-Key` — com a mesma chave, o `429` gravado é repetido.","content":{"application/problem+json":{"schema":{"type":"object","description":"Resposta de erro no formato RFC 7807 (Problem Details). Os campos extras **não** vêm na raiz:\nficam dentro de `properties` (`message`, `errorCode`, `errors`, `retryAfter`…).\n\nIdentifique o erro por `status` + `properties.errorCode`. O `type` agrupa famílias e sozinho não\nidentifica o erro: `#business-rule-violation` aparece com 400, 403, 404, 409, 413, 422 e 503.\nCatálogo completo em https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.\n","required":["type","title","status"],"properties":{"type":{"type":"string","description":"URL do guia de erros com o fragmento da família: `validation-error`, `not-authenticated`,\n`forbidden`, `resource-not-found`, `conflict`, `business-rule-violation`,\n`dataprev-suspension-window`, `rate-limit-exceeded`, `internal-error`, `upstream-error`,\n`service-unavailable`. Corpo ilegível, parâmetro de tipo errado, rota inexistente, `405` e\n`415` vêm como `about:blank`, sem `properties`.\n"},"title":{"type":"string","description":"Resumo curto. Na maioria dos casos é a frase padrão do status HTTP."},"status":{"type":"integer","description":"Código HTTP do erro"},"detail":{"type":"string","description":"Mensagem legível desta ocorrência. Pode mudar de texto; use `properties.errorCode` para automação."},"instance":{"type":"string","description":"Path da requisição que falhou"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}},"502":{"description":"Falha ao gerar presigned URL (problema de comunicação com S3)","content":{"application/problem+json":{"schema":{"type":"object","description":"Resposta de erro no formato RFC 7807 (Problem Details). Os campos extras **não** vêm na raiz:\nficam dentro de `properties` (`message`, `errorCode`, `errors`, `retryAfter`…).\n\nIdentifique o erro por `status` + `properties.errorCode`. O `type` agrupa famílias e sozinho não\nidentifica o erro: `#business-rule-violation` aparece com 400, 403, 404, 409, 413, 422 e 503.\nCatálogo completo em https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros.\n","required":["type","title","status"],"properties":{"type":{"type":"string","description":"URL do guia de erros com o fragmento da família: `validation-error`, `not-authenticated`,\n`forbidden`, `resource-not-found`, `conflict`, `business-rule-violation`,\n`dataprev-suspension-window`, `rate-limit-exceeded`, `internal-error`, `upstream-error`,\n`service-unavailable`. Corpo ilegível, parâmetro de tipo errado, rota inexistente, `405` e\n`415` vêm como `about:blank`, sem `properties`.\n"},"title":{"type":"string","description":"Resumo curto. Na maioria dos casos é a frase padrão do status HTTP."},"status":{"type":"integer","description":"Código HTTP do erro"},"detail":{"type":"string","description":"Mensagem legível desta ocorrência. Pode mudar de texto; use `properties.errorCode` para automação."},"instance":{"type":"string","description":"Path da requisição que falhou"},"properties":{"type":"object","nullable":true,"description":"Extensões do ProblemDetail. Ausente (`null`) nas respostas `about:blank`.","additionalProperties":true,"properties":{"message":{"type":"string","description":"Repete o `detail`."},"errorCode":{"type":"string","description":"Código estável da regra violada. Opcional: só parte dos erros de regra de negócio tem.\nLista por status no guia de erros.\n"},"errors":{"type":"object","additionalProperties":{"type":"string"},"description":"(Apenas 400 `validation-error`) Mapa campo → mensagem."},"retryAfter":{"type":"integer","description":"(429 e 503) Segundos a aguardar antes de nova requisição."},"limit":{"type":"integer","description":"(Apenas 429) Limite de requisições da janela."},"resetAt":{"type":"integer","format":"int64","description":"(Apenas 429) Fim da janela, em epoch **milissegundos**."}}}}}}}}}}}}}
```

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