> 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/propostas/criar-proposta.md).

# Criar Proposta

Cria uma proposta de empréstimo para um trabalhador, em um de dois modos:

* **Com `simulationPublicId`**: basta `simulationPublicId` + `employmentRelationshipPublicId`. Valores e parcelas vêm da simulação, que precisa estar em `EPHEMERAL` e passa a `CONVERTED_TO_PROPOSAL`.
* **Sem `simulationPublicId`**: todos os campos financeiros e `installments` são obrigatórios e devem ser consistentes com a simulação de referência; divergências significativas podem levar à rejeição.

A proposta usa `tacAmount` (sempre `0`) e `insuranceAmount` separados; o `feesAmount` da simulação está deprecated. O `feesAmount` de cada parcela em `installments` **não** está deprecated.

## Request

`POST /api/v1/originator/employees/{publicId}/proposals`

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

### Parâmetros

| Parâmetro  | Local | Tipo     | Obrigatório | Descrição                         |
| ---------- | ----- | -------- | ----------- | --------------------------------- |
| `publicId` | path  | `string` | Sim         | Identificador público do employee |

### Corpo

| Campo                            | Tipo            | Obrigatório | Descrição                                                                                                                                                                 |
| -------------------------------- | --------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `simulationPublicId`             | `string (uuid)` | Não         | ID da simulação. Define o modo (ver acima).                                                                                                                               |
| `employmentRelationshipPublicId` | `string (uuid)` | Sim         | ID do vínculo empregatício                                                                                                                                                |
| `loanAmount`                     | `decimal`       | Condicional | Valor do empréstimo em reais. Obrigatório sem `simulationPublicId`.                                                                                                       |
| `financedAmount`                 | `decimal`       | Condicional | Valor financiado em reais (principal + juros + encargos). Obrigatório sem `simulationPublicId`.                                                                           |
| `totalInterestAmount`            | `decimal`       | Condicional | Valor total de juros em reais. Obrigatório sem `simulationPublicId`.                                                                                                      |
| `monthlyInterestRate`            | `decimal`       | Condicional | Taxa de juros mensal (%). Obrigatório sem `simulationPublicId`.                                                                                                           |
| `monthlyEffectiveCost`           | `decimal`       | Condicional | CET mensal (%). Obrigatório sem `simulationPublicId`.                                                                                                                     |
| `annualEffectiveCost`            | `decimal`       | Condicional | CET anual (%). Obrigatório sem `simulationPublicId`.                                                                                                                      |
| `disbursementAmount`             | `decimal`       | Condicional | Valor líquido a receber pelo trabalhador. Obrigatório sem `simulationPublicId`.                                                                                           |
| `insuranceAmount`                | `decimal`       | Condicional | Valor do seguro prestamista. Obrigatório sem `simulationPublicId`.                                                                                                        |
| `iofAmount`                      | `decimal`       | Condicional | Valor total de IOF. Obrigatório sem `simulationPublicId`.                                                                                                                 |
| `tacAmount`                      | `decimal`       | Opcional    | TAC (Taxa de Abertura de Crédito). Deve ser `0` ou `null`; valor positivo dá `400` (`Produto não permite TAC (Taxa de Abertura de Crédito) conforme legislação vigente`). |
| `installmentCount`               | `integer`       | Condicional | Número de parcelas. Obrigatório sem `simulationPublicId`.                                                                                                                 |
| `dueDate`                        | `string` (date) | Condicional | Data de vencimento da primeira parcela. Obrigatório sem `simulationPublicId`.                                                                                             |
| `installments`                   | `array`         | Condicional | Parcelas. Obrigatório sem `simulationPublicId`.                                                                                                                           |

#### Objeto de cada item de `installments`

