Consulte NCM com descrição e unidade
API REST com a tabela NCM oficial. Descrição, unidade tributável, vigência e ato legal. Ideal para ERPs, e-commerce e fiscal.
curl https://datahub.falcon-server.com.br/private/v1/ncm/85171300/search \
-H "Authorization: Bearer <SEU_TOKEN>"
# Resposta
{
"data": {
"code": "8517.13.00",
"description": "-- Telefones inteligentes (<i>smartphones</i>)",
"start_date": "2022-04-01",
"end_date": "9999-12-31",
"act_type": "Res Camex",
"act_number": "000272",
"year_act": "2021",
"unit_trib": {
"unit_abbreviation": "UN",
"unit_description": "UNIDADE",
"start_of_validity": "2022-04-01",
"end_of_validity": ""
}
}
}Tudo que você precisa do NCM
Sem precisar manter a tabela atualizada no seu banco.
Descrição oficial
Texto exato da publicação oficial. Use direto no cadastro de produtos sem precisar resumir.
Unidade tributável
UN, KG, M³, LT, PAR, etc. Crítico para emissão de NF-e correta (campo uTrib).
Vigência e ato legal
Datas de início e fim de vigência e o ato que criou o código (tipo, número e ano).
Aceita com ou sem pontos
Consulte 85171300 ou 8517.13.00: o código é normalizado antes da busca.
Cache com renovação
Cada código fica em cache e é reconsultado na fonte depois de 30 dias. Sem precisar baixar e manter a tabela.
Integra com CNPJ + Fiscal
Mesmo token cobre CNAE (do CNPJ) + NCM (do produto). Stack fiscal completa em uma só assinatura.
Falcon vs. alternativas para NCM
A maioria dos devs mantém tabela NCM no banco — não precisa
| Recurso | Falcon Data Hub | Manter no banco | Outros providers |
|---|---|---|---|
| Tabela completa atualizada | Sim | Manual | Sim |
| Renovação automática do cadastro | 30 dias | Manual | Parcial |
| Vigência e ato legal no retorno | Sim | Manual | Não |
| Plano grátis sem cartão | Sim | N/A | Não |
| SDK oficial PHP | Sim | N/A | Não |
| Tabelas fiscais combinadas (CNAE, CFOP, etc) | Sim | Manual | Parcial |
Perguntas frequentes sobre a API de NCM
O NCM tem 8 dígitos no Brasil?
Sim, o NCM brasileiro tem 8 dígitos (estrutura SH + dígitos nacionais). A consulta é pelo código de 8 dígitos, com ou sem pontos.
Vocês retornam a alíquota de IPI/ICMS?
Alíquotas variam por estado, produto e regime. Não retornamos no endpoint NCM básico — isso fica na nossa API Fiscal específica (cTribNac, CST, etc).
Como funciona a unidade tributável (uTrib)?
É a unidade de medida oficial para cobrança do tributo. Pode diferir da unidade comercial (uCom). Retornamos sempre a uTrib oficial para você preencher correto no XML da NFe.
Posso consultar NCM antigo (desatualizado)?
O retorno traz start_date e end_date da vigência, então dá para saber se o código ainda vale. Códigos que a fonte não reconhece mais retornam HTTP 400.
O que acontece se o NCM não existir?
A API responde HTTP 400 com uma mensagem de erro. Toda requisição conta no limite por hora do seu plano, inclusive a que não encontra resultado ou é recusada por dado inválido.
Cabe no plano grátis para um e-commerce pequeno?
Sim. O plano Free permite 10 requisições/hora, sem cadastro de cartão. Você só informa e-mail e senha. Para cadastro em massa ou catálogo grande: Iniciante (R$ 4,90/mês): 100 requisições/hora; Premium (R$ 49,90/mês): 1.000 requisições/hora; Enterprise (R$ 199,90/mês): 10.000 requisições/hora. Os limites e preços atualizados estão na página de planos.
Outras APIs no mesmo token
Uma única conta cobre tudo. Crie agora e use todas as APIs com o mesmo plano.
Consulte NCM em 30 segundos
Não precisa mais manter a tabela NCM no seu banco. Cria conta grátis e usa direto.