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: |
| ||||||||||||||||||||||||||||||
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: |
| ||||||||||||||||||||||||||||||
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
- 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étodo | 1- Síncrono |
Operação | 1- Todas |
Canal Envio | 2- EAI |
Versão de Envio | 2.000 |
Mensagem Unica | 1-Sim |
Rotina | TMSA250 |
Mensagem | TRANSPORTDOCUMENT |
Descrição | CONTRATO CARRETEIRO |
Envia | 1- Sim |
Recebe | 1- Sim |
Método | 1- Síncrono |
Operação | 1- Todas |
Canal Envio | 2- EAI |
Versão de Envio | 2.000 |
Mensagem Unica | 1-Sim |
Rotina | TMSA310 |
Mensagem | TRANSPORTDOCUMENT |
Descrição | FECHAMENTO DA VIAGEM |
Envia | 1- Sim |
Recebe | 1- Sim |
Método | 1- Síncrono |
Operação | 1- Todas |
Canal Envio | 2- EAI |
Versão de Envio | 2.000 |
Mensagem Unica | 1-Sim |
Rotina | TMSA330 |
Mensagem | TRANSPORTDOCUMENT |
Descrição | FECHAMENTO DE SEGURO |
Envia | 1- Sim |
Recebe | 1- Sim |
Método | 1- Síncrono |
Operação | 1- Todas |
Canal Envio | 2- EAI |
Versão de Envio | 2.000 |
Mensagem Unica | 1-Sim |
Rotina | TMSA370 |
Mensagem | TRANSPORTDOCUMENT |
Descrição | INDENIZACAO |
Envia | 1- Sim |
Recebe | 1- Sim |
Método | 1- Síncrono |
Operação | 1- Todas |
Canal Envio | 2- EAI |
Versão de Envio | 2.000 |
Mensagem Unica | 1-Sim |
Rotina | TMSI250BX |
Mensagem | TRANSPORTDOCUMENTSTATUS |
Descrição | STATUS CONTRATO CARRETEIRO |
Envia | 2- Não |
Recebe | 1- Sim |
Método | 1- Síncrono |
Operação | 1- Todas |
Canal Envio | 2- EAI |
Versão de Envio | 2.000 |
Procedimento para Utilização
Exemplo:
Envio Adiantamento Complemento de Viagem (TMSA240)
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (Mod2) (TMSA240).
- Selecione a opção "Incluir".
- Preencha os parâmetros de acordo com a necessidade e confirme.
- Informe os documentos que farão parte da viagem.
- Clique em Outras Ações e selecione a opção Comp. Via.
- Informe os dados de veículo e motorista da viagem.
- Clique em Outras Ações e selecione a opção Adiantam./Desp.
- No campo Cod. Despesa, informe uma despesa para o adiantamento de viagem.
- Informe o valor do adiantamento e selecione a opção Salvar.
- 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)
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Viagens / Rod. Entrega / Fechamento (TMSA310).
- 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)
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Contrato de Carreteiro (TMSA250).
O sistema apresenta a tela dos contratos gerados. - Selecione a opção Por Viagem.
- 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)
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Terceiros / Lib. Contratos (TMSA251).
- 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. - 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)
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Seguro / Reg. de Indenização (TMSA370).
- Selecione um registro em aberto.
- Clique em Outras Ações e selecione a opção Autoriza Pagto.
- 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)
- Em Gestão de Transportes (SIGATMS), acesse Atualizações / Seguro / Fechamento (TMSA330).
- Selecione a opção Fechar.
- 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.
- documento_tecnico
- integracao_tms_datasul
- versao_12_1_17
- financas_apb
- mv_tmserp
- protheus
- logistica
- sigatms
- gestao_de_transportes
- datasul
- logtms01_1100
- integracao_protheus_sigatms_erp_datasul_financas_apb
- contas_a_pagar
- p12
- eai
- tmsa240
- complemento_da_viagem
- tmsa250
- contrato_carreteiro
- tmsa310
- fechamento_da_viagem
- tmsa330
- fechamento_de_seguro
- tmsa370
- indenizacao
- mp_tmsoms_inov