NCM Buscador
API idêntica ao motor oficial em 944 de 948 casos · banco V0066

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.

✓ Oficial · 28 de outubro de 2026 Calculadora de Tributos (RTC) — motor oficial de cálculo do IBS/CBS — LC 214/2025, arts. 343 a 348 (transição) — pacote offline oficial, banco V0066 · Receita Federal / Serpro

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.

Voltar ao topo