API de dados fiscais
As mesmas tabelas oficiais que o site mostra, consolidadas por código e em JSON, com a fonte e a data de cada bloco. Determinística e sem IA: a mesma consulta devolve a mesma resposta, com a versão das tabelas no payload. O que depende de quem emite volta como pergunta com as opções. Comece pelo NCM: com a chave grátis o endereço devolve a ficha inteira. Sem chave, só o exemplo desta página responde.
curl https://api.buscadorncm.com.br/v1/ncm/22030000
curl https://api.buscadorncm.com.br/v1/ncm/buscar?q=cerveja
curl -H "x-api-key: ncm_SUA_CHAVE" https://api.buscadorncm.com.br/v1/ncm/22030000
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/pre-nfe?sentido=saida&natureza=venda-producao-propria®ime=real&tributacao=tributada&origem=0&uf_origem=RS&uf_destino=SP&destinatario=nao-contribuinte&consumidor_final=sim&ncm=94036000" Pegar a chave de avaliação · console para testar · referência rota a rota · OpenAPI
IBS e CBS na API
A reforma dentro do seu ERP
cClassTrib, cálculo pela Calculadora e pré-nota de NF-e e NFS-e.
Pré-nota: do pedido à nota, sem adivinhar
O caso de quem decide CFOP e natureza no ERP antes de faturar. A API não escolhe por você o que depende do pedido: quando falta um dado que decide a nota, ela devolve a pergunta com as opções. Você responde e chama de novo.
- 1. Envie o pedido e o itemOperação (sentido, natureza, regime, tributação, origem, UFs, destinatário, consumidor final) mais o NCM. Parâmetro com erro de digitação ou valor fora das opções volta 400 dizendo qual e as opções válidas.
- 2. Leia
prontoSefalse, cada item dependenciastrazparametro,perguntaeopcoes. É o questionário que o vendedor não preencheu, pronto para virar tela. - 3. Preencha a nota
nfetraz natOp, CFOP, idDest, indIEDest e indFinal;operacaotraz o CST ou CSOSN e o PIS/COFINS;difaldiz se é devido e quem paga.rejeicoesPrevistasé o que a SEFAZ recusaria com esses dados;avisossão pontos de conferência. - 4. Guarde a provaO cabeçalho
X-Resposta-Sha256emeta.pacote(versão das tabelas) junto do pedido. Comreferenciavocê amarra a resposta à linha do seu pedido.
curl -H "x-api-key: $NCM_API_KEY" \
"https://api.buscadorncm.com.br/v1/pre-nfe?sentido=saida&natureza=venda-producao-propria®ime=real&tributacao=tributada&origem=0&uf_origem=RS&uf_destino=SP&destinatario=nao-contribuinte&consumidor_final=sim&ncm=94036000&referencia=PED-1042-3" // No SEU servidor, nunca no navegador: a chave dá acesso à sua cota.
const base = 'https://api.buscadorncm.com.br/v1/pre-nfe';
async function preNota(pedido, item) {
const q = new URLSearchParams({ ...pedido, ...item });
const r = await fetch(`${base}?${q}`, { headers: { 'x-api-key': process.env.NCM_API_KEY } });
const corpo = await r.json();
if (!r.ok) throw new Error(corpo.erro.codigo + ': ' + corpo.detail); // 400 diz o parâmetro e as opções
return { corpo, hash: r.headers.get('x-resposta-sha256') };
}
const { corpo, hash } = await preNota(pedido, item);
if (!corpo.pronto) {
// Cada pendência traz o parâmetro que a responde: pergunte ao vendedor e chame de novo.
for (const p of corpo.pendencias) perguntar(p.parametro, p.pergunta, p.opcoes);
} else {
gravarNoPedido({ cfop: corpo.nfe.CFOP, natOp: corpo.nfe.natOp, indFinal: corpo.nfe.indFinal.valor, hash, pacote: corpo.meta.pacote });
} Pedido com vários itens: POST /pre-nfe com { "operacao": {…}, "itens": [ … ] }, até 500 itens. Item inválido volta com erro na posição dele, sem derrubar o pedido e sem gastar cota; campos extras do seu ERP no item são ignorados.
Todos os parâmetros
Gerada da mesma lista que o servidor usa para validar. Os marcados com • decidem a nota: sem eles a resposta traz a pendência.
| parâmetro | o que é | valores |
|---|---|---|
| Operação (o pedido) | ||
| sentido • | Saída (você emite) ou entrada (você recebe a mercadoria). | saida · entrada |
| natureza • | Operação canônica: decide o CFOP e o CST de PIS/COFINS. | 66 opções (lista na referência) |
| regime • | Regime de apuração da SUA empresa: decide entre CST ICMS e CSOSN. | real · presumido · simples |
| tributacao • | Situação do ICMS nesta operação. | tributada · tributada-st · st-anterior · reducao · isenta · isenta-st · nao-tributada · suspensao · diferimento · outras |
| origem • | Origem da mercadoria (Tabela A, 1º dígito do CST ICMS). 1, 2, 3 e 8 levam a interestadual de 4%. | 0 · 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 |
| uf_origem • | UF do emitente. | 27 opções (lista na referência) |
| uf_destino • | UF do destinatário. EX na operação com o exterior. | 28 opções (lista na referência) |
| ambito | Opcional: sai das UFs. Se vier e contradisser as UFs, a consulta é recusada. | interna · interestadual · exterior |
| destinatario | Destinatário (indIEDest): contribuinte com IE, contribuinte isento de IE ou não contribuinte. Aceito em qualquer operação. | contribuinte · isento · nao-contribuinte |
| consumidor_final | Operação com consumidor final (indFinal): sim quando quem compra usa ou consome o bem (pessoa física, órgão público, empresa comprando para uso próprio). | sim · nao |
| perfil | Perfil do tomador, só nos grupos de comunicação e transporte. | mesma-natureza · industrial · comercial · prestador-transporte · geradora-energia · produtor-rural |
| perfil_emitente | Perfil declarado do emitente para IBS/CBS: produtor rural não contribuinte (art. 164), nanoempreendedor (art. 26, IV), entidade religiosa ou templo (art. 9º, II), entidade sem fins lucrativos do art. 9º, III ou condomínio edilício não optante pelo regime regular (art. 26, I). É condição da pessoa, não do produto. Confira os requisitos e eventual opção pelo regime regular. | regular · rural-nao-contribuinte · nanoempreendedor · templo · sem-fins-lucrativos · condominio |
| documento | Modelo do documento: 55 (NF-e) ou 65 (NFC-e). Padrão 55. | 55 · 65 |
| orgao_publico | Venda a órgão público: a nota pede a Nota de Empenho (rejeição 359). | sim · nao |
| nota_empenho | Número da Nota de Empenho (xNEmp) na venda a órgão público. | texto |
| ref_nfe | Chave de 44 dígitos da nota de origem (refNFe), nas devoluções. | 44 dígitos |
| data_emissao | Data de emissão prevista, AAAA-MM-DD. Sem ela, vale o dia de hoje (Brasília). Decide a vigência das regras que têm data. | texto |
| municipio_destino | Código IBGE do município de destino (7 dígitos), onde o IBS e a CBS são devidos. Sem ele, o cálculo usa a capital da UF de destino: em 2026 e 2027 a alíquota de referência é a mesma em todo município. | texto |
| ente_gov | Compra governamental: tipo do ente comprador (1 União, 2 Estado, 3 Distrito Federal, 4 Município). Com ele o grupo gTribCompraGov sai calculado. | 1 · 2 · 3 · 4 |
| cnpj_destinatario | CNPJ do destinatário (14 caracteres). Pelo cadastro aberto da Receita, das UFs e da SUFRAMA, preenche o que faltar (UF, município, indIEDest pela IE da UF e o ente_gov da compra governamental) e avisa o que diverge do informado (situação cadastral, IE). O CNPJ não volta na resposta e não é guardado. | texto |
| cnpj_emitente | CNPJ do emitente (14 caracteres). Pelo cadastro aberto da Receita, preenche a UF de origem e o regime (Simples ou MEI na data da emissão) quando faltam, e avisa o que diverge (situação cadastral, regime). O CNPJ não volta na resposta e não é guardado. | texto |
| porta_a_porta | Venda a revendedor que vende porta a porta (Anexo XXVI do Convênio ICMS 142/2018 e Convênio ICMS 45/1999). | sim · nao |
| Perguntas da reforma | ||
| medicamento | Como este medicamento se enquadra? (pergunta sobre o produto) | indicacao-art146 · registrado · veterinario · outro |
| preparo_no_estabelecimento | O item é preparado no estabelecimento (prato, lanche, bebida não alcoólica feita na casa)? | sim · nao |
| destino_zfm_alc | Para quem vai esta venda, na Zona Franca de Manaus ou em Área de Livre Comércio? | zfm-industria · zfm · alc · outro |
| industrializado_nacional | O item é bem material industrializado de origem nacional? (pergunta sobre o produto) | sim · nao |
| classe_bem_zfm | Que tipo de bem é este, para o crédito presumido da Zona Franca de Manaus? (pergunta sobre o produto) | consumo-final · capital · intermediario · informatica |
| adquirente_cooperativa | Para quem a cooperativa vende nesta operação? | associado-regular · associado-nao-contribuinte · terceiro |
| venda_para_cooperativa | Esta venda é para a cooperativa de que a empresa é associada? | sim · nao |
| adquirente_automovel | Quem compra este automóvel? | taxista · pcd · outro |
| automovel_art149 | Este automóvel cumpre os requisitos do art. 149 para o comprador da venda? (pergunta sobre o produto) | sim · nao |
| produto_projeto_automotivo | O item é veículo do projeto incentivado, fabricado ou montado no estabelecimento habilitado? (pergunta sobre o produto) | sim · nao |
| livro_jornal_periodico | O item é livro, jornal ou periódico? (pergunta sobre o produto) | sim · nao |
| papel_para_impressao | O papel é destinado à impressão de livros, jornais ou periódicos? (pergunta sobre o produto) | sim · nao |
| fonograma_nacional | É fonograma ou videofonograma musical produzido no Brasil? (pergunta sobre o produto) | sim · nao |
| in_natura | O produto é fornecido in natura? (pergunta sobre o produto) | sim · nao |
| industrializador_exportador | O adquirente cumpre os requisitos de industrializador exportador do art. 82, § 11? | sim · nao |
| adquirente_nao_contribuinte | O adquirente é produtor rural ou transportador autônomo não contribuinte? | produtor-rural · transportador-autonomo · nao |
| bem_da_lista_art110 | O produto é o bem descrito no item da lista do art. 197 dos regulamentos? (pergunta sobre o produto) | sim · nao |
| produto_do_item_anexo | O produto é o descrito no item do anexo da LC 214/2025? (pergunta sobre o produto) | sim · nao |
| combustivel_monofasico | Este combustível está na tabela de monofásicos e qual é o papel da empresa na cadeia? | contribuinte · revenda · nao |
| destinacao | Nesta operação, a que se destina o produto? | alimentacao-humana · insumo-agropecuario · outro |
| adquirente | Quem é o adquirente nesta operação? | mercado · administracao-publica |
| regime_operacao | A operação está sujeita a diferimento? | normal · diferimento |
| evento_saude | A operação ocorre sob situação de emergência de saúde pública reconhecida? | nao · sim |
| natureza_produto | Qual é a natureza deste item? (pergunta sobre o produto) | saude-menstrual · higiene-limpeza · outro |
| papel_cadeia | Qual é o papel da empresa na cadeia para os itens desta planilha? | fabricante-importador · atacado-varejo · outro |
| regime_apuracao | Qual é o regime de apuração de PIS/COFINS da empresa? | simples · cumulativo · nao-cumulativo |
| diferimento | Atalho de regime_operacao: sim = diferimento. | sim · nao |
| emergencia_saude | Atalho de evento_saude. | sim · nao |
| Item (o produto) | ||
| ncm • | NCM do item, 8 dígitos (aceita pontos). | 8 dígitos |
| cest | CEST informado no cadastro, 7 dígitos (aceita pontos): conferido contra a tabela e o NCM. | texto |
| gtin | cEAN: GTIN do produto ou SEM GTIN. | texto |
| gtin_tributavel | cEANTrib: GTIN da unidade tributável ou SEM GTIN. | texto |
| utrib | Unidade tributável informada (conferida contra a tabela só na exportação). | texto |
| cst_ibs_cbs | CST do IBS/CBS informado, 3 dígitos. | texto |
| cclasstrib | cClassTrib informado, 6 dígitos. | texto |
| cst_pis | CST de PIS/COFINS informado, 2 dígitos. | texto |
| cbenef | cBenef informado (conferido na tabela da UF de origem). | texto |
| importado | Mercadoria importada (interestadual de 4%). Sem ele vale a origem. | sim · nao |
| carga_propria | Carga própria do substituto na operação interna, percentual de 0 a 100. | 0 a 100 |
| valor | Base de cálculo do IBS e da CBS do item, em reais (até 2 casas). Com ele a resposta traz o grupo IBS/CBS calculado pelo motor da Calculadora de Tributos. | texto |
| quantidade | Quantidade tributável do item (padrão 1). | texto |
| cst_regular | CST da tributação regular (grupo gTribRegular), só quando o cClassTrib exige o grupo: na Calculadora, o 200022, o 200024 e a série 550 (suspensão), a mesma marca que o Emissor Nacional usa. A resposta pede quando falta. Padrão 000. | texto |
| cclasstrib_regular | cClassTrib da tributação regular, quando o cClassTrib exige. Padrão 000001. | texto |
| descricao | Descrição do produto, só devolvida na resposta. | texto |
| referencia | Seu identificador do item (código do produto, linha do pedido), devolvido igual na resposta. | texto |
Tabelas por código
Com a chave grátis, desde 03/11/2026. É a base para montar ou conferir o seu cadastro.
ncm · nível 0 (resumo) · 1 (completo, com chave)
sem chave, só o exemplo: descrição plena, vigência, IPI, II, CEST, uTrib e o estado da reforma com os cClassTrib candidatos. Com chave: a ficha consolidada inteira, com fonte e data por bloco (reforma com anexo, artigo e condição; PIS/COFINS por papel; Ex da TIPI; TEC e regimes temporários; Ex-tarifário; antidumping; LESSIN; atributos da Duimp; CEST com segmento; redução de base do Convênio ICMS 52/91 com a vigência; uTrib agendada; GTIN do Anexo I; DIRBI; NESH; histórico e agenda). NCM que ainda não vige responde 404 com a data e o ato
curl "https://api.buscadorncm.com.br/v1/ncm/22030000" busca · nível 0
busca em ncm, cest, cfop, cnae, nbs, lc116 e ctribnac por prefixo de código ou por palavra da descrição oficial (sem sinônimo e sem IA, declarado na resposta)
curl "https://api.buscadorncm.com.br/v1/ncm/buscar?q=cerveja" ncm-capitulos · nível 0
os capítulos da NCM com descrição e quantidade de códigos; /ncm/capitulo/{cap} lista os códigos
curl "https://api.buscadorncm.com.br/v1/ncm/capitulos" ncm-familias · nível 0
as famílias de NCM (antidumping, LESSIN, produção nacional, Ex-tarifário, regime temporário, BK/BIT, exceção de PIS/Cofins) com a contagem
curl "https://api.buscadorncm.com.br/v1/ncm/familias" cest · nível 0
descrição, segmento, anexo do Convênio ICMS 142/18, versões do SPED e os NCMs associados
curl "https://api.buscadorncm.com.br/v1/cest/0100100" cnae · nível 0
subclasse com hierarquia, atividades, o que compreende e o que não compreende, grau de risco da NR-04, RAT, se está sujeita ao fator R e as ocupações mais admitidas (Novo CAGED)
curl "https://api.buscadorncm.com.br/v1/cnae/4751201" nbs · nível 0
código da NBS com hierarquia, itens da LC 116 correlatos, tratamento do IBS/CBS pela correlação oficial e as notas explicativas
curl "https://api.buscadorncm.com.br/v1/nbs/101013000" lc116 · nível 0
item da lista do ISS com retenção pela lei nacional, alíquota mínima e máxima, NBS correlatas e o desdobro cTribNac
curl "https://api.buscadorncm.com.br/v1/lc116/14-01" ctribnac · nível 0
código de tributação nacional da NFS-e com o local de incidência do ISS
curl "https://api.buscadorncm.com.br/v1/ctribnac/140101" cclasstrib · nível 0
CST, tratamento, redução de IBS e CBS, anexo, vigência, documentos em que vale e o que o código exige saber da operação
curl "https://api.buscadorncm.com.br/v1/cclasstrib/200030" cst · nível 0
as tabelas de CST de ICMS, PIS, COFINS, CSOSN e IBS/CBS
curl "https://api.buscadorncm.com.br/v1/cst/pis/01" cbenef · nível 0
código de benefício fiscal das 8 tabelas estaduais, com CSTs admitidos, dispositivo e vigência
curl "https://api.buscadorncm.com.br/v1/cbenef/sp/sp010010" nfse-erro · nível 0
mensagem e solução de erro e alerta da NFS-e (ABRASF e Nacional)
curl "https://api.buscadorncm.com.br/v1/nfse/erros/e1521" municipio · nível 0
código IBGE do município (cMun) com nome e UF, pela tabela do Portal da NF-e
curl "https://api.buscadorncm.com.br/v1/municipios/3550308" iss · nível 0
ISS do município pelo código IBGE, como a prefeitura cadastrou no Sistema Nacional NFS-e (API ADN, consultada com certificado): convênio e Emissor Nacional, alíquota por código de tributação nacional com onde o ISS é devido, retenções do art. 6º e municipais, benefícios com o nBM, mudanças de alíquota em vigor e agendadas, e o ISS arrecadado (Siconfi). /iss/{municipio}/{ctribnac} traz os códigos municipais (sufixo) com alíquota e vigência
curl "https://api.buscadorncm.com.br/v1/iss/3550308" icms · nível 0
ICMS da UF pela sigla: alíquota geral com a lei, faixa do fundo de pobreza na NF-e, interestadual de saída e de entrada, segmentos com ST afirmada, cBenef, EFD, GNRE, Nota Fiscal Fácil, o Convênio ICMS 52/91 na UF, o ICMS de 2029 a 2033 pela fração da lei e o cadastro de contribuintes (formato da IE e consulta oficial). /icms lista as 27 UFs
curl "https://api.buscadorncm.com.br/v1/icms/sp" ie · nível 0
validação da inscrição estadual pela fórmula do dígito verificador de cada UF (a mesma do validador do site, conferida contra 11,3 milhões de IEs reais), com o cálculo passo a passo, o formato da UF e o link da consulta oficial. O dígito não prova que a inscrição existe
curl "https://api.buscadorncm.com.br/v1/ie/sp/110042490114" cbo · nível 0
ocupação da CBO 2002 com a família e os sinônimos oficiais
curl "https://api.buscadorncm.com.br/v1/cbo/252210" darf · nível 0
código de receita do DARF com o grupo, a vigência e os atos que o criaram ou alteraram
curl "https://api.buscadorncm.com.br/v1/darf/2172" natureza-juridica · nível 0
natureza jurídica com o grupo e as notas do que compreende e do que não compreende
curl "https://api.buscadorncm.com.br/v1/natureza-juridica/206-2" dirbi · nível 0
benefício da DIRBI com os tributos, o dispositivo legal e os NCMs que o anexo cita
curl "https://api.buscadorncm.com.br/v1/dirbi/programa-emergencial-de-retomada-perse" dfe-cstat · nível 0
o código de status (cStat) em cada documento fiscal eletrônico que o usa, com a mensagem de cada um e se o sentido diverge
curl "https://api.buscadorncm.com.br/v1/dfe/cstat/539" dere-codtrib · nível 0
código de tributação da DeRE com título, descrição e dispositivo legal
curl "https://api.buscadorncm.com.br/v1/dere/codtrib/110111001" dere-tabela · nível 0
uma das 16 tabelas da DeRE inteira, com as colunas e os itens
curl "https://api.buscadorncm.com.br/v1/dere/tabelas/13" dere-erro · nível 0
mensagem de erro da DeRE com a seção e as regras que a disparam
curl "https://api.buscadorncm.com.br/v1/dere/erros/ms1004" dir · nível 0
o leiaute da DIR (Anexo V da IN RFB 1.737/2017), bloco a bloco
curl "https://api.buscadorncm.com.br/v1/dir/leiaute" gtin · nível 0
formato, dígito verificador, prefixo GS1 e a rejeição que o erro daria; com ?ncm=, o cruzamento com o Anexo I da NT 2021.003
curl "https://api.buscadorncm.com.br/v1/gtin/7891000325858?ncm=04022110" agenda · nível 0
mudanças oficiais na NCM, na TEC e na uTrib já publicadas e com vigência futura (ato, DOU, data) mais o calendário de obrigatoriedade dos DF-e da reforma
curl "https://api.buscadorncm.com.br/v1/agenda?futuras=1" Completa e cruzada
Com a chave. A ficha consolidada do NCM, o lote e as conferências que cruzam uma tabela com a outra.
ncm-familia · nível 1
os NCMs de uma família com o resumo do bloco, o mesmo que a ficha completa traz
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/ncm/familia/antidumping" ncm-lote · nível 1
até 200 NCMs por GET ou 2.000 por POST, completos ou em resumo, com os não encontrados e os inválidos nomeados. Cada NCM distinto conta uma consulta da cota. Só nos planos pagos: a chave de avaliação recebe 403 (desde 08/out/2026)
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/ncm/lote?codigos=22030000,30049099" reforma-conferencia · nível 1
o par CST × cClassTrib contra a tabela oficial (rejeições 1020, 1023, 1024, 1025) e a relação do cClassTrib com o NCM: entre os candidatos, vedado, regra geral ou fora dos candidatos
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/reforma/conferir?ncm=30049099&cst=200&cclasstrib=200030" reforma-calculo · nível 1
IBS e CBS de um cClassTrib no ano: a efetiva do motor oficial ou a redução da tabela sobre a alíquota do ano; ano sem alíquota fixada sai a fixar
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/reforma/calcular?cclasstrib=200030&valor=1000&ano=2026" simples-calculo · nível 1
IBS e CBS do Simples Nacional pela NT 2026.005, com o mesmo contrato de entrada e saída da API do motor oficial da Receita
POST https://api.buscadorncm.com.br/v1/simples/calcular ibs-cbs-calculo · nível 1
IBS e CBS do regime geral com o mesmo contrato do POST /api/calculadora/regime-geral do motor oficial da Receita (objetos por item, total, compra governamental, tributação regular, memória de cálculo e os erros REG/CAL), pelo motor reproduzido e conferido contra o pacote oficial, sem captcha
POST https://api.buscadorncm.com.br/v1/ibs-cbs/calcular servico · nível 1
cTribNac × item da LC 116 × NBS × IBS/CBS: onde o ISS incide, alíquota mínima e máxima, retenção pela lei nacional e o tratamento da reforma; com ?municipio=, a alíquota e o código municipal que a prefeitura cadastrou
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/servico?ctribnac=140101&municipio=3550308" nfe-validacao · nível 1
o XML da NF-e/NFC-e pelo mesmo motor do validador do site e do XML em lote do Pro, com os achados e a rejeição de cada um; com ?perspectiva=destinatario, o CFOP espelho na entrada, o cBenef do emitente e o CEST por item. O XML é processado em memória e descartado
POST https://api.buscadorncm.com.br/v1/nfe/validar CFOP · 620
descrição do SPED, a nota explicativa do ato, os 9 indicadores da tabela oficial da NF-e, as regras do MOC que nomeiam o código ou leem um indicador dele, a malha de citação entre notas do Anexo II e as operações do assistente
curl -H "Accept: application/json" "https://buscadorncm.com.br/cfop/6107" Rejeição da NF-e · 1.061
motivo, a regra de validação literal do MOC com as exceções, se é obrigatória ou facultativa em cada UF e os CFOPs e indicadores que a regra toca
curl -H "Accept: application/json" "https://buscadorncm.com.br/nfe/rejeicoes/694" Operação → conjunto (nível 2)
para a operação caracterizada pelos eixos da querystring, o conjunto CFOP + CST ICMS (ou CSOSN) + CST PIS/COFINS com base legal, os avisos das regras 508/529/600 do MOC, a consequência de DIFAL e, quando o eixo que decide não veio, o CFOP como exige_resposta com os admissíveis e a pergunta. É o mesmo motor da página, rodando na borda
curl -H "Accept: application/json" "https://buscadorncm.com.br/qual-codigo-fiscal?sentido=saida&natureza=venda-revenda&ambito=interestadual®ime=real&tributacao=tributada&origem=0&destinatario=nao-contribuinte" ICMS-ST por rota (nível 1)
para NCM + UF de origem + UF de destino (e CEST, quando o NCM tem mais de um; sem ele, o leque com o que cada CEST daria na mesma rota): o estado de evidência (MVA publicada · só ajustada · segmento afirma sem MVA · não afirmada · UF saiu do ato · sem prova · origem fora do alcance · sem CEST), a MVA original e a ajustada pela alíquota da rota, a alíquota interna do destino com a origem dela, condição e dispositivo da UF, base legal do segmento e cobertura da prova. É o MESMO pacote versionado que o auditor em lote baixa. A URL do pacote está no manifest
curl -H "Accept: application/json" "https://buscadorncm.com.br/icms-st/consulta?ncm=32089010&origem=MG&destino=RJ" Monitor de mudanças (nível 0 e nível 1)
o delta semântico entre versões do pacote fiscal, por domínio (reforma e ICMS-ST): NCMs novos, removidos e alterados com os campos que mudaram, público e sem chave. E, com chave, https://buscadorncm.com.br/api/monitor?ncms=…&dominio=…&desde=V0006 (no host: /v1/monitor) responde "destes NCMs, quais mudaram desde a versão em que conferi?", encadeando versões. É o mesmo dado que o auditor cruza com a planilha e que o acompanhamento de Minha conta usa para avisar por e-mail e webhook assinado. Correção de erro nosso também sai no delta, com os NCMs afetados
curl -H "Accept: application/json" "https://buscadorncm.com.br/api/delta/reforma" Pré-nota
Com a chave. Operação mais item devolvem o item fiscal inteiro antes de emitir, com a trilha de cada decisão.
pre-nfse · nível 2
serviço + município + tomador → a NFS-e Nacional antes de emitir: itens da LC 116, código de tributação nacional e municipal, ISS do município pelo Ambiente Nacional, cIndOp com o local de incidência e o que ele exige na DPS (pela data da NT 009), CST e cClassTrib com o vínculo da Calculadora, IBS e CBS calculados, as recusas previstas e os campos na ordem do Emissor Nacional
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/pre-nfse?municipio=3106200®ime=regular&nbs=113022100&tomador=cnpj&municipio_tomador=3106200&valor=1000" pre-nfe · nível 2
operação + item → o item fiscal inteiro antes de emitir: CFOP com o perfil de risco (9 indicadores e as regras do MOC que leem o código), CST ou CSOSN, ICMS-ST da rota, DIFAL, IPI, PIS/COFINS com a exceção do NCM cruzada com o CST da operação, IBS/CBS com os candidatos filtrados pelas respostas, uTrib, GTIN, CEST e cBenef da UF; as rejeições que o dado enviado prova, os avisos, as perguntas em aberto e a trilha de cada decisão, com hash da resposta. Até 500 itens por POST. Cada item conta uma consulta da cota
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/pre-nfe?sentido=saida&natureza=venda-producao-propria®ime=real&tributacao=tributada&origem=0&uf_origem=RS&uf_destino=SP&destinatario=nao-contribuinte&consumidor_final=sim&ncm=94036000" A chave
A chave vai no cabeçalho x-api-key. A de avaliação é grátis, com
100 consultas por dia nos níveis 1 e 2, menos o lote de NCM, que é dos planos pagos. Crie a conta com o e-mail
profissional e um código, sem senha.
| plano | consultas por dia |
|---|---|
| Avaliação | 100, grátis |
| Pro API | 10.000 |
| API Escala | 100.000 |
Cota por dia e por conta (as chaves da conta somam), nunca por chamada avulsa. Acima de 100.000 por dia, contrato anual. A condição de cada plano depende do volume e das rotas que você usa: para conversar sobre ela, escreva para contato@buscadorncm.com.br. A tabela inteira não se vende: o valor está na consulta consolidada, versionada e com a mudança datada.
Operação → conjunto: os parâmetros
A consulta é a mesma da tela do assistente, eixo por eixo, na querystring. Valor fora das opções volta
400 com o eixo, o valor recebido e as opções válidas, nunca a página 404.
destinatario e perfil só decidem
onde a operação desdobra o CFOP; sem resposta, o campo cfop.codigo vem como
exige_resposta, com os admissíveis e a pergunta que fecha.
| eixo | opções |
|---|---|
| sentido | saida · entrada |
| ambito | interna · interestadual · exterior |
| regime | real · presumido · simples |
| tributacao | tributada · tributada-st · st-anterior · reducao · isenta · isenta-st · nao-tributada · suspensao · diferimento · outras |
| origem | 0 · 1 · 2 · 3 · 4 · 5 · 6 · 7 · 8 |
| destinatario | contribuinte · isento · nao-contribuinte |
| perfil | mesma-natureza · industrial · comercial · prestador-transporte · geradora-energia · produtor-rural |
| natureza | 66 operações canônicas: a lista com o id de cada uma está na própria página do assistente (links “?natureza=…”) e no índice JSON de https://buscadorncm.com.br/api. |
Base dedicada: https://api.buscadorncm.com.br/v1
Mesmo worker, mesma borda e mesmo payload, sem Accept: no host da API toda
resposta é JSON, o caminho carrega a versão (/v1), a raiz devolve o catálogo e
/openapi.json a especificação. Erros seguem a RFC 9457 (type,
title, status, detail)
junto do objeto erro que já existia; toda resposta traz
X-Request-Id para suporte. Atalho: /v1/operacao é o
mesmo que /v1/qual-codigo-fiscal.
curl https://api.buscadorncm.com.br/v1/cfop/6107
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/icms-st/consulta?ncm=11010020&origem=SP&destino=MG"
curl -H "x-api-key: ncm_SUA_CHAVE" "https://api.buscadorncm.com.br/v1/operacao?sentido=saida&natureza=venda-revenda&ambito=interestadual®ime=real&destinatario=nao-contribuinte" Referência rota a rota →
Parâmetros, valores aceitos, respostas e um curl por rota, gerados da própria OpenAPI. Com trechos em Python, Node, Go e PHP.
Disponibilidade
https://api.buscadorncm.com.br/v1/saude responde sem chave e sem cache: 200 no ar, 503 com
degradado[] quando falta dependência, inclusive a base que autentica as chaves.
Ligue no seu monitoramento. Do lado de cá, seis sondas externas a cada 5 minutos, uma delas numa rota com chave:
página de status →
Não há SLA contratado enquanto a API está em piloto fechado. Quando houver, ele será escrito aqui, com número.
ICMS-ST por rota: os parâmetros (nível 1)
A resposta é um estado de evidência, nunca "tem/não tem": o que a UF de destino publica para o
CEST (MVA original, só a ajustada, PMPF, condição e dispositivo), o que o ato do CONFAZ sustenta para o segmento
(afirmada, saída, não afirmada, sem prova) e o que falta e é de quem emite (o CEST quando o NCM tem vários, a MVA
quando a UF não publica). Pacote versionado: V0021 de
13/11/2026, fontes de 04/11/2026 (MVA por CEST×UF) e
10/08/2026 (alíquotas).
| parâmetro | valores |
|---|---|
| ncm | obrigatório: 8 dígitos |
| origem | obrigatório: sigla da UF do remetente |
| destino | obrigatório: sigla da UF do destinatário (interna quando igual à origem) |
| cest | opcional: SS.III.DD; obrigatório quando o NCM tem mais de um CEST (a resposta sem ele lista as opções em pergunta) |
| importado | opcional: 1 para mercadoria importada (alíquota interestadual de 4%, Res. SF 13/2012) |
| carga_propria | opcional: percentual da carga própria do substituto na operação INTERNA (ajusta a MVA quando menor que a alíquota interna) |
O que só tem aqui
- Os 9 indicadores oficiais por CFOP: 5.571 pontos da tabela do Portal Nacional da NF-e (IT-2023-002-v2.10-Tabela-CFOP-Descricao.xlsx), extraídos em 28/09/2026. Eles decidem o que o autorizador cobra na nota e não estão na descrição da operação: indNFe, indDevol, indRetor, indRemes, indAnula, indTransp, indComunica, indComb, indExcIBSCBS.
- As 619 notas explicativas do ato: 148.541 caracteres de texto normativo do Anexo II do Convênio s/nº de 1970, redação do Ajuste SINIEF 03/24. É o texto que decide o enquadramento; o catálogo do SPED traz só o rótulo.
- 190 divergências entre dois artefatos oficiais do mesmo Convênio: a tabela do portal SPED, que é a que se escritura na EFD, não grafa igual ao ato. O payload traz as duas e marca a divergência, em vez de escolher uma e calar a outra.
- O cruzamento regra × CFOP × indicador: das 1.336 regras do MOC, 48 nomeiam CFOP por extenso e 21 consultam um indicador da tabela. Nos dois sentidos: da ficha do código para a regra e da regra para os códigos.
Campo vazio nunca vem como null
Numa tela, "vazio" é lido por uma pessoa que sabe interpretar. Num JSON, null é lido
por um programa que conclui. Ausências de significados opostos viram a mesma conclusão. Isso deixa de ser
um vazio nosso e passa a ser um defeito nosso instalado no seu sistema. Por isso todo campo sem valor vem assim:
"divergenciaSped": {
"ausente": true,
"motivo": "nao_se_aplica",
"explicacao": "A pergunta não cabe neste código.",
"detalhe": "sem divergência entre o ato e a tabela do SPED"
} | motivo | o que quer dizer |
|---|---|
| nao_consta_na_fonte | A fonte oficial não publica este dado para este código. Ausência na fonte não é zero nem negativa. |
| fora_de_vigencia | O código existe no catálogo mas está fora da tabela vigente: serve para ler documento antigo, não para emitir documento novo. |
| sem_fim_publicado | A fonte traz a coluna e ela vem vazia para todos os códigos: nenhum fim de vigência foi publicado até a data desta extração. |
| fora_de_cobertura | Fora do que esta base cobre. Não equivale a "procuramos e não existe". |
| nao_medido | Não medimos. Não interpretar como zero, vazio ou negativa. |
| regra_geral | Procuramos dentro da cobertura declarada e não há exceção aplicável: a regra geral é a resposta. |
| exige_resposta | Falta caracterizar um eixo da operação. O conjunto só fecha com essa resposta, e ela é de quem emite. |
| nao_se_aplica | A pergunta não cabe neste código. |
A fronteira: o que a API responde e o que ela não responde
A API devolve o conjunto que a legislação admite, o discriminador que separa um código do outro, a base legal e a data de cada fonte. Não devolve veredito. A caracterização da operação (a destinação do item, se o destinatário é contribuinte, a UF de destino) depende de dado que está no seu cadastro, não no nosso; e vínculo entre regra e código diz que a regra lê aquele código, nunca que a nota será rejeitada. Cálculo e prova do nosso lado; caracterização e escolha do seu.
Para operação vinculante (emissão de NF-e, escrituração, consulta fiscal), confirme na fonte primária. Divergiu entre o nosso dado e a publicação oficial vigente, vale a publicação oficial. O aviso pela página de contato entra no reprocessamento.
Perguntas frequentes
Como consumir a API do Buscador NCM?
Pela base dedicada: GET https://api.buscadorncm.com.br/v1/ncm/22030000 devolve JSON sempre, sem header Accept, com a versão no caminho (/v1); a raiz lista o catálogo e /openapi.json traz a especificação. As fichas do site também respondem JSON na própria URL com Accept: application/json. Sem chave, o NCM volta em resumo e as tabelas respondem por código; com a chave x-api-key, o mesmo endereço devolve a ficha completa e liberam o lote, as conferências e a pré-nota.
Quais recursos estão disponíveis em JSON?
Em três camadas. Tabelas por código, com a chave grátis: NCM, CEST, CFOP, CNAE, NBS, LC 116, cTribNac, cClassTrib, CST, cBenef, erros da NFS-e, municípios, GTIN, a agenda de mudanças com data marcada e a busca por palavra da descrição oficial. Completa e cruzada, com chave: a ficha consolidada do NCM, o lote de até 2.000 NCMs, a conferência CST × cClassTrib × NCM, o serviço (cTribNac × LC 116 × NBS), o validador de XML, a consulta de ICMS-ST por rota e as 66 operações canônicas do assistente. E a pré-nota: operação mais item devolvem o item fiscal inteiro com as rejeições que o dado prova e a trilha de cada decisão.
Por que a API nunca devolve null?
Porque numa tela "vazio" é lido por um humano que interpreta. Num JSON, o vazio é lido por um sistema que tira conclusão sozinho. Um campo sem valor pode significar coisas opostas: a fonte não publica o dado, o código está fora da tabela vigente, a pergunta não cabe naquele código ou nunca medimos. Se os quatro casos viessem vazios do mesmo jeito, quem consome chegaria à mesma conclusão para quatro fatos diferentes. Por isso todo campo ausente vem como um objeto com motivo e explicação em português.
A API diz qual CFOP eu devo usar?
Não. É decisão de projeto. A API devolve o conjunto que a legislação admite, o discriminador que separa um código do outro e a base legal, nunca um veredito. A caracterização da operação (destinação do item, se o destinatário é contribuinte, a UF) depende de dado que está no seu cadastro, não no nosso. Cálculo e prova do nosso lado; caracterização e escolha do seu.
O vínculo entre uma rejeição e um CFOP significa que a nota vai ser rejeitada?
Vínculo por indicador diz que a regra LÊ aquele indicador e quanto ele vale neste CFOP — nunca que a rejeição vai disparar. O disparo depende do CST, da UF e do resto da nota, que não estão aqui.
Há limite de requisições?
Nível 0 (tabelas por código, resumo do NCM, busca, agenda): pede a chave grátis desde 03/11/2026. Sem chave seguem abertos o catálogo, a especificação OpenAPI, a saúde e o exemplo de cada rota. Toda chamada com a chave x-api-key conta numa cota diária que zera à meia-noite de Brasília, nos três níveis: o 0 (tabelas, busca, resumo), o 1 e o 2 (ficha completa, lote, conferências, validador, ICMS-ST, operação e pré-nota); no lote e na pré-nota em lote, cada NCM ou item conta uma consulta. A cota é da conta: as chaves de uma conta dividem o mesmo total do dia. O lote de NCM é dos planos pagos. A chave de avaliação é grátis, com 100 consultas por dia; o Pro API tem 10.000 e a Escala 100.000. Toda resposta com chave traz X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset; cota esgotada volta 429 com Retry-After. Nunca se cobra por chamada avulsa nem se vende a tabela inteira.
Existe ambiente de testes ou homologação?
Não. A API só consulta e não grava nada, então o teste é em produção, com a chave de avaliação (grátis, 100 consultas por dia). O console em buscadorncm.com.br/api/console executa cada rota no navegador.
Posso usar a API dentro de um sistema que vendo para clientes?
Pode. Integrar ao seu ERP, PDV ou sistema e mostrar o resultado aos seus usuários é o uso previsto, inclusive guardar as respostas. Os Termos vedam redistribuir a base e revender o acesso à API.
A API encontra o NCM pela descrição do produto?
Pela descrição técnica da TIPI, sim (/v1/ncm/buscar). Nome comercial, marca e modelo, não: o NCM segue sendo decisão de quem classifica. A API confere o código informado.