NCM Buscador

Referência da API

54 rotas, com os parâmetros que cada uma aceita e o que ela responde. Esta página é gerada da especificação OpenAPI 3.1.0 que o próprio serviço publica: se as duas divergirem, a publicação não sai. Para executar cada rota no navegador, use o console. Visão geral, preço e fronteira do que a API responde estão em /api.

Base

https://api.buscadorncm.com.br/v1

JSON sempre, sem header Accept.

Autenticação

x-api-key

Níveis 1 e 2. Cota diária por plano, em X-RateLimit-*.

Erros

RFC 9457

type, title, status + erro.codigo estável.

Campo vazio nunca vem como null. Vem como { ausente: true, motivo, explicacao }. Num JSON o null é lido por um programa que conclui. Ausências de significados opostos viram a mesma conclusão.

Nível 0

Dado aberto, com a chave grátis desde 03/11/2026

GET /{recurso}/buscar

Busca por prefixo de código ou palavra da descrição oficial

ParâmetroObrig.ValoresO que é
recurso sim ncm, cest, cfop, cnae, nbs, lc116, ctribnac onde buscar
q sim string código ou palavras
limite não string até 100 (padrão 20)
pagina não string a partir de 1
200400
curl "https://api.buscadorncm.com.br/v1/ncm/buscar?q=moveis"
GET /agenda

Mudanças oficiais com vigência futura

ParâmetroObrig.ValoresO que é
ncms não string filtra por NCMs
futuras não string 1 para só as que ainda não vigem
desde não string AAAA-MM-DD
200
curl "https://api.buscadorncm.com.br/v1/agenda?futuras=1"
GET /api/delta

Índice dos deltas semânticos entre versões do pacote fiscal (reforma e icms-st): o último de cada domínio e o histórico. No host da API: /v1/delta

200404
curl "https://api.buscadorncm.com.br/v1/delta"
GET /api/delta/{dominio}

O último delta do domínio: NCMs novos/removidos/alterados com os campos que mudaram (reforma: candidatos, vedados, seletivo, base, piscofins; icms-st: CEST×UF, alíquota, condição)

ParâmetroObrig.ValoresO que é
dominio sim reforma, icms-st —
200404
curl "https://api.buscadorncm.com.br/v1/delta/reforma"
GET /api/saude

Estado do serviço, para ligar no seu monitoramento

Atalho: `/v1/saude` responde o mesmo que esta rota. Sem chave, sem cache (`no-store`). Devolve 200 com `ok: true` quando o serviço responde, o pacote fiscal está sendo servido e a base de contas e chaves responde (`contasEChaves`, desde 08/out/2026: sem ela toda chamada com chave falha); **503 com `ok: false` e `degradado[]`** quando alguma dependência falta ou a base passa de 1,5 s em duas leituras seguidas (uma leitura lenta isolada não derruba o sinal, desde 11/out/2026). Afirma só o que mede: que a API responde, qual pacote está no ar e que as chamadas com chave conseguem ser autenticadas. Não afirma que uma regra fiscal está correta e por isso não constitui SLA.

200503
curl "https://api.buscadorncm.com.br/v1/saude"
GET /cbenef/{uf}/{codigo}

Código de benefício fiscal da UF

ParâmetroObrig.ValoresO que é
uf sim string sigla
codigo sim string ex.: sp010010
200404
curl "https://api.buscadorncm.com.br/v1/cbenef/sp/sp010010"
GET /cbo/{codigo}

Ocupação da CBO 2002

ParâmetroObrig.ValoresO que é
codigo sim string 6 dígitos (aceita 2522-10)
200404
curl "https://api.buscadorncm.com.br/v1/cbo/252210"
GET /cclasstrib/{codigo}

Classificação tributária do IBS/CBS

ParâmetroObrig.ValoresO que é
codigo sim string 6 dígitos
200404
curl "https://api.buscadorncm.com.br/v1/cclasstrib/200032"
GET /cest/{codigo}

CEST com os NCMs associados

ParâmetroObrig.ValoresO que é
codigo sim string 7 dígitos (aceita com pontos)
200404
curl "https://api.buscadorncm.com.br/v1/cest/2806100"
GET /cfop

Índice dos 620 CFOPs

200
curl "https://api.buscadorncm.com.br/v1/cfop"
GET /cfop/{codigo}

Ficha do CFOP: descrição, nota do ato, 9 indicadores da NF-e, regras do MOC que o tocam, espelho, operações do assistente

ParâmetroObrig.ValoresO que é
codigo sim formato ^[1-7][0-9]{3}$ —
200404
curl "https://api.buscadorncm.com.br/v1/cfop/6107"
GET /cnae/{codigo}

CNAE com riscos, fator R e ocupações

ParâmetroObrig.ValoresO que é
codigo sim string 7 dígitos (aceita 4751-2/01)
200404
curl "https://api.buscadorncm.com.br/v1/cnae/4751201"
GET /cst/{tabela}/{codigo}

