English
Español
Integração ERP x Contas a Pagar
A integração entre TMS e ERP realiza o envio automático de faturas a pagar, garantindo sincronização das informações financeiras entre os sistemas.
O processo é baseado em uma fila de integração, monitorada por serviços responsáveis pelo envio e retorno dos dados.
Fluxo do Processo
- Configuração de Integração:
Deve ser criada uma configuração geral indicando que o cliente utilizará a integração do TMS com o ERP.
- Revisão de Integrações Existentes:
Devem ser revisados os pontos de integração do FMS com o ERP, garantindo que, quando o cliente utilizar a integração do TMS com o ERP, a integração de Contas a Pagar não ocorra pelo FMS.
- Status da Fatura:
Para controlar a integração, serão utilizados os seguintes status no campo inSituacao da tabela GFATUR:
- 0 – Integrado com Sucesso
- 1 – Fatura/Documento Cancelado
- 2 – Em Validação para Integração com o ERP
- 3 – Pronto para Integração com o ERP
- 4 – Aguardando ERP
- 5 – Retorno de Erro do ERP
- Chave de Integração Externa:
Deve existir um campo de chave de integração “ERP Externo” para casos em que recebemos informações do ERP.
- Exemplo: No módulo Frotas, que já possui integração, devem ser considerados tanto o campo atual ERP Senior quanto o novo campo ERP Externo.
Objetivo da funcionalidade
Estabelecer o processo de integração entre o TMS e o ERP, garantindo que as faturas a pagar geradas no TMS sejam:
- Enviadas automaticamente ao ERP;
- Validadas antes do envio;
- Processadas no ERP;
- Atualizadas no TMS com os dados de retorno.
Pré-requisitos
Configuração
- Integração ativada:
CFG > Utilitários > Configurações (ERP XT Monitor)
- Cadastro da integração configurado:
CFG > Cadastros > Cadastro de Integrações Plataforma Senior X
Estrutura
- Replicação da tabela de integração
- Execução do script da trigger de integração
Cadastros obrigatórios
- Empresa e filial da fatura devem existir no ERP
Atualizações necessárias
Os executáveis a seguir deverão ser atualizados para a versão 3.34.01 ou superior.
Serviços:
- SRVERPXTEnvContasPagarTMS (envio)
- SRVFMSRetIntegContPagar (retorno)
Módulos:
- FIN
- GFV
- CFG
Funcionamento da Rotina
Gatilho de Integração das Faturas – Resumo
A integração das faturas com o ERP é iniciada automaticamente pelo serviço sempre que existir um registro na tabela integ_GFAFATUR_ERPXT, que funciona como fila de processamento.
Quando o serviço identifica um item nessa tabela, ele verifica se a fatura correspondente está:
- Liberada internamente (InSituacao = LIBERADO)
- Pendente de integração externa (InStatusERPExterno = PENDENTE)
- Com títulos consistentes (soma dos títulos igual ao valor da fatura)
Se todas as condições forem atendidas, o serviço monta os dados da fatura e realiza a integração com o ERP.
Após o envio:
- O item é removido da fila de integração
- A fatura tem seus status atualizados conforme o retorno recebido
Configurações / Parametrizações
Ativação da Integração
Caminho: CFG > Utilitários > Configurações
Na guia ERP XT Monitor, marque a flag Realiza integração do Gestão de Transportes com o ERP Senior, para realizar a integração.
Cadastro de Integrações Plataforma Senior X
Caminho: CFG > Cadastros > Cadastro de Integrações Plataforma Senior X
Campos Superiores (Configuração da Conexão)
- Usuário – Usuário utilizado para autenticação na Senior X
- Senha – Senha correspondente ao usuário
- Chave – Chave de acesso usada quando a integração exige autenticação por token
- Usar login com chave – Define se a autenticação será feita por chave em vez de usuário e senha
- URL – Endereço da API da Plataforma Senior X
Campo Inferior (Serviço de Integração)
- Serviço – Seleciona qual tipo de integração o TMS utilizará
Replicação de Tabelas
Caminho: CFG > Cadastros > Replicação de tabelas para Integração
Será necessário replicar a tabela:
- INTEG_GFAFATUR_ERPXT conforme o exemplo abaixo:
Importante:
- A rotina depende da existência de registros na tabela integ_GFAFATUR_ERPXT;
- A integridade dos títulos (soma dos títulos igual ao valor da fatura) é validada antes do envio;
- O processo é automático e baseado em fila.
Exemplos de Integração
Exemplo de Acesso às Faturas
Caminho: FIN > Movimentações > Títulos > Faturas a Pagar
Exemplo em Acertos de Viagem
Caminho: GFV > Movimentações > Acertos de Viagem
Situação Integrado com ERP
Após integração, a fatura passa a apresentar os dados retornados pelo ERP.
Observação importante:
A empresa e a filial associadas à fatura devem estar previamente cadastradas no ERP. Essa informação é essencial para permitir a identificação correta da origem dos dados e garantir que a integração seja processada de forma consistente.
Retorno da Integração
Após a fatura ser enviada ao ERP e processada, o TMS precisa exibir os dados confirmados pelo ERP.
Essa atualização ocorre no momento em que o usuário clica em Salvar Fatura.
No campo Dados ERP Externo, serão exibidas:
- Número de referência da fatura no ERP
- Situação da integração (ex.: integrada, rejeitada)
- Data da integração
Serviço responsável:
- SRVFMSRetIntegContPagar
Serviço de Retorno
A rotina tem como objetivo criar um serviço de integração que funcione como consumidor de mensagens RabbitMQ, escutando eventos de inclusão de faturas no módulo financeiro.
Trazendo os seguintes benefícios:
- Eliminação de atrasos na integração de faturas entre módulos.
- Atualização automática e em tempo real do status das faturas.
- Redução de erros manuais e de inconsistências de dados.
- Aumento da eficiência operacional e controle de fluxo financeiro.
- Melhor rastreabilidade por meio de logs automáticos e padronizados.
Ao receber uma notificação do evento faturaIncluida, o serviço realiza uma consulta na base de dados para identificar a fatura correspondente e atualizar automaticamente sua situação, garantindo a integração em tempo real entre sistemas.
O serviço SRVFMSRetIntegContPagar de Retorno foi desenvolvido com base no padrão já estabelecido no SRVFMS.
Quando o evento faturaIncluida é publicado no domínio erp_log_int e no serviço financas, o serviço realiza as seguintes etapas:
- Conexão ao RabbitMQ
O serviço utiliza as credenciais e parâmetros definidos no arquivo JSON para conectar-se ao broker RabbitMQ e se inscrever no evento desejado.
- Recebimento do Payload
O serviço recebe uma mensagem no formato JSON contendo o campo idFatura.
- Processamento e Atualização
- O serviço consulta a tabela GFAFATUR para buscar os dados completos da fatura correspondente.
- A seguir, o serviço realiza a atualização dos seguintes campos:
- InSituacao = 0 (Liberado)
- InStatusERP = 2 (Integrado com erro)
- Registro de Logs
Toda mensagem processada é registrada para garantir rastreabilidade, permitindo o acompanhamento completo de cada evento.
Pré-requisitos e Configurações
Para o correto funcionamento, atualize o CAS e o SRVFMSRetIntegContPagar para a versão 3.33.01 ou superior.
Configuração do RabbitMQ
- Acesse o menu CFG > Utilitários > Configurações > Rabbit TMS Interno.
- Insira corretamente as credenciais de acesso ao RabbitMQ (Host, Porta, Usuário/Senha).
- Configure a fila/exchange para o evento faturaIncluida.
Ambiente de Integração
- Certifique-se de que o broker RabbitMQ esteja ativo e acessível.
- Instale o serviço SRVFMSRetIntegContPagar e configure o arquivo JSON conforme o exemplo abaixo:
Campos da Tela
No módulo CFG, acesse o menu Utilitários > Configurações > Rabbit TMS Interno.
Na configuração do RabbitMQ, defina as seguintes opções:
- Host: Endereço do broker RabbitMQ.
- Porta: Porta de conexão do serviço.
- Usuário/Senha: Credenciais de acesso.
- Fila / Exchange: Nome do evento e canal de escuta (neste caso, faturaIncluida).
Processamento de Retorno
Pré-requisitos
Para utilização desta funcionalidade, é necessário que o ambiente esteja atualizado conforme as versões e executáveis descritos abaixo.
Atualize para a versão 3.34.01 ou superior os executáveis a seguir:
- CAS - execute com data de criação de 26/11/2025.
- SRVFMSRetIntegContPagar
Utilização
Inclusão de Processamento no Serviço
Foi incluído o processamento dos retornos referentes à inclusão da fatura a receber no serviço:
- SRVFMSRetIntegContPagar
Regras de Validação
Durante o processamento do serviço, quando o campo IDdocumento estiver igual a vazio, será necessário validar as seguintes informações:
- Data de Vencimento;
- Valor da Fatura;
- Retirada e Inclusão de Documentos;
- Eventos de Desconto e Acréscimo no Título.
Reenvio da Integração
Caso tenha ocorrido qualquer alteração em um ou mais dos campos listados acima, será necessário reenviar a integração.
Log do Processamento
No log do processamento do serviço, são apresentadas as informações do retorno, permitindo a verificação do comportamento e das validações realizadas durante o processamento.
Estrutura de Dados / Banco
- Tabela de Controle de Integração
- integ_GFAFATUR_ERPXT: usada para armazenar faturas pendentes de envio ao ERP
- Atualizações nas Tabelas Principais
GFAFATUR
- Campo idFaturaERPXT para guardar o identificador da fatura no ERP
- Campo InSituacao atualizado para indicar status da integração
GFATITU
- Campo idTituloERPXT para guardar o identificador do título no ERP
- Operações Realizadas pelo Serviço
- INSERT/DELETE na tabela de integração (integ_GFAFATUR_ERPXT) para controlar fila
- UPDATE em GFAFATUR e GFATITU para gravar IDs e status
Atualização de Status e Envio de Cancelamento/Exclusão de Faturas
Pré-requisitos
Para utilização desta funcionalidade, é necessário que o ambiente esteja atualizado conforme a versão e os executáveis descritos abaixo.
Atualize para a versão 3.34.01 ou superior os executáveis a seguir:
- CAS - execute com data de criação de 27/11/2025.
- SRVERPXTEnvContasReceberTMS
Utilização e Alterações
Foram realizadas as seguintes alterações no serviço SRVERPXTEnvContasReceberTMS:
- Criação de uma constante no campo que verifica os eventos da integração com o ERP, sendo eles:
- 0 – integração ERP
- 1 – alteração ERP
- 2 – cancelamento ERP
- 3 – baixa ERP
- Criação de um status que retorna se a integração teve sucesso ou não, com as seguintes situações:
- 0 – pendente
- 1 – aguardando
- 2 – sucesso
- 3 – erro
- Inclusão da data de processamento de envio da integração com o ERP.
Registro em Log
As informações e os status do processo são registrados no log do serviço, permitindo o acompanhamento do envio da integração.
English
Español
