---
title: "Calculadora: Holding Familiar Compensa? Comparativo com Inventário Tradicional"
method: POST
path: "/api/v1/calc/holding-familiar"
tags: ["calc", "nichos"]
---

# Calculadora: Holding Familiar Compensa? Comparativo com Inventário Tradicional

`POST /api/v1/calc/holding-familiar`

## Request

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

Compara o custo total de constituir e manter uma holding familiar versus passar pelo inventário tradicional. Considera ITCMD por UF, custos de constituição/manutenção, economia tributária em aluguéis e horizonte de tempo.

## 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) de domicílio da família e localização principal dos bens. Determina a alíquota de ITCMD usada para comparar o custo do inventário tradicional versus a holding.
  - `patrimonioTotalCents` integer, required: Valor total do patrimônio familiar a ser analisado (imóveis, investimentos, participações societárias etc.). Valor em centavos. Ex: R$ 2.000.000 → 200000000.
  - `numeroImoveis` integer: Quantidade de imóveis que compõem o patrimônio familiar. Imóveis são os principais ativos transferidos para a holding. Padrão: 0.
  - `recebeAlugueisMensaisCents` integer: Total de aluguéis mensais recebidos atualmente como pessoa física (PF). Valor em centavos. Ex: R$ 10.000/mês → 1000000. Quanto maior o aluguel, maior a economia tributária ao migrar para a holding (lucro presumido vs IRPF PF). Padrão: 0.
  - `custoConstituicaoEstimadoCents` integer: Custo estimado para constituir a holding (honorários de advogado, contador, cartório e taxas). Valor em centavos. Ex: R$ 35.000 → 3500000. Padrão: R$ 35.000.
  - `custoManutencaoAnualCents` integer: Custo anual estimado para manter a holding em funcionamento (contabilidade, obrigações fiscais, declarações). Valor em centavos. Ex: R$ 15.000/ano → 1500000. Padrão: R$ 15.000.
  - `horizonteAnos` integer: Horizonte de tempo em anos para o qual a comparação holding vs inventário é feita. Quanto maior o horizonte, maior a tendência de a holding compensar pelos custos fixos diluídos. Padrão: 20.
  - `temConjugeMeacao` boolean: Se verdadeiro (true), há cônjuge com direito à meação — o ITCMD no inventário incide apenas sobre 50% do patrimônio (metade do falecido). Se falso (false), o ITCMD incide sobre o patrimônio total.
  - `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)