| Campo                | Tipo               | Descrição                                            |
| -------------------- | ------------------ | ---------------------------------------------------- |
| `installmentNumber`  | `integer`          | Número da parcela (1-based)                          |
| `installmentAmount`  | `decimal`          | Valor da parcela (desconto em folha)                 |
| `dueDate`            | `string` (date)    | Data de vencimento (yyyy-MM-dd)                      |
| `amortizationAmount` | `decimal`          | Amortização (principal) da parcela                   |
| `interestAmount`     | `decimal`          | Juros da parcela                                     |
| `iofAmount`          | `decimal`          | IOF da parcela                                       |
| `feesAmount`         | `decimal`          | Taxas da parcela                                     |
| `outstandingBalance` | `decimal`          | Saldo devedor após a parcela                         |
| `daysToCompensate`   | `integer`          | Dias para compensação                                |
| `documentNumber`     | `string` (máx. 10) | Número identificador do vencimento. Opcional         |
| `ourNumber`          | `string` (máx. 32) | Nosso número do documento no banco emissor. Opcional |
| `ourNumberBankCode`  | `string` (máx. 3)  | Código do banco do nosso número. Opcional            |
| `participantControl` | `string` (máx. 25) | Controle do participante. Opcional                   |

As parcelas da proposta são as do contrato.

#### Campos de leilão

Informe só quando a proposta materializa uma [oferta de leilão](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/leilao/aceite-da-oferta.md) aceita pelo trabalhador.

| Campo            | Tipo               | Descrição                                                                                                                                                                                                                              |
| ---------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `proposalNumber` | `string` (máx. 20) | Número da oferta (`GT-{prefixo}-{único}`). É o que classifica a operação como leilão: com ele, a CCB é formalizada no programa de leilão do originador; sem ele, a operação é tratada como originação ativa. Vazio equivale a ausente. |
| `solicitationId` | `integer`          | Identificador Dataprev da solicitação. Opcional: com `proposalNumber`, a Giro grava o da oferta (um valor diferente retorna `422`); sem `proposalNumber`, é ignorado.                                                                  |

#### Campos bancários do documento

`documentNumber`, `ourNumber`, `ourNumberBankCode` e `participantControl` são opcionais e repassados ao banco emissor na formalização da CCB, para você reconciliar a parcela com o documento bancário. A Giro só valida o tamanho.

Quando omitidos, dois deles são gerados a partir do número da CCB e da parcela com dois dígitos:

| Campo                | Gerado (CCB `00000001`, parcela 1) |
| -------------------- | ---------------------------------- |
| `documentNumber`     | `0000000101`                       |
| `participantControl` | `00000001-01`                      |

`ourNumber` e `ourNumberBankCode` omitidos não são enviados.

A resposta devolve os quatro campos como você os enviou.

## Response

| Campo                  | Tipo                 | Descrição                                                                                                                                                                                                                                                      |
| ---------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `publicId`             | `string`             | Identificador público da proposta — o `proposalPublicId` de [Criar Contrato](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/criar-contrato.md)                                                                                   |
| `employeePublicId`     | `string`             | Identificador público do trabalhador (16 caracteres Base64 URL-safe)                                                                                                                                                                                           |
| `simulationPublicId`   | `string (uuid)`      | Simulação de referência; `null` sem simulação                                                                                                                                                                                                                  |
| `loanAmount`           | `number`             | Valor do empréstimo em reais                                                                                                                                                                                                                                   |
| `financedAmount`       | `number`             | Valor financiado em reais                                                                                                                                                                                                                                      |
| `totalInterestAmount`  | `number`             | Juros totais em reais                                                                                                                                                                                                                                          |
| `monthlyInterestRate`  | `number`             | Taxa mensal em percentual                                                                                                                                                                                                                                      |
| `monthlyEffectiveCost` | `number`             | CET mensal em percentual                                                                                                                                                                                                                                       |
| `annualEffectiveCost`  | `number`             | CET anual em percentual                                                                                                                                                                                                                                        |
| `disbursementAmount`   | `number`             | Valor a desembolsar em reais                                                                                                                                                                                                                                   |
| `insuranceAmount`      | `number`             | Seguro em reais                                                                                                                                                                                                                                                |
| `iofAmount`            | `number`             | IOF em reais                                                                                                                                                                                                                                                   |
| `tacAmount`            | `number`             | TAC em reais (sempre `0`)                                                                                                                                                                                                                                      |
| `debitAmount`          | `number`             | Valor total a pagar (`installmentCount` × `installmentAmount`) em reais                                                                                                                                                                                        |
| `outstandingBalance`   | `number`             | Saldo devedor em reais                                                                                                                                                                                                                                         |
| `installmentCount`     | `integer`            | Número de parcelas                                                                                                                                                                                                                                             |
| `dueDate`              | `string` (date)      | Data de vencimento da primeira parcela                                                                                                                                                                                                                         |
| `status`               | `string`             | Status da proposta: `PENDING`, `ACCEPTED`, `REJECTED`, `EXPIRED` ou `CONVERTED_TO_CONTRACT`                                                                                                                                                                    |
| `expiresAt`            | `string` (date-time) | Data e hora limite para aceite                                                                                                                                                                                                                                 |
| `acceptedAt`           | `string` (date-time) | Data e hora do aceite, quando aplicável                                                                                                                                                                                                                        |
| `installments`         | `array`              | Lista de parcelas (`installmentNumber`, `dueDate`, `installmentAmount`, `amortizationAmount`, `interestAmount`, `iofAmount`, `feesAmount`, `outstandingBalance`, `daysToCompensate`, `documentNumber`, `ourNumber`, `ourNumberBankCode`, `participantControl`) |
| `createdDate`          | `string` (date-time) | Data e hora de criação da proposta (UTC)                                                                                                                                                                                                                       |

