---
title: "Holding Familiar vs Inventário — qual custa menos?"
method: POST
path: "/api/v1/calc/holding-vs-inventario"
tags: ["calc", "juridico"]
---

# Holding Familiar vs Inventário — qual custa menos?

`POST /api/v1/calc/holding-vs-inventario`

## Request

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

Compare o custo de criar uma holding familiar hoje com o custo estimado de um inventário no futuro. Descubra o ponto de virada patrimonial e se a holding vale o investimento.

## Request body

- object
  - `patrimonioTotalCents` integer, required: Patrimônio total que seria transferido via inventário ou protegido pela holding, em centavos. Inclui imóveis, participações societárias, investimentos e demais bens. Ex: R$ 1.000.000 → 100000000.
  - `ufContribuinte` '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': Estado (UF) onde o inventário seria processado — define a alíquota de ITCMD. Cada estado tem sua alíquota: SP e PR = 4%, MG = 5%, RS = 6%, RJ/BA/CE/SC/PB/PE = 8%. Padrão: SP.
  - `numeroHerdeiros` integer: Número de herdeiros que receberiam o patrimônio no inventário. Afeta a complexidade do processo. Padrão: 2.
  - `anosPrazo` integer: Por quantos anos a holding ficará ativa antes da sucessão. Quanto maior o prazo, mais tempo de custo de manutenção acumula. Padrão: 10 anos.
  - `custoAnualHoldingCents` integer: Custo anual de manutenção da holding em centavos: contabilidade, compliance, declarações, anuidade do advogado. Holding simples: R$ 3.000–8.000/ano. Padrão: R$ 6.000/ano = 600000.
  - `custoSetupHoldingCents` integer: Custo único de abertura da holding em centavos: honorários advocatícios, registro na Junta Comercial, capital social mínimo. Faixa típica: R$ 3.000–10.000. Padrão: R$ 5.000 = 500000.
  - `honorariosInventarioPct` number: Percentual de honorários e custos sobre o patrimônio para o processo de inventário (advogado, cartório e despesas acessórias). Tabelas de honorários das seccionais da OAB sugerem 3–10% (mínimo usual 6%). Padrão: 6% — mediana de mercado, equivalente ao inventário extrajudicial médio (faixa 5–8%); inventário judicial costuma custar 8–12% conforme a complexidade — ajuste para cima se espera litígio entre herdeiros. Faixa aceita: 0–20%.
  - `taxaDescontoAnualPercent` number: Audit fix v1.4: taxa de desconto real anual (%) para VPL. Quando > 0, engine calcula custos a valor presente (inventário ocorre no FIM do horizonte; manutenção da holding é descontada ano a ano). Padrão 0 = sem desconto (comportamento v1.3 preservado). Sugestões: 4-6% real para análise patrimonial.
  - `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)