CST de ICMS, PIS, COFINS, CSOSN ou IBS/CBS

ParâmetroObrig.ValoresO que é
tabela sim icms, pis, cofins, csosn, ibs-cbs tabela
codigo sim string código
200404
curl "https://api.buscadorncm.com.br/v1/cst/pis/01"
GET /ctribnac/{codigo}

Código de tributação nacional da NFS-e

ParâmetroObrig.ValoresO que é
codigo sim string 6 dígitos
200404
curl "https://api.buscadorncm.com.br/v1/ctribnac/140101"
GET /darf/{codigo}

Código de receita do DARF

ParâmetroObrig.ValoresO que é
codigo sim string 4 dígitos
200404
curl "https://api.buscadorncm.com.br/v1/darf/2172"
GET /dere/codtrib/{codigo}

Código de tributação da DeRE

ParâmetroObrig.ValoresO que é
codigo sim string até 9 dígitos
200404
curl "https://api.buscadorncm.com.br/v1/dere/codtrib/110111001"
GET /dere/erros/{codigo}

Mensagem de erro da DeRE

ParâmetroObrig.ValoresO que é
codigo sim string ex.: ms1004
200404
curl "https://api.buscadorncm.com.br/v1/dere/erros/ms1004"
GET /dere/tabelas/{numero}

Tabela da DeRE inteira

ParâmetroObrig.ValoresO que é
numero sim string ex.: 13, 12.1
200404
curl "https://api.buscadorncm.com.br/v1/dere/tabelas/13"
GET /dfe/cstat/{codigo}

cStat em todos os documentos fiscais eletrônicos

ParâmetroObrig.ValoresO que é
codigo sim string número do cStat
200404
curl "https://api.buscadorncm.com.br/v1/dfe/cstat/539"
GET /dir/leiaute

Leiaute da DIR

200
curl "https://api.buscadorncm.com.br/v1/dir/leiaute"
GET /dirbi/{codigo}

Benefício fiscal da DIRBI

ParâmetroObrig.ValoresO que é
codigo sim string o identificador do benefício, como na ficha do site
200404
curl "https://api.buscadorncm.com.br/v1/dirbi/programa-emergencial-de-retomada-perse"
GET /gtin/{gtin}

Validação de GTIN

ParâmetroObrig.ValoresO que é
gtin sim string 8, 12, 13 ou 14 dígitos (ou sem-gtin)
ncm não string cruza com o Anexo I da NT 2021.003
200
curl "https://api.buscadorncm.com.br/v1/gtin/7891000325858?ncm=04022110"
GET /ibs-cbs/vinculo

cClassTrib × NCM ou NBS: o vínculo da Calculadora nos dois sentidos

ParâmetroObrig.ValoresO que é
ncm não string 8 dígitos (ou nbs)
nbs não string 9 dígitos (ou ncm)
cclasstrib não string 6 dígitos: com ele a resposta diz se o par é aceito
data não string AAAA-MM-DD (padrão: hoje)
200400
curl "https://api.buscadorncm.com.br/v1/ibs-cbs/vinculo?ncm=84713012&cclasstrib=200003"
GET /icms

ICMS das 27 UFs: alíquota geral, lei e fundo de pobreza

200
curl "https://api.buscadorncm.com.br/v1/icms"
GET /icms/{uf}

ICMS da UF: alíquota geral, fundo, interestadual, ST, cBenef, EFD, GNRE, 52/91, reforma e inscrição estadual

A alíquota geral é a modal da lei estadual; mercadoria com alíquota própria na lei paga a dela. A faixa do fundo é o que o campo da NF-e aceita, não a lista de produtos. `alteradaEm` só sai quando a alíquota mudou; ausente, vale a da lei de origem.

ParâmetroObrig.ValoresO que é
uf sim formato ^[A-Za-z]{2}$ sigla, ex.: sp
200404
curl "https://api.buscadorncm.com.br/v1/icms/sp"
GET /ie/{uf}/{numero}

Inscrição estadual: dígito verificador pela fórmula da UF

Confere formato e dígito pela fórmula que cada secretaria publica (roteiro de crítica do Sintegra; Goiás com as exceções da SEFAZ-GO; SP com o produtor rural P). `digitoConfere: true` diz que o número é bem formado, não que a inscrição existe ou está ativa: para isso, `consultaOficial`.

ParâmetroObrig.ValoresO que é
uf sim string sigla, ex.: sp
numero sim string a inscrição, com ou sem pontuação (SP produtor rural: P mais 12)
200400404
curl "https://api.buscadorncm.com.br/v1/ie/sp/110042490114"
GET /iss/{municipio}

ISS do município: convênio, alíquota por cTribNac, retenções, benefícios (nBM), mudanças e arrecadação

