---
title: "Calculadora de Rolagem (Consolidação) de Dívida — Vale a Pena?"
method: POST
path: "/api/v1/calc/rolagem-divida"
tags: ["calc", "financas"]
---

# Calculadora de Rolagem (Consolidação) de Dívida — Vale a Pena?

`POST /api/v1/calc/rolagem-divida`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/rolagem-divida`
- Auth: HTTP bearer

Compara a CET (Custo Efetivo Total) da sua dívida atual contra a oferta de consolidação. Mostra economia total, parcela nova vs atual e se vale realmente trocar.

## Request body

- object
  - `saldoDevedorAtualCents` integer, required: Saldo devedor atual da dívida que você quer consolidar em centavos. Ex: R$ 10.000 → 1000000
  - `taxaAtualMensalPercent` number, required: Taxa de juros mensal da dívida atual em % (0 a 20). Ex: 5 = 5% ao mês (rotativo de cartão)
  - `parcelasRestantes` integer, required: Número de parcelas restantes na dívida atual (1 a 120). Ex: 18 = 18 meses restantes
  - `taxaOfertaMensalPercent` number, required: Taxa de juros mensal da oferta de consolidação em % (0 a 20). Ex: 2 = 2% ao mês (crédito pessoal)
  - `prazoOfertaMeses` integer, required: Prazo total da oferta de consolidação em meses (1 a 120). Ex: 36 = 36 meses
  - `taxaAberturaCents` integer: Taxa de abertura de crédito (TAC) cobrada pela nova operação em centavos. Ex: R$ 500 → 50000. Padrão: 0
  - `iofTotalCents` integer: IOF total cobrado na operação de consolidação em centavos (Decreto 6.306/2007). Ex: R$ 300 → 30000. Padrão: 0
  - `seguroTotalCents` integer: Seguros embutidos na operação (prestamista, vida, etc.) em centavos. Ex: R$ 200 → 20000. Padrão: 0
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)