API Tributária: Integre Dados Fiscais no seu Sistema em 2026

Resposta Rápida: A API Tributária Agente Tributário entrega dados fiscais oficiais de CNAE, NCM, CEST, convênios CONFAZ e súmulas para consulta direta no seu ERP, CRM ou e-commerce. Com endpoints REST padronizados, você reduz erros de tributação, automatiza cálculos e se prepara para o novo IVA Dual previsto na LC 214/2025.

O que é a API Tributária Agente Tributário?

A API Tributária Agente Tributário é uma interface de programação de aplicações que permite consultar, em tempo real, bases de dados tributárias oficiais do Brasil: CNAE, NCM, CEST, convênios CONFAZ e súmulas administrativas. Ela funciona como uma camada de inteligência fiscal entre o seu software e a legislação brasileira.

Em vez de manter planilhas desatualizadas ou tabelas locais que exigem atualização manual, o desenvolvedor aponta o sistema para os endpoints da API. Cada consulta retorna dados estruturados em JSON, com links de referência à norma legal correspondente. Isso é particularmente útil para sistemas que lidam com notas fiscais, gestão de estoque, cadastro de produtos e emissão de documentos fiscais.

O contexto atual da reforma tributária torna essa integração ainda mais necessária. A EC 132/2023 criou o IVA Dual (CBS e IBS), e a LC 214/2025 regulamentou a transição. Os contribuintes precisarão classificar operações com muito mais precisão para enquadrar produtos e serviços na alíquota correta. Nesse cenário, uma API que devolve a classificação fiscal correta deixa de ser um luxo e passa a ser um requisito de conformidade.

Endpoints principais e dados consultados

A API está organizada em módulos independentes, de modo que o cliente pode assinar apenas os endpoints que precisa. Cada módulo segue uma convenção REST: uma chamada GET a um recurso com parâmetros de filtro, uma resposta com status HTTP e um corpo JSON contendo os dados. Abaixo descrevemos os módulos.

Consulta de CNAE

A CNAE (Classificação Nacional de Atividades Econômicas) é o código que identifica a atividade econômica de uma empresa. Ele é usado na apuração do Simples Nacional, nas alíquotas do Anexo da Lei Complementar 123/2006 e na maior parte das prefeituras para definição de impostos como o ISSQN. A API consulta a versão vigente da CNAE 2.3, mantida pelo IBGE e pelo CONCLA.

Uma busca simples pelo número do código CNAE retorna a descrição da atividade, o grau de risco (usado na NR-4) e a compatibilidade com os Anexos do Simples. Sistemas que fazem gestão de pessoas e folha de pagamento também usam esse dado para calcular a alíquota do RAT conforme o FAP.

Consulta de NCM

O NCM (Nomenclatura Comum do Mercosul) é o código de oito dígitos que classifica mercadorias para fins de tributação interna e comércio exterior. Ele determina o IPI, o PIS/Cofins, o ICMS-ST e agora o novo IBS e a CBS. A API consulta a tabela oficial publicada pela Receita Federal, incluindo as atualizações trazidas pela IN RFB nº 2.220/2024.

Cada registro do NCM vem com a descrição, a unidade de medida, a alíquota de IPI padrão e os campos de observação da Receita Federal. Para empresas que importam ou exportam, o módulo expõe ainda o tratamento administrativo dos órgãos anuentes.

Consulta de CEST

O CEST (Código Especificador da Substituição Tributária) é um código de sete dígitos que identifica mercadorias sujeitas ao ICMS-ST. Ele foi criado pelo Convênio ICMS 92/2015 e é exigido na NF-e. A API devolve o CEST correspondente a uma determinada combinação de NCM e descrição do produto.

Esse módulo é um dos mais usados por varejistas e atacadistas de eletroeletrônicos, bebidas, perfumes e materiais de construção. A resposta inclui a MVA (margem de valor agregado) por estado, informação necessária no cálculo da substituição tributária nas operações interestaduais.

Consulta de convênios CONFAZ

O CONFAZ pública convênios, ajustes e protocolos que definem a política tributária do ICMS entre os estados. A API disponibiliza um buscador completo dos atos CONFAZ, que retorna o número, a data de públicação, a ementa, os estados signatários e o arquivo PDF oficial. É uma ferramenta de auditoria poderosa para departamentos fiscais que precisam consultar rapidamente a base legal de benefícios fiscais.

Consulta de súmulas

A API reúne as súmulas do CARF e da CSRF, além das súmulas vinculantes do STF e dos enunciados do STJ sobre matérias tributárias. Cada súmula é indexada pelo número, pelo órgão de origem, pelo tema e pelas palavras-chave. Essa funcionalidade ajuda advogados e contadores a identificar rapidamente jurisprudência consolidada sobre um assunto antes de estruturar uma defesa administrativa.

Tabela comparativa dos módulos da API