`201 Created`.

## Exemplo

### Request com `simulationPublicId`

```http
POST /api/v1/originator/employees/Kj8mP2xQ9nR4sT6v/proposals HTTP/1.1
Host: api.giro.tech
Authorization: Bearer {originatorToken}
Content-Type: application/json

{
  "simulationPublicId": "0198f2a1-7c3e-7b2d-9f14-3a5c8e6d1b05",
  "employmentRelationshipPublicId": "0198f2a1-7c3e-7b2d-9f14-3a5c8e6d1b02"
}
```

### Request sem `simulationPublicId`

O exemplo mostra só a primeira parcela; envie uma por parcela, `installmentCount` no total.

```http
POST /api/v1/originator/employees/Kj8mP2xQ9nR4sT6v/proposals HTTP/1.1
Host: api.giro.tech
Authorization: Bearer {originatorToken}
Content-Type: application/json

{
  "employmentRelationshipPublicId": "0198f2a1-7c3e-7b2d-9f14-3a5c8e6d1b02",
  "loanAmount": 5750.00,
  "financedAmount": 7125.36,
  "totalInterestAmount": 1189.72,
  "monthlyInterestRate": 1.97,
  "monthlyEffectiveCost": 2.43,
  "annualEffectiveCost": 33.18,
  "disbursementAmount": 5627.78,
  "insuranceAmount": 87.30,
  "iofAmount": 63.42,
  "tacAmount": 0,
  "installmentCount": 12,
  "dueDate": "2027-04-28",
  "installments": [
    {
      "installmentNumber": 1,
      "dueDate": "2027-04-28",
      "installmentAmount": 593.78,
      "amortizationAmount": 481.46,
      "interestAmount": 112.32,
      "iofAmount": 15.90,
      "feesAmount": 0,
      "outstandingBalance": 6531.58,
      "daysToCompensate": 30
    }
  ]
}
```

### Response `201 Created`

Resposta ao request com `simulationPublicId` acima. Sem simulação, o corpo tem o mesmo formato, com `simulationPublicId` nulo e os valores enviados.

```json
{
  "publicId": "Kj8mP2xQ9nR4sT6v",
  "employeePublicId": "Kj8mP2xQ9nR4sT6v",
  "simulationPublicId": "0198f2a1-7c3e-7b2d-9f14-3a5c8e6d1b05",
  "loanAmount": 5000.00,
  "financedAmount": 5668.08,
  "totalInterestAmount": 599.83,
  "monthlyInterestRate": 1.99,
  "monthlyEffectiveCost": 2.43,
  "annualEffectiveCost": 33.18,
  "disbursementAmount": 4931.75,
  "insuranceAmount": 50.00,
  "iofAmount": 18.25,
  "tacAmount": 0,
  "debitAmount": 5668.08,
  "outstandingBalance": 5668.08,
  "installmentCount": 12,
  "dueDate": "2026-06-28",
  "status": "PENDING",
  "expiresAt": "2026-05-12T10:00:00Z",
  "acceptedAt": null,
  "installments": [
    {
      "installmentNumber": 1,
      "dueDate": "2026-06-28",
      "installmentAmount": 472.34,
      "amortizationAmount": 372.84,
      "interestAmount": 99.50,
      "iofAmount": 1.52,
      "feesAmount": 4.17,
      "outstandingBalance": 5295.24,
      "daysToCompensate": 48
    }
  ],
  "createdDate": "2026-05-11T10:00:00Z"
}
```

