DT Configurações para importação de dados via API

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Na aplicação Manutenção de NCM Carga Tribut. - MAP00501, implementar recurso para configurar dados de comunicação com API De Olho no Imposto, com o objetivo de atualizar os dados de carga tributária automaticamente.

03. SOLUÇÃO

Inicialmente, o responsável deve acessar o site https://deolhonoimposto.ibpt.org.br/, criar uma conta, adicionar a empresa, e assim será gerado um token para aquele CNPJ incluído, esse token deve-ser configurado na aplicação para comunicação com a API do IBPT. Basta somente um cadastro, com CNPJ de uma única empresa do grupo, para ter acesso aos dados.

Conforme critérios informados, na aplicação Manutenção de NCM Carga Tribut. - MAP00501, foram implementados recursos para configurar dados de comunicação com a API De Olho no Imposto, com o objetivo de atualizar os dados de carga tributária automaticamente. Foram executadas as seguintes atividades:

• Inclusão do botão de nome Configurações API IBPT , que ao acionado, abre caixa de diálogo para informar as configurações de comunicação com a API De Olho no Imposto, sendo:
  • URL (endereço API);
  • CNPJ de autenticação;
  • Token de autenticação;
  • Horário para execução do serviço (hh:mm:ss);
  • URL do Servidor onde estão instaladas as APIs;
  • Observação no rodapé: O serviço será executado todo primeiro dia de cada mês.

Imagem 1 - Tela da rotina Manutenção de NCM Carga Tribut. - MAP00501

Imagem 2 - Dialog Configuação de API IBPT

• Na caixa de diálogo Importação Tabela IBPT já realizadas, melhorar a visualização e exibir mais detalhes sobre as importações, quando executadas via API, como:
  • Tipo de Importação (API / Arquivo);
  • Status (Finalizada, Executando, Erro);
  • Usuário de importação;
  • Data e hora início de execução;
  • Data e hora fim de execução.

Imagem 3 - Dialog Importação tabela IBPT já realizadas

Imagem 4 - Dialog Importação tabela IBPT já realizadas

• Na caixa de diálogo Importação de Alíquota NCM, foi implementado as seguintes alterações:
  • Inclusão de uma caixa de seleção do Tipo de Importação que o usuário deseja realizar, com as opções API e Arquivo, sendo Arquivo o tipo selecionado por padrão.
  • Selecionando o tipo Arquivo, nada se altera.
  • Se o usuário selecionar o tipo API, a aplicação desabilita os campos Versão do Layout IBPT e Arquivo, e habilita o botão Confirmar se houverem informações de configuração da API na dialog Configuração API IBPT.
  • Ao acionar o botão Confirmar, com o tipo API selecionado, será exibida a mensagem: Será realizado o processo de atualização de carga tributária via API do IBPT, e pode durar vários minutos. Acompanhe o status da importação através do botão Log Importação. Deseja continuar? (Sim / Não).
  • Se o usuário escolher a resposta Sim, a aplicação fará a chamada de integração com a API De Olho no Imposto, utilizando as configurações definidas em Configurações API IBPT, para atualização dos dados de carga tributária.

• Ao tentar realizar a importação e não possuir as configurações da API para a execução, será exibida mensagem de alerta e o botão de Confirmar e ficará desabilitado, havendo informações de configuração, o usuário poderá realizar a importação.

Imagem 5 - Configurando a API IBPT

•  A rotina Manutenção de NCM Carga Tribut. - MAP00501, verificará permissão ao botão Configurações API IBPT, caso o usuário não possua, deverá ser realizada a permissão através do módulo Segurança -> Permissão nas Aplicações, deverá ser selecionado o módulo, e a rotina MAP0501 e marcar para o usuário na opção Constroles Especiais.

Porém, é importante observar, que a API do IBPT também verificará se o usuário que está realizando a tentativa de importação possui permissão para execução.

Imagem 7 - Controle de permissões

•  Havendo todas as condições positivas para a execução da importação, a mesma é realizada e retorna com sucesso.

Imagem 8 - Execução da importação e retorno com sucesso

Importante: Ao iniciar o serviço de comunicação com o IBPT, a primeira execução automática ocorrerá no próximo horário configurado e, posteriormente, será agendada para o primeiro dia de cada mês.

04. DEMAIS INFORMAÇÕES

Se estiver na versão 24.01, atualizar o sistema para o service pack 24.01.014 ou service pack superior.

05. ASSUNTOS RELACIONADOS

        Clique aqui para mais informações sobre Manutenção de NCM Carga Tribut. - MAP00501.