Tributário

CBS/IBS · Calcular POST

Calcula CBS (União), IBS estadual e IBS municipal pelo cronograma oficial da reforma tributária (LC 214/2025), do período de teste (2026) até a alíquota plena (2033). Esse é o mesmo motor já usado internamente na emissão de NFS-e/NF-e -- aqui exposto como calculadora avulsa, pra simular o valor sem emitir nenhum documento.

POST https://areacliente.centralfiscal.com.br/v1/tributario/ibscbs/calcular

Corpo da requisição

Campo	Tipo	Obrigatório	Observação
`base_calculo`	number	Sim
`classificacao_tributaria`	string	Sim	Código `cClassTrib`. Sem ele não há como saber se alguma redução se aplica -- fonte oficial: calculadora piloto do Comitê Gestor do IBS. Código não cadastrado não é erro: a API aplica a alíquota de referência integral e devolve `classificacaoEncontrada: false`.
`municipio_ibge`	integer	Não	Código IBGE do município da prestação. Resolve a alíquota real de IBS estadual e municipal pra esse município/ano. Sem esse campo, a resposta usa a alíquota de IBS estadual de referência nacional e IBS municipal fica zero.
`ano`	integer	Não	Ano de referência da alíquota (2026 a 2033). Default: ano corrente. Útil pra simular anos futuros (ex.: `ano: 2029`) antes de chegarem.

💡

Cronograma oficial 2026-2033 (LC 214/2025, alíquotas de referência nacionais -- fonte: banco de dados oficial da Calculadora de Tributos sobre o Consumo, Comitê Gestor do IBS):

Ano	CBS (União)	IBS estadual	IBS municipal
2026	0,9%	0,1%	0%
2027	8,4%	0,05%	0,05%
2028	8,4%	0,05%	0,05%
2029	8,5%	1,6%	0,25%
2030	8,5%	3,2%	0,5%
2031	8,5%	4,8%	0,75%
2032	8,5%	6,4%	1,0%
2033	8,5%	16,0%	2,5%

Essas são as alíquotas de referência nacionais -- hoje nenhum estado/município legislou uma alíquota própria diferente da referência. Se isso mudar, esta API já resolve a alíquota certa pro municipio_ibge informado automaticamente, sem quebrar sua integração.

⚠️

"Sem alíquota" ≠ "sem desconto": classificações com tipo_aliquota = "Sem alíquota" (isenção/imunidade/não-incidência) têm alíquota efetiva sempre zero, independente do percentual de redução cadastrado na base (que nessas linhas costuma ser 0.0 por ser um artefato do dataset oficial, não porque "cobra cheio"). O motor já trata essa distinção antes de aplicar a fórmula de redução.

curl -X POST https://areacliente.centralfiscal.com.br/v1/tributario/ibscbs/calcular \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "base_calculo": 1000,
    "classificacao_tributaria": "000001",
    "municipio_ibge": 4314902,
    "ano": 2029
  }'

Resposta

{
  "classificacaoTributaria": "000001",
  "classificacaoEncontrada": true,
  "municipioIbge": 4314902,
  "ano": 2029,
  "aliquotaDinamica": true,
  "aliquotaCbs": 8.5,
  "aliquotaIbsUf": 1.6,
  "aliquotaIbsMunicipio": 0.25,
  "valorCbs": 85.0,
  "valorIbsUf": 16.0,
  "valorIbsMunicipio": 2.5,
  "fundamentacao": "..."
}

Cálculo de referência -- não substitui análise tributária profissional. As alíquotas vêm do cronograma oficial da reforma tributária (LC 214/2025) até 2033, ano em que a transição do ICMS/ISS pro IBS termina; a partir daí o Comitê Gestor do IBS pode publicar novas fixações (a API é atualizada assim que houver uma nova versão oficial).

💡

Prefere implementar o próprio motor de cálculo no ERP em vez de chamar este endpoint a cada nota? Veja CBS/IBS · Catálogos pra baixar as tabelas de CST, classificação tributária, NCM/NBS aplicável e o cronograma completo de alíquotas.