Árvore de páginas

INTEGRAÇÃO PROTHEUS X DATASUL FINANÇAS APB

Características do Requisito

Linha de Produto:

Microsiga Protheus® / DATASUL®

Segmento:

Supply Chain - Logística

Módulo:

SIGATMS - Gestão de Transportes

Rotina:

Rotina

Nome Técnico

TMSA370Ocorrência de Indenização
TMSA330Fechamento de Seguro
TMSA250Contrato de Carreteiro
TMSA240Complemento de Viagem
TMSIABPIntegração TMS x ABP Datasul
TMSA310Fechamento da Viagem
TMSA251Liberação Contrato de Carreteiro
TMSAE77Controle de envio EAI
TMSI240ABPIntegração EAI Gera Título a Pagar - Adiantamento de Frete
TMSI310ABPIntegração EAI Gera Título a Pagar - Pedágio e Adiantamento de Frete
TMSI250ABPIntegração EAI, Gera Título a Pagar do Contrato de Carreteiro 
TMSI330ABPIntegração EAI Gera Título a Pagar - Fechamento Seguro
TMSI370ABPIntegração EAI Gera Título a Pagar - Indenização
TMSI250BXIntegração EAI Gera Título a Pagar - Baixa título

Parâmetro(s):

MV_TMSERP - ERP que está integrado ao SIGATMS (0-Protheus / 1-Datasul).

Requisito/Story/Issue (informe o requisito relacionado):

LOGTMS01-1100

País(es):

Todos

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

  • DUJ - Contrato Fornecedor.
  • DTY - Contrato Carreteiro.
  • SDG - Movimento Custo Transporte.
  • DUB - Registro de Indenizações.
  • DU8 - Fechamento Seguro.

Sistema(s) Operacional(is):

Windows® / Linux®

Descrição

Foram realizadas integrações das informações de contas a pagar, geradas pelo módulo SIGATMS (Transportation Management System) da linha Microsiga Protheus® com o módulo Finanças APB da linha Datasul.

O Protheus usa como ferramenta de Integração o EAI Protheus® (Enterprise Application Integrator), o EAI por sua vez, tem a responsabilidade de trafegar mensagens de XML entre o Protheus e o Datasul, além de fazer o controle de filas das mensagens a serem integradas.

 

Definição da Regra de Negócio

Para que se cumpra o objetivo deste requisito, o parâmetro MV_TMSERP, deve estar configurado com a opção igual a "1", onde significa que o sistema integrará com outra marca, neste caso, o DATASUL.

O Adapter EAI deve estar cadastrado, indicando o(s) cadastro(s) que integrará com a outra marca.

 

Movimentos de Custo de Transporte (TMSA070)

Quando o módulo SIGATMS estiver integrado com o ERP Datasul (MV_TMSERP = '1'), não será possível incluir movimento de custo de transporte para viagens que já possuem o contrato de carreteiro gerado.

 

Registro de Indenizações (TMSA370)

Por intermédio da rotina Registro de Indenizações (TMSA370), é gerado um título no contas a pagar para indenização. Os títulos serão gerados no ERP Datasul, a partir do envio de uma mensagem ao EAI Protheus para se comunicar com o Datasul e solicitar a geração deste título no ERP Datasul.

 

Fechamento de Seguro (TMSA330)

Ao confirmar o fechamento de seguros no TMS, é gerado um título financeiro.

É importante observar que hoje os títulos gerados pelo fechamento do seguro, podem ter seus lançamentos contábeis demonstrados no SIGATMS. Com a integração ativa com o ERP Datasul, essa visualização não será mais disponível, já que a mesma será realizada automaticamente pelo ERP Datasul.

 

Contrato de Carreteiro (TMSA250)

Quando o SIGATMS estiver integrado com o ERP Datasul, durante o processamento de geração do contrato de carreteiro, será iniciada a integração entre o SIGATMS e ERP Datasul. O ERP Datasul retornará os valores dos impostos para o SIGATMS. Com o retorno das informações dos impostos o contrato de carreteiro terá sua geração confirmada.

Além dos títulos do contrato de carreteiro e seus impostos, os títulos referente ao adiantamento e pedágio também poderão ser gerados neste momento no ERP Datasul. 

Pagamento Saldo

Com a integração ativa, a rotina Pagamento de Saldo do Carreteiro não poderá mais ser acessada pelo transportador, já que o pagamento (baixa) dos títulos ocorrerão apenas no ERP Datasul.

O ERP Datasul, por sua vez, terá a responsabilidade de enviar uma mensagem de baixa dos títulos para o SIGATMS, por meio do EAI.

 

Liberação do Contrato de Carreteiro (TMSA251)

Quando estiver habilitado o uso do parâmetro MV_LIBCT = .T., enviará na geração do contrato de carreteiro uma indicação para o título no ERP Datasul permanecer bloqueado para pagamento. Para liberar o título no ERP Datasul, será necessário realizar a liberação do contrato de carreteiro no SIGATMS, que enviará uma mensagem ao ERP Datasul solicitando a liberação do título para pagamento.

 

Complemento de Viagem (TMSA240)

A geração do título de adiantamento da viagem passou a ocorrer em três momentos de acordo com a configuração realizada no contrato do fornecedor, o campo Mom.Ger.ADI (DUJ_TITADI) podendo ser na inclusão da viagem, fechamento ou na geração do contrato de carreteiro da viagem.

Caso o campo esteja configurado com a opção 0 - Geração da viagem, será realizada a integração com o Datasul para geração do título no financeiro.

 

Fechamento de Viagem (TMSA310)

