Integração Gestão Empresarial | ERP e TMS Transportador
A integração entre os sistemas tem como objetivo enviar ao Gestão Empresarial | ERP as informações relacionadas aos valores de pagamento e recebimento de faturas. O ERP realiza o tratamento dessas informações por meio de suas rotinas de gestão financeira.
Como funciona?
O processo inicia no TMS Transportador, com a emissão das faturas que representam os valores a pagar e a receber. Essas faturas consolidam as informações financeiras da operação, como valores, datas e partes envolvidas.
Após a emissão, as informações são exportadas automaticamente para o Gestão Empresarial | ERP, que realiza o processamento e a validação dos dados, encaminhando-os ao módulo financeiro para registro.
>> Entenda quais entidades são validadas no processo:
É realizada uma tentativa de localizar a filial pelo CNPJ na tabela E070FIL. Caso não encontrada, o processo é abortado.
O sistema tenta localizar o tipo de título padrão configurado na tela F191CPT. Se não for localizado, o processo é interrompido.
Quando a informação é exportada pelo TMS Transportador, o sistema tenta localizar o tipo de título com base no código informado, na tabela E002TPT. Se não for localizado, o processo também é interrompido.
A validação do valor padrão será realizada mesmo que o tipo de título seja exportado pelo TMS Transportador.
O sistema tenta localizar a transação padrão configurada na tela F191CPT. Se não for localizada, o processo é interrompido.
Quando a informação é exportada pelo TMS Transportador, o sistema tenta localizar a transação com base no código informado, na tabela E001TNS. Se não for localizada, o processo é interrompido.
A validação da transação padrão é realizada mesmo quando a transação é exportada pelo TMS Transportador.
Quando a informação é exportada pelo TMS Transportador, o sistema tenta localizar o portador com base na empresa e no código informado, na tabela E039POR. Se não for localizado, o processo é interrompido.
Quando a informação é exportada pelo TMS Transportador, o sistema tenta localizar a carteira com base no código informado, na tabela E033CRT. Se não for localizada, o processo é interrompido.
O sistema tenta localizar o representante padrão configurado na tela F191CPT. Se não for localizado, o processo é interrompido.
A validação do valor padrão é realizada somente no processo de recebimento.
>> Entenda quais entidades são contempladas no cadastro automático:
O cadastro é realizado na integração de faturas a receber, utilizando os valores do objeto “participante” no JSON.
- Antes de efetuar o cadastro, o sistema tenta localizar o cliente pelo CPF/CNPJ na tabela E085CLI. Se forem encontrados um ou mais registros, será utilizado o primeiro retornado pela consulta.
- Se o parâmetro UsaEntOri estiver configurado com “S”, as informações de endereço também serão utilizadas para gravar o endereço de entrega.
- O parâmetro Cliente igual Fornecedor da tela F070FVE é considerado da seguinte forma:
- S - Sim: na integração de um novo cliente, o sistema verifica se já existe um fornecedor com o mesmo CPF/CNPJ. Se encontrado, é realizada a vinculação entre as entidades.
- N - Não: não é realizada vinculação com cadastros existentes.
- Independentemente dessa parametrização, a rotina não cria fornecedores a partir de clientes. Apenas realiza a vinculação com cadastros já existentes, quando o parâmetro estiver ativado.
- A criação de fornecedores ocorre exclusivamente pelo fluxo de pagamentos.
Não há campo de ordenação definido na consulta. Portanto, não há garantia de que o mesmo registro será sempre selecionado.
O cadastro é realizado na integração de faturas a pagar, utilizando as informações do objeto “participante” no JSON.
- Antes de efetuar o cadastro, o sistema tenta localizar o fornecedor pelo CPF/CNPJ na tabela E095FOR. Se forem encontrados um ou mais registros, será utilizado o primeiro retornado pela consulta.
- Se o parâmetro UsaEntOri estiver configurado com “S”, as informações de endereço também serão utilizadas para gravar o endereço de origem da mercadoria.
- O parâmetro Cliente igual Fornecedor, da tela F070FVE, é considerado da seguinte forma:
- S – Sim: na integração de um novo fornecedor, o sistema verifica se já existe um cliente com o mesmo CPF/CNPJ. Se encontrado, é realizada a vinculação entre as entidades.
- N – Não: não é realizada vinculação com cadastros existentes.
- Independentemente dessa parametrização, a rotina não cria clientes a partir de fornecedores. Apenas realiza a vinculação com cadastros já existentes, quando o parâmetro estiver ativado.
- A criação de clientes ocorre exclusivamente pelo fluxo de recebimentos.
Não há campo de ordenação definido na consulta. Portanto, não há garantia de que o mesmo registro será sempre selecionado.
Fluxo do processo
Pré-requisitos
- Gestão Empresarial | ERP na versão 5.10.4.84 ou superior.
- TMS Transportador na versão X.XX.XX ou superior.
Componentes
Para que a integração ocorra corretamente, é necessário que alguns componentes tecnológicos estejam devidamente configurados e em funcionamento.
Servidor de mensageria de código aberto responsável pelo gerenciamento dos eventos trocados entre o ERP e a senior X Platform. Para garantir a comunicação entre os ambientes, são utilizadas duas instâncias do RabbitMQ:
- Uma instância instalada no ambiente do ERP, que pode estar hospedada On-Premise ou no ambiente Cloud da Senior, administrada pelo IT Services.
- Outra instância instalada no ambiente da senior X Platform, administrada pela equipe de Arquitetura da Senior.
É responsável por criar a ponte de comunicação entre o Gestão Empresarial | ERP e a senior X Platform, permitindo o recebimento de informações de fontes externas. Para o funcionamento correto do componente, deve obrigatoriamente estar conectado a instância do RabbitMQ.
Importante
- Em ambiente Cloud Senior, este componente é configurado e mantido pela equipe IT Services da Senior.
- Para maiores informações sobre a instalação do componente em ambientes On-Premise, verifique a documentação: Manual de instalação - ERP Service.
Componente responsável pelo gerenciamento das instâncias do ERP Service. Deve permanecer obrigatoriamente habilitado.
Sua desativação ou indisponibilidade impede o carregamento das instâncias do ERP Service em memória, comprometendo o processamento e o tráfego de informações entre o Gestão Empresarial | ERP e a senior X Platform.
Importante
- Em ambiente Cloud Senior, o componente é configurado e mantido pela equipe de IT Services da Senior.
- Em ambientes On-Premise, a configuração é realizada durante a instalação do componente ERP Service.
Componente responsável pela execução dos processos automáticos por meio de uma instância do SapiensServer (sapiensserv.exe).
Os processos automáticos realizam a exportação de informações do Gestão Empresarial | ERP para a senior X Platform. Portanto, o Middleware deve estar em execução para garantir o funcionamento da integração.
Parametrizações
Atenção!
A execução deste processo em ambientes que possuam integrações ativas entre o Gestão Empresarial | ERP e a senior X Platform pode causar impactos operacionais. Portanto, não deve ser realizada nessas condições.
- Execute o SeniorConfigCenter.exe;
- Acesse Plataforma XT > Configuração de integração;
- Informe o nome do tenant, a chave de acesso à plataforma e a chave secreta de acesso.
- Valide e aguarde a mensagem: "Autenticação na Plataforma SeniorX realizada com sucesso."
Caso não possua as informações necessárias para a configuração, consulte a seção Gerenciamento de aplicações.
Importante
A aplicação configurada deve estar vinculada a um papel com permissão para os processos do domínio/serviço erp_log_int / financas.
- Acesse Cadastros > Empresas > Parâmetros de integração (F191CPT);
- Em Grupo, indique "TMS - Transportador";
- Clique em Mostrar;
- Informe o Tipo de título, Transação do título, Transação de cancelamento do título e Grava rateio no título.
Devem ser preenchidos os valores para os subgrupos Contas a Pagar e Contas a Receber.
Ativação da integração
- Acesse Recursos > XPlatform > Integração XPlatform (F000ISX);
- Selecione o módulo Logística, integração TMS - Transportador;
- Clique em Ativar.
|
Veja também: |
- GER-000RCTMS01 - Definir informações do título antes de consistir na base.
- GER-000RCTMS02 - Permite bloquear o cancelamento/exclusão dos títulos da fatura.
- GER-000RCTMS03 - Personalização após títulos serem consistidas na base.
English
Español
English
Español