O que a prefeitura cadastrou no Sistema Nacional NFS-e, que é o que a Sefin Nacional usa para validar a DPS. Alíquota -1 nunca sai: não incidência vem como ausência declarada. Empresa do Simples Nacional não usa a alíquota do município.

ParâmetroObrig.ValoresO que é
municipio sim formato ^[0-9]{7}$ código IBGE de 7 dígitos
200404
curl "https://api.buscadorncm.com.br/v1/iss/3550308"
GET /iss/{municipio}/{ctribnac}

Códigos municipais (cTribMun) de um serviço no município, com nome, alíquota e vigência

Aceita o cTribNac com 6 dígitos (010701), com pontos (01.07.01) ou o código completo de 9 dígitos com o sufixo municipal (01.07.01.001). Traz onde o ISS é devido, a retenção (lei nacional, art. 6º e regras municipais), os benefícios gerais que alcançam o código e as mudanças.

ParâmetroObrig.ValoresO que é
municipio sim string código IBGE de 7 dígitos
ctribnac sim string 010701, 01.07.01 ou 01.07.01.001
200400404
curl "https://api.buscadorncm.com.br/v1/iss/3550308/01.07.01"
GET /lc116/{item}

Item da lista do ISS

ParâmetroObrig.ValoresO que é
item sim string no formato 14-01 (14.01 redireciona)
200404
curl "https://api.buscadorncm.com.br/v1/lc116/14-01"
GET /municipios/{codigo}

Município pelo código IBGE (cMun)

ParâmetroObrig.ValoresO que é
codigo sim string 7 dígitos
200404
curl "https://api.buscadorncm.com.br/v1/municipios/3550308"
GET /natureza-juridica/{codigo}

Natureza jurídica (Concla/IBGE)

ParâmetroObrig.ValoresO que é
codigo sim string 4 dígitos (aceita 206-2)
200404
curl "https://api.buscadorncm.com.br/v1/natureza-juridica/206-2"
GET /nbs/{codigo}

NBS com LC 116 e reforma

ParâmetroObrig.ValoresO que é
codigo sim string 9 dígitos (aceita 1.0101.30.00)
200404
curl "https://api.buscadorncm.com.br/v1/nbs/101013000"
GET /ncm/{codigo}

NCM: ficha consolidada com chave; sem chave, só o exemplo

O II que vale hoje sai em importacao.impostoDeImportacao.emVigor (TEC ou o regime vigente sem Ex e sem cota que a fixa); importacao.impostoDeImportacao.aliquota é a TEC.

ParâmetroObrig.ValoresO que é
codigo sim formato ^[0-9.]{8,10}$ NCM de 8 dígitos (aceita com pontos)
200404
curl "https://api.buscadorncm.com.br/v1/ncm/94036000"
GET /ncm/capitulo/{cap}

Códigos de um capítulo

ParâmetroObrig.ValoresO que é
cap sim formato ^[0-9]{2}$ dois dígitos
200404
curl "https://api.buscadorncm.com.br/v1/ncm/capitulo/94"
GET /ncm/capitulos

Capítulos da NCM

200
curl "https://api.buscadorncm.com.br/v1/ncm/capitulos"
GET /ncm/familias

Famílias de NCM

Cada família lê um bloco da ficha do NCM. A lista e a ficha saem do mesmo dado.

200
curl "https://api.buscadorncm.com.br/v1/ncm/familias"
GET /nfe/rejeicoes

Índice das 1061 rejeições da NF-e

200
curl "https://api.buscadorncm.com.br/v1/nfe/rejeicoes"
GET /nfe/rejeicoes/{codigo}

Rejeição: motivo, regra literal do MOC com exceções, obrigatória × facultativa, CFOPs e indicadores que a regra toca

ParâmetroObrig.ValoresO que é
codigo sim formato ^[0-9]{3,4}$ —
200404
curl "https://api.buscadorncm.com.br/v1/nfe/rejeicoes/694"
GET /nfse/erros/{codigo}

Erro ou alerta da NFS-e

ParâmetroObrig.ValoresO que é
codigo sim string ex.: e1521, a1
200404
curl "https://api.buscadorncm.com.br/v1/nfse/erros/e1521"

Nível 1

ICMS-ST por rota (exige chave)

GET /api/monitor exige chave

Destes NCMs, quais mudaram nas fontes desde a versão X? (sem estado: o ERP pergunta quando quiser). No host da API: /v1/monitor

Cruza a lista de NCMs com os deltas do domínio depois de `desde` (encadeando versões) ou só com o último delta. Para listas maiores que 2.000 ou aviso automático por e-mail/webhook assinado, cadastre um acompanhamento em Minha conta (o /app envia só a lista de NCMs).

ParâmetroObrig.ValoresO que é
ncms sim string até 2.000 NCMs de 8 dígitos separados por vírgula
dominio não reforma, icms-st Padrão: reforma
desde não formato ^V[0-9]{4}$ versão do pacote em que você conferiu (V0006); sem ela, só o último delta
ufs não string ICMS-ST: só mudanças que tocam estas UFs (SP,MG)
200400401403429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/monitor?ncms=94036000,30049069&dominio=reforma"
GET /cnpj exige chave

