Calcula a correção de FGTS (teses JAM e Depósito)

Corrige lançamentos de FGTS por uma das duas teses de cálculo:

• jam: Realiza a correção monetária do JAM. Exige jam_interests.id = 3|4|5|6 (correspondentes a 3%–6% a.a.). A resposta agrupa items[] mês a mês desde 01/1999 até a data atual, com _calculation_basis, _difference_jam e _outstanding_balance_correction por item, além do _amount_correction acumulado no topo.
• deposit: Tese de Depósito — corrige o valor original com pro rata na primeira e última competência. Cada item traz um schedule[] com a evolução mês a mês.

items precisa de pelo menos um lançamento. O índice (index.id) é resolvido no backend para o bacen_code correspondente (ex.: 2 → INPC).

POST /api/v1/calculadoras/fgts

Calcula a correção de FGTS (teses JAM e Depósito)

cURL

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/v1/calculadoras/fgts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "author": "Autor Exemplo",
  "end_date": "2021-07-09",
  "thesis": {
    "id": "deposit",
    "name": "Depósito"
  },
  "index": {
    "id": 2,
    "name": "INPC",
    "bacen_code": "188"
  },
  "items": [
    {
      "date": "1999-01-10",
      "amount": 100,
      "description": "Depósito jan/1999"
    }
  ]
}
'

200

Example

{
  "statusCode": 200,
  "message": "Cálculo concluído com sucesso",
  "timestamp": "2026-06-22T18:00:00.000Z",
  "path": "/api/v1/calculadoras/fgts",
  "result": {
    "index": "INPC",
    "latest_index_update": "04/2026",
    "author": "Autor Exemplo",
    "interests_rate": "",
    "hasInterests": false,
    "hasFine": false,
    "hasLegalFees": false,
    "hasInterestRate": false,
    "items": [
      {
        "_key": 1,
        "_date": "10/01/1999",
        "_amount": "100,00",
        "_fine": "0,00",
        "_interests": "0,00",
        "_subtotal": "415,71",
        "_differenceAdjustedAmount": "415,71",
        "_outstanding_balance": "415,71",
        "date": "1999-01-10",
        "amount": 100,
        "description": "Depósito jan/1999",
        "interests": 0,
        "subtotal": 415.71,
        "schedule": [
          {
            "date": "1999-01-10",
            "amount": 100,
            "correction": 0,
            "amount_adjusted": 0,
            "interests": 0,
            "outstanding_balance": 100,
            "_description": "Depósito jan/1999",
            "_date": "10/01/1999",
            "_amount": "100,00",
            "_amount_adjusted": "",
            "_correction": "",
            "_interests": "",
            "_outstanding_balance": ""
          },
          {
            "date": "1999-01-31",
            "amount": 100,
            "correction": 0.55,
            "amount_adjusted": 100.55,
            "interests": 0,
            "outstanding_balance": 100.55,
            "_description": "",
            "_date": "31/01/1999",
            "_amount": "100,00",
            "_amount_adjusted": "R$ 100,55",
            "_correction": "0,55",
            "_interests": "",
            "_outstanding_balance": "R$ 100,55"
          },
          {
            "date": "2021-07-09",
            "amount": 415.53,
            "correction": 0.09,
            "amount_adjusted": 415.71,
            "interests": 0,
            "outstanding_balance": 415.71,
            "_description": "",
            "_date": "09/07/2021",
            "_amount": "415,53",
            "_amount_adjusted": "R$ 415,71",
            "_correction": "0,09",
            "_interests": "",
            "_outstanding_balance": "R$ 415,71"
          }
        ]
      }
    ],
    "_end_date": "09/07/2021",
    "_total_interests": "0,00",
    "_total_outstanding_balance": "415,71",
    "_subtotal_amount": "100,00",
    "_subtotal": "415,71",
    "_subtotal_nofine": "415,71",
    "_difference": "315,71",
    "_legal_fees": "0,00",
    "_total": "415,71",
    "_total_fines": "R$ 0,00",
    "status": true
  }
}

Autorizações

x-api-key · string · header · obrigatório

Corpo

application/json

Payload da calculadora de FGTS.

Payload da correção de FGTS. Escolha a tese (jam ou deposit), o índice de correção e informe os lançamentos (items). Para a tese jam, também é obrigatório o jam_interests (rótulo 3–6, correspondentes a 3%–6% a.a.). A resposta traz os itens corrigidos e os totais agregados.

end_date · string<date> · obrigatório

Data final da correção (YYYY-MM-DD).

thesis · object · obrigatório

Tese aplicada ao cálculo.

Show child attributes

index · object · obrigatório

Índice de correção monetária.

Show child attributes

items · object[] · obrigatório

Itens a corrigir. Deve conter pelo menos um item.

Show child attributes

name · string

Nome do cálculo. Opcional; não afeta o resultado.

author · string

Autor do cálculo (ecoado).

jam_interests · object

Configuração dos juros da tese jam. Obrigatório quando thesis.id === "jam".

Show child attributes

Resposta

200

application/json

Resultado da correção, com os itens processados e totais agregados.

The response is of type object.