---
title: "Calculadora Regra 50/30/20 — Alocador de Orçamento"
method: POST
path: "/api/v1/calc/alocador-50-30-20"
tags: ["calc", "financas"]
---

# Calculadora Regra 50/30/20 — Alocador de Orçamento

`POST /api/v1/calc/alocador-50-30-20`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/alocador-50-30-20`
- Auth: HTTP bearer

Aplica a regra 50/30/20 (Elizabeth Warren) ao seu orçamento mensal: 50% essenciais, 30% desejos, 20% poupança. Calcula gaps e aderência.

## Request body

- object
  - `rendaLiquidaMensalCents` integer, required: Renda líquida mensal (após descontos de INSS e IR) em centavos. Ex: R$ 5.000 → 500000
  - `gastosEssenciaisAtuais` object[]: Despesas essenciais agrupadas por categoria (moradia, alimentacao, transporte, saude, educacao, etc.). Cada item: { categoria, valorCents, descricao? }. Use "outro" + descrição livre para casos não cobertos.
    - `categoria` 'moradia' | 'alimentacao' | 'transporte' | 'saude' | 'educacao' | 'lazer' | 'vestuario' | 'seguros' | 'servicos_profissionais' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `gastosDesejosAtuais` object[]: Gastos com desejos (lazer, vestuário, etc.) agrupados por categoria. Mesmo formato que essenciais.
    - `categoria` 'moradia' | 'alimentacao' | 'transporte' | 'saude' | 'educacao' | 'lazer' | 'vestuario' | 'seguros' | 'servicos_profissionais' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `poupancaAtualCents` integer: Valor aportado mensalmente em poupança ou investimentos em centavos. Ex: R$ 1.000 → 100000. 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)