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

# Consulta de margem - melhor vínculo

Lê a margem consignável vigente do trabalhador, no melhor vínculo elegível. Não dispara consulta à Dataprev: a primeira consulta é automática após a autorização (webhook `MARGIN_QUERY_COMPLETED`), e uma margem nova se pede em [Solicitar Atualização de Margem](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/atualizar-margem.md) (`POST` no mesmo caminho).

## Request

`GET /api/v1/originator/employees/{publicId}/margin`

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

### Parâmetros

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

## Response

| Campo                     | Tipo            | Descrição                                                                                                   |
| ------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------- |
| `status`                  | `string` (enum) | `OK`, `PENDING`, `PROCESSING`, `EXPIRED`, `TERM_EXPIRED`, `NO_BONDS`, `NOT_ELIGIBLE`, `NO_MARGIN`, `ERROR`. |
| `reason`                  | `string`        | Motivo associado ao status (ex.: em `NOT_ELIGIBLE` ou `ERROR`).                                             |
| `employmentRelationships` | `array`         | Vínculos com margem e dados Dataprev (ver [abaixo](#campos-da-resposta-employmentrelationships)).           |

| Código | Significado                                                                                                                                                                                                                                                                                                     |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `200`  | Resposta com `status` no corpo. **Não** significa necessariamente margem disponível: `OK` traz a margem; `TERM_EXPIRED` indica autorização vencida e o trabalhador precisa [reautorizar](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/ciclo-de-vida-da-autorizacao.md) (não há webhook para isso) |
| `202`  | Em processamento (`status: PROCESSING`). Consulte de novo em alguns segundos                                                                                                                                                                                                                                    |
| `404`  | Employee não encontrado                                                                                                                                                                                                                                                                                         |
| `422`  | `MARGIN_REFRESH_REQUIRED`: sem margem vigente e sem consulta em andamento                                                                                                                                                                                                                                       |

## O `GET` read-only

O `GET` avalia, nesta ordem:

| Situação                                            | Resposta                                       |
| --------------------------------------------------- | ---------------------------------------------- |
| Há margem utilizável vigente                        | `200` com `status: OK` e os vínculos           |
| Há consulta de margem (ou de vínculos) em andamento | `202` com `status: PROCESSING`                 |
| Nenhuma das duas                                    | `422` com `errorCode: MARGIN_REFRESH_REQUIRED` |

Repetir só o `GET` não sai do `422`. Trate-o como "chame o `POST`", não como erro fatal:

1. `GET /margin` → `422 MARGIN_REFRESH_REQUIRED`
2. [`POST /margin`](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/atualizar-margem.md) → `202`
3. Aguarde o webhook `MARGIN_QUERY_COMPLETED` (ou consulte o `GET` até `200`)

Ramifique pelo `properties.errorCode`, que é estável; o `detail` é texto livre e pode mudar. Exemplo de corpo:

```json
{
  "type": "https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/erros#business-rule-violation",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "Margem indisponível. Solicite um refresh via POST /api/v1/originator/employees/Kj8mP2xQ9nR4sT6v/margin",
  "instance": "/api/v1/originator/employees/Kj8mP2xQ9nR4sT6v/margin",
  "properties": {
    "message": "Margem indisponível. Solicite um refresh via POST /api/v1/originator/employees/Kj8mP2xQ9nR4sT6v/margin",
    "errorCode": "MARGIN_REFRESH_REQUIRED"
  }
}
```

## Campos da resposta (employmentRelationships)

| Grupo                                 | Campos                                                                                                                                                                                                     |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Identificação**                     | `publicId`, `bondPublicId`, `registrationNumber`, `employerTaxId`, `employerName`, `workerName`, `birthDate`, `motherName`, `gender`, `admissionDate`, `status`                                            |
| **Margem e elegibilidade**            | `totalEarnings`, `marginBase`, `availableMargin`, `usableMargin`, `isEligible`, `ineligibilityReasons`, `dataprevExpiresAt`, `marginCacheExpiresAt`, `eligibility`                                         |
| **Dados profissionais (Dataprev)**    | `workerCategory`, `workerCategoryDescription`, `workerCboCode`, `workerCboDescription`, `employerCnae`, `employerCnaeDescription`, `employerActivityStartDate`, `employerTaxIdType`                        |
| **Outros (Dataprev)**                 | `activeConsignmentsCount`, `nationalityCode`, `nationalityDescription`, `blockingTypeCode`, `blockingTypeDescription`, `terminationDate`, `terminationReason`, `politicallyExposedPerson`                  |
| **Alertas do trabalhador (Dataprev)** | `alerts` (ver [Alertas do trabalhador](#alertas-do-trabalhador-alerts))                                                                                                                                    |
| **Empréstimos legados (Dataprev)**    | `legacyLoans` (ver [Empréstimos legados](#emprestimos-legados-legacyloans))                                                                                                                                |
| **FGTS**                              | `fgtsAvailability`: último resultado de [FGTS disponível](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/consultas-dataprev/consultar-fgts-disponivel.md) do vínculo, ou `null` |

* `publicId` é o valor a enviar em `employmentRelationshipPublicId` na simulação, elegibilidade e proposta. `bondPublicId` é o aceito nas [consultas por vínculo](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/consultas-dataprev.md).
* Valores enumerados: [Categoria do Trabalhador](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/enums/categoria-trabalhador.md), [Motivo de Desligamento](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/enums/motivo-desligamento.md), [Motivo de Inelegibilidade](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/enums/motivo-inelegibilidade.md) e [PEP](https://docs.giro.tech/desenvolvedores/api-gtpayroll/guias/enums/pessoa-exposta-politicamente.md).
* `workerName` é o nome que a Dataprev tem cadastrado, e é o nome usado na averbação. Pode vir `null` em vínculos antigos; nesse caso a averbação usa o nome cadastrado no employee (ASCII em maiúsculas).

### Alertas do trabalhador (`alerts`)

Array opcional com alertas de afastamento ou desligamento informados pela Dataprev. Vem ausente ou `null` quando não há alertas. Os campos `suspension*` só são preenchidos em `SUSPENSION`; `termination*` e `priorNotice*`, só em `TERMINATION`. Os demais vêm `null`.

| Campo                          | Tipo                      | Descrição                                                   |
| ------------------------------ | ------------------------- | ----------------------------------------------------------- |
| `alertType`                    | `string` (enum)           | `SUSPENSION` (afastamento) ou `TERMINATION` (desligamento). |
| `alertTypeDescription`         | `string`                  | `"Afastamento"` ou `"Desligamento"`.                        |
| `referenceDate`                | `string` (date) \| `null` | Data de referência do alerta.                               |
| `eventId`                      | `integer` \| `null`       | Identificador do evento na Dataprev.                        |
| `suspensionReasonCode`         | `integer` \| `null`       | Código do motivo do afastamento.                            |
| `suspensionReasonDescription`  | `string` \| `null`        | Descrição do motivo do afastamento.                         |
| `suspensionStartDate`          | `string` (date) \| `null` | Início do afastamento.                                      |
| `suspensionEndDate`            | `string` (date) \| `null` | Término do afastamento.                                     |
| `terminationReasonCode`        | `integer` \| `null`       | Código do motivo do desligamento.                           |
| `terminationReasonDescription` | `string` \| `null`        | Descrição do motivo do desligamento.                        |
| `terminationDate`              | `string` (date) \| `null` | Data do desligamento.                                       |
| `priorNoticeDate`              | `string` (date) \| `null` | Data do aviso prévio.                                       |
| `priorNoticeEndDate`           | `string` (date) \| `null` | Fim do aviso prévio.                                        |

Datas no formato `AAAA-MM-DD`.

### Empréstimos legados (`legacyLoans`)

Array opcional com os contratos (consignados e não consignados) que o trabalhador já tem, informados pela Dataprev. Vem ausente ou `null` quando não há; campos indisponíveis vêm `null`.

| Campo                      | Tipo                      | Descrição                                                                                            |
| -------------------------- | ------------------------- | ---------------------------------------------------------------------------------------------------- |
| `financialInstitutionCode` | `integer` \| `null`       | Código da instituição financeira.                                                                    |
| `contractNumber`           | `string` \| `null`        | Número do contrato.                                                                                  |
| `contractType`             | `string` (enum) \| `null` | `NON_PAYROLL_UNSECURED` (não consignado sem garantia) ou `PAYROLL_DEDUCTED` (com desconto em folha). |
| `contractTypeDescription`  | `string` \| `null`        | Descrição do tipo do contrato.                                                                       |
| `contractStartDate`        | `string` (date) \| `null` | Início do contrato (`AAAA-MM-DD`).                                                                   |
| `contractEndDate`          | `string` (date) \| `null` | Fim do contrato (`AAAA-MM-DD`).                                                                      |
| `totalInstallments`        | `integer` \| `null`       | Total de parcelas.                                                                                   |
| `paidInstallments`         | `integer` \| `null`       | Parcelas pagas.                                                                                      |
| `installmentAmount`        | `number` \| `null`        | Valor da parcela.                                                                                    |
| `loanAmount`               | `number` \| `null`        | Valor do empréstimo.                                                                                 |
| `disbursedAmount`          | `number` \| `null`        | Valor liberado.                                                                                      |
| `outstandingBalance`       | `number` \| `null`        | Saldo devedor.                                                                                       |
| `monthlyInterestRate`      | `number` \| `null`        | Taxa mensal.                                                                                         |
| `monthlyCet`               | `number` \| `null`        | CET mensal.                                                                                          |
| `sourceUpdatedAt`          | `string` \| `null`        | Data/hora de atualização do registro na Dataprev (texto bruto).                                      |

## Exemplo

```http
GET /api/v1/originator/employees/Kj8mP2xQ9nR4sT6v/margin HTTP/1.1
Host: api.giro.tech
Authorization: Bearer {originatorToken}
```

### Margem disponível (200)

```json
{
  "status": "OK",
  "reason": null,
  "employmentRelationships": [
    {
      "registrationNumber": "12345678901",
      "employerTaxId": "12345678000199",
      "employerName": "Empresa Exemplo Ltda",
      "workerName": "FULANO DA SILVA",
      "birthDate": "1990-05-12",
      "motherName": "MARIA DA SILVA",
      "gender": "MALE",
      "admissionDate": "2020-03-15",
      "status": "ACTIVE",
      "totalEarnings": 4850.73,
      "marginBase": 4850.73,
      "availableMargin": 1697.76,
      "usableMargin": 1697.76,
      "isEligible": true,
      "workerCategory": "GENERAL_EMPLOYEE",
      "workerCategoryDescription": "Empregado - Geral",
      "workerCboCode": "521130",
      "workerCboDescription": "ATENDENTE DE FARMACIA - BALCONISTA",
      "employerCnae": "4771701",
      "employerCnaeDescription": "COMERCIO VAREJISTA DE PRODUTOS FARMACEUTICOS, SEM MANIPULACAO DE FORMULAS",
      "employerActivityStartDate": "2002-09-04",
      "activeConsignmentsCount": 1,
      "nationalityCode": 76,
      "nationalityDescription": "BRASIL",
      "employerTaxIdType": "CNPJ",
      "blockingTypeCode": 0,
      "blockingTypeDescription": "Sem Bloqueio",
      "terminationDate": null,
      "terminationReason": null,
      "politicallyExposedPerson": "NOT_EXPOSED",
      "alerts": [
        {
          "alertType": "SUSPENSION",
          "alertTypeDescription": "Afastamento",
          "referenceDate": "2024-03-01",
          "eventId": 7,
          "suspensionReasonCode": 1,
          "suspensionReasonDescription": "Acidente/doença do trabalho",
          "suspensionStartDate": "2024-03-01",
          "suspensionEndDate": "2024-04-01",
          "terminationReasonCode": null,
          "terminationReasonDescription": null,
          "terminationDate": null,
          "priorNoticeDate": null,
          "priorNoticeEndDate": null
        }
      ],
      "legacyLoans": [
        {
          "financialInstitutionCode": 341,
          "contractNumber": "CONTRATO-123",
          "contractType": "PAYROLL_DEDUCTED",
          "contractTypeDescription": "Empréstimo com descontos em folha de pagamento",
          "contractStartDate": "2024-03-01",
          "contractEndDate": "2026-03-01",
          "totalInstallments": 24,
          "paidInstallments": 6,
          "installmentAmount": 150.00,
          "loanAmount": 3000.00,
          "disbursedAmount": 2800.00,
          "outstandingBalance": 2400.00,
          "monthlyInterestRate": 1.99,
          "monthlyCet": 2.15,
          "sourceUpdatedAt": "2024-03-01T10:15:30"
        }
      ]
    }
  ]
}
```

### Alerta de desligamento (`TERMINATION`)

Item de `alerts` com `alertType: TERMINATION`:

```json
{
  "alertType": "TERMINATION",
  "alertTypeDescription": "Desligamento",
  "referenceDate": "2024-05-20",
  "eventId": 12,
  "suspensionReasonCode": null,
  "suspensionReasonDescription": null,
  "suspensionStartDate": null,
  "suspensionEndDate": null,
  "terminationReasonCode": 2,
  "terminationReasonDescription": "Demissão sem justa causa",
  "terminationDate": "2024-05-20",
  "priorNoticeDate": "2024-04-20",
  "priorNoticeEndDate": "2024-05-20"
}
```

### Em processamento (202)

```json
{
  "status": "PROCESSING",
  "reason": null,
  "employmentRelationships": null
}
```

## Erros

| Código | `errorCode`               | Situação                                                                                                                                                                                                                                                                      |
| ------ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 404    | `EMPLOYEE_NOT_FOUND`      | Employee não encontrado ou de outro originador                                                                                                                                                                                                                                |
| 422    | `CPF_INELIGIBLE`          | O último termo de autorização foi reprovado pela Dataprev como inelegível. [Atualizar Margem](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/atualizar-margem.md) reenvia a autorização se o termo tiver menos de 30 dias; senão, colha novo termo |
| 422    | `MARGIN_REFRESH_REQUIRED` | Sem margem vigente e sem consulta em andamento. Chame [Solicitar Atualização de Margem](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/margem/atualizar-margem.md)                                                                                        |

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

## Consultar Margem

> Consulta margem consignável de um employee.\
> \
> Durante uma janela de suspensão da Dataprev este \`GET\` responde \`423\`, apesar de ser\
> leitura local. Durante a janela, o \`423\` vale para toda a consulta de margem.<br>

```json
{"openapi":"3.0.0","info":{"title":"GT Payroll Originator API","version":"1.1.0"},"tags":[{"name":"Margin","description":"Consulta de margem consignável"}],"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}/margin":{"get":{"operationId":"getMargin","summary":"Consultar Margem","description":"Consulta margem consignável de um employee.\n\nDurante uma janela de suspensão da Dataprev este `GET` responde `423`, apesar de ser\nleitura local. Durante a janela, o `423` vale para toda a consulta de margem.\n","tags":["Margin"],"parameters":[{"name":"publicId","in":"path","required":true,"description":"Identificador público do employee (16 caracteres)","schema":{"type":"string"}}],"responses":{"200":{"description":"Margem retornada com sucesso","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["OK","PENDING","PROCESSING","EXPIRED","TERM_EXPIRED","NO_BONDS","NOT_ELIGIBLE","NO_MARGIN","ERROR"],"description":"Status da consulta de margem no convênio.\n| Valor | Significado |\n|-------|-------------|\n| OK | Margem disponível e elegível |\n| PENDING | Consulta em análise |\n| PROCESSING | Processando dados no convênio |\n| EXPIRED | Margem expirada (prazo Dataprev) |\n| TERM_EXPIRED | Prazo do contrato expirado |\n| NO_BONDS | Sem vínculos ativos |\n| NOT_ELIGIBLE | Não elegível às regras do produto |\n| NO_MARGIN | Sem margem disponível |\n| ERROR | Erro na consulta |\n"},"reason":{"type":"string","nullable":true,"description":"Motivo associado ao status (ex. quando NOT_ELIGIBLE ou ERROR)."},"employmentRelationships":{"type":"array","items":{"type":"object","properties":{"publicId":{"type":"string","format":"uuid","description":"Identificador público opaco do vínculo. É este o valor a enviar em `employmentRelationshipPublicId` nas operações de simulação, elegibilidade e proposta. Pode vir ausente em vínculos antigos."},"bondPublicId":{"type":"string","format":"uuid","nullable":true,"description":"Identificador público opaco do vínculo autorizado, aceito em `POST /employees/{publicId}/authorized-bonds/{bondPublicId}/margin-queries` e `.../fgts-availability-queries`. `null` quando não há bond correspondente na listagem ou em registros antigos."},"registrationNumber":{"type":"string"},"employerTaxId":{"type":"string","description":"Documento do empregador: CNPJ (14 dígitos) ou CPF (11 dígitos)."},"employerName":{"type":"string"},"workerName":{"type":"string","maxLength":200,"nullable":true,"description":"Nome do trabalhador conforme retornado pela Dataprev. É a fonte de verdade\npara a averbação. Pode ser `null` em vínculos legados cujo dado da Dataprev\nainda não foi atualizado.\n"},"birthDate":{"type":"string","format":"date","nullable":true,"description":"Data de nascimento do trabalhador (employee). Preenchida a partir do cadastro\nlocal, preenchida pela consulta à Dataprev.\nPode ser `null` se ainda não disponível.\n"},"motherName":{"type":"string","maxLength":100,"nullable":true,"description":"Nome completo da mãe do trabalhador, preenchido pela Dataprev.\nPode ser `null` se ainda não disponível.\n"},"gender":{"type":"string","enum":["MALE","FEMALE","NOT_INFORMED"],"nullable":true,"description":"Gênero do trabalhador, preenchido pela Dataprev.\nPode ser `null` se ainda não disponível.\n"},"admissionDate":{"type":"string","format":"date"},"status":{"type":"string","enum":["ACTIVE","INACTIVE","TERMINATED","SUSPENDED"],"description":"Status do vínculo empregatício no convênio.\n| Valor | Significado |\n|-------|-------------|\n| ACTIVE | Vínculo ativo |\n| INACTIVE | Vínculo inativo |\n| TERMINATED | Vínculo encerrado |\n| SUSPENDED | Vínculo suspenso (ex.: afastamento) |\n"},"totalEarnings":{"type":"number","format":"decimal","description":"Remuneração total em reais (decimal com 2 casas decimais)."},"marginBase":{"type":"number","format":"decimal","description":"Base de margem em reais (decimal com 2 casas decimais)."},"availableMargin":{"type":"number","format":"decimal","description":"Margem disponível em reais (decimal com 2 casas decimais)."},"usableMargin":{"type":"number","format":"decimal","description":"Margem utilizável em reais (decimal com 2 casas decimais)."},"isEligible":{"type":"boolean"},"dataprevExpiresAt":{"type":"string","format":"date-time","nullable":true,"description":"Validade da margem retornada. Após esse instante os dados de margem estão vencidos\ne uma nova consulta de margem deve ser disparada para revalidar. `null` quando a validade\né desconhecida (vínculo nunca sincronizado).\n"},"marginCacheExpiresAt":{"type":"string","format":"date-time","deprecated":true,"description":"**Deprecated** — alias de `dataprevExpiresAt` (mesmo valor). Mantido por compatibilidade;\nserá removido em versão futura. Use `dataprevExpiresAt`.\n"},"employerCnaeDescription":{"type":"string","description":"Descrição do CNAE do empregador."},"nationalityCode":{"type":"integer","description":"Código do país de nacionalidade do trabalhador (padrão IBGE/Dataprev)."},"nationalityDescription":{"type":"string","description":"Descrição do país de nacionalidade do trabalhador."},"blockingTypeCode":{"type":"integer","description":"Código do tipo de bloqueio do trabalhador na Dataprev.\n| Código | Significado |\n|--------|-------------|\n| 0 | Sem Bloqueio |\n"},"blockingTypeDescription":{"type":"string","description":"Descrição do tipo de bloqueio do trabalhador."},"workerCategory":{"type":"string","description":"Código da categoria do trabalhador no eSocial.\nExemplo: 101 = Empregado - Geral.\n"},"workerCategoryDescription":{"type":"string","description":"Descrição da categoria do trabalhador."},"workerCboCode":{"type":"string","description":"Código CBO (Classificação Brasileira de Ocupações) do trabalhador."},"workerCboDescription":{"type":"string","description":"Descrição do CBO do trabalhador."},"employerCnae":{"type":"string","description":"Código CNAE (Classificação Nacional de Atividades Econômicas) do empregador."},"employerActivityStartDate":{"type":"string","format":"date","description":"Data de início de atividade do empregador (formato ISO 8601)."},"activeConsignmentsCount":{"type":"integer","description":"Quantidade de empréstimos consignados ativos/suspensos do trabalhador."},"employerTaxIdType":{"type":"string","description":"Tipo de inscrição do empregador.\n| Valor | Significado |\n|-------|-------------|\n| CNPJ | Cadastro Nacional de Pessoa Jurídica |\n| CPF | Cadastro de Pessoa Física |\n| CEI | Cadastro Específico do INSS |\n| CAEPF | Cadastro de Atividade Econômica de Pessoa Física |\n"},"terminationDate":{"type":"string","format":"date","description":"Data de desligamento do trabalhador, se aplicável (formato ISO 8601).","nullable":true},"terminationReason":{"type":"string","description":"Motivo do desligamento do trabalhador, se aplicável.","nullable":true},"politicallyExposedPerson":{"type":"string","description":"Indicador de pessoa politicamente exposta.\n| Valor | Significado |\n|-------|-------------|\n| NOT_EXPOSED | Pessoa Não Exposta Politicamente |\n| EXPOSED | Pessoa Exposta Politicamente |\n| RELATED | Pessoa Relacionada a PEP |\n"},"alerts":{"type":"array","nullable":true,"description":"Alertas de afastamento/desligamento do trabalhador informados pela Dataprev.\nNulo/ausente quando não há alertas.\n","items":{"type":"object","description":"Alerta de afastamento/desligamento do trabalhador informado pela Dataprev junto da\nconsulta de margem.\n","properties":{"alertType":{"type":"string","enum":["SUSPENSION","TERMINATION"],"description":"Tipo do alerta."},"alertTypeDescription":{"type":"string"},"referenceDate":{"type":"string","format":"date","nullable":true,"description":"Data de referência do alerta."},"eventId":{"type":"string","nullable":true,"description":"Identificador do evento na Dataprev."},"suspensionReasonCode":{"type":"integer","nullable":true,"description":"Código do motivo de afastamento (preenchido quando `SUSPENSION`)."},"suspensionReasonDescription":{"type":"string","nullable":true},"suspensionStartDate":{"type":"string","format":"date","nullable":true,"description":"Data de início do afastamento."},"suspensionEndDate":{"type":"string","format":"date","nullable":true,"description":"Data de término do afastamento."},"terminationReasonCode":{"type":"integer","nullable":true,"description":"Código do motivo de desligamento (preenchido quando `TERMINATION`)."},"terminationReasonDescription":{"type":"string","nullable":true},"terminationDate":{"type":"string","format":"date","nullable":true,"description":"Data do desligamento."},"priorNoticeDate":{"type":"string","format":"date","nullable":true,"description":"Data do aviso prévio."},"priorNoticeEndDate":{"type":"string","format":"date","nullable":true,"description":"Data fim do aviso prévio."}}}},"legacyLoans":{"type":"array","nullable":true,"description":"Empréstimos legados do trabalhador informados pela Dataprev.\nNulo/ausente quando não há empréstimos legados.\n","items":{"type":"object","description":"Empréstimo legado do trabalhador informado pela Dataprev junto da consulta de margem.\n","properties":{"financialInstitutionCode":{"type":"integer","nullable":true,"description":"Código da instituição financeira (codigoIF)."},"contractNumber":{"type":"string","nullable":true,"description":"Número do contrato."},"contractType":{"type":"string","enum":["NON_PAYROLL_UNSECURED","PAYROLL_DEDUCTED"],"nullable":true,"description":"Tipo do contrato.\n| Valor | Significado |\n|-------|-------------|\n| NON_PAYROLL_UNSECURED | Empréstimo não consignado sem garantia |\n| PAYROLL_DEDUCTED | Empréstimo com descontos em folha de pagamento |\n"},"contractTypeDescription":{"type":"string","nullable":true},"contractStartDate":{"type":"string","format":"date","nullable":true,"description":"Data de início do contrato."},"contractEndDate":{"type":"string","format":"date","nullable":true,"description":"Data de fim do contrato."},"totalInstallments":{"type":"integer","nullable":true,"description":"Total de parcelas."},"paidInstallments":{"type":"integer","nullable":true,"description":"Quantidade de parcelas pagas."},"installmentAmount":{"type":"number","format":"decimal","nullable":true,"description":"Valor da parcela."},"loanAmount":{"type":"number","format":"decimal","nullable":true,"description":"Valor do empréstimo."},"disbursedAmount":{"type":"number","format":"decimal","nullable":true,"description":"Valor liberado."},"outstandingBalance":{"type":"number","format":"decimal","nullable":true,"description":"Valor do saldo devedor."},"monthlyInterestRate":{"type":"number","format":"decimal","nullable":true,"description":"Valor da taxa mensal."},"monthlyCet":{"type":"number","format":"decimal","nullable":true,"description":"Valor do CET mensal."},"sourceUpdatedAt":{"type":"string","nullable":true,"description":"Data/hora de atualização do registro na Dataprev (texto bruto)."}}}},"fgtsAvailability":{"allOf":[{"type":"object","description":"Snapshot of the worker's available FGTS as consigned-loan guarantee, from Dataprev's\nconsultar-saldo-fgts. Maps 1:1 to the FGTS guarantee fields used at endorsement time.\n","required":["availableBalance","severanceFine","referenceAt"],"properties":{"availableBalance":{"type":"number","format":"double","description":"Available FGTS balance as consigned guarantee (valorSaldoDisponivelConsignado)"},"severanceFine":{"type":"number","format":"double","description":"Available severance fine portion as guarantee (valorMultaRescisoriaConsignado)"},"referenceAt":{"type":"string","format":"date-time","description":"Dataprev consultation timestamp (dataHoraConsulta), as a local date-time"}}}],"nullable":true,"description":"Último snapshot FGTS COMPLETED do vínculo (projeção read-time, R5.1), ou null quando o vínculo\nnunca teve consulta de FGTS concluída. Resolvido pela chave natural\n(employee + registrationNumber + employer tax id); não cria/altera storage.\n"}}}}}}}}},"202":{"description":"Consulta em processamento","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["OK","PENDING","PROCESSING","EXPIRED","TERM_EXPIRED","NO_BONDS","NOT_ELIGIBLE","NO_MARGIN","ERROR"],"description":"Status da consulta de margem no convênio.\n| Valor | Significado |\n|-------|-------------|\n| OK | Margem disponível e elegível |\n| PENDING | Consulta em análise |\n| PROCESSING | Processando dados no convênio |\n| EXPIRED | Margem expirada (prazo Dataprev) |\n| TERM_EXPIRED | Prazo do contrato expirado |\n| NO_BONDS | Sem vínculos ativos |\n| NOT_ELIGIBLE | Não elegível às regras do produto |\n| NO_MARGIN | Sem margem disponível |\n| ERROR | Erro na consulta |\n"},"reason":{"type":"string","nullable":true,"description":"Motivo associado ao status (ex. quando NOT_ELIGIBLE ou ERROR)."},"employmentRelationships":{"type":"array","items":{"type":"object","properties":{"publicId":{"type":"string","format":"uuid","description":"Identificador público opaco do vínculo. É este o valor a enviar em `employmentRelationshipPublicId` nas operações de simulação, elegibilidade e proposta. Pode vir ausente em vínculos antigos."},"bondPublicId":{"type":"string","format":"uuid","nullable":true,"description":"Identificador público opaco do vínculo autorizado, aceito em `POST /employees/{publicId}/authorized-bonds/{bondPublicId}/margin-queries` e `.../fgts-availability-queries`. `null` quando não há bond correspondente na listagem ou em registros antigos."},"registrationNumber":{"type":"string"},"employerTaxId":{"type":"string","description":"Documento do empregador: CNPJ (14 dígitos) ou CPF (11 dígitos)."},"employerName":{"type":"string"},"workerName":{"type":"string","maxLength":200,"nullable":true,"description":"Nome do trabalhador conforme retornado pela Dataprev. É a fonte de verdade\npara a averbação. Pode ser `null` em vínculos legados cujo dado da Dataprev\nainda não foi atualizado.\n"},"birthDate":{"type":"string","format":"date","nullable":true,"description":"Data de nascimento do trabalhador (employee). Preenchida a partir do cadastro\nlocal, preenchida pela consulta à Dataprev.\nPode ser `null` se ainda não disponível.\n"},"motherName":{"type":"string","maxLength":100,"nullable":true,"description":"Nome completo da mãe do trabalhador, preenchido pela Dataprev.\nPode ser `null` se ainda não disponível.\n"},"gender":{"type":"string","enum":["MALE","FEMALE","NOT_INFORMED"],"nullable":true,"description":"Gênero do trabalhador, preenchido pela Dataprev.\nPode ser `null` se ainda não disponível.\n"},"admissionDate":{"type":"string","format":"date"},"status":{"type":"string","enum":["ACTIVE","INACTIVE","TERMINATED","SUSPENDED"],"description":"Status do vínculo empregatício no convênio.\n| Valor | Significado |\n|-------|-------------|\n| ACTIVE | Vínculo ativo |\n| INACTIVE | Vínculo inativo |\n| TERMINATED | Vínculo encerrado |\n| SUSPENDED | Vínculo suspenso (ex.: afastamento) |\n"},"totalEarnings":{"type":"number","format":"decimal","description":"Remuneração total em reais (decimal com 2 casas decimais)."},"marginBase":{"type":"number","format":"decimal","description":"Base de margem em reais (decimal com 2 casas decimais)."},"availableMargin":{"type":"number","format":"decimal","description":"Margem disponível em reais (decimal com 2 casas decimais)."},"usableMargin":{"type":"number","format":"decimal","description":"Margem utilizável em reais (decimal com 2 casas decimais)."},"isEligible":{"type":"boolean"},"dataprevExpiresAt":{"type":"string","format":"date-time","nullable":true,"description":"Validade da margem retornada. Após esse instante os dados de margem estão vencidos\ne uma nova consulta de margem deve ser disparada para revalidar. `null` quando a validade\né desconhecida (vínculo nunca sincronizado).\n"},"marginCacheExpiresAt":{"type":"string","format":"date-time","deprecated":true,"description":"**Deprecated** — alias de `dataprevExpiresAt` (mesmo valor). Mantido por compatibilidade;\nserá removido em versão futura. Use `dataprevExpiresAt`.\n"},"employerCnaeDescription":{"type":"string","description":"Descrição do CNAE do empregador."},"nationalityCode":{"type":"integer","description":"Código do país de nacionalidade do trabalhador (padrão IBGE/Dataprev)."},"nationalityDescription":{"type":"string","description":"Descrição do país de nacionalidade do trabalhador."},"blockingTypeCode":{"type":"integer","description":"Código do tipo de bloqueio do trabalhador na Dataprev.\n| Código | Significado |\n|--------|-------------|\n| 0 | Sem Bloqueio |\n"},"blockingTypeDescription":{"type":"string","description":"Descrição do tipo de bloqueio do trabalhador."},"workerCategory":{"type":"string","description":"Código da categoria do trabalhador no eSocial.\nExemplo: 101 = Empregado - Geral.\n"},"workerCategoryDescription":{"type":"string","description":"Descrição da categoria do trabalhador."},"workerCboCode":{"type":"string","description":"Código CBO (Classificação Brasileira de Ocupações) do trabalhador."},"workerCboDescription":{"type":"string","description":"Descrição do CBO do trabalhador."},"employerCnae":{"type":"string","description":"Código CNAE (Classificação Nacional de Atividades Econômicas) do empregador."},"employerActivityStartDate":{"type":"string","format":"date","description":"Data de início de atividade do empregador (formato ISO 8601)."},"activeConsignmentsCount":{"type":"integer","description":"Quantidade de empréstimos consignados ativos/suspensos do trabalhador."},"employerTaxIdType":{"type":"string","description":"Tipo de inscrição do empregador.\n| Valor | Significado |\n|-------|-------------|\n| CNPJ | Cadastro Nacional de Pessoa Jurídica |\n| CPF | Cadastro de Pessoa Física |\n| CEI | Cadastro Específico do INSS |\n| CAEPF | Cadastro de Atividade Econômica de Pessoa Física |\n"},"terminationDate":{"type":"string","format":"date","description":"Data de desligamento do trabalhador, se aplicável (formato ISO 8601).","nullable":true},"terminationReason":{"type":"string","description":"Motivo do desligamento do trabalhador, se aplicável.","nullable":true},"politicallyExposedPerson":{"type":"string","description":"Indicador de pessoa politicamente exposta.\n| Valor | Significado |\n|-------|-------------|\n| NOT_EXPOSED | Pessoa Não Exposta Politicamente |\n| EXPOSED | Pessoa Exposta Politicamente |\n| RELATED | Pessoa Relacionada a PEP |\n"},"alerts":{"type":"array","nullable":true,"description":"Alertas de afastamento/desligamento do trabalhador informados pela Dataprev.\nNulo/ausente quando não há alertas.\n","items":{"type":"object","description":"Alerta de afastamento/desligamento do trabalhador informado pela Dataprev junto da\nconsulta de margem.\n","properties":{"alertType":{"type":"string","enum":["SUSPENSION","TERMINATION"],"description":"Tipo do alerta."},"alertTypeDescription":{"type":"string"},"referenceDate":{"type":"string","format":"date","nullable":true,"description":"Data de referência do alerta."},"eventId":{"type":"string","nullable":true,"description":"Identificador do evento na Dataprev."},"suspensionReasonCode":{"type":"integer","nullable":true,"description":"Código do motivo de afastamento (preenchido quando `SUSPENSION`)."},"suspensionReasonDescription":{"type":"string","nullable":true},"suspensionStartDate":{"type":"string","format":"date","nullable":true,"description":"Data de início do afastamento."},"suspensionEndDate":{"type":"string","format":"date","nullable":true,"description":"Data de término do afastamento."},"terminationReasonCode":{"type":"integer","nullable":true,"description":"Código do motivo de desligamento (preenchido quando `TERMINATION`)."},"terminationReasonDescription":{"type":"string","nullable":true},"terminationDate":{"type":"string","format":"date","nullable":true,"description":"Data do desligamento."},"priorNoticeDate":{"type":"string","format":"date","nullable":true,"description":"Data do aviso prévio."},"priorNoticeEndDate":{"type":"string","format":"date","nullable":true,"description":"Data fim do aviso prévio."}}}},"legacyLoans":{"type":"array","nullable":true,"description":"Empréstimos legados do trabalhador informados pela Dataprev.\nNulo/ausente quando não há empréstimos legados.\n","items":{"type":"object","description":"Empréstimo legado do trabalhador informado pela Dataprev junto da consulta de margem.\n","properties":{"financialInstitutionCode":{"type":"integer","nullable":true,"description":"Código da instituição financeira (codigoIF)."},"contractNumber":{"type":"string","nullable":true,"description":"Número do contrato."},"contractType":{"type":"string","enum":["NON_PAYROLL_UNSECURED","PAYROLL_DEDUCTED"],"nullable":true,"description":"Tipo do contrato.\n| Valor | Significado |\n|-------|-------------|\n| NON_PAYROLL_UNSECURED | Empréstimo não consignado sem garantia |\n| PAYROLL_DEDUCTED | Empréstimo com descontos em folha de pagamento |\n"},"contractTypeDescription":{"type":"string","nullable":true},"contractStartDate":{"type":"string","format":"date","nullable":true,"description":"Data de início do contrato."},"contractEndDate":{"type":"string","format":"date","nullable":true,"description":"Data de fim do contrato."},"totalInstallments":{"type":"integer","nullable":true,"description":"Total de parcelas."},"paidInstallments":{"type":"integer","nullable":true,"description":"Quantidade de parcelas pagas."},"installmentAmount":{"type":"number","format":"decimal","nullable":true,"description":"Valor da parcela."},"loanAmount":{"type":"number","format":"decimal","nullable":true,"description":"Valor do empréstimo."},"disbursedAmount":{"type":"number","format":"decimal","nullable":true,"description":"Valor liberado."},"outstandingBalance":{"type":"number","format":"decimal","nullable":true,"description":"Valor do saldo devedor."},"monthlyInterestRate":{"type":"number","format":"decimal","nullable":true,"description":"Valor da taxa mensal."},"monthlyCet":{"type":"number","format":"decimal","nullable":true,"description":"Valor do CET mensal."},"sourceUpdatedAt":{"type":"string","nullable":true,"description":"Data/hora de atualização do registro na Dataprev (texto bruto)."}}}},"fgtsAvailability":{"allOf":[{"type":"object","description":"Snapshot of the worker's available FGTS as consigned-loan guarantee, from Dataprev's\nconsultar-saldo-fgts. Maps 1:1 to the FGTS guarantee fields used at endorsement time.\n","required":["availableBalance","severanceFine","referenceAt"],"properties":{"availableBalance":{"type":"number","format":"double","description":"Available FGTS balance as consigned guarantee (valorSaldoDisponivelConsignado)"},"severanceFine":{"type":"number","format":"double","description":"Available severance fine portion as guarantee (valorMultaRescisoriaConsignado)"},"referenceAt":{"type":"string","format":"date-time","description":"Dataprev consultation timestamp (dataHoraConsulta), as a local date-time"}}}],"nullable":true,"description":"Último snapshot FGTS COMPLETED do vínculo (projeção read-time, R5.1), ou null quando o vínculo\nnunca teve consulta de FGTS concluída. Resolvido pela chave natural\n(employee + registrationNumber + employer tax id); não cria/altera storage.\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":"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**."}}}}}}}},"422":{"description":"Margem não pode ser lida no estado atual.","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."}}}}}}}}}}}}}
```

Com a margem disponível, siga para [Criar Simulação](https://docs.giro.tech/desenvolvedores/api-gtpayroll/api-reference/simulacoes/criar-simulacao.md).

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