Integração API IBPT: Atualização dos Valores Aproximados dos Tributos

Por

Com o objetivo de simplificar o cumprimento da Lei da Transparência (Lei nº 12.741/2012), o ERPFlex agora conta com uma integração direta via API com o IBPT (Instituto Brasileiro de Planejamento e Tributação).

Com essa melhoria, ficou mais fácil atualizar os Valores Aproximados de Tributos dos seus NCMs em lote. Basta um clique no botão da tela de cadastro de NCM para que o sistema busque e atualize os dados de forma automática.

1. Como obter o Token do IBPT

O token é gerado individualmente para cada empresa (vinculado ao CNPJ).

  1. Acesse o portal De Olho no Imposto (IBPT).

  2. Crie uma conta de usuário e, dentro do painel, seleciona a opção “Incluir Empresa”.

  3. Após preencher o CNPJ e os dados da empresa, o sistema gera uma sequência alfanumérica única (ex: a1b2c3d4...). Esse é o seu Token.

 

2. Configurando a Integração (Ativação)

Antes de usar o recurso, é necessário ativar a integração e inserir o token gerado pelo próprio IBPT.

  1. Acesse o menu Integrações, selecione a opção Configurador de Integrações.

  2. Clique no botão IBPT.

  3. Ative a integração mudando a chave para Integração Ativa.

  4. Insira o seu Token cadastrado no site oficial do IBPT (https://deolhonoimposto.ibpt.org.br/).

  5. Clique em Salvar.

Nota: Sem o token configurado e a integração ativa, os novos botões na tela de NCM não ficarão visíveis.

3. Como Atualizar os NCMs

Com a integração ativa:

  1. Acesse menu Cadastros, Configurações Fiscais e selecione a opção NCM.
  2. Você notará dois novos botões ao clicar em Mais: Atualizar IBPT e Monitor de Processos.

O botão Atualizar IBPT funciona de duas formas:

Cenário A: Atualizar NCMs Selecionados

Se você selecionar NCMs específicos utilizando as caixas de seleção (checkboxes) do lado esquerdo da grade, o sistema abrirá uma janela com três opções:

  • Selecionados (X): Atualiza apenas os NCMs que você marcou.

  • Base Toda: Ignora a seleção e atualiza todos os NCMs cadastrados.

  • Cancelar: Cancela a operação e volta para a tela anterior.

Cenário B: Atualizar a Base Inteira Diretamente

Se você clicar em Atualizar IBPT sem selecionar nenhum NCM na listagem, o sistema entenderá que o objetivo é atualizar todo o cadastro. Uma mensagem de confirmação será exibida:

  • “Deseja atualizar a base toda de NCMs?” -> Clique em Sim para iniciar ou Não para cancelar.

 

4. Acompanhando o Processamento (Monitor de Processos)

Como a consulta é feita item a item via API, o processo roda em segundo plano. Para acompanhar o andamento:

  1. Clique no botão Mais > Monitor de Processos.

  2. A tela exibe a origem, o usuário que solicitou e o Histórico (atualizado automaticamente a cada 10 segundos), mostrando quantos NCMs já foram processados.

 

5. Atualização do NCM

Assim que a integração realiza a busca bem-sucedida das alíquotas no IBPT, o ERPFlex replica e grava as informações automaticamente em duas abas distintas dentro do detalhamento de cada NCM:

  1. Aba Valores Padrões – Faturamento: Os percentuais retornados alimentam a subaba % Aproximado de tributos, preenchendo os campos de tributos federais (nacionais/importados), estaduais e municipais que serão calculados na saída das mercadorias.

  2. Aba Valores Padrões – Compras: As mesmas alíquotas são gravadas na subaba % Aproximado de tributos voltada para a entrada de mercadorias.

 

6. Tratamento de Inconsistências e Erros

Se o IBPT retornar algum erro durante a atualização, o processo terminará com o status “Com inconsistências” e exibirá um ícone de alerta vermelho.

Para saber quais itens falharam:

  1. No Monitor de Processos, clique no botão Inconsistências ao lado do processo.

  2. O sistema fará o download de um arquivo de texto (.txt).

  3. Abra o arquivo para ver o ID do NCM, o Código e o motivo do erro (Ex: NCM não possui dados obrigatórios, Descrição ou EX inválidos, etc.).

Informação Importante sobre Timeout: Cada consulta de NCM enviada para a API do IBPT possui um limite de espera de 25 segundos. Caso a API do IBPT não responda dentro desse prazo, o sistema registrará automaticamente um erro de Timeout no arquivo de inconsistências e pulará para o próximo NCM da fila, garantindo que o restante da sua base continue sendo atualizada sem travamentos.