---
title: "Calculadora de ITCMD + Inventário Projetado"
method: POST
path: "/api/v1/calc/itcmd-inventario"
tags: ["calc", "nichos"]
---

# Calculadora de ITCMD + Inventário Projetado

`POST /api/v1/calc/itcmd-inventario`

## Request

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

Estimativa total dos custos de inventário no Brasil: ITCMD por UF + custas cartoriais + honorários advocatícios. Compara extrajudicial (Lei 11.441/07) vs judicial.

## Request body

- object
  - `uf` 'AC' | 'AL' | 'AM' | 'AP' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MG' | 'MS' | 'MT' | 'PA' | 'PB' | 'PE' | 'PI' | 'PR' | 'RJ' | 'RN' | 'RO' | 'RR' | 'RS' | 'SC' | 'SE' | 'SP' | 'TO', required: Estado (UF) onde o inventário será processado. Cada UF tem sua própria lei de ITCMD com alíquotas entre 1% e 8%.
  - `patrimonioTotalCents` integer, required: Valor total do patrimônio a ser inventariado (imóveis, investimentos, veículos, saldos bancários etc.). Valor em centavos. Ex: R$ 1.000.000 → 100000000.
  - `numeroHerdeiros` integer: Número total de herdeiros que participam do inventário (não inclui o cônjuge que recebe meação). Padrão: 2.
  - `temViuvoMeacao` boolean: Se verdadeiro (true), o cônjuge sobrevivente tem direito à meação (50% dos bens comuns) — o ITCMD incide apenas sobre o restante do patrimônio. Se falso (false), o ITCMD é calculado sobre o patrimônio total.
  - `temTestamento` boolean: Se verdadeiro (true), há testamento registrado — o inventário obrigatoriamente será judicial (mais lento e caro). Se falso (false), pode ser extrajudicial caso todos os herdeiros sejam maiores e capazes e haja acordo.
  - `custoCartorialEstimadoPercent` number: Percentual das custas cartorias sobre o patrimônio. Em %. Varia por UF (tipicamente 1-3%). Ex: 2 = 2%. Padrão: 2.
  - `honorariosAdvogadoPercent` number: Percentual dos honorários advocatícios sobre o valor do patrimônio. Em %. Tipicamente 4-10% no extrajudicial e 8-15% no judicial. Ex: 6 = 6%. Padrão: 6.
  - `inventarioExtrajudicial` boolean: Se verdadeiro (true), o inventário é feito em cartório (extrajudicial — Lei 11.441/07), mais rápido e barato. Se falso (false), o inventário é judicial. Só pode ser extrajudicial sem testamento, com herdeiros maiores capazes e com acordo.
  - `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)