API IBPT: Como Integrar Dados Tributários 2026

Resposta Rápida: A API IBPT permite consultar automaticamente a classificação fiscal de produtos e serviços, com alíquotas de impostos federais, estaduais e municipais. Ao integrar essa interface ao ERP da sua empresa, você reduz erros de cálculo e ganha agilidade na emissão de notas fiscais e na apuração de tributos.

O que é a API IBPT

O Instituto Brasileiro de Planejamento e Tributação (IBPT) desenvolveu uma interface de programação de aplicações, conhecida como API IBPT, para centralizar dados tributários de todos os impostos que incidem sobre produtos e serviços no Brasil. Essa API disponibiliza informações como código NCM, alíquotas de IPI, ICMS, PIS, COFINS, ISS e Imposto de Importação, além de dados sobre carga tributária média por setor econômico.

Para empresas que precisam calcular impostos com precisão em cada operação, a API IBPT funciona como uma fonte de referência consultada em tempo real. Em vez de manter planilhas desatualizadas ou digitar manualmente cada alíquota, o sistema da empresa faz uma requisição à API e recebe os dados atualizados em formato estruturado.

A adoção dessa tecnologia se tornou ainda mais relevante com a chegada da reforma tributária, pois a estrutura de cobrança está sendo modificada. A Emenda Constitucional 132/2023 criou o IVA Dual, e a Lei Complementar 214/2025 regulamentou o novo sistema. Isso significa que as empresas precisarão se adaptar a novas alíquotas e métodos de apuração, e uma API como a do IBPT pode simplificar esse processo.

Como funciona a consulta de NCM e alíquotas

O funcionamento da API IBPT é simples. A empresa informa o código da Nomenclatura Comum do Mercosul (NCM) de oito dígitos ou descrição do produto, e a API retorna um conjunto de dados tributários. A NCM é o código padronizado que identifica mercadorias para fins de tributação no comércio exterior e também para operações internas.

Quando uma empresa consulta um NCM, a API do IBPT retorna as alíquotas dos seguintes tributos, quando aplicáveis:

• Imposto sobre Produtos Industrializados (IPI)
• Imposto sobre Circulação de Mercadorias e Serviços (ICMS)
• Programa de Integração Social (PIS)
• Contribuição para o Financiamento da Seguridade Social (COFINS)
• Imposto sobre Serviços (ISS), para o caso de serviços
• Imposto de Importação, para mercadorias vindas do exterior

A consulta pode ser feita de duas maneiras principais. A primeira é a consulta por NCM, que retorna os dados de uma mercadoria específica. A segunda é a consulta por descrição, que localiza produtos similares por palavra-chave. Nos dois casos, a resposta vem em formatos de fácil integração, como JSON, XML ou CSV.

Endpoints e formatos de resposta

Os endpoints da API IBPT seguem uma estrutura padrão de REST. O endpoint mais utilizado é o de consulta de NCM, em que se envia o código como parâmetro na URL. A resposta traz os impostos separados por esfera de governo e uma estimativa da carga tributária total.

A tabela abaixo mostra os principais endpoints e as informações retornadas:

Essa estrutura permite que o desenvolvedor obtenha somente os dados necessários para cada operação. Por exemplo, um e-commerce que vende apenas no mercado interno não precisa consultar Imposto de Importação na maioria das operações, mas pode filtrar essa informação caso atue com importação.

Dados disponíveis na API IBPT

Além das alíquotas por NCM, a API IBPT oferece dados históricos de carga tributária, informações sobre tributos por estado e até estimativas de impactos de mudanças na legislação. Esses dados são usados por empresas de todos os portes para planejamento tributário e previsão de custos.

Um ponto de atenção é que a carga tributária brasileira varia conforme a operação. O ICMS tem alíquotas diferentes em cada estado. A mesma mercadoria pode ter ICMS de 17% em São Paulo e de 20% no Rio de Janeiro, por exemplo. A API resolve esse problema quando a consulta informa a unidade federativa de destino, permitindo o cálculo correto para cada venda.

Com a reforma tributária, a estrutura desses dados mudará. A CBS (Contribuição sobre Bens e Serviços) substituirá PIS e COFINS, e o IBS (Imposto sobre Bens e Serviços) unificará ICMS e ISS. As alíquotas de referência da CBS são de aproximadamente 8,8% e as do IBS de aproximadamente 17,7%, dentro da faixa de 25% a 27,5% prevista no artigo 19 da Lei Complementar 214/2025. Esses números ainda dependem de ajustes e devem ser tratados como referência, não como valores definitivos.

