01. DADOS GERAIS
Produto: |
TOTVS Varejo Supermercados |
---|
Linha de Produto: | |
---|
Segmento: | |
---|
Módulo: | CADASTROS |
---|
Função: | MANUTENÇÃO DE NCM CARGA TRIBUT. - MAP00501 |
---|
Ticket: |
|
---|
Requisito/Story/Issue (informe o requisito relacionado) : | DSUPESTRUT-10778 |
---|
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
![](/download/attachments/825303524/image-2024-3-4_10-12-47.png?version=1&modificationDate=1709557967513&api=v2)
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.
![](/download/attachments/825303524/image-2024-3-4_10-13-30.png?version=1&modificationDate=1709558010450&api=v2)
Imagem 3 - Dialog Importação tabela IBPT já realizadas
![](/download/attachments/825303524/image-2024-3-4_10-16-15.png?version=1&modificationDate=1709558177530&api=v2)
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.
![](/download/attachments/825303524/image-2024-3-4_10-25-0.png?version=1&modificationDate=1709558710600&api=v2)
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.
![](/download/attachments/825303524/image-2024-3-4_10-40-54.png?version=1&modificationDate=1709559655890&api=v2)
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.
![](/download/attachments/825303524/image-2024-3-4_10-45-9.png?version=1&modificationDate=1709559912500&api=v2)
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.
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.