Cadastro do CNPJ para o motor fiscal: situação, UF, CNAE, Simples e MEI, IE, SUFRAMA, ente público e o ISS das atividades

ParâmetroObrig.ValoresO que é
cnpj sim string 14 caracteres, com ou sem máscara (aceita o CNPJ alfanumérico). Vai na query para não ficar no caminho dos logs
data não string AAAA-MM-DD para o Simples e o MEI na data (padrão: hoje)
200404503
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/cnpj?cnpj=00394460000141"
GET /ibs-cbs/calcular exige chave

IBS e CBS do regime geral com o contrato do motor oficial (regime-geral)

200400404422
curl -X POST -H "x-api-key: $NCM_API_KEY" -H "content-type: application/json" -d '{"id":"exemplo-1","versao":"1.0.0","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"}]}' "https://api.buscadorncm.com.br/v1/ibs-cbs/calcular"
GET /icms-st/consulta exige chave

NCM + UF de origem + UF de destino → estado de evidência do ICMS-ST, MVA original e ajustada, alíquotas, condição da UF, base legal e cobertura da prova

Estado de evidência, nunca veredito: `com-st` (MVA publicada para CEST×UF), `com-st-so-ajustada` (a UF publica só a ajustada), `com-st-sem-mva` (o segmento afirma a UF, falta MVA para o CEST: sai a referência ou a faixa do segmento e a `pergunta`), `nao-afirmada`, `saida` (a UF saiu do ato), `sem-prova`, `origem-fora-do-alcance`, `sem-cest`, `cest-ambiguo` (o NCM tem mais de um CEST: `pergunta.opcoes` lista; repita com `cest=`). Mesmo motor e MESMO pacote versionado do auditor em lote (`/fiscal-pack/icms-st/manifest.json`). Pacote corrente: V0021 de 2026-11-13; fontes: MVA por CEST×UF de 2026-11-04, alíquotas de 2026-08-10. FCP e PMPF não são calculados: saem declarados em `condicoes` e `avisos`.

ParâmetroObrig.ValoresO que é
ncm sim formato ^[0-9.]{8,10}$ NCM de 8 dígitos
origem sim AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 15 UF do remetente
destino sim AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 15 UF do destinatário (igual à origem = operação interna)
cest não formato ^[0-9]{2}\.?[0-9]{3}\.?[0-9]{2}$ SS.III.DD, obrigatório quando o NCM tem mais de um CEST
importado não 0, 1 1 = mercadoria importada (4%, Res. SF 13/2012)
carga_propria não mín. 0 · máx. 100 Percentual da carga própria do substituto na operação INTERNA; ajusta a MVA quando menor que a alíquota interna
porta_a_porta não sim, nao sim = venda a revendedor porta a porta. O CEST do Anexo XXVI (venda porta a porta) só tem ST nesse canal (Convênio ICMS 45/1999): sem este parâmetro, NCM que só tem CEST desse anexo sai `so-porta-a-porta`
200400401403429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/icms-st/consulta?ncm=94036000&origem=RS&destino=RJ&porta_a_porta=sim"
GET /icms-st/segmento/{segmento}/{uf} exige chave

Segmento + UF → MVA de referência com a faixa, a MVA de cada CEST do segmento e, com origem, quem retém

Para precificar sem o CEST de cada item. A referência é orientação do segmento; o valor que vale é o do CEST. Mesmo pacote e mesma cota da consulta por NCM.

ParâmetroObrig.ValoresO que é
segmento sim string slug do segmento, como na página /icms-st/{segmento}
uf sim ac, al, am, ap, ba, ce, df, es, go, ma, mg, ms e mais 15 UF de destino em minúsculas, como na página /icms-st/{segmento}/{uf}. Maiúscula responde 301 para a minúscula.
origem não AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 15 UF do remetente: com ela a resposta diz quem retém
200400401429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/icms-st/segmento/tintas-e-vernizes/rj?origem=SP"
GET /ncm/familia/{familia} exige chave

NCMs de uma família

Os NCMs com o bloco presente e o resumo dele. Código extinto que a fonte ainda cita sai em foraDaNcmVigente.

ParâmetroObrig.ValoresO que é
familia sim antidumping, lessin, producao-nacional, ex-tarifario, regimes-temporarios, bk-bit, pis-cofins antidumping, lessin, producao-nacional, ex-tarifario, regimes-temporarios, bk-bit ou pis-cofins
200404
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/ncm/familia/antidumping"
GET /ncm/lote exige chave

Lote de até 200 NCMs (planos pagos)

Só nos planos pagos: com a chave de avaliação a resposta é 403 `nivel_nao_liberado`; consulte `/ncm/{codigo}` um por vez.

