> 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/simulacoes.md).

# Simulações

A simulação calcula parcelas, juros, IOF, CET e valor líquido de um empréstimo a partir de valor (ou parcela desejada), prazo e taxa. Você pode criar quantas simulações quiser para o mesmo trabalhador até chegar à condição ideal.

## Pré-requisitos

1. O employee esteja [cadastrado](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/employees/criar-employee.md)
2. A [autorização Dataprev](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/autorizacao.md) esteja concluída
3. A [margem](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/consultar-margem.md) tenha sido consultada

```
Consultar Margem → Criar Simulação → Criar Proposta
```

O primeiro vencimento segue o calendário Dataprev, sempre no dia 28 — ver [Regra de vencimento automático](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/simulacoes/criar-simulacao.md#regra-de-vencimento-automatico).

## Operações disponíveis

| Operação                                                                                                                                            | Método | Endpoint                                                             |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------- |
| [Criar Simulação](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/simulacoes/criar-simulacao.md)                                 | `POST` | `/api/v1/originator/employees/{publicId}/simulations`                |
| [Criar Simulação por Parcela](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/simulacoes/criar-simulacao-por-parcela.md)         | `POST` | `/api/v1/originator/employees/{publicId}/simulations/by-installment` |
| [Simular sem Vínculo](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/simulacoes/simular-sem-vinculo.md)                         | `POST` | `/api/v1/originator/simulations`                                     |
| [Simular sem Vínculo por Parcela](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/simulacoes/simular-sem-vinculo-por-parcela.md) | `POST` | `/api/v1/originator/simulations/by-installment`                      |

{% hint style="info" %}
As operações **sem vínculo** servem para simular a migração de um contrato antes de o vínculo novo existir no GT Payroll. Elas não exigem os pré-requisitos acima, não validam margem nem regras de elegibilidade, e o resultado não é gravado nem pode ser convertido em proposta.
{% endhint %}

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