## Próximo passo

[Criar Contrato](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/contratos/criar-contrato.md) com o `publicId` retornado.

## Erros

| Código | `errorCode`                      | Situação                                                                                                                                                                                        |
| ------ | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400    | —                                | Payload inválido (`properties.errors`): informe exatamente um identificador de vínculo/simulação; `proposalNumber` até 20 caracteres; `installmentAmount` ≥ 0,01; campos de garantia            |
| 400    | —                                | UUID ou data inválidos (`type: about:blank`)                                                                                                                                                    |
| 400    | `TAC_NOT_ALLOWED`                | `tacAmount` diferente de 0 (positivo ou negativo)                                                                                                                                               |
| 400    | `INSTALLMENT_NOT_IN_SIMULATION`  | Parcela informada não existe na simulação                                                                                                                                                       |
| 400    | —                                | `Simulação não encontrada: <id>` ou vínculo não encontrado — inexistente ou de outro employee                                                                                                   |
| 400    | —                                | Modo manual: `Campos obrigatórios ausentes ou inválidos: <lista>` (inclui `dueDate` no passado e taxa anual incoerente) ou `A quantidade de parcelas (N) deve ser igual a installmentCount (M)` |
| 400    | —                                | CET acima do teto: `title: Elegibility Violation`, `properties.violations[].code` = `MAX_EFFECTIVE_COST_EXCEEDED`                                                                               |
| 403    | `AUCTION_PARTICIPATION_DISABLED` | `proposalNumber` de uma oferta válida, com o originador sem participação no leilão habilitada. Avaliado depois do `422` `AUCTION_OFFER_NOT_FOUND`; nada é gravado                               |
| 404    | —                                | Employee não encontrado ou de outro originador                                                                                                                                                  |
| 409    | `INVALID_SIMULATION_TAC`         | Simulação antiga com TAC maior que 0. Refaça a simulação                                                                                                                                        |
| 422    | `FI`                             | Cobertura de garantia FGTS fora da regra; a mensagem traz o valor esperado. Ver [Cobertura de Garantias](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/cobertura-de-garantias.md)  |
| 422    | `AUCTION_OFFER_NOT_FOUND`        | `proposalNumber` que não é oferta de leilão sua para este trabalhador e esta `solicitationId`, ou já convertida em contrato. `proposalNumber` vazio equivale a ausente                          |
| 429    | —                                | Mais de 75 requisições por segundo                                                                                                                                                              |
| 500    | —                                | Simulação que não está mais disponível para virar proposta (já convertida ou expirada). Crie uma nova simulação                                                                                 |

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

## Criar Proposta

