Calcula a revisão de RMC/RCC (cartão consignado)

Revisa contratos de RMC (Reserva de Margem Consignável) / RCC (Reserva de Cartão de Crédito). O input é uma union discriminada por refund_total, com dois fluxos e dois formatos de resposta:

• refund_total: false (diferenças): converte o empréstimo, apura as diferenças por parcela e o refinanciamento. Exige pelo menos uma parcela com amount > 0; caso contrário a resposta é 422.
• refund_total: true (restituição total): devolve tudo que foi pago (opcionalmente em dobro via double_refund); contrato e juros são opcionais.

O índice de correção (correction_differences_index_id) usa o id de /indices-correcao (ou null).

POST /api/calculadoras/rmc

cURL

diferencas

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/calculadoras/rmc \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "refund_total": false,
  "contract": {
    "date": "2020-01-01",
    "amount_lending": 1000
  },
  "double_refund": false,
  "not_apply_negative_differences": false,
  "installments": [
    {
      "id": 1,
      "date": "2020-02-01",
      "amount": 200
    },
    {
      "id": 2,
      "date": "2020-03-01",
      "amount": 200
    },
    {
      "id": 3,
      "date": "2020-04-01",
      "amount": 200
    }
  ],
  "correction_differences_index_id": null,
  "own_average_interest": true,
  "average_interest": 2
}
'

200

Example

{
  "statusCode": 200,
  "message": "Cálculo concluído com sucesso",
  "timestamp": "2026-06-22T18:00:00.000Z",
  "path": "/api/calculadoras/rmc",
  "result": {
    "converted_loan": {
      "amount": 1000,
      "bacen_rate": 2,
      "installments_quantity": 6,
      "total_payable": 1064.54
    },
    "refund_amount": -464.54,
    "refinance_loan": {
      "quantity": 2,
      "value": 449.13,
      "total_payable": 462.64,
      "installment_value": 231.32
    },
    "difference_installments": [
      {
        "dueDate": "2020-02-01",
        "paymentDate": "2020-02-01",
        "contractAmount": 200,
        "paidAmount": 200,
        "differenceAmount": 0,
        "differenceAdjustedAmount": 0,
        "interests": 0,
        "number": 1,
        "adjustedPercentage": 0,
        "total": 0
      },
      {
        "dueDate": "2020-05-01",
        "paymentDate": null,
        "contractAmount": 200,
        "paidAmount": 0,
        "differenceAmount": -200,
        "differenceAdjustedAmount": -200,
        "interests": 0,
        "number": 4,
        "adjustedPercentage": 0,
        "total": -200
      },
      {
        "dueDate": "2020-07-01",
        "paymentDate": null,
        "contractAmount": 64.54,
        "paidAmount": 0,
        "differenceAmount": -64.54,
        "differenceAdjustedAmount": -64.54,
        "interests": 0,
        "number": 6,
        "adjustedPercentage": 0,
        "total": -64.54
      }
    ],
    "total_difference": -464.54
  }
}

Autorizações

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

Corpo

application/json

Payload da calculadora de RMC/RCC (uma das duas variantes).

Option 1

Option 2

Fluxo de diferenças (refund_total: false): revisão do contrato — converte o empréstimo, apura as diferenças por parcela e o refinanciamento. Exige pelo menos uma parcela com amount > 0.

refund_total · enum<boolean> · obrigatório

Discriminador — false para o fluxo de diferenças.

Opções disponíveis: false

contract · object · obrigatório

Dados do contrato de RMC/RCC.

Show child attributes

double_refund · boolean · obrigatório

Restituir em dobro as diferenças.

not_apply_negative_differences · boolean · obrigatório

Não aplicar diferenças negativas (a favor do banco).

installments · object[] · obrigatório

Parcelas pagas (pelo menos uma com amount > 0).

Show child attributes

correction_differences_index_id · number | null · obrigatório

Índice de correção das diferenças (id de /indices-correcao) ou null.

interest_differences · number

Taxa de juros aplicada às diferenças (>= 0). Opcional.

own_average_interest · boolean | null

Usar o juros médio informado em average_interest. Opcional.

average_interest · number | null

Juros médio de mercado. Opcional.

Resposta

200

application/json

Resultado da revisão. O formato depende de refund_total: diferenças (empréstimo convertido, diferenças por parcela e refinanciamento) ou restituição total (valor a restituir e parcelas de devolução). O exemplo ilustra o fluxo de diferenças.

The response is of type object.