Integração Gestão Empresarial | ERP e TMS Transportador

Informamos que esta integração se encontra em fase piloto e ainda não está disponível para todos os clientes do Gestão Empresarial | ERP.

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.

Validações

>> Entenda quais entidades são validadas no processo:

Filial
É realizada uma tentativa de localizar a filial pelo CNPJ na tabela E070FIL. Caso não encontrada, o processo é abortado.
Tipo de título

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.

Transação

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.

Portador
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.
Carteira
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.
Representante

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.

Atenção: Além das validações descritas acima, também são executadas as validações previstas nas telas F501TCP e F301TCR.

Cadastros

>> Entenda quais entidades são contempladas no cadastro automático:

Cliente

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 da seguinte forma:

  • Pelo CPF/CNPJ na tabela E085CLI.
  • Para clientes do exterior, pelo código para identificação do cliente na tabela E085CLI.
  • 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.
Fornecedor

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.

Fluxo do processo

Integração de faturas

>>Passo a passo do fluxo de integração

  1. O TMS Transportador emite a fatura.
  2. Após a emissão, o TMS gera uma pendência de integração para essa fatura.
  3. Um serviço do TMS processa as pendências de integração geradas.
  4. Durante esse processamento, a fatura é exportada para a camada de integração.
  5. A informação é enviada para a Senior X Platform pelo serviço erp-log-int-financas.
  6. Na Senior X Platform, a fatura é registrada no monitoramento para permitir rastreabilidade.
  7. O arquivo JSON recebido no serviço é armazenado no S3 para persistência e consulta futura.
  8. Depois disso, a Senior X Platform exporta o evento para o ERP.
  9. No ERP, o erp_service recebe e processa o evento enviado pela plataforma.
  10. O ERP realiza a validação dos dados da fatura.
  11. Após a validação, o sistema verifica se existem inconsistências.
    • Se forem identificadas inconsistências, o ERP registra as inconsistências encontradas.
    • Essas inconsistências são exportadas como retorno para o TMS Transportador.
    • O TMS recebe esse retorno para tratamento do problema.
  12. Se não houver inconsistências, o ERP registra o participante.
  13. O ERP registra o título financeiro.
  14. O sistema verifica se o título possui rateio.
    • Se houver rateio, o ERP registra o rateio no título.
  15. Após concluir o processamento, o ERP registra a confirmação.
  16. A confirmação é enviada de volta pela Senior X Platform.
  17. Por fim, o TMS Transportador recebe o retorno de sucesso do processamento.

Pré-requisitos

Componentes

Para que a integração ocorra corretamente, é necessário que alguns componentes tecnológicos estejam devidamente configurados e em funcionamento.

RabbitMQ

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.
ERP Service

É 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.
APP Manager

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.
Middleware Senior

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

Central de Configurações Senior
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.
  1. Execute o SeniorConfigCenter.exe;
  2. Acesse Plataforma XT > Configuração de integração;
  3. Informe o nome do tenant, a chave de acesso à plataforma e a chave secreta de acesso.
  4. 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.

Parâmetros padrões
  1. Acesse Cadastros > Empresas > Parâmetros de integração (F191CPT);
  2. Em Grupo, indique “TMS - Transportador”;
  3. Clique em Mostrar;
  4. 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

  1. Acesse Recursos > XPlatform > Integração XPlatform (F000ISX);
  2. Selecione o módulo Logística, integração TMS - Transportador;
  3. Clique em Ativar.
  • 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.
  • GER-000RCTMS04 - Antes de cancelar fatura no ERP Senior.

Este artigo ajudou você?