---
title: "Crédito PJ — quanto custa estruturar versus pegar no balcão?"
method: POST
path: "/api/v1/calc/credito-pj-comparador"
tags: ["calc", "pj"]
---

# Crédito PJ — quanto custa estruturar versus pegar no balcão?

`POST /api/v1/calc/credito-pj-comparador`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/credito-pj-comparador`
- Auth: HTTP bearer

Compara parcela e custo total de crédito PJ por garantia (sem garantia / aval / alienação imobiliária) e finalidade (capital de giro / investimento / aquisição). Faixa de taxa baseada em referenciais BCB-SCR.

## Request body

- object
  - `valorCreditoCents` integer: Valor total do crédito solicitado. Valor em centavos. Ex: R$ 200.000 → 20000000. Mínimo: R$ 10.000. Padrão: R$ 200.000 (20000000).
  - `prazoMeses` integer: Prazo de pagamento do crédito em meses. Ex: 36 = 3 anos, 60 = 5 anos. Mínimo: 6 meses. Máximo: 120 meses (10 anos). Padrão: 36 meses.
  - `garantia` 'sem_garantia' | 'aval' | 'imovel': Tipo de garantia oferecida à instituição financeira. Influencia diretamente a taxa de juros. "sem_garantia" = crédito sem garantia real — taxa mais alta (1,8%–3,5% a.m.). "aval" = aval pessoal dos sócios — taxa intermediária (1,2%–2,5% a.m.). "imovel" = alienação fiduciária de imóvel — taxa mais baixa (0,8%–1,8% a.m.). Padrão: aval.
  - `finalidade` 'capital_giro' | 'investimento' | 'aquisicao': Finalidade do crédito. Pode afetar a taxa e as linhas disponíveis. "capital_giro" = cobrir despesas operacionais do dia a dia. "investimento" = aquisição de equipamentos ou expansão — pode ter acesso a linhas subsidiadas (BNDES, FINAME). "aquisicao" = compra de participação societária ou empresa. Padrão: capital_giro.
  - `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)