> 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/upload-contrato-assinado.md).

# Upload de Contrato Assinado

Envia o PDF do contrato assinado pelo trabalhador. Só para originadores com estratégia de assinatura `ORIGINATOR_MANAGED`; o PDF original vem do webhook `CONTRACT_DOCUMENT_READY` ou de [Baixar Documento do Contrato](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/assinatura-originador/baixar-documento-contrato.md).

## Request

`POST /api/v1/originator/contracts/{publicId}/upload-signed`

Autenticação: `Authorization: Bearer {originatorToken}`. Envio em **`multipart/form-data`**.

### Parâmetros

| Parâmetro            | Local            | Tipo                  | Descrição                                                                  |
| -------------------- | ---------------- | --------------------- | -------------------------------------------------------------------------- |
| `publicId`           | path             | `string`              | `publicId` ou `requestNumber` do contrato (ex.: `GTAB12CD34EF`)            |
| `signedDocument`     | body (multipart) | file                  | Arquivo PDF do contrato assinado **(obrigatório)**                         |
| `biometricSelfie`    | body (multipart) | file                  | Selfie para biometria **(obrigatório)**                                    |
| `frontDocument`      | body (multipart) | file                  | Frente do documento **(obrigatório)**                                      |
| `backDocument`       | body (multipart) | file                  | Verso do documento **(obrigatório)**                                       |
| `biometricScore`     | body (multipart) | `decimal`             | Score de biometria **(obrigatório)**                                       |
| `latitude`           | body (multipart) | `decimal`             | Latitude da assinatura **(obrigatório)**                                   |
| `longitude`          | body (multipart) | `decimal`             | Longitude da assinatura **(obrigatório)**                                  |
| `ipAddress`          | body (multipart) | `string`              | IP do assinante **(obrigatório)**                                          |
| `device`             | body (multipart) | `string`              | Dispositivo usado na assinatura (ex.: `iPhone iOS 18.7`) **(obrigatório)** |
| `signatureTimestamp` | body (multipart) | `datetime` (ISO-8601) | Data/hora da assinatura em UTC **(obrigatório)**                           |

* Campos numéricos e data/hora não aceitam string vazia.
* `latitude`/`longitude` devem ser a geolocalização real da assinatura: `0,0` é rejeitado com `422`.

## Response (200)

| Campo              | Tipo            | Descrição                                      |
| ------------------ | --------------- | ---------------------------------------------- |
| `contractPublicId` | `string (uuid)` | Identificador público do contrato              |
| `contractNumber`   | `string`        | Número do contrato (8 dígitos)                 |
| `status`           | `string`        | Status do contrato após upload (ex.: `SIGNED`) |
| `message`          | `string`        | Mensagem descritiva                            |

O contrato passa a `SIGNED` e segue para averbação. Acompanhe por [Buscar Contrato](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/buscar-contrato-por-request-number.md) ou pelos webhooks `ENDORSEMENT_*`.

## Exemplo

```http
POST /api/v1/originator/contracts/GTAB12CD34EF/upload-signed
Authorization: Bearer {originatorToken}
Content-Type: multipart/form-data

signedDocument: [arquivo PDF]
biometricSelfie: [imagem selfie]
frontDocument: [imagem frente documento]
backDocument: [imagem verso documento]
biometricScore: 0.92
latitude: -23.55052
longitude: -46.633308
ipAddress: 189.44.12.55
device: iPhone iOS 18.7
signatureTimestamp: 2026-03-12T14:30:00Z
```

Resposta:

```json
{
  "contractPublicId": "0198f2a1-7c3e-7b2d-9f14-3a5c8e6d1b07",
  "contractNumber": "00345678",
  "status": "SIGNED",
  "message": "Contrato assinado recebido e enviado para averbação"
}
```

## Erros

| Código | `errorCode`                     | Situação                                                                                                                                                                                  |
| ------ | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400    | —                               | `device` em branco (`properties.errors`)                                                                                                                                                  |
| 400    | —                               | `biometricScore`, `latitude`, `longitude` ou `signatureTimestamp` em formato inválido (`type: about:blank`, `Failed to convert …`)                                                        |
| 400    | —                               | Parte do multipart ausente (corpo sem mensagem)                                                                                                                                           |
| 400    | —                               | `Upload de contrato assinado disponível apenas para ORIGINATOR_MANAGED`                                                                                                                   |
| 400    | —                               | `Contrato já foi processado - Status: <status>` — contrato já assinado ou adiante                                                                                                         |
| 400    | —                               | `Erro ao processar contrato assinado` / `Erro ao fazer upload de imagem biometrica` — falha ao processar os arquivos, inclusive transitória. Consulte o contrato e reenvie com chave nova |
| 404    | —                               | Contrato não encontrado ou de outro originador                                                                                                                                            |
| 409    | `CONTRACT_ILLEGAL_TRANSITION`   | Contrato `CANCELLED` ou `PENDING_PAYMENT_APPROVAL`. Não retente                                                                                                                           |
| 422    | `INVALID_SIGNATURE_GEOLOCATION` | Coordenada `(0,0)` ou fora de ±90 (latitude) / ±180 (longitude)                                                                                                                           |
| 423    | `DATAPREV_SUSPENSION_WINDOW`    | Janela de suspensão da Dataprev                                                                                                                                                           |
| 429    | —                               | Mais de 75 requisições por segundo                                                                                                                                                        |

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).

## Upload de Contrato Assinado (ORIGINATOR\_MANAGED)

> Envia o \*\*PDF do contrato já assinado\*\* pelo trabalhador.\
> \*\*Disponível apenas para originators com estratégia de assinatura de contrato ORIGINATOR\_MANAGED.\*\*\
> \
> Fluxo recomendado:\
> 1\. Criar contrato (\`POST /proposals/{proposalPublicId}/contracts\`) — o sistema gera o PDF e envia webhook \`CONTRACT\_DOCUMENT\_READY\` com presignedUrl.\
> 2\. Originador obtém assinatura fora do GIRO (próprio fluxo).\
> 3\. Chamar este endpoint com o PDF assinado; o contrato segue para averbação.\
> \
> \*\*Todos os dados biométricos são obrigatórios:\*\* selfie, frente/verso do documento, score, geolocalização, IP e timestamp de assinatura.<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}/upload-signed":{"post":{"summary":"Upload de Contrato Assinado (ORIGINATOR_MANAGED)","description":"Envia o **PDF do contrato já assinado** pelo trabalhador.\n**Disponível apenas para originators com estratégia de assinatura de contrato ORIGINATOR_MANAGED.**\n\nFluxo recomendado:\n1. Criar contrato (`POST /proposals/{proposalPublicId}/contracts`) — o sistema gera o PDF e envia webhook `CONTRACT_DOCUMENT_READY` com presignedUrl.\n2. Originador obtém assinatura fora do GIRO (próprio fluxo).\n3. Chamar este endpoint com o PDF assinado; o contrato segue para averbação.\n\n**Todos os dados biométricos são obrigatórios:** selfie, frente/verso do documento, score, geolocalização, IP e timestamp de assinatura.\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}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["signedDocument","biometricSelfie","frontDocument","backDocument","biometricScore","latitude","longitude","ipAddress","device","signatureTimestamp"],"properties":{"signedDocument":{"type":"string","format":"binary","description":"Arquivo PDF do contrato assinado"},"biometricSelfie":{"type":"string","format":"binary","description":"Imagem selfie para biometria"},"frontDocument":{"type":"string","format":"binary","description":"Frente do documento"},"backDocument":{"type":"string","format":"binary","description":"Verso do documento"},"biometricScore":{"type":"number","format":"decimal","description":"Score de biometria"},"latitude":{"type":"number","format":"decimal","minimum":-90,"maximum":90,"description":"Latitude da assinatura em grau decimal (ponto como separador). Coordenada em micrograu ou sem separador decimal é rejeitada com 422."},"longitude":{"type":"number","format":"decimal","minimum":-180,"maximum":180,"description":"Longitude da assinatura em grau decimal (ponto como separador). Coordenada em micrograu ou sem separador decimal é rejeitada com 422."},"ipAddress":{"type":"string","description":"IP do assinante"},"device":{"type":"string","minLength":1,"maxLength":255,"description":"Dispositivo usado na assinatura (ex. \"iPhone iOS 18.7\")"},"signatureTimestamp":{"type":"string","format":"date-time","description":"Data/hora da assinatura (UTC)"}}}}}},"responses":{"200":{"description":"Upload realizado com sucesso; contrato enviado para averbação","content":{"application/json":{"schema":{"type":"object","description":"Resposta do upload do contrato assinado (estratégia **ORIGINATOR_MANAGED**).\nApós o upload, o contrato segue para averbação.\n","properties":{"contractId":{"type":"integer","format":"int64","description":"Identificador interno do contrato."},"contractNumber":{"type":"string","description":"Número do contrato (8 dígitos com zero à esquerda).\nPor padrão (estratégia GIRO), gerado pela plataforma; na estratégia ORIGINATOR_MANAGED, pode ser informado pelo originador.\n"},"status":{"type":"string","enum":["CREATED","SIGNED","ENDORSED","FORMALIZED","COMPLETED","CANCELLED"],"description":"Status do contrato após o upload. Retorna `SIGNED` indicando que o documento assinado foi recebido e o contrato segue para averbação.\n"},"message":{"type":"string","description":"Mensagem explicativa."}}}}}},"400":{"description":"Campo inválido, parâmetro de tipo errado, estratégia diferente, contrato já processado ou falha ao processar os arquivos (pode ser transitória).","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**."}}}}}}}},"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 ou estratégia não é ORIGINATOR_MANAGED","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**."}}}}}}}},"409":{"description":"Contrato `CANCELLED` ou `PENDING_PAYMENT_APPROVAL`.","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**."}}}}}}}},"422":{"description":"Coordenada `(0,0)` ou fora de ±90/±180.","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**."}}}}}}}},"423":{"description":"Janela de suspensão da Dataprev aberta (virada de competência). A operação **não** foi\nregistrada — reenvie depois de `windowEnd`.\n\nOnde olhar para reagendar: o header `Retry-After` traz os **segundos** que faltam (é sempre\ndelta-seconds, nunca HTTP-date) e o corpo traz `windowEnd` como `date-time`. Use um dos dois —\n**não** faça backoff exponencial, a volta tem hora marcada.\n","headers":{"Retry-After":{"description":"Segundos até o fim previsto da janela.","schema":{"type":"integer","format":"int32"}}},"content":{"application/problem+json":{"schema":{"type":"object","description":"Recusa por janela de suspensão da Dataprev (virada de competência). A Dataprev suspende as\noperações mensalmente, por volta do dia 21 ao dia 23, e nesse período o GTPayroll recusa de\nimediato em vez de aceitar um pedido que ficaria dias sem resposta.\n\nUse o header `Retry-After` para reagendar: **não** faça backoff exponencial, a volta tem hora\nmarcada. A recusa fica gravada na `Idempotency-Key` — reenvie com chave nova. Simulação,\npropostas e webhooks continuam disponíveis durante a janela; o webhook `DATAPREV_WINDOW_CLOSED`\navisa quando as demais rotas voltam.\n","required":["type","title","status","properties"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"properties":{"type":"object","required":["errorCode"],"properties":{"message":{"type":"string"},"errorCode":{"type":"string"},"windowEnd":{"type":"string","description":"Fim previsto da janela, em data/hora **sem fuso** (`yyyy-MM-ddTHH:mm:ss`). Ausente quando a Dataprev não informou a data."}}}}}}}},"429":{"description":"Mais de 75 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 fazer upload do documento para o armazenamento","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/>" %}