ParâmetroObrig.ValoresO que é
codigos sim string NCMs separados por vírgula
resumo não string 1 para a forma resumida
200400401403429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/ncm/lote?codigos=94036000,30049069"
GET /nfe/validar exige chave

Validação do XML da NF-e/NFC-e (em memória, sem gravar)

ParâmetroObrig.ValoresO que é
perspectiva não string destinatario: acrescenta a leitura de quem recebe
200400401403413429
curl -X POST -H "x-api-key: $NCM_API_KEY" --data-binary @nota.xml "https://api.buscadorncm.com.br/v1/nfe/validar"
GET /reforma/calcular exige chave

IBS e CBS de um cClassTrib num ano da transição

ParâmetroObrig.ValoresO que é
cclasstrib sim string 6 dígitos
valor não string base em reais, para receber os valores
ano não string de 2026 a 2033; ano sem alíquota fixada sai a fixar
200400
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/reforma/calcular?cclasstrib=200030&valor=1000&ano=2026"
GET /reforma/conferir exige chave

CST × cClassTrib × NCM

ParâmetroObrig.ValoresO que é
ncm sim string 8 dígitos
cst não string CST do IBS/CBS
cclasstrib não string cClassTrib
documento não string 55 (padrão) ou 65
destinacao não string resposta da operação
destinatario não string resposta da operação (mercado ou administracao-publica)
regimeOperacao não string normal ou diferimento
naturezaProduto não string resposta da operação
200400401403429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/reforma/conferir?ncm=30049069&cst=200&cclasstrib=200032"
GET /servico exige chave

cTribNac × LC 116 × NBS × IBS/CBS (e o ISS do município)

ParâmetroObrig.ValoresO que é
ctribnac não string 6 dígitos
lc116 não string item, ex.: 14.01
nbs não string 9 dígitos
municipio não string código IBGE de 7 dígitos: acrescenta issMunicipal (exige ?ctribnac=)
200400401403429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/servico?ctribnac=140101&municipio=3550308"
GET /simples/calcular exige chave

IBS e CBS do Simples Nacional (NT 2026.005), com o contrato da API do motor oficial

200422
curl -X POST -H "x-api-key: $NCM_API_KEY" -H "content-type: application/json" -d '{"id":"exemplo-1","versao":"1.0","data":"2027-01-15","tpDoc":"55","CRT":"1","tpEnteGov":"","itens":[{"numero":1,"cClassTrib":"000001","cAtivSN":"01","baseCalculo":"1000.00","valorImpostoSeletivo":"0","pIBSSN":"0.5","pCBSSN":"2.75"},{"numero":2,"cClassTrib":"410001","cAtivSN":"01","baseCalculo":"200.00","valorImpostoSeletivo":"0"}]}' "https://api.buscadorncm.com.br/v1/simples/calcular"

Nível 2

Operação → conjunto (exige chave)

GET /pre-nfe exige chave

Pré-nota de um item

Operação + item → os campos da NF-e (CFOP, idDest, indIEDest, indFinal), CST ou CSOSN, DIFAL com quem paga, ICMS-ST da rota, IPI, PIS/COFINS, IBS/CBS, uTrib, GTIN, CEST e cBenef, com as rejeições que o dado prova, as pendências (cada uma com o parâmetro que a responde) e a trilha. `X-Resposta-Sha256` carimba o corpo. Parâmetro desconhecido ou valor fora das opções → 400.

