API de IBS e CBS para ERP e sistemas fiscais
O cálculo da Calculadora de Tributos da Receita, sem captcha, com o mesmo contrato de entrada e saída. Em volta dele, o que o motor oficial não diz: qual cClassTrib aceita o NCM ou a NBS, por que o par seria recusado e a pré-nota inteira da NF-e e da NFS-e.
POST /v1/ibs-cbs/calcular
O regime geral, com o JSON do POST /api/calculadora/regime-geral do motor oficial: objetos por item, total, compra governamental, tributação regular, memória de cálculo e os erros do motor (REG e CAL) com o mesmo type, título e mensagem. Cada item conta uma consulta da cota.
curl -X POST https://api.buscadorncm.com.br/v1/ibs-cbs/calcular -H "x-api-key: SUA_CHAVE" -H "content-type: application/json" -d '{
"dhFatoGerador": "2026-11-20T12:00:00-03:00",
"municipio": 3550308,
"uf": "SP",
"itens": [
{
"numero": 1,
"ncm": "84713012",
"cst": "000",
"cClassTrib": "000001",
"baseCalculo": 1000,
"quantidade": 1,
"unidade": "UN"
}
]
}' GET /v1/ibs-cbs/vinculo
O vínculo da Calculadora nos dois sentidos, antes do envio: se o cClassTrib aceita o NCM ou a NBS na data, os códigos com lista que aceitam aquele código e os prefixos que o cClassTrib aceita. É o par que a SEFAZ autoriza e a Calculadora recusa (REG-011 e REG-012).
curl "https://api.buscadorncm.com.br/v1/ibs-cbs/vinculo?ncm=84713012&cclasstrib=200003"
GET /v1/pre-nfe e GET /v1/pre-nfse
A pré-nota da NF-e (CFOP, CST ou CSOSN, ICMS-ST, Difal, IPI, PIS e Cofins e, com o valor, o grupo IBS/CBS calculado) e a da NFS-e Nacional (itens da LC 116, código de tributação nacional e municipal, ISS da cidade, cIndOp com o que ele exige na DPS, cClassTrib e IBS e CBS), com as rejeições previstas e as perguntas que faltam. São os motores dos simuladores do site: NF-e e NFS-e.
Parâmetros, respostas e erros de cada rota: referência da API. Planos e chave: API do Buscador NCM.
Perguntas frequentes
Existe API para calcular IBS e CBS?
A Receita Federal publica a Calculadora de Tributos com API e um pacote para rodar local. O Buscador NCM oferece a mesma conta numa API com o cClassTrib sugerido pelo NCM e pela NBS, o aviso do par recusado e a pré-nota com ICMS, ICMS-ST e ISS.
A API do Buscador NCM calcula igual à Calculadora da Receita?
Sim. O motor é reproduzido e comparado caso a caso com as respostas do pacote oficial (banco V0066), inclusive o arredondamento: 944 de 948 casos saem idênticos, e os 4 restantes são o Imposto Seletivo de 2027 com alíquota ainda provisória, que o Buscador NCM não publica. Cada resposta informa a versão do banco oficial usada.
A API calcula a compra governamental?
Calcula: com o ente comprador informado, a resposta traz o grupo de tributação da compra governamental (gTribCompraGov) com as alíquotas e a destinação do IBS e da CBS, pela regra do motor oficial que o Buscador NCM reproduz.
Preciso mudar meu sistema para usar a API?
Para o cálculo, não: a rota /v1/ibs-cbs/calcular recebe e devolve o mesmo JSON do POST /api/calculadora/regime-geral da Calculadora da Receita, sem captcha. As rotas de vínculo e de pré-nota do Buscador NCM acrescentam o que o motor oficial não diz: qual código usar e por que o par seria recusado.