Além do título de adiantamento, o título de pedágio pode ser configurado para ser gerado no momento do fechamento da viagem, campo Mom.Ger.PDG (DUJ_TITPDG).

Se o contrato do fornecedor estiver configurado para gerar o título de pedágio no fechamento da viagem, ao efetuarmos o fechamento, será enviada a mensagem ao ERP Datasul solicitando a geração do título financeiro do tipo pedágio. Porém, a data de vencimento do título deverá ser a mesma data da geração.

 

Procedimento para Configuração

CONFIGURAÇÃO DE PARÂMETROS

  1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:

Itens/Pastas

Descrição

Nome:

MV_TMSERP

Tipo:

Caracter

Cont. Por.:

1

Descrição:

ERP que está integrado ao SIGATMS.

0 - Protheus, 1 - Datasul.           

 

CONFIGURAÇÃO DE ADAPTER'S EAI

2.  No Configurador (SIGACFG), acesse Ambientes/Schedule/Adapter E.a.i.(CFGA020). Cadastre os Adapter's a seguir: 

Mensagem Unica

1-Sim

Rotina

TMSA240

Mensagem

TRANSPORTDOCUMENT

Descrição

COMPLEMENTO DA VIAGEM

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio2.000

Mensagem Unica

1-Sim

Rotina

TMSA250

Mensagem

TRANSPORTDOCUMENT

Descrição

CONTRATO CARRETEIRO

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio2.000

Mensagem Unica

1-Sim

Rotina

TMSA310

Mensagem

TRANSPORTDOCUMENT

Descrição

FECHAMENTO DA VIAGEM

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio2.000

Mensagem Unica

1-Sim

Rotina

TMSA330

Mensagem

TRANSPORTDOCUMENT

Descrição

FECHAMENTO DE SEGURO

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio2.000

Mensagem Unica

1-Sim

Rotina

TMSA370

Mensagem

TRANSPORTDOCUMENT

Descrição

INDENIZACAO

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio2.000

Mensagem Unica

1-Sim

Rotina

TMSI250BX

Mensagem

TRANSPORTDOCUMENTSTATUS

Descrição

STATUS CONTRATO CARRETEIRO

Envia

2- Não

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio2.000

Procedimento para Utilização

Exemplo:

Envio Adiantamento Complemento de Viagem (TMSA240)

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (Mod2) (TMSA240).
  2. Selecione a opção "Incluir".
  3. Preencha os parâmetros de acordo com a necessidade e confirme.
  4. Informe os documentos que farão parte da viagem.
  5. Clique em Outras Ações e selecione a opção Comp. Via.
  6. Informe os dados de veículo e motorista da viagem.
  7. Clique em Outras Ações e selecione a opção Adiantam./Desp.
  8. No campo Cod. Despesa, informe uma despesa para o adiantamento de viagem.
  9. Informe o valor do adiantamento e selecione a opção Salvar.
  10. Confirme a inclusão do complemento da viagem e a inclusão da viagem.
    Na gravação o sistema Protheus irá disparar automaticamente uma mensagem para o adaptar EAI, que irá enviar ao financeiro do ERP Datasul realizando a integração dos dados.

 

Fechamento da Viagem: Envio Adiantamento e/ou Pedágio (TMSA310)

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens / Rod. Entrega / Fechamento (TMSA310).
  2. Posicione o cursor sobre a viagem que será realizado o fechamento e selecione a opção Fechar.
    Neste momento o sistema Protheus irá disparar automaticamente uma mensagem para o adapter EAI, que irá enviar ao financeiro do ERP Datasul realizando a integração dos dados.

 

Contrato de Carreteiro (TMSA250)

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato de Carreteiro (TMSA250).
    O sistema apresenta a tela dos contratos gerados.
  2. Selecione a opção Por Viagem.
  3. Preencha os parâmetros de geração do contrato, de acordo com a necessidade e confirme.
    Na geração o sistema Protheus irá disparar automaticamente uma mensagem para o adapter EAI, que irá enviar ao financeiro do ERP Datasul realizando a integração dos dados. 

Liberação Contrato de Carreteiro (TMSA251)

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Lib. Contratos (TMSA251).
  2. Na tela apresentada selecione a opção Parâm., para configurar os parâmetros de liberação do contrato conforme necessidade e confirme.
    Será apresentada a tela com os contratos para liberação.
  3. Selecione o contrato que deseja liberar e selecione a opção Liberar.
    Neste momento o sistema Protheus irá disparar automaticamente uma mensagem para o adapter EAI, que irá enviar ao financeiro do ERP Datasul realizando a integração dos dados.

 

Registro de indenização (TMSA370)

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Seguro / Reg. de Indenização (TMSA370).
  2. Selecione um registro em aberto.
  3. Clique em Outras Ações e selecione a opção Autoriza Pagto.
  4. Preencha os dados para gravação da autorização do pagamento conforme necessidade e confirme.
    Neste momento o sistema Protheus irá disparar automaticamente uma mensagem para o adapter EAI, que irá enviar ao financeiro do ERP Datasul realizando a integração dos dados.

 

Fechamento Seguro (TMSA330)

  1. Em Gestão de Transportes (SIGATMS), acesse Atualizações / Seguro / Fechamento (TMSA330).
  2. Selecione a opção Fechar.
  3. Preencha os parâmetros da rotina conforme necessidade e confirme.
    Neste momento o sistema Protheus irá disparar automaticamente uma mensagem para o adapter EAI, que irá enviar ao financeiro do ERP Datasul realizando a integração dos dados.