Impostos federais, estaduais e municipais

A complexidade do sistema tributário brasileiro exige que a API tenha clareza na separação dos tributos. Os impostos federais como PIS, COFINS e IPI aparecem em campos próprios. O ICMS, estadual, é retornado conforme a UF informada na consulta. E o ISS, municipal, aparece quando o serviço possui incidência local.

Essa separação facilita a geração de arquivos fiscais como o SPED, a emissão de NF-e e o cálculo de créditos tributários. Muitas empresas usam a API IBPT como base de dados para o módulo fiscal do ERP, evitando tabelas internas desatualizadas.

Integração com ERP e automação fiscal

A integração da API IBPT com o ERP é feita normalmente por um sistema intermediário, que buscamos chamar de camada de integração fiscal. Esse sistema consulta a API quando uma nota fiscal é emitida e armazena as alíquotas aplicadas a cada item, criando um histórico auditável.

Na prática, o vendedor lança o pedido no ERP, o sistema identifica o NCM do produto cadastrado e faz uma chamada automática à API IBPT. A resposta é usada para calcular os impostos e gravar no banco de dados da nota. Todo o processo leva poucos segundos e dispensa a digitação manual de qualquer alíquota.

Esse modelo de automatização reduz drasticamente o número de erros de preenchimento. Também possibilita a atualização diária das alíquotas, já que o IBPT acompanha as mudanças da legislação e altera os dados na API. Para empresas que emitem muitas notas por dia, o ganho de produtividade é imediato.

A integração envolve quatro etapas básicas:

1. Identificar o NCM de cada produto no cadastro do ERP
2. Configurar as chamadas à API com a UF de origem e destino
3. Calcular os impostos usando os dados retornados
4. Armazenar o resultado para auditoria e geração de relatórios

Empresas que já possuem certificação digital e emissores de NF-e podem integrar a API IBPT diretamente ao processo de faturamento. Vale lembrar que o ERP deve estar preparado para receber as respostas da API em formato JSON ou XML, o que é padrão nos sistemas modernos.

Benefícios para a gestão tributária

O primeiro benefício da API IBPT é a redução de custos operacionais. Menos tempo gasto com digitação e conferência significa mais produtividade para a equipe fiscal. O segundo benefício é a conformidade: como a base de dados é mantida pelo IBPT, a empresa diminui o risco de usar informações desatualizadas.

A precisão dos cálculos também impacta diretamente o caixa. Se uma alíquota de ICMS é aplicada de forma errada, a empresa pode pagar imposto a mais ou ficar sujeita a multas por recolhimento a menor. Com a API, esse erro desaparece na maioria das operações.

Outro ponto positivo é a facilidade para gerar relatórios de carga tributária. A API permite saber exatamente quanto cada produto paga de imposto, o que ajuda na formação do preço de venda e na avaliação de viabilidade de novos produtos. Para empresas que trabalham com margens apertadas, essa informação é estratégica.

Também é importante citar a adaptação à reforma tributária. Com a CBS e o IBS, muitas regras mudarão. A API IBPT está sendo atualizada para incorporar a nova sistemática, e quem já usa a interface terá menos retrabalho do que quem mantém planilhas manuais. Confira o guia completo da reforma tributária para entender os prazos e as mudanças no IVA Dual.

Na prática: exemplo numérico em R$

Vamos supor que uma empresa de eletrônicos queira calcular os impostos de uma venda de R$ 1.000,00 de um produto que, após a reforma tributária, estará sujeito apenas à CBS e ao IBS. Usando as alíquotas de referência da LC 214/2025, a operação ficaria assim:

• Preço de venda: R$ 1.000,00
• CBS (alíquota de referência de 8,8%): R$ 88,00
• IBS (alíquota de referência de 17,7%): R$ 177,00
• Carga tributária total: R$ 265,00
• Preço final ao consumidor: R$ 1.265,00

Antes da reforma, o cálculo seria diferente, com PIS, COFINS, ICMS e IPI aplicados em cascata ou por dentro, dependendo da operação. A API IBPT retorna tanto as alíquotas atuais quanto as referências para o novo modelo, permitindo que a empresa compare cenários.

