NCM Buscador

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&regime=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.

Ver a API de IBS e CBS

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. 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. 2. Leia prontoSe false, cada item de pendencias traz parametro, pergunta e opcoes. É o questionário que o vendedor não preencheu, pronto para virar tela.
  3. 3. Preencha a notanfe traz natOp, CFOP, idDest, indIEDest e indFinal; operacao traz o CST ou CSOSN e o PIS/COFINS; difal diz se é devido e quem paga. rejeicoesPrevistas é o que a SEFAZ recusaria com esses dados; avisos são pontos de conferência.
  4. 4. Guarde a provaO cabeçalho X-Resposta-Sha256 e meta.pacote (versão das tabelas) junto do pedido. Com referencia você 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&regime=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.

A chave não vai no navegador. A API responde a qualquer origem para você testar, mas chave em código de front-end é pública: qualquer visitante a lê e gasta a sua cota. Chame do seu servidor e entregue o resultado à sua tela.

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âmetroo 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)
ambitoOpcional: sai das UFs. Se vier e contradisser as UFs, a consulta é recusada.interna · interestadual · exterior
destinatarioDestinatário (indIEDest): contribuinte com IE, contribuinte isento de IE ou não contribuinte. Aceito em qualquer operação.contribuinte · isento · nao-contribuinte
consumidor_finalOperaçã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
perfilPerfil do tomador, só nos grupos de comunicação e transporte.mesma-natureza · industrial · comercial · prestador-transporte · geradora-energia · produtor-rural
perfil_emitentePerfil 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
documentoModelo do documento: 55 (NF-e) ou 65 (NFC-e). Padrão 55.55 · 65
orgao_publicoVenda a órgão público: a nota pede a Nota de Empenho (rejeição 359).sim · nao
nota_empenhoNúmero da Nota de Empenho (xNEmp) na venda a órgão público.texto
ref_nfeChave de 44 dígitos da nota de origem (refNFe), nas devoluções.44 dígitos
data_emissaoData 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_destinoCó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_govCompra 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_destinatarioCNPJ 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_emitenteCNPJ 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_portaVenda 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
medicamentoComo este medicamento se enquadra? (pergunta sobre o produto)indicacao-art146 · registrado · veterinario · outro
preparo_no_estabelecimentoO item é preparado no estabelecimento (prato, lanche, bebida não alcoólica feita na casa)?sim · nao
destino_zfm_alcPara quem vai esta venda, na Zona Franca de Manaus ou em Área de Livre Comércio?zfm-industria · zfm · alc · outro
industrializado_nacionalO item é bem material industrializado de origem nacional? (pergunta sobre o produto)sim · nao
classe_bem_zfmQue tipo de bem é este, para o crédito presumido da Zona Franca de Manaus? (pergunta sobre o produto)consumo-final · capital · intermediario · informatica
adquirente_cooperativaPara quem a cooperativa vende nesta operação?associado-regular · associado-nao-contribuinte · terceiro
venda_para_cooperativaEsta venda é para a cooperativa de que a empresa é associada?sim · nao
adquirente_automovelQuem compra este automóvel?taxista · pcd · outro
automovel_art149Este automóvel cumpre os requisitos do art. 149 para o comprador da venda? (pergunta sobre o produto)sim · nao
produto_projeto_automotivoO item é veículo do projeto incentivado, fabricado ou montado no estabelecimento habilitado? (pergunta sobre o produto)sim · nao
livro_jornal_periodicoO item é livro, jornal ou periódico? (pergunta sobre o produto)sim · nao
papel_para_impressaoO 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_naturaO produto é fornecido in natura? (pergunta sobre o produto)sim · nao
industrializador_exportadorO adquirente cumpre os requisitos de industrializador exportador do art. 82, § 11?sim · nao
adquirente_nao_contribuinteO adquirente é produtor rural ou transportador autônomo não contribuinte?produtor-rural · transportador-autonomo · nao
bem_da_lista_art110O produto é o bem descrito no item da lista do art. 197 dos regulamentos? (pergunta sobre o produto)sim · nao
produto_do_item_anexoO produto é o descrito no item do anexo da LC 214/2025? (pergunta sobre o produto)sim · nao
combustivel_monofasicoEste combustível está na tabela de monofásicos e qual é o papel da empresa na cadeia?contribuinte · revenda · nao
destinacaoNesta operação, a que se destina o produto?alimentacao-humana · insumo-agropecuario · outro
adquirenteQuem é o adquirente nesta operação?mercado · administracao-publica
regime_operacaoA operação está sujeita a diferimento?normal · diferimento
evento_saudeA operação ocorre sob situação de emergência de saúde pública reconhecida?nao · sim
natureza_produtoQual é a natureza deste item? (pergunta sobre o produto)saude-menstrual · higiene-limpeza · outro
papel_cadeiaQual é o papel da empresa na cadeia para os itens desta planilha?fabricante-importador · atacado-varejo · outro
regime_apuracaoQual é o regime de apuração de PIS/COFINS da empresa?simples · cumulativo · nao-cumulativo
diferimentoAtalho de regime_operacao: sim = diferimento.sim · nao
emergencia_saudeAtalho de evento_saude.sim · nao
Item (o produto)
ncm •NCM do item, 8 dígitos (aceita pontos).8 dígitos
cestCEST informado no cadastro, 7 dígitos (aceita pontos): conferido contra a tabela e o NCM.texto
gtincEAN: GTIN do produto ou SEM GTIN.texto
gtin_tributavelcEANTrib: GTIN da unidade tributável ou SEM GTIN.texto
utribUnidade tributável informada (conferida contra a tabela só na exportação).texto
cst_ibs_cbsCST do IBS/CBS informado, 3 dígitos.texto
cclasstribcClassTrib informado, 6 dígitos.texto
cst_pisCST de PIS/COFINS informado, 2 dígitos.texto
cbenefcBenef informado (conferido na tabela da UF de origem).texto
importadoMercadoria importada (interestadual de 4%). Sem ele vale a origem.sim · nao
carga_propriaCarga própria do substituto na operação interna, percentual de 0 a 100.0 a 100
valorBase 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
quantidadeQuantidade tributável do item (padrão 1).texto
cst_regularCST 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_regularcClassTrib da tributação regular, quando o cClassTrib exige. Padrão 000001.texto
descricaoDescrição do produto, só devolvida na resposta.texto
referenciaSeu 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&regime=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&regime=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&regime=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ção100, grátis
Pro API10.000
API Escala100.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&regime=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.

Voltar ao topo