ParâmetroObrig.ValoresO que é
sentido não saida, entrada Saída (você emite) ou entrada (você recebe a mercadoria). Decide a nota: sem ele a resposta traz a pendência e pronto=false.
natureza não venda-producao-propria, venda-revenda, venda-producao-propria-st, venda-revenda-st-substituto, venda-revenda-st-substituido, venda-ativo-imobilizado, bonificacao-doacao-brinde, amostra-gratis, devolucao-compra-industrializacao, devolucao-compra-comercializacao, devolucao-venda-producao, devolucao-venda-revenda e mais 54 Operação canônica: decide o CFOP e o CST de PIS/COFINS. Decide a nota: sem ele a resposta traz a pendência e pronto=false.
regime não real, presumido, simples Regime de apuração da SUA empresa: decide entre CST ICMS e CSOSN. Decide a nota: sem ele a resposta traz a pendência e pronto=false.
tributacao não tributada, tributada-st, st-anterior, reducao, isenta, isenta-st, nao-tributada, suspensao, diferimento, outras Situação do ICMS nesta operação. Decide a nota: sem ele a resposta traz a pendência e pronto=false.
origem não 0, 1, 2, 3, 4, 5, 6, 7, 8 Origem da mercadoria (Tabela A, 1º dígito do CST ICMS). 1, 2, 3 e 8 levam a interestadual de 4%. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como origem_mercadoria, origemMercadoria.
uf_origem não AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 15 UF do emitente. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como ufOrigem.
uf_destino não AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS e mais 16 UF do destinatário. EX na operação com o exterior. Decide a nota: sem ele a resposta traz a pendência e pronto=false. Também aceito como ufDestino.
ambito não interna, interestadual, exterior Opcional: sai das UFs. Se vier e contradisser as UFs, a consulta é recusada.
destinatario não contribuinte, isento, nao-contribuinte Destinatário (indIEDest): contribuinte com IE, contribuinte isento de IE ou não contribuinte. Aceito em qualquer operação.
consumidor_final não sim, nao 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). Também aceito como consumidorFinal, indFinal.
perfil não mesma-natureza, industrial, comercial, prestador-transporte, geradora-energia, produtor-rural Perfil do tomador, só nos grupos de comunicação e transporte.
perfil_emitente não regular, rural-nao-contribuinte, nanoempreendedor, templo, sem-fins-lucrativos, condominio 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. Também aceito como perfilEmitente.
documento não 55, 65 Modelo do documento: 55 (NF-e) ou 65 (NFC-e). Padrão 55. Também aceito como modelo.
orgao_publico não sim, nao Venda a órgão público: a nota pede a Nota de Empenho (rejeição 359). Também aceito como orgaoPublico.
nota_empenho não string Número da Nota de Empenho (xNEmp) na venda a órgão público. Também aceito como notaEmpenho, xNEmp.
ref_nfe não formato ^[0-9]{44}$ Chave de 44 dígitos da nota de origem (refNFe), nas devoluções. Também aceito como refNFe.
data_emissao não string 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. Também aceito como dataEmissao, dhEmi.
municipio_destino não string 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. Também aceito como municipioDestino, cMunFG.
ente_gov não 1, 2, 3, 4 Compra governamental: tipo do ente comprador (1 União, 2 Estado, 3 Distrito Federal, 4 Município). Com ele o grupo gTribCompraGov sai calculado. Também aceito como enteGov, tpEnteGov.
cnpj_destinatario não string 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. Também aceito como cnpjDestinatario, CNPJDest.
cnpj_emitente não string 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. Também aceito como cnpjEmitente, CNPJEmit.
porta_a_porta não sim, nao Venda a revendedor que vende porta a porta (Anexo XXVI do Convênio ICMS 142/2018 e Convênio ICMS 45/1999). Também aceito como portaAPorta.
medicamento não indicacao-art146, registrado, veterinario, outro Como este medicamento se enquadra? (pergunta sobre o produto) Também aceito como medicamento.
preparo_no_estabelecimento não sim, nao O item é preparado no estabelecimento (prato, lanche, bebida não alcoólica feita na casa)? Também aceito como preparoNoEstabelecimento.
destino_zfm_alc não zfm-industria, zfm, alc, outro Para quem vai esta venda, na Zona Franca de Manaus ou em Área de Livre Comércio? Também aceito como destinoZfmAlc.
industrializado_nacional não sim, nao O item é bem material industrializado de origem nacional? (pergunta sobre o produto) Também aceito como industrializadoNacional.
classe_bem_zfm não consumo-final, capital, intermediario, informatica Que tipo de bem é este, para o crédito presumido da Zona Franca de Manaus? (pergunta sobre o produto) Também aceito como classeBemZfm.
adquirente_cooperativa não associado-regular, associado-nao-contribuinte, terceiro Para quem a cooperativa vende nesta operação? Também aceito como adquirenteCooperativa.
venda_para_cooperativa não sim, nao Esta venda é para a cooperativa de que a empresa é associada? Também aceito como vendaParaCooperativa.
adquirente_automovel não taxista, pcd, outro Quem compra este automóvel? Também aceito como adquirenteAutomovel.
automovel_art149 não sim, nao Este automóvel cumpre os requisitos do art. 149 para o comprador da venda? (pergunta sobre o produto) Também aceito como automovelArt149.
produto_projeto_automotivo não sim, nao O item é veículo do projeto incentivado, fabricado ou montado no estabelecimento habilitado? (pergunta sobre o produto) Também aceito como produtoProjetoAutomotivo.
livro_jornal_periodico não sim, nao O item é livro, jornal ou periódico? (pergunta sobre o produto) Também aceito como livroJornalPeriodico.
papel_para_impressao não sim, nao O papel é destinado à impressão de livros, jornais ou periódicos? (pergunta sobre o produto) Também aceito como papelParaImpressao.
fonograma_nacional não sim, nao É fonograma ou videofonograma musical produzido no Brasil? (pergunta sobre o produto) Também aceito como fonogramaNacional.
in_natura não sim, nao O produto é fornecido in natura? (pergunta sobre o produto) Também aceito como inNatura.
industrializador_exportador não sim, nao O adquirente cumpre os requisitos de industrializador exportador do art. 82, § 11? Também aceito como industrializadorExportador.
adquirente_nao_contribuinte não produtor-rural, transportador-autonomo, nao O adquirente é produtor rural ou transportador autônomo não contribuinte? Também aceito como adquirenteNaoContribuinte.
bem_da_lista_art110 não sim, nao O produto é o bem descrito no item da lista do art. 197 dos regulamentos? (pergunta sobre o produto) Também aceito como bemDaListaArt110.
produto_do_item_anexo não sim, nao O produto é o descrito no item do anexo da LC 214/2025? (pergunta sobre o produto) Também aceito como produtoDoItemAnexo.
combustivel_monofasico não contribuinte, revenda, nao Este combustível está na tabela de monofásicos e qual é o papel da empresa na cadeia? Também aceito como combustivelMonofasico.
destinacao não alimentacao-humana, insumo-agropecuario, outro Nesta operação, a que se destina o produto? Também aceito como destinacao.
adquirente não mercado, administracao-publica Quem é o adquirente nesta operação?
regime_operacao não normal, diferimento A operação está sujeita a diferimento? Também aceito como regimeOperacao.
evento_saude não nao, sim A operação ocorre sob situação de emergência de saúde pública reconhecida? Também aceito como eventoSaude.
natureza_produto não saude-menstrual, higiene-limpeza, outro Qual é a natureza deste item? (pergunta sobre o produto) Também aceito como naturezaProduto.
papel_cadeia não fabricante-importador, atacado-varejo, outro Qual é o papel da empresa na cadeia para os itens desta planilha? Também aceito como papelCadeia.
regime_apuracao não simples, cumulativo, nao-cumulativo Qual é o regime de apuração de PIS/COFINS da empresa? Também aceito como regimeApuracao.
diferimento não sim, nao Atalho de regime_operacao: sim = diferimento.
emergencia_saude não sim, nao Atalho de evento_saude. Também aceito como emergenciaSaude.
ncm sim formato ^[0-9.]{8,10}$ NCM do item, 8 dígitos (aceita pontos).
cest não string CEST informado no cadastro, 7 dígitos (aceita pontos): conferido contra a tabela e o NCM.
gtin não string cEAN: GTIN do produto ou SEM GTIN. Também aceito como cEAN, cean.
gtin_tributavel não string cEANTrib: GTIN da unidade tributável ou SEM GTIN. Também aceito como gtinTributavel, cEANTrib, ceantrib.
utrib não string Unidade tributável informada (conferida contra a tabela só na exportação). Também aceito como uTrib.
cst_ibs_cbs não string CST do IBS/CBS informado, 3 dígitos. Também aceito como cstIbsCbs.
cclasstrib não string cClassTrib informado, 6 dígitos. Também aceito como cClassTrib.
cst_pis não string CST de PIS/COFINS informado, 2 dígitos. Também aceito como cstPis, cst_pis_cofins.
cbenef não string cBenef informado (conferido na tabela da UF de origem). Também aceito como cBenef.
importado não sim, nao Mercadoria importada (interestadual de 4%). Sem ele vale a origem.
carga_propria não mín. 0 · máx. 100 Carga própria do substituto na operação interna, percentual de 0 a 100. Também aceito como cargaPropria.
valor não string 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. Também aceito como vBC, base_calculo, baseCalculo.
quantidade não string Quantidade tributável do item (padrão 1). Também aceito como qTrib.
cst_regular não string 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. Também aceito como cstRegular, CSTReg.
cclasstrib_regular não string cClassTrib da tributação regular, quando o cClassTrib exige. Padrão 000001. Também aceito como cclasstribRegular, cClassTribReg.
descricao não string Descrição do produto, só devolvida na resposta.
referencia não string Seu identificador do item (código do produto, linha do pedido), devolvido igual na resposta. Também aceito como id.
200400401403429
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"
GET /pre-nfse exige chave

Pré-NFS-e: o serviço inteiro antes de emitir, na ordem do Emissor Nacional

ParâmetroObrig.ValoresO que é
nbs sim string 9 dígitos
municipio não string IBGE do prestador
regime não string regular, simples ou mei
data não string competência AAAA-MM-DD (padrão: hoje)
ctribnac não string 6 dígitos
ctribmun não string sufixo municipal de 3 dígitos
cindop não string 6 dígitos
tomador não string cnpj, cpf, exterior ou nao-identificado
municipio_tomador não string IBGE
municipio_prestacao não string IBGE
ente_gov não string 1 União, 2 Estado, 3 DF, 4 Município
cst não string CST do IBS/CBS
cclasstrib não string 6 dígitos
cst_regular não string grupo de tributação regular
cclasstrib_regular não string grupo de tributação regular
valor não string valor do serviço em reais
retencao_iss não string sim ou nao, como a DPS vai sair: é conferido contra a regra do município (E0655 a E0657). Sem ele, a resposta recomenda o tpRetISSQN pela parametrização do ADN
200400
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/pre-nfse?municipio=3106200&regime=regular&nbs=113022100&tomador=cnpj&municipio_tomador=3106200&valor=1000"
GET /qual-codigo-fiscal exige chave

Operação caracterizada → conjunto CFOP + CST ICMS/CSOSN + CST PIS/COFINS, com base legal, avisos das regras 508/529/600 e a pergunta pendente

