API REST

Integre o motor de cálculo IBS/CBS ao seu ERP, e-commerce ou sistema de emissão. Disponível nos planos com API.

Autenticação

Gere seu token em Minha conta e envie em todas as requisições:

Authorization: Bearer ibscbs_xxxxxxxxxxxxxxxx
Content-Type: application/json

Valores numéricos em ponto decimal (100.5) ou texto brasileiro ("100,50"). Percentuais são informados como número (12 = 12%). Cada item calculado consome uma consulta do plano.

Exemplo com cURL

curl -X POST http://reforma.hexasistemas.com.br/api/v1/calcular \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"modo":"ida","valor":100,"cbs":11.9,"ibs_uf":0.1,"icms":12,"aplicar_st":true,"mva_st":40,"aliq_st":18}'

Resposta (resumida):

{
  "ok": true,
  "resultado": { "v_prod_liq": 100.0, "v_prod": 127.27, "v_trib_reforma": 12.0, "v_icms": 15.27,
                 "v_icms_st": 16.8, "total_nfe": 144.07, "carga_efetiva_pct": 44.07, "composicao": [...], "memoria": [...] },
  "simulacao_id": 123,
  "consultas_usadas": 1,
  "cota": { "ilimitado": false, "limite": 5000, "usadas": 42, "extras": 0, "disponivel": 4958 }
}

Endpoints

POST/api/v1/perguntar

Pergunta em português + perfil da empresa → resposta pronta (título, resumo, números, recomendações).

{"texto":"Quanto cobrar num produto de R$ 80 com ST para MG em 2027?","perfil":{"nome":"Loja X","regime":"presumido","uf":"SP","perc_b2b":30,"usa_st":1}}

POST/api/v1/decisao

Decisão direta: intencao = preco | lucro | simples | caixa, com params e perfil.

{"intencao":"preco","params":{"valor":100,"ano":2027},"perfil":{"nome":"Loja X","regime":"real","uf":"MG"}}

POST/api/v1/calcular

Simulação IDA ou VOLTA de um item (campo "modo").

{"modo":"ida","valor":100,"quantidade":1,"cbs":0.9,"ibs_uf":0.1,"ibs_mun":0,"icms":12,"aplicar_st":true,"mva_st":40,"aliq_st":18}

POST/api/v1/lote

Até o limite do plano de itens por chamada.

{"itens":[{"rotulo":"Produto A","valor":100,"cbs":0.9,"ibs_uf":0.1,"icms":18}]}

POST/api/v1/comparacao

Compara de 2 a 6 cenários.

{"cenarios":[{"rotulo":"Atual","valor":100,"icms":18,"pis":1.65,"cofins":7.6},{"rotulo":"2033","valor":100,"cbs":8.8,"ibs_uf":15.2,"ibs_mun":2.5}]}

POST/api/v1/projecao

Projeção 2026–2033 de um item.

{"base":{"valor":100,"icms":18,"pis":1.65,"cofins":7.6},"reducao_setorial":0}

POST/api/v1/simples

Decisor do Simples Nacional.

{"receita_mensal":100000,"perc_b2b":60,"aliquota_das":10,"parcela_ibscbs_das":40,"compras_com_credito":40000}

POST/api/v1/apuracao

Apuração débito × crédito com split payment.

{"vendas":[{"base":100000,"cbs":8.8,"ibs_uf":15.2,"ibs_mun":2.5}],"compras":[{"base":60000,"cbs":8.8,"ibs_uf":15.2,"ibs_mun":2.5,"perc_credito":100}],"modo_split":"inteligente"}

POST/api/v1/especial

{"regime":"bares","ano":2033,"receita":150000,"exclusoes":12000,"compras":60000}

POST/api/v1/ncm

Classificação tributária (CST/cClassTrib e redução) sugerida pelo NCM ou consultada pelo código. Não consome consultas.

{"ncm":"10063021"}

GET/api/v1/cota

Consultas disponíveis no plano.

GET/api/v1/tabelas

UFs, regimes diferenciados, cronograma, alíquotas de referência, classificação tributária e parâmetros dos regimes específicos.

Códigos de retorno

200	Sucesso
400	JSON inválido
401	Token ausente, inválido ou revogado
402	Consultas insuficientes no plano
403	Plano sem acesso à API
422	Dados inválidos (a mensagem explica o campo)
503	Serviço de cálculo temporariamente indisponível