Em um período de um mês, se a empresa vender 10 mil unidades desse produto, a diferença de imposto a recolher pode passar de R$ 1 milhão. Por isso, é essencial que o sistema busque os dados corretos na API em tempo real, em vez de usar tabelas fixas que podem ficar desatualizadas.

Para projetar esse tipo de cenário na sua empresa, use o simulador de impostos. Ele permite calcular o impacto das alíquotas atuais e futuras sem precisar fazer manualmente cada conta. Depois de simular, acompanhe os resultados no dashboard fiscal, que reúne as informações de notas emitidas e impostos calculados.

Reforma tributária e o futuro da API IBPT

A reforma tributária promove a maior mudança na estrutura de impostos do Brasil desde a Constituição de 1988. A EC 132/2023 estabeleceu o IVA Dual, formado pela CBS e pelo IBS. A LC 214/2025 regulamentou os principais pontos, incluindo as alíquotas de referência e o período de transição.

Com essa mudança, os dados que a API IBPT fornece precisam passar por uma adaptação. Muitas empresas ainda vão operar com PIS, COFINS, ICMS e ISS durante o período de transição, que se estende até 2032. Depois disso, o sistema será mais simples, mas os desafios de integração continuarão, pois as alíquotas podem variar por estado e município durante a fase de convergência.

A API IBPT tem a vantagem de ser constantemente atualizada pelos seus mantenedores. A empresa que já adota essa tecnologia não precisa se preocupar em reprogramar o sistema a cada mudança de legislação, porque os dados vêm da nuvem. Basta ajustar a lógica de cálculo para consumir os novos campos quando eles estiverem disponíveis.

A Receita Federal também tem atuado na regulamentação dos novos tributos por meio de instruções normativas. As INs RFB vão detalhar questões operacionais como prazos de recolhimento e obrigações acessórias. É recomendável acompanhar essas publicações no site do governo federal para não perder nenhum prazo.

FAQ - Perguntas Frequentes

O que é a API do IBPT?

A API do IBPT é uma interface de programação que disponibiliza dados tributários como NCM, alíquotas de impostos e carga tributária média de produtos e serviços. Ela é usada por sistemas empresariais para consultar essas informações automaticamente, sem necessidade de digitação manual.

Como consultar NCM pela API IBPT?

Basta enviar uma requisição HTTP para o endpoint de consulta de NCM, informando o código de oito dígitos do produto. A resposta traz as alíquotas de IPI, ICMS, PIS, COFINS, Imposto de Importação e outras informações conforme o tipo de operação.

A API IBPT é gratuita?

Existem planos gratuitos e pagos. A versão gratuita normalmente permite um número limitado de consultas por mês, com dados básicos. Planos pagos oferecem consultas ilimitadas, suporte prioritário e cobertura de todos os estados e municípios, recomendado para empresas com alto volume de operações.

Como integrar a API IBPT com ERP?

A integração é feita por meio de chamadas de API no módulo fiscal do ERP. O sistema identifica o NCM do produto, consulta a API, recebe as alíquotas e calcula os impostos automaticamente. A maioria dos ERPs modernos permite essa configuração sem alteração complexa no código.

O que mudou na API IBPT com a reforma tributária?

A API passou a incluir campos para CBS e IBS, além dos tributos atuais. Durante o período de transição, as empresas podem consultar tanto os impostos antigos quanto as novas referências. Essa atualização permite que os sistemas se preparem gradualmente para o novo modelo de cobrança.

Conclusão

A API IBPT é uma ferramenta prática para empresas que precisam de dados tributários confiáveis em tempo real. A integração com o ERP reduz erros, aumenta a eficiência e prepara o negócio para a reforma tributária. Com os novos tributos chegando, essa automação deixa de ser um diferencial e passa a ser uma necessidade operacional.

Se você quer verificar como está o cálculo de impostos na sua operação atual, a melhor forma é começar por uma auditoria dos documentos fiscais. Com a tecnologia certa, é possível identificar erros de classificação e alíquotas que geram prejuízo silenciosamente. Faça um teste e veja o resultado na prática.

Use o simulador de impostos para projetar o impacto tributário e acompanhe os indicadores da sua empresa no dashboard fiscal.

Consulte a legislação atualizada e as normas oficiais no Planalto e no Gov.br.

Veja também o guia completo da reforma tributária e o cálculo de CBS e IBS na nota fiscal.