Sem `destinatario` onde a operação desdobra o CFOP (saída interestadual de venda), `cfop.codigo` vem como `exige_resposta` e `cfop.admissiveis` traz os dois códigos com quem separa cada um. É o MESMO motor da página `/qual-codigo-fiscal`.

ParâmetroObrig.ValoresO que é
sentido não saida, entrada Saída (você emite) ou entrada (você recebe). Padrão: saida
natureza não venda-producao-propria, venda-revenda, venda-producao-propria-st, venda-revenda-st-substituto, venda-revenda-st-substituido, venda-ativo-imobilizado, bonificacao-doacao-brinde, amostra-gratis, devolucao-compra-industrializacao, devolucao-compra-comercializacao, devolucao-venda-producao, devolucao-venda-revenda e mais 54 Operação canônica. Padrão: venda-revenda
ambito não interna, interestadual, exterior Interna, interestadual ou exterior. Padrão: interna
regime não real, presumido, simples Regime da empresa. Padrão: simples
tributacao não tributada, tributada-st, st-anterior, reducao, isenta, isenta-st, nao-tributada, suspensao, diferimento, outras Situação do ICMS. Padrão: tributada
origem não 0, 1, 2, 3, 4, 5, 6, 7, 8 Origem da mercadoria (Tabela A). Padrão: 0
destinatario não contribuinte, isento, nao-contribuinte Só decide na saída interestadual de venda (fork 6101/6107 · 6102/6108). Informado fora disso → 400.
perfil não mesma-natureza, industrial, comercial, prestador-transporte, geradora-energia, produtor-rural Só decide nos grupos 1.300/1.350 e 5.300/5.350 (comunicação e transporte).
200400401403429
curl -H "x-api-key: $NCM_API_KEY" "https://api.buscadorncm.com.br/v1/operacao?sentido=saida&natureza=venda-producao-propria&ambito=interestadual&regime=real&tributacao=tributada&origem=0&destinatario=nao-contribuinte"

Em outras linguagens

Não publicamos SDK, de propósito. São rotas GET que devolvem JSON com um header de chave: a biblioteca padrão de qualquer linguagem resolve em poucas linhas. Um SDK nosso acrescentaria um pacote com versão própria, que envelhece entre uma mudança da API e a publicação seguinte. Quem quiser cliente tipado gera da especificação, que está sempre na versão corrente.

Python

import requests
r = requests.get(
    "https://api.buscadorncm.com.br/v1/icms-st/consulta",
    params={"ncm": "22021000", "origem": "SP", "destino": "RJ"},
    headers={"x-api-key": SUA_CHAVE},
    timeout=20,
)
r.raise_for_status()
dados = r.json()

Node

const u = new URL("https://api.buscadorncm.com.br/v1/icms-st/consulta");
u.search = new URLSearchParams({ ncm: "22021000", origem: "SP", destino: "RJ" });
const r = await fetch(u, { headers: { "x-api-key": SUA_CHAVE } });
if (!r.ok) throw new Error((await r.json()).erro?.codigo);
const dados = await r.json();

Go

req, _ := http.NewRequest("GET",
  "https://api.buscadorncm.com.br/v1/cfop/6107", nil)
req.Header.Set("x-api-key", chave)
res, err := http.DefaultClient.Do(req)

PHP

$ctx = stream_context_create(["http" => [
  "header" => "x-api-key: $chave",
]]);
$dados = json_decode(file_get_contents(
  "https://api.buscadorncm.com.br/v1/cfop/6107", false, $ctx), true);
O que muda de verdade no seu código não é a linguagem. É que campo sem valor não vem como null: vem como { ausente: true, motivo, explicacao }. Trate o objeto antes de concluir: if (x) é verdadeiro para uma ausência. É assim que "não se aplica" e "não medimos" viram a mesma conclusão no seu relatório.

Gerar um cliente tipado

A especificação é OpenAPI 3.1.0 e serve de entrada para qualquer gerador. Ela também importa direto no Postman e no Insomnia, sem coleção separada:

# TypeScript
npx openapi-typescript https://api.buscadorncm.com.br/v1/openapi.json -o ncm.d.ts

# Python, Java, C#, Rust, Ruby, Kotlin… (50+ linguagens)
openapi-generator generate -i https://api.buscadorncm.com.br/v1/openapi.json -g python -o ./cliente-ncm

Disponibilidade: https://api.buscadorncm.com.br/v1/saude (sem chave, sem cache) e a página de status, com seis sondas externas a cada 5 minutos, uma delas numa rota com chave. Dúvida de integração: /contato.

Voltar ao topo