Os percentuais da tabela são estimativas conservadoras com base em relatos da nossa base de usuários; não representam estatística formal.

Na prática: cálculo de uma operação sujeita a ICMS-ST

Vamos supor que sua empresa revista cosméticos e precise emitir uma NF-e de saída para um cliente no mesmo estado. O produto é um perfume com NCM 3303.00.10 e CEST 17.045.00. Sem a API, seu sistema dependeria de uma tabela fixa de MVA que, segundo a SEFAZ local, mudou no último mês. O sistema calcula o imposto com base em uma MVA antiga de 45%, mas a MVA atualizada é de 62%.

Com a API Tributária Agente Tributário, a rotina de emissão da NF-e faz uma única chamada GET informando NCM, descrição e a unidade da federação. A API retorna o CEST correto e o MVA atualizado. No exemplo:

• Preço de venda: R$ 180,00
• MVA atualizado retornado pela API: 62%
• Base de ICMS-ST: R$ 180,00 × 1,62 = R$ 291,60
• ICMS-ST = R$ 291,60 × 18% = R$ 52,49

Caso o sistema usasse a MVA antiga, a base seria de R$ 261,00 e o imposto de R$ 46,98. A diferença é de R$ 5,51 nesta única operação. Se a empresa vende 500 unidades desse perfume por mês, a diferença mensal chega a R$ 2.755,00. Em 12 meses, estamos falando de R$ 33.060,00 de obrigação tributária não calculada — valor que pode se materializar em autuação, multa e juros no futuro.

Esse cálculo reforça a importância de usar um simulador de impostos para testar cenários antes de integrar a API. Com o dashboard fiscal, também é possível comparar a base de cálculo lançada com a retornada pela API para identificar divergências na origem.

Referências normativas e a reforma tributária

A EC 132/2023 e a LC 214/2025 definiram as regras gerais do novo sistema tributário. O PLP 68/2024 foi o projeto apresentado no Senado que, após as emendas da Câmara, deu origem à LC 214/2025. O contribuinte que deseja se antecipar precisa entender que as alíquotas do CBS e do IBS serão definidas em lei complementar própria, com uma faixa de referência mencionada no artigo 19 da LC 214/2025 de 25% a 27,5%. Os valores de aproximadamente CBS 8,8% e IBS 17,7% são estimativas usadas em cálculos oficiais preliminares, não alíquotas definitivas.

Enquanto a legislação não se estabiliza, as bases atuais de NCM, CEST e CNAE continuam vigentes. A boa notícia é que a API Tributária Agente Tributário foi desenhada para

FAQ - Perguntas Frequentes

O que é a API Tributária Agente Tributário?

A API Tributária do Agente Tributário é uma solução que centraliza a consulta e integração de dados fiscais como NF-e, CT-e e NFS-e em um único endpoint. Ela permite que sistemas automatizem a validação, o download de documentos fiscais e o gerenciamento de obrigações acessórias.

Como integrar dados fiscais no meu sistema com a API do Agente Tributário?

Basta usar os endpoints REST da API, que aceitam JSON e exigem um token de autenticação via OAuth 2.0. A integração típica envolve enviar a chave de acesso do documento e receber o XML completo em segundos, sem a necessidade de manter certificados digitais localmente.

Quais dados fiscais a API Tributária do Agente Tributário retorna?

Ela retorna o XML original, protocolo de autorização, status do documento, valores totais e impostos destacados, além de informações do emitente e destinatário. Também é possível consultar o histórico de eventos da NF-e, como cancelamentos e correções.

A API do Agente Tributário é compatível com NF-e e CT-e?

Sim, a API é compatível com NF-e (modelo 55), CT-e (modelo 57), NFS-e e outros documentos fiscais eletrônicos. Ela se conecta diretamente às SEFAZ de todos os estados e ao CT-e da ANTT, unificando o acesso.

Como autenticar na API Tributária do Agente Tributário?

A autenticação é feita por OAuth 2.0, com credenciais fornecidas após o cadastro. Você recebe um client_id e client_secret para obter um access_token válido por 24 horas, que deve ser enviado no cabeçalho Authorization em todas as requisições.

Na prática

Na prática, cada empresa precisa avaliar o impacto tributário da reforma no seu setor, na sua estrutura de custos e no seu sistema de faturamento. Um bom ponto de partida é calcular o efeito das novas alíquotas sobre uma nota fiscal real: use o simulador de impostos do Agente Tributário e acompanhe os indicadores no dashboard fiscal.

Para aprofundar, veja também nosso guia prático de cálculo de CBS e IBS na nota fiscal e o guia completo da reforma tributária.

As regras da reforma estão na EC 132/2023 e na LC 214/2025, com regulamentação em discussão no Congresso.

Teste grátis: audite 50 notas fiscais com IA e veja divergências de NCM, CBS, IBS, ICMS, PIS e COFINS na sua operação.