Integração ERP x Faturas a Receber

Configurações

1. Instalação do Serviço

   Para realizar a instalação do serviço, siga os passos abaixo:

   1. Criação do Diretório de Instalação:

      Crie um diretório para salvar o executável e os arquivos necessários:

      • emlv3.dll
      • libeay32.dll
      • ssleay32.dll
      • libIntegraTLS1_2.dll
      • Messaging.Net.Api.dll
      • Messaging.Net.Api.x86.dll

      Importante:

      Caso algum desses arquivos DLL não esteja presente no diretório, entre em contato com o suporte para solicitar a liberação das mesmas.

   2. Abrir o Prompt de Comando:

      Abra o Prompt de Comando (cmd) como Administrador.

   3. Executar o Comando de Instalação:

      No prompt de comando, execute o seguinte comando, substituindo pelo diretório onde os arquivos estão salvos:

      C:\ERPXTEnvioContasReceber> SRVERPXTEnvContasReceberTMS.EXE /install
   4. Definição de Apelido para o Serviço (Opcional):

      Durante a instalação, é possível informar um apelido para o serviço, de acordo com a descrição que deseja para ele. Por exemplo:

      C:\ERPXTEnvioContasReceber> SRVERPXTEnvContasReceberTMS.EXE -ERPContasAReceber /install

      

   5. Verificação da Instalação:

      Após a instalação, acesse a tela Serviços do Windows para confirmar que o serviço foi instalado corretamente.

2. Configuração Inicial
   1. Primeira Execução:

      Na primeira execução do serviço, as chaves de conexão com o banco de dados serão criadas no registro do Windows. Importante: Como as chaves ainda não existem, uma mensagem de erro será exibida durante essa primeira execução.

   2. Verificação do Arquivo JSON:

      Após a primeira execução, verifique a pasta de instalação para confirmar que o arquivo .json foi gerado. Este arquivo contém diversas tags que podem ser utilizadas por outros serviços, conforme a necessidade.

      Exemplo de tags principais que podem ser configuradas:

      • "driver": "banco de dados" – Defina o driver do banco de dados.
      • "server": "descrição do servidor" – Nome ou endereço do servidor do banco de dados.
      • "database": "descrição da base de dados" – Nome da base de dados.
      • "user": "usuário do BD" – Usuário de acesso ao banco de dados.
      • "pass": "senha do BD" – Senha do banco de dados.
      • "empresa": "código da empresa" – Código da empresa utilizada.
      • "dirlog": "diretório onde serão salvos os logs" – Caminho onde os logs serão armazenados (diretórios separados por \\).
      • "ativaLog": false ou true – Para ativar (true) ou desativar (false) o log do serviço executado.
      • "tipoLog": "info" ou "debug" – Tipo de log: info para uma descrição simples ou debug para logs mais detalhados (com informações sobre campos e tabelas).
      • "tempoLog": tempo em segundos que deseja que o serviço execute – Define o intervalo de execução do serviço.
      • "geraLogAte": [descrição da regra para geração do lote] – Consulte o manual aqui para obter informações sobre como desativar o log automaticamente.

      Exemplo do arquivo JSON gerado:

      

3. Logs

   Todos os registros do serviço serão salvos no log, conforme as configurações definidas no arquivo JSON.

Utilização

Início do Processo

O processo inicia com a fatura no status:

• 2 – Em validação para Integração com ERP

Esse status indica que a fatura está em fase de conferência para liberação da integração.

Validações Automáticas (Trigger)

Existe uma trigger responsável por identificar as seguintes situações:

• Se a fatura foi criada;
• Se o total de todos os títulos é igual ao total da fatura;
• Se o status da fatura é igual ao status de todos os títulos vinculados.

Essas validações garantem a consistência das informações antes da liberação da integração.

Atualização do Status da Fatura

Com a trigger executando esse processo e todas as condições atendidas, o sistema grava o status da fatura como:

• 3 – Pronto para integração com o ERP.

Esse status libera a fatura para envio ao ERP.

Constante no CFG

No módulo CFG, em Cadastros > Replicação de Tabelas para Integração

É criada uma constante com o nome das tabelas que serão monitoradas no processo de integração.

Na imagem, são utilizadas as tabelas:

• INTEG_GTCFAT_ERPXT
• INTEG_GFATITU_ERPXT

  

Execução do Serviço de Integração

Quando o serviço SRVERPXTEnvContasReceberTMS está iniciado, ele verifica inicialmente a tabela INTEG_GTCFAT_ERPXT para buscar as faturas que devem ser integradas com o ERP.

Tratamento da Integração

Durante a integração:

• Os registros da tabela INTEG_GTCFAT_ERPXT são apagados;
• É gerado um código único no campo IdFaturaERPXT da tabela GTCFAT.

Esse campo é enviado na integração para o ERP, permitindo que o ERP identifique qual fatura existente no TMS está sendo integrada.

Logs e Identificação

O log do serviço executado apresenta a identificação da fatura, facilitando as tratativas no processo de integração TMS x ERP XT.

A identificação da fatura também é apresentada na tela de Faturas a Receber, facilitando a pesquisa e o acompanhamento posterior.

• O ERP deve retornar as informações do Nosso Número, conforme exemplo do JSON abaixo:

• Os documentos fiscais que inicialmente serão considerados na vinculação, são: Conhecimentos, NFS-e, Outros (minuta).

No processo de integração, será bloqueada toda alteração que tiver relacionado aos títulos a receber. Quando houver esta necessidade, deverá ser cancelada a fatura e então criado uma nova.

Apenas com exceções que fazem parte da alteração:

• Alteração de vencimento;
• Retirada de conhecimento que gera um desconto.

Existirá uma trigger para identificar se houve alterações (semelhante à trigger de inclusão) e o mesmo serviço que vai identificar estas tabelas. Com isso, apresenta no monitor com o evento de ALTERAÇÃO.

Da mesma forma que o serviço recebe o retorno do monitor e então confirma no TMS a alteração ou não da fatura. Caso não integrado, apresenta nos logs qual o motivo da rejeição/falha.

Para alterações de vencimento ou desconto nas faturas, a integração será excluída no ERP e será gerado novamente.

Sempre que for realizada uma alteração na fatura, o integrador gera um evento de "exclusão" e, no retorno deste evento, gera um evento de "integração", para mandar os dados alterados da fatura, títulos e movimentação financeira.

Existirá uma trigger para identificar se houve o cancelamento da fatura (semelhante a trigger de inclusão/alteração) e o mesmo serviço que vai identificar estas tabelas. Com isso, apresenta no monitor com o evento de CANCELAMENTO/BAIXA por cancelamento.

Da mesma forma que o serviço recebe o retorno do monitor e então confirma no TMS a alteração ou não da fatura. Caso não integrado, apresenta nos logs qual o motivo da rejeição/falha.

Fluxo de utilização

• A trigger identifica o cancelamento da fatura (semelhante a trigger de inclusão/alteração);
• O serviço identifica as tabelas envolvidas;
• O evento é apresentado no monitor como CANCELAMENTO/BAIXA por cancelamento;
• O serviço recebe o retorno do monitor;
• O TMS confirma a alteração ou não da fatura;
• Caso não integrado, o motivo da rejeição/falha é apresentado nos logs.

Status no TMS

Na tela de Faturas no TMS, é possível identificar os status quando receber o retorno e o cancelamento do processo de integração, como:

• Fatura integrada com ERP com status de aguardando;
• Fatura integrada com ERP com status de erro;
• Fatura integrada com ERP com status de sucesso;
• Fatura cancelada com ERP com status de aguardando;
• Fatura cancelada com ERP com status de erro;
• Fatura cancelada com ERP com status de sucesso.

  

  

Exemplos

Exemplo do JSON de Baixa por Cancelamento:

Todas as rotinas do sistema, que permitem realizar a exclusão de faturas, estarão bloqueadas no processo de integração com ERP.

São afetadas as seguintes rotinas:

• Módulo FAT - Tela de Fatura à Receber
• Módulo FAT - Utilitários > Outros > Exclusão de Faturas, assim como outras rotinas de alterações
• Módulo UTL - Utilitários > Exclusão de Títulos a Receber Pagos

Acesso ao Monitor de Integração

No acesso à plataforma Senior X, em:

Gestão Empresarial > Integração > Logística > Monitor, apresentam as faturas com a situação que ela se encontra durante a integração.

Visualização de detalhes

Ao clicar sobre a linha da fatura (ou no botão +), são exibidos seus dados mais completos, com as informações que vêm do ERP.

Ações disponíveis

No botão Ações, ao clicar para abrir, constam as opções:

• Exibir erros: quando o status está com erro, ao clicar nesta opção, apresenta a origem, motivo e data do processamento.
• Exibir histórico: ao clicar, apresenta o histórico completo com todos os passos que a fatura executou, desde a solicitação até a conclusão.
• Reenviar: quando o status está com erro e, ao verificar o motivo, o mesmo pode ser corrigido, existe a opção de reenviar o mesmo registro para integrar novamente.
• Baixar JSON: o sistema faz a baixa do arquivo JSON com o identificador da integração com o ERP.

O botão Consultar Status tem como objetivo tratar situações em que as faturas apresentam erro ao integrar com o ERP e, mesmo sendo tratadas diretamente no ERP, o status dessas faturas no TMS não é atualizado automaticamente, permanecendo em um estado inconsistente.

A rotina também permite que o status das faturas no TMS seja atualizado conforme o status real existente no ERP, evitando inconsistências quando o tratamento do erro ocorre diretamente no ERP.

Funcionamento da Rotina

Foi incluído o botão Atualizar status conforme ERP.

Ao utilizar esse botão, o sistema realiza a consulta do status da fatura no ERP e atualiza o status correspondente no TMS, garantindo a consistência das informações entre os sistemas.

Essa funcionalidade é indicada especialmente para cenários em que o erro de integração foi tratado diretamente no ERP, sem retorno automático ao TMS.

Pré-requisitos

Para utilização da funcionalidade, é necessário atualizar os executáveis abaixo para a versão 3.34.01 ou superior:

• FAT
• SRVERPXTEnvContasReceberTMS.exe

Utilização

Executado o serviço de integração com ERP Contas a Receber, e foi gerado corretamente.

Após a integração, apenas o ID corretamente integrado no ERP.

Ao clicar no botão para atualizar o status, o sistema apresenta uma mensagem para o usuário, comunicando que o processo foi feito corretamente.