> Cria uma nova proposta de empréstimo. Dois modos de criação:\
> \- \*\*Com simulationPublicId\*\*: apenas o identificador da simulação +\
> &#x20; \`employmentRelationshipPublicId\` são necessários. Dados financeiros e parcelas são\
> &#x20; derivados automaticamente da simulação.\
> \- \*\*Sem identificador de simulação\*\*: todos os campos financeiros e \`installments\` são obrigatórios.<br>

```json
{"openapi":"3.0.0","info":{"title":"GT Payroll Originator API","version":"1.1.0"},"tags":[{"name":"Proposals","description":"Propostas 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/employees/{publicId}/proposals":{"post":{"summary":"Criar Proposta","description":"Cria uma nova proposta de empréstimo. Dois modos de criação:\n- **Com simulationPublicId**: apenas o identificador da simulação +\n  `employmentRelationshipPublicId` são necessários. Dados financeiros e parcelas são\n  derivados automaticamente da simulação.\n- **Sem identificador de simulação**: todos os campos financeiros e `installments` são obrigatórios.\n","tags":["Proposals"],"parameters":[{"name":"publicId","in":"path","required":true,"description":"Identificador público do employee (16 caracteres)","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":255},"description":"Chave de idempotência para evitar duplicação em retentativas.\nSe fornecida, o servidor retornará a mesma resposta para chamadas\ncom a mesma chave do mesmo originador.\nA chave é retida por 7 dias. Depois desse prazo ela é expurgada e uma\nrequisição com a mesma chave é tratada como nova, sendo reprocessada.\n"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Cria uma proposta de empréstimo. Dois modos de criação:\n- **Com simulationPublicId**: apenas `simulationPublicId` + `employmentRelationshipPublicId`\n  são obrigatórios; todos os dados financeiros e parcelas são derivados da simulação\n  (status EPHEMERAL). A simulação é marcada como CONVERTED_TO_PROPOSAL.\n- **Sem simulationPublicId**: todos os campos financeiros e `installments` são obrigatórios.\n","properties":{"simulationPublicId":{"type":"string","format":"uuid","description":"Identificador público opaco da simulação. Quando informado, dados financeiros e parcelas são derivados automaticamente da simulação, que deve estar no status EPHEMERAL; se não for informado, a proposta é criada manualmente a partir dos campos financeiros abaixo."},"employmentRelationshipPublicId":{"type":"string","format":"uuid","description":"Identificador público opaco do vínculo empregatício."},"loanAmount":{"type":"number","format":"decimal","minimum":0.01,"description":"Valor do empréstimo em reais. Obrigatório sem simulationPublicId."},"financedAmount":{"type":"number","format":"decimal","minimum":0.01,"description":"Valor financiado em reais. Obrigatório sem simulationPublicId."},"totalInterestAmount":{"type":"number","format":"decimal","minimum":0,"description":"Juros totais em reais. Obrigatório sem simulationPublicId."},"monthlyInterestRate":{"type":"number","format":"decimal","minimum":0,"description":"Taxa de juros mensal em percentual. Obrigatório sem simulationPublicId."},"annualInterestRate":{"type":"number","format":"decimal","minimum":0,"description":"Taxa de juros anual em percentual. Obrigatório sem simulationPublicId. Deve ser coerente com monthlyInterestRate (dentro da banda entre a taxa nominal i*12 e a efetiva composta (1+i)^12-1); valores fora dessa banda retornam 400 Bad Request."},"monthlyEffectiveCost":{"type":"number","format":"decimal","minimum":0,"description":"CET mensal em percentual. Obrigatório sem simulationPublicId."},"annualEffectiveCost":{"type":"number","format":"decimal","minimum":0,"description":"CET anual em percentual. Obrigatório sem simulationPublicId."},"disbursementAmount":{"type":"number","format":"decimal","minimum":0,"description":"Valor a desembolsar em reais. Obrigatório sem simulationPublicId."},"insuranceAmount":{"type":"number","format":"decimal","minimum":0,"description":"Valor do seguro em reais. Obrigatório sem simulationPublicId."},"iofAmount":{"type":"number","format":"decimal","minimum":0,"description":"IOF em reais. Obrigatório sem simulationPublicId."},"tacAmount":{"type":"number","format":"decimal","minimum":0,"maximum":0,"description":"TAC em reais. Deve ser 0 ou null. Enviar valor positivo retorna 400 Bad Request com a mensagem \"Produto não permite TAC (Taxa de Abertura de Crédito) conforme legislação vigente\"."},"installmentCount":{"type":"integer","minimum":1,"description":"Número de parcelas. Obrigatório sem simulationPublicId."},"dueDate":{"type":"string","format":"date","description":"Data de vencimento da primeira parcela. Obrigatório sem simulationPublicId. Não pode ser no passado."},"installments":{"type":"array","minItems":1,"description":"Lista de parcelas. Obrigatório sem simulationPublicId;\nquando simulationPublicId é informado, as parcelas são derivadas da simulação e só os\nidentificadores bancários enviados aqui (`documentNumber`, `ourNumber`, `ourNumberBankCode`,\n`participantControl`) são aplicados sobre elas, casando por `installmentNumber` (ou pela\nposição na lista, quando omitido). Identificador para parcela que a simulação não tem\nretorna `400` com `errorCode = INSTALLMENT_NOT_IN_SIMULATION`.\n","items":{"type":"object","description":"Dados de cada parcela. Alinha com os campos retornados pelo response da simulação\n(installmentNumber, installmentAmount, amortizationAmount, etc.).\n","properties":{"installmentNumber":{"type":"integer","minimum":1,"description":"Número da parcela (1-based). Alinha com installmentNumber do response da simulação."},"installmentAmount":{"type":"number","format":"decimal","minimum":0.01,"description":"Valor da parcela (desconto em folha) em reais. Alinha com installmentAmount do response da simulação."},"dueDate":{"type":"string","format":"date","description":"Data de vencimento da parcela (yyyy-MM-dd). Não pode ser no passado."},"amortizationAmount":{"type":"number","format":"decimal","minimum":0,"description":"Amortização (principal) da parcela em reais. Alinha com simulation response."},"interestAmount":{"type":"number","format":"decimal","minimum":0,"description":"Juros da parcela em reais."},"iofAmount":{"type":"number","format":"decimal","minimum":0,"description":"IOF da parcela em reais."},"feesAmount":{"type":"number","format":"decimal","minimum":0,"description":"Taxas da parcela em reais."},"outstandingBalance":{"type":"number","format":"decimal","minimum":0,"description":"Saldo devedor após a parcela em reais."},"daysToCompensate":{"type":"integer","minimum":1,"description":"Dias para compensação. Alinha com simulation response."},"documentNumber":{"type":"string","maxLength":10,"description":"Número identificador do vencimento, repassado ao banco emissor (`numero_documento`) na formalização da CCB. Opcional; quando omitido ou em branco a plataforma gera o número da CCB seguido da parcela em dois dígitos (CCB `00000001`: parcela 1 → `0000000101`, parcela 2 → `0000000102`)."},"ourNumber":{"type":"string","maxLength":32,"description":"Nosso número do documento no banco emissor. Opcional; repassado à formalização da CCB quando presente."},"ourNumberBankCode":{"type":"string","maxLength":3,"description":"Código do banco do nosso número do documento (COMPE, 3 dígitos). Opcional; repassado à formalização da CCB quando presente."},"participantControl":{"type":"string","maxLength":25,"description":"Controle do participante no banco emissor (`participante_controle`), usado para associar a baixa à parcela. Opcional; quando omitido ou em branco a plataforma gera o número da CCB, hífen e a parcela em dois dígitos (CCB `00000001`: parcela 1 → `00000001-01`, parcela 2 → `00000001-02`)."}}}},"proposalNumber":{"type":"string","maxLength":20,"description":"Número da proposta do leilão Dataprev (formato GT-{prefixo}-{único}, ex. GT-XX-7K3F9Q2M1ZX4AB). Opcional; informado apenas quando a proposta materializa uma oferta de leilão vencida, para amarrar a averbação à oferta original. Precisa ser uma oferta do próprio originador, para o mesmo trabalhador (CPF), da `solicitationId` quando informada, e ainda não convertida em contrato; caso contrário `422` com `properties.errorCode = AUCTION_OFFER_NOT_FOUND`. Vazio equivale a ausente."},"solicitationId":{"type":"integer","format":"int64","description":"Identificador Dataprev da solicitação de leilão (idSolicitacaoProposta) que originou esta proposta — o mesmo valor recebido no redirect de aceite. Opcional; presente apenas no fluxo de leilão."},"hasWarranty":{"type":"boolean","description":"Indica se a proposta carrega garantia FGTS. Opcional; quando true, os campos warranty* são propagados para a averbação Dataprev."},"warrantyFgtsBalance":{"type":"number","format":"decimal","minimum":0,"description":"Saldo disponível de garantia FGTS em reais. Opcional (fluxo de leilão com garantia)."},"warrantyFgtsPenalty":{"type":"number","format":"decimal","minimum":0,"description":"Multa rescisória da garantia FGTS em reais. Opcional (fluxo de leilão com garantia)."},"warrantySeverancePercentage":{"type":"number","format":"decimal","minimum":0,"maximum":35,"description":"Percentual da verba rescisória dado em garantia. Opcional (fluxo de leilão com garantia)."}}}}}},"responses":{"201":{"description":"Proposta criada com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"publicId":{"type":"string","description":"Identificador público (16 caracteres Base64 URL-safe). Ex. Kj8mP2xQ9nR4sT6v"},"employeePublicId":{"type":"string","description":"Identificador público opaco do employee (16 caracteres Base64 URL-safe). Pode vir ausente em registros antigos.","nullable":true},"simulationPublicId":{"type":"string","format":"uuid","nullable":true,"description":"Identificador público opaco da simulação de referência, quando houver."},"loanAmount":{"type":"number","format":"decimal","description":"Valor do empréstimo em reais (decimal com 2 casas decimais)."},"financedAmount":{"type":"number","format":"decimal","description":"Valor financiado em reais (decimal com 2 casas decimais)."},"totalInterestAmount":{"type":"number","format":"decimal","description":"Juros totais em reais (decimal com 2 casas decimais)."},"debitAmount":{"type":"number","format":"decimal","minimum":0,"description":"Total repayment amount (installmentCount × installmentAmount) in reais (decimal with 2 decimal places)."},"monthlyInterestRate":{"type":"number","format":"decimal","description":"Taxa mensal em percentual (decimal com 4 casas decimais)."},"annualInterestRate":{"type":"number","format":"decimal","description":"Taxa de juros anual em percentual (snapshot da proposta)."},"monthlyEffectiveCost":{"type":"number","format":"decimal","description":"CET mensal em percentual (decimal com 4 casas decimais)."},"annualEffectiveCost":{"type":"number","format":"decimal","description":"CET anual em percentual (decimal com 4 casas decimais)."},"disbursementAmount":{"type":"number","format":"decimal","description":"Valor a desembolsar em reais (decimal com 2 casas decimais)."},"insuranceAmount":{"type":"number","format":"decimal","description":"Seguro em reais (decimal com 2 casas decimais)."},"iofAmount":{"type":"number","format":"decimal","description":"IOF em reais (decimal com 2 casas decimais)."},"tacAmount":{"type":"number","format":"decimal","description":"TAC em reais. Sempre `0`; valor diferente responde `400 TAC_NOT_ALLOWED`."},"outstandingBalance":{"type":"number","format":"decimal","description":"Saldo devedor em reais (decimal com 2 casas decimais)."},"installmentCount":{"type":"integer"},"dueDate":{"type":"string","format":"date"},"status":{"type":"string","enum":["PENDING","ACCEPTED","REJECTED","EXPIRED","CONVERTED_TO_CONTRACT"],"description":"Status da proposta.\n| Valor | Significado |\n|-------|-------------|\n| PENDING | Aguardando aceite do trabalhador |\n| ACCEPTED | Aceita pelo trabalhador |\n| REJECTED | Rejeitada pelo trabalhador |\n| EXPIRED | Expirada (prazo de aceite) |\n| CONVERTED_TO_CONTRACT | Convertida em contrato |\n"},"expiresAt":{"type":"string","format":"date-time"},"acceptedAt":{"type":"string","format":"date-time"},"installments":{"type":"array","items":{"type":"object","properties":{"installmentNumber":{"type":"integer","description":"Número da parcela (1-based)."},"dueDate":{"type":"string","format":"date","description":"Data de vencimento da parcela."},"installmentAmount":{"type":"number","format":"decimal","description":"Valor da parcela (desconto em folha) em reais."},"amortizationAmount":{"type":"number","format":"decimal","description":"Amortização (principal) da parcela em reais."},"interestAmount":{"type":"number","format":"decimal","description":"Juros da parcela em reais."},"iofAmount":{"type":"number","format":"decimal","description":"IOF da parcela em reais."},"feesAmount":{"type":"number","format":"decimal","description":"Taxas da parcela em reais."},"outstandingBalance":{"type":"number","format":"decimal","description":"Saldo devedor após a parcela em reais."},"daysToCompensate":{"type":"integer","description":"Dias para compensação."},"documentNumber":{"type":"string","maxLength":10,"description":"Número identificador do vencimento informado na criação da proposta. Vazio quando o originador não enviou; nesse caso a CCB vai ao banco emissor com o número da CCB seguido da parcela em dois dígitos (`0000000101`)."},"ourNumber":{"type":"string","maxLength":32,"description":"Nosso número do documento no banco emissor."},"ourNumberBankCode":{"type":"string","maxLength":3,"description":"Código do banco do nosso número do documento."},"participantControl":{"type":"string","maxLength":25,"description":"Controle do participante informado na criação da proposta. Vazio quando o originador não enviou; nesse caso a CCB vai ao banco emissor com o número da CCB, hífen e a parcela em dois dígitos (`00000001-01`)."}}}},"createdDate":{"type":"string","format":"date-time"}}}}}},"400":{"description":"Dados inválidos, corpo ilegível, regra de negócio ou CET acima do teto.","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","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":"Employee 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":"Simulação antiga com TAC, ou mesma `Idempotency-Key` ainda em processamento.","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":"Cobertura de garantia fora da regra, ou `proposalNumber` que não é oferta de leilão sua.","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 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**."}}}}}}}}}}}}}
```

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