Páginas filhas
  • DI_SIGATMS_x_Datasul_Contas_a_Pagar

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

INTEGRAÇÃO PROTHEUS SIGATMS X DATASUL CONTAS A PAGAR

Contexto de negócio (Introdução)

Cada vez mais as empresas necessitam gerenciar e otimizar sua logística e conforme legislação, necessitam do papel de uma Transportadora. Por isto, há uma busca por softwares de Gestão de Transportes que controlem os processos e operações de uma Transportadora. O módulo SIGATMS da linha Microsiga Protheus é a solução TOTVS para este cenário de mercado. Em relação aos clientes desta linha, o módulo já possui integração nativa com os módulos de BackOffice como, faturamento Faturamento (SIGAFAT), fiscal Fiscal (SIGAFIS), financeiro Financeiro (SIGAFIN) e contábil Contábil (SIGACTB). Já em relação aos clientes da linha Datasul, o módulo SIGATMS não possuía integração. 


Sistemas Envolvidos

Linha Microsiga Protheus

  • SIGATMS (Transportation Management System): sistema  Sistema de gerenciamento de transportes, que tem como objetivo principal controlar todos os processos fiscais e gerenciais envolvidos na operação de transportes, bem como, controlar os veículos, motoristas, fretes e viagens da empresa e de terceiros, entre as atividades mais importantes destacam-se controle das despesas dos veículos, viagens, fretes, emissão de CTRC (Conhecimento de Transporte Rodoviário de Cargas), nota fiscal de serviço, manifesto e entre outros. O SIGATMS controla todos os processos de um transportador, abrangendo as áreas: operacionalOperacional, comercialComercial, segurosSeguros, faturamentoFaturamento, logística Logística e SAC. Solução totalmente integrada com a área administrativa (financeiroFinanceiro, fiscal Fiscal e contábilContábil).

Linha Datasul (BackOffice)

  • Financeiro:
    • Contas a Pagar (APB): 
    • O Módulo de Contas a Pagar objetiva-se em permitir um efetivo controle dos compromissos a serem pagos pela organização, possibilitando a movimentação dos documentos, desde a implantação até o pagamento total deste, e sua eliminação do banco de dados. Maiores detalhes, consultar: APB - Contas a Pagar


Integração

O módulo SIGATMS da linha Microsiga Protheus possui integração nativa com os módulos de BackOffice de mesma linha como, Faturamento (SIGAFAT), Fiscal (SIGAFIS), Financeiro (SIGAFIN) e Contábil

Integração

O módulo SIGATMS da linha Microsiga Protheus possui integração nativa com os módulos de BackOffice de mesma linha como, faturamento (SIGAFAT), fiscal (SIGAFIS), financeiro (SIGAFIN) e contábil (SIGACTB).

Existem clientes da linha Datasul que demandam a necessidade de utilização de um módulo de Gestão de Transportes como o SIGATMS, porém, mantendo os módulos de BackOffice da linha Datasul.

Para que seja possível atender esta demanda e possibilitar uma nova oferta de mercado TOTVS, através por meio desta integração será possível a utilização do módulo SIGATMS da linha Microsiga Protheus integrado aos módulos de BackOffice da linha Datasul (faturamentoFaturamento, fiscalFiscal, financeiro Financeiro e contábilContábil). Este documento especificamente apresenta os detalhes da integração do SIGATMS com o módulo Datasul: Contas a Pagar Finanças APB.

  • Premissas
    • Integrar o módulo SIGATMS da linha Protheus com o módulo financeiro do BackOffice Financeiro do BackOffice Datasul: Contas a Pagar;.
 
    • .


Escopo

Image RemovedImage Added

Pré-requisitos instalação/implantação/utilização

Datasul

 

Protheus

 

Versão mínima12.1.18
Módulo implantadoAPB - Contas a Pagar
Ferramentas necessáriasConfiguração do WebService do EAI2

Protheus

Pré-requisitos necessários:

Versão mínima12.1.
17
18
Módulo implantadoSIGATMS - Gestão de Transportes
Funcionalidades implantadas

Contrato de Carreteiro

Viagem Rodoviária

Indenizações

Ferramentas necessárias¹ Servidor WebServices Protheus iniciado
 

Schedule Protheus configurado
Aviso

¹ Ajuste o timeout do servidor HTTP, na qual o WebService Protheus estará para acima de 15 minutos (900 segundos).

  1. Acessar o ambiente Protheus / Programa inicial: APWEBWIZARD;
  2. Servidor Internet (HTTP/FTP) / HTTP;
  3. Altere o parâmetro: TimeOut de Sessions WEBEX para 900;.

Instalação/Atualização

Datasul

Configurações Iniciais

  1. Realizar as configurações descritas para o Datasul no documento: DI_SIGATMS_x_Datasul_Cadastros

Configurações EAI

  1. Toda a configuração do EAI Datasul será feita através do TOTVS Monitor, que é acessado através do caminho: http://<HOST-DATASUL>:<PORTA>/totvs-monitor

  2. Configurar no EAI do Datasul as mensagens de Transação do Contas a Pagar que serão trocas com o Protheus:
    1. A configuração é feita através do caminho: TOTVS Monitor / EAI2 / Aplicação Interna / Transações Disponíveis;

    2. As mensagens deverão ser configuradas conforme tabela abaixo:

      Transação

      Versão

      Modo Habilitado

      TransportDocument2.000Recebimento
      TransportDocumentStatus2.000Envio
  3. Configurar as Rotas de Envio para as Transações que serão enviadas ao Protheus.

    1. A configuração é feita através do caminho: TOTVS Monitor / EAI2 / Aplicação Interna / Rotas de Envio;

    2. Importante: para que seja possível realizar este procedimento, é necessário que previamente as transações estejam atualizadas do lado do Protheus, conforme descrito neste manual;
    3. Deverá ser selecionado no combo-box "Aplicação Externa" a aplicação que representa o Protheus;

    4. Para a transação "TransportDocumentStatus", deve ser selecionada e marcada a opção "Habilitado". 

Configurações Gerais 

  1. No processo de integração de Contrato de Carreteiro do TMS Protheus para o Contas a Pagar Datasul, serão calculados impostos relacionados ao Fornecedor do Contrato. Portanto, todos os fornecedores envolvidos no processo, sejam pessoas Jurídicas ou Físicas, deverão ser alterados para indicar que realizam a retenção de impostos, para isto, deve ser seguido os passos abaixo:
    1. No Menu do Datasul, acessar o programa "Fornecedor Financeiro"; 
    2. Posicionar no Fornecedor relacionado ao processo e modificar;
    3. Marcar a opção "Retém Imposto";
    4. Repetir estes passos, para todos os Fornecedores envolvidos no processo.
  2. O TMS Protheus pode ser configurado para indicar onde deverão ser calculados os Impostos dos Contatos. As opções possíveis são: "Através da Operadora de Frete" ou "Através do Contas a Pagar do Datasul". Conforme a opção determinada no TMS Protheus, é necessário realizar parametrizações diferenciadas no Contas a Pagar Datasul, conforme abaixo:
    1. Cálculo dos Impostos através da Operadora de Frete:
      1. Como o imposto será calculado pela Operadora de Frete, ela deverá fazer o controle de Limite Máximo de INSS para os Fornecedores que são Pessoa Física. Desta forma, o Contas a Pagar deve ser alterado para não realizar este controle para os Fornecedores. Para isto, deve-se, através do Menu do Datasul, acessar o programa "Fornecedor (Financeiro)", posicionar no Fornecedor relacionado ao processo (pessoa Física), modificar, desmarcando a opção "Controla Limite Máx.Ret.". Este processo deve ser repetido para todos os Fornecedores que são Pessoa Física e estão relacionados ao processo.
      2. Além disto, também deverão ser vinculados todos os impostos aos Fornecedores envolvidos no processo. Para isto, deve-se, através do Menu do Datasul, acessar o programa "Fornecedor Financeiro", posicionar no Fornecedor relacionado ao processo e ir no Botão "Movimentos". Para Fornecedores que são Pessoa Jurídica, deverão ser vinculados os impostos do tipo "IRRF" e "ISS". Para Fornecedores que são Pessoa Física, deverão ser vinculados os impostos do tipo "IRRF", "INSS", "ISS", "SEST" e "SENAT". Este processo deve ser repetido para todos os Fornecedores que estão relacionados ao processo. Importante: Para que a integração dos impostos ocorra corretamente, o campo "% Redução", deve ser informado seguindo as regras vigentes do governo, conforme cada tipo de imposto.
    2. Cálculo dos Impostos através do Contas a Pagar Datasul:
      1. Serão considerados para cálculo, todos os Impostos que estiverem vinculados ao Fornecedor e que forem obrigatórios. Portanto, deverão ser vinculados todos os impostos aos Fornecedores envolvidos no processo;
      2. Para isto, deve-se, através do Menu do Datasul, acessar o programa "Fornecedor Financeiro", posicionar no Fornecedor relacionado ao processo e ir no Botão "Movimentos". Para Fornecedores que são Pessoa Jurídica, deverão ser vinculados os impostos do tipo "IRRF" e "ISS". Para Fornecedores que são Pessoa Física, deverão ser vinculados os impostos do tipo "IRRF", "INSS", "ISS", "SEST" e "SENAT". Este processo deve ser repetido para todos os Fornecedores que estão relacionados ao processo. Importante: Para que o cálculo dos impostos ocorra corretamente, a opção "Opcional" deve estar desmarcada, e o campo "% Redução", deve ser informado seguindo as regras vigentes do governo, conforme cada tipo de imposto.
  3. Na integração do TMS Protheus com o Contas a Pagar do Datasul, poderão ser integrados diversos Tipos de Documentos, que chamamos de Documentos de Transporte.
    1. Abaixo segue a lista dos Documentos de Transporte possíveis:

      Documento de Transporte

      DescriçãoTipo de Título gerado no Contas a Pagar
      AdiantamentoValor de adiantamento pago ao Fornecedor do ContratoAntecipação
      PedágioValor de Pedágio a ser Pago para a ViagemNormal
      Contrato CarreteiroValor de Frete a PagarNormal
      Contrato ComplementarValor que é adicionado a um Contrato que já esta em trânsitoNormal
      Indenização de TransporteValores adicionais pagos ao FornecedorNormal
      Seguro de TransporteValor de Seguro pago para o ContratoNormal
      Custo de TransporteValores que serão descontados do FornecedorAntecipação ou Nota de Crédito
      Taxa de Operador de FreteValor pago a Operadora de FreteNormal
      Provisão de Frete a PagarValor inicial da Viagem, representa uma visão Futura do Frete a PagarProvisão
      ReembolsoValores adicionais pagos ao FornecedorNormal
  4. É possível parametrizar o Contas a Pagar Datasul, para indicar quais serão as informações utilizada para geração do Título, para cada Tipo de Documento de Transporte. Isto é feito através dos seguintes cadastros:
    1. Pagamento Padrão: Cadastro que possibilita definir informações padrões para geração do Título, tais como Espécie, Série, Portador, Despesas Financeiras e Rateio Contábil.
    2. Seleção de Pagamento Padrão: Cadastro que permite parametrizar qual Pagamento Padrão será utilizado para geração do Título com base nas informações de Tipo de Documento de Transporte, Estabelecimento e Fornecedor. O cadastro poderá ser feito de forma mais genérica, por exemplo deixando o Código do Fornecedor em branco, desta forma, independente do Fornecedor, será utilizado sempre o mesmo Pagamento Padrão. Ou, ser feito de forma mais especifica, por exemplo informando um Código de Fornecedor, desta forma, sempre que for gerado um Documento de Transporte para aquele Fornecedor, será utilizado um Pagamento Padrão diferente, podendo gerar títulos com características diferente, por exemplo, com outra Espécie.

    3. Portanto, deve ser criado um Pagamento Padrão e uma Seleção de Pagamento para cada Tipo de Documento de Transporte.

    4. Importante: Quando o sistema estiver parametrizado para que o cálculo dos impostos seja realizado pelo Contas a Pagar, os Documentos de Transporte que devem gerar impostos, devem estar com a opção "Calcula Imposto" marcada no Pagamento Padrão correspondente. 
  5. Para alguns tipos de Documento de Transporte, é possível criar uma Seleção de Pagamento Padrão diferenciada conforme a Origem do Documento. Por exemplo, no caso do Seguro de Transporte, podemos ter três origens, desta forma, é possível fazer uma seleção para cada um deles, apontando para um Pagamento Padrão diferente, desta forma, gerado o título com características diferentes. Esta distinção é feita através do campo "Código Transação" da Seleção Padrão. Se for deixado em branco, sempre irá utilizar o mesmo Pagamento Padrão, se tiver algum valor, e seja o mesmo enviado pelo TMS Protheus, será utilizado aquele registro específico. Segue abaixo, a lista dos Documentos de Transporte que possuem esta particularidade e a respectiva informação que é envida para parametrizar o Código da Transação, caso necessário.

    Documento de TransporteOrigemCódigo Transação
    Provisão de Frete a PagarGeração da Viagem101
    Fechamento da Viagem102
    Adiantamento, Pedágio, Taxa de Operador de Frete e ReembolsoGeração da Viagem101
    Fechamento da Viagem102
    Contrato de Carreiro201
    Custo de Transporte
    Geração da Viagem101
    Fechamento da Viagem102
    Contrato de Carreiro201
    Custo de Transporte501
    Seguro de TransportePremiação401
    RCF-DC402
    RCTR-C403
  6. Para mais detalhes sobre as configurações, acessar a FAQ: http://tdn.totvs.com/x/3yocEQ


Protheus

Parâmetros de Integração

  1. Acesse o ambiente Protheus / Programa inicial: SIGACFG;
  2. Ambiente / Cadastros / Parâmetros;
  3. Busque e altere os parâmetros:

    ParâmetroDescriçãoValor
    MV_TMSERP

    ERP que está integrado ao SIGATMS.

    0 - Protheus, 1 - Datasul.

    1

Configurações EAI

  1. Cadastre um agendamento no Schedule para a rotina FWEAI, de forma que fique sempre ativo.

 

Protheus

Parâmetros de Integração

  1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;
  2. Ambiente / Cadastros / Parâmetros;
  3. Busque e altere os parâmetros:

    ParâmetroDescriçãoValor
    MV_TMSERPERP que está integrado ao SIGATMS. 0 - Protheus, 1 - Datasul.1

Configurações EAI

  1. Cadastre um agendamento no Schedule para a rotina FWEAI de forma que fique sempre ativo (Este serviço é necessário para processamento das mensagens);
  2. Configure a rota para o ambiente Datasul que será integrado, através por meio da alteração dos parâmetros ou do cadastro de rotas:


(Lib inferior a label 20170208)

ParâmetroDescriçãoValor
MV_EAIWSNome do Client WS do EAI para envio a outro EAI.WSEAIDATASUL
MV_EAIURL2Nome do canal configurado no EAI para envio a outro EAI. http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente Datasul
MV_EAIMETHMétodo de envio do EAI para envio a outro EAIreceiveMessage
MV_EAIXSDDiretórios dos XSD usados na validação<DIRETÓRIO XSD>
MV_EAIUSERUsuário para autenticação<USUÁRIO>
MV_EAIPASSSenha para autenticação<SENHA>

 


(Lib igual ou superior label 20170208)

  1. Através Por intermédio do cadastro Cadastro de rotasRotas: Acessar
    1. Acesse o ambiente Protheus / Programa inicial: SIGACFG;
    2. Ambiente / Schedule / Cadastro Rotas Eai;

      ProdutoAplicaçãoURLClient WSMétodoUsuárioSenha
      DATASUL<Aplicação Datasul>http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente DatasulWSEAIDATASULreceiveMessage<USUÁRIO><SENHA>
  2.    
  3. Realize o cadastro de De/Para de Empresas Mensagem Única:
    1. Acessar Acesse o ambiente Protheus / Programa inicial: SIGACFG;
    2. Ambiente / Schedule / Emp. filial Mensagem Única.

      ReferênciaCompanyBranchEmp.ProtheusFil.Protheus
      DATASUL<EMPRESA DATASUL>
       
      <EMPRESA PROTHEUS><FILIAL PRINCIPAL>
      Informações
      Cadastre o De/Para para todas as empresas que possuírem integração
  4. Devem ser realizados os seguintes cadastros de adapters EAI:
    1. Acessar Acesse o ambiente Protheus / Programa inicial: SIGACFG;
    2. Ambiente / Schedule / Adapter E.a.iEai;
    3. Cadastre os seguintes registros:

      Mensagem única?

      RotinaMensagemDescriçãoEnvia?Recebe?MétodoOperaçãoCanal EnvioXSDVersão Envio
      1 - SimTMSA240TRANSPORTDOCUMENTCOMPLEMENTO DA VIAGEM1 - Sim
      1 - Sim1 - Síncrono; 2 - Assíncrono1 - Todas2 - EAI
       1
      2.000
      1 - SimTMSA250TRANSPORTDOCUMENT

      CONTRATO CARRETEIRO

      1 - Sim1 - Sim1 - Síncrono; 2 - Assíncrono1 - Todas2 - EAI
       1
      2.000
      1 - SimTMSA310TRANSPORTDOCUMENTFECHAMENTO DA VIAGEM1- Sim1- Sim1 - Síncrono; 2 - Assíncrono1- Todas2- EAI
       1
      2.000
      1 - SimTMSA330TRANSPORTDOCUMENTFECHAMENTO DE SEGURO1- Sim1- Sim1 - Síncrono; 2 - Assíncrono1- Todas2- EAI
       1
      2.000
      1 - SimTMSA370TRANSPORTDOCUMENT

      INDENIZACAO

      1- Sim1- Sim1 - Síncrono; 2 - Assíncrono1- Todas2- EAI
       1
      2.000
      1 - SimTMSI250BXTRANSPORTDOCUMENTSTATUSSTATUS CONTRATO CARRETEIRO
       

      2- Não

       

      1- Sim

      1 - Síncrono; 2 - Assíncrono1- Todas2- EAI
       1
      2.000
      Aviso
      titleObservação (Lib igual ou superior label 20170208)
      Vincule a rota criada do produto Datasul e indique o campo Envia como Sim para todos os adapters que enviam mensagem (Envia? 1 - Sim).

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

 


Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim, as equipes de suporte dos produtos SIGATMS Protheus e BackOffice BackOffice Datasul estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso. 


Transações/Entidades/Mensagens únicas

Método

ID

Descrição

Origem

Destino

XSD (versões podem variar)       

Processos

01Complemento da Viagem
ProtheusDatasul
 TransportDocument
TransportDocument_
1
2_000.xsd
02Contrato de Carreteiro
ProtheusDatasul
 
TransportDocument_
1
2_000.xsd
 
03Fechamento da ViagemProtheusDatasulTransportDocument_
1
2_000.xsd
04Fechamento de SeguroProtheusDatasulTransportDocument_
1
2_000.xsd
05IndenizaçãoProtheusDatasulTransportDocument_
1
2_000.xsd
06Status Contrato CarreteiroDatasulProtheus

TransportDocumentStatus_

1

2_000.xsd

Fluxo das Informações

Image RemovedImage Added

Processos

TMSA070  - Movimentos Movimentos de Custo de Transporte (TMSA070)

Quando o 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.


TMSA370 - Registro de Indenizações (TMSA370)

Através Por meio da rotina de 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.

Image RemovedImage Added


Tmsa330 - 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á , já que a mesma será realizada automaticamente pelo ERP Datasul.

Image RemovedImage Added


TMSA250 - Contrato de Carreteiro (TMSA250)

Quando o módulo 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 ref. referente ao adiantamento e pedágio também poderão ser gerados neste momento no ERP Datasul.

Informações
titlePagamento Saldo

Com a integração ativa, a rotina de pagamento de saldo do carreteiro não poderá mais ser acessada pelo transportador. Já , 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, através por meio do EAI.


TMSA251 - 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.


TMSA240 - Complemento de Viagem (TMSA240)

A geração do título de adiantamento da viagem passou a ocorrer em dois três momentos de acordo com a configuração realizada no contrato do fornecedor 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á realizado realizada a integração com o Datasul para a geração do título no financeiro.


Image RemovedImage Added

TMSA310 - 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.

_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.


Status de Pagamento do Contrato

Sempre que um título for baixado no ERP Datasul, total ou parcialmente, será enviando uma mensagem ao TMS Protheus, indicando o valor de Saldo do Título de Frete. Através desta informação, o TMS Protheus irá atualizar o Status do Contrato, indicando se ele está totalmente pago ou não.

Tipo de Fluxo: Datasul > Protheus
Mensagem: TransportDocumentStatus_2_000
Versão: 2.000
Modo: Assíncrono


Integração no modo assíncrono: Ao Integração no modo assíncrono: ao ser disparada, a mensagem será enviada ao EAI Protheus para que seja processada pela agenda do programa FWEAI programa FWEAI no Schedule. Ao processar a mensagem, será enviada ao EAI Datasul que por sua vez irá processar a mensagem conforme agenda do programa Registrar Fila do EAI2 no RPW (BTB948AA).

AvisoÉ estritamente necessário que o Schedule Protheus e RPW Datasul estejam corretamente configurados para o processamento no modo assíncrono

.

Integração no modo síncrono: ao Ao ser disparada, a mensagem será enviada pelo EAI Protheus diretamente ao EAI Datasul, que irá processar e retornar a resposta. O processo que disparou a mensagem fica aguardando até o retorno da resposta do ambiente destino para dar continuidade em sua execução. 

Aviso
É estritamente necessário que o Schedule Protheus e RPW Datasul, estejam corretamente configurados para o processamento no modo Síncrono ou Assíncrono.

Limitações / Restrições Gerais 

Como fazer

  1. Integração TMS x Contas a Pagar
    Os procedimentos para utilização do processo de integração entre o módulo SIGATMS com o BackOffice Datasul, estão descritos no documento técnico técnico Integração Protheus x Datasul Finanças APB
  2. Ativar parâmetro de Integração com Datasul
    Para que a integração seja ativa, é necessário habilitar via parâmetro MV_TMSERP == 1, conforme tela abaixo:
    Acesse via Configurador: (SIGACFG): Ambiente - > Cadastros ->Parâmetros > Parâmetros
    Image RemovedImage Added
  3. Cadastro de Adapter
    Para o correto funcionamento da integração, deve-se cadastrar os adapters conforme a tabela de cadastro de adapter
    Image RemovedImage Added
  4. Inclusão Viagem Entrega
    Acesse: Atualizações / Viagens / Rodoviário Entrega / Viagem (Mod.2)
    Image RemovedImage Added
  5. Na tela de browser exibida apresentada previamente, click no botão incluir Image Removedclique no botão Image Addedou pressione a tecla “i” para acessar a tela de inclusão da viagem.

    Caso solicitado, informe a filial da viagem.

    Image RemovedImage Added
  6. Informe os parâmetros da viagem
    Image RemovedImage Added
  7. Uma vez na tela de viagem informe os campos conforme tabela de campos da viagem

    . Image Removed
    Image Added

    Tabela de Campos da Viagem

    Campo

    Conteúdo / Descrição

    Fil.Origem

    Preenchimento com a filial logada

    Viagem*

    Sequência automática da numeração

    Rota*

    Informe uma rota previamente cadastrada

    Observação

    Texto Livre

    Grid de Documentos

    da Viagem

    Se existir documento calculado e autorizado pela SEFAZ,

    inclua o documento de transporte pressionando a tecla F3 no campo Fil.Docto.

    Após o preenchimento dos campos citados anteriormente pela tabela de campos da Viagem, será necessário informar os veículos e motoristas conforme os tópicos seguintes.


  8. Veículos da Viagem
    Ainda na tela que contém as informações da viagem, no canto superior direito da tela, click clique no botão Outras Ações Image Removed Image Added, e em seguida em Comp.Via para acessar a interface de Complemento da Viagem, por onde podemos
    informar os veículos que serão utilizados para realizar o transporte da carga.
    Image Removed
    Image Added
  9. Será exibida apresentada a seguinte tela:
    Image RemovedImage Added
  10. Preencha os campos conforme tabela de campos de complemento

 Pastas / Abas

Campos

Conteúdo/Descrição

Planejamento

Data Inicio

Data de Início prevista para a viagem.

Hora Inicio

Horário de Início previsto para viagem.

Data Fim

Data de Término prevista da viagem.

Hora Fim

Hora de Término prevista da viagem.

Tempo Viag.

Período de transporte da carga, todo o ciclo.

Operadoras de Frota

Cod.Operad.

Código da Operadora de Frete e Pedágio. Deverá ser preenchido para realizar adiantamentos de frete, pagamentos

de pedágio e

 adiantamentos

adiantamentos de frete a terceiros

através de

, por meio de uma operadora.

Nome Operad.

Descrição da operadora de fretes.

N.oProc.Tr.

 


Ped.Com.Oper

 


Outros

Tipo Carga

Informe se a

carga e

carga é fechada ou fracionada.

Grid – Complemento da Viagem

Item

Sequencia

Sequência do registro.

Cod.Veículo

Informe o veículo que realizará o transporte.

Modelo

Modelo do

Veiculo

Veículo informado no cadastro do veículo.

Proprietário

Descrição do proprietário do veículo.

Cod.1° Reboq.

Informe o código do 1° Reboque se houver.

Cod.2° Reboq.

Informe o código do 2° Reboque se houver.

Qtde Eixos

Quantidade de Eixos, soma dos eixos dos veículos informados pelos campos Cod.Veiculo + Cod.1° Reboq. + Cod.2°Reboq.

Grid – Complemento da Viagem

INSS Retido

Valor do INSS retido. Este campo somente poderá ser preenchido caso o veículo informado seja frota de

"Terceiro" ou "Agregado". Utilizado para informar o INSS retido referente a serviços de transporte prestados pelo motorista em

outras transportadoras. O valor informado, será somado ao valor do INSS calculado em relação ao valor do frete a ser recebido no

contrato de carreteiro.

 

Pedágio

Valor do Pedágio vinculado a rota ou digitado.

Credor Adto e Loja Credor

Credor do Adiantamento

;

. É o responsável pelo dinheiro (referente ao adiantamento) dado ao Carreteiro

;

. Na Geração do Contrato

do Carreteiro, será gerado, para o Credor do Adiantamento, Contas a Pagar com o Valor do Adiantamento efetuado ao carreteiro.

Adiantamento

Valor do adiantamento,

devera

deverá ser informado acessando Outras Ações / Adiantamento / Despesas.

  

  1. Informando o Motorista da Viagem

    Acesse pelo botão Outras Ações Relacionadas / Mot.Viag.

    Será exibida apresentada a janela tela para informar o(s) motorista(s) da viagem.
    Image RemovedImage RemovedImage AddedImage Added

    Tabela de Campos do Motorista da viagem:

    Campos

    Conteúdo/Descrição

    Cd.Motorista

    Código do motorista que será relacionado a viagem, da rotina cadastro de motoristas.

    Motorista

    Descrição do Motorista.

    Tp.Motorista

    Tipo do Motorista: Frota, Agregado ou Terceiro.

    Lib.Seguro

    Número da liberação de seguro para o motorista. Esta informação é passada pela seguradora

    e informada no sistema.

    Val.Segurado

    Valor liberado pelo seguro para este motorista

    , importante

    . Importante lembrar que caso o valor liberado para

    o motorista seja menor do que o valor contido na viagem, a viagem será bloqueada.

    Id.Motorista

    Id do Motorista junto a Operadora de Frota (

    Cartao

    Cartão, Bilhete,

    etc

    entre outros).

    Tp.Condutor

    Informe se o motorista é o condutor principal ou auxiliar.

    Meio Pg.Frt.

    Campo de integração com o sistema Pamcard. Informar o meio de pagamento ao favorecido, sendo cartão para Pessoa Física e Conta deposito para Pessoa Jurídica.

    Quando existir valor do pedágio para a viagem e for Pessoa Jurídica a opção tem que ser Ambos, pois o valor do pedágio será creditado no cartão indicado e o valor

    do frete será depositado no banco/agencia/conta indicados no cadastro

    o

    do favorecido na tabela de fornecedores. Para frota

    própria/

    Própria, Terceiros e Agregados pessoa física

    o único meio de pagamento que o sistema Pamcard disponibiliza neste momento

    é através

    , é por meio do cartão, não sendo permitido informar outro meio de pagamento.

    Para pessoa Jurídica o único meio de pagamento que o sistema Pamcard disponibiliza neste momento

    é através de

    , é por meio de Conta deposito e se a viagem tiver pedágio segue a

    regra acima informada e o meio de pagamento será

    “Ambos”

    Ambos.

    Tp.Pgt Pedag.

    Campo para integração com o sistema Pamcard. Informar quem será o responsável pelo pagamento do pedágio, se for

    através

    por meio do sistema Pamcard, informe a opção

    “5

    5=

    Pamcard”

    Pamcard.

    Meio Pg. Adto

    Informe se o pagamento será realizado em cartão ou deposito bancário.

    Pag.Diaria

    Utilizado no controle de diárias de motoristas do tipo próprio. Indica se haverá pagamento de diária para o motorista.

    Confirme após finalizar a digitação dos campos.

  2. Informando o adiantamento da Viagem

    Ainda na tela de complemento da viagem, é possível informar despesas e adiantamentos para o motorista.

    Acesse o botão de menu Outras Ações, localizado no canto superior direito da tela, uma vez nele click clique em Adiantam./Desp.
    Image RemovedImage Added

    Tabela de campos de adiantamento de viagens:

    Campos

    Conteúdo/Descrição

    Cod.Despesa

    Informe o código de uma despesa cadastrada previamente pelo cadastro de Despesas, pode ser acessado por Atualizações

    / Transportes / Despesas

    Valor Total

    Informe o valor da despesa/adiantamento.

    Valor Cobrado

    Informe o valor que será cobrado, se o valor for menor que o total será gerado um saldo para próxima viagem.

    Val. Baixado

    Valor que será baixado do total.

    Saldo

    Saldo do valor total, após informar o valor cobrado.

    Data Vencto

    Data de validade

    / Transportes / Despesas.

    Valor Total

    Informe o valor da despesa/adiantamento.

    Banco

    Código do Banco, deve estar previamente cadastrado pela interface de cadastro de banco. O cadastro de banco deve ser realizado pelo módulo financeiro em Atualizações / Cadastros / Bancos.

    • Quando informado o banco significa dizer que o valor lançado movimenta financeiro e será gerado um titulo no valor informado contra o Proprietário ou Favorecido.

    Agencia

    Ao informar  banco esse campo é preenchido automaticamente de acordo com o cadastro informado pelo campo Banco.

    Conta Banco

    Ao informar  banco esse campo é preenchido automaticamente de acordo com o cadastro informado pelo campo Banco.

    Num.Cheque

    Valor Cobrado

    Informe o valor que será cobrado, se o valor for menor que o total será gerado um saldo para próxima viagem.

    Val. Baixado

    Valor que será baixado do total.

    Saldo

    Saldo do valor total, após informar o valor cobrado.

    Data Vencto

    Data de validade da despesa/adiantamento

    Informe o número do cheque gerado

    .

    Tipo Despesa

    Despesa selecionada ou informada.

    Confirme o cadastro da despesa, confirme a tela de complemento de viagem, em seguida confirme a tela de inclusão da viagem.

    Neste momento se existir algum adiantamento/despesa que movimenta banco, será realizado o envio de uma mensagem ao adapter EAI configurado anteriormente para realização da integração com o ERP DATASUL com o valor do adiantamento lançado na viagem.

    Informações
    titleAtenção

    O não sucesso da Falha na integração impede que a viagem seja cadastrada no sistema, caso haja algum problema de integração da mensagem únicao adapter TMSA240, esteja cadastrado como Síncrono.

  3. Inclusão de Contrato de Carreteiro Por Viagem

    Acesse: Atualizações / Terceiros / Contrato de Carreteiro
    Na tela de Browser click clique no botão por Viagem Image Removed Image Added, será aberta uma janela tela de Confirmação do Calculo Cálculo do Frete Carreteiro de onde pode-se acessar alguns parâmetros conforme figura abaixo.
    Image RemovedImage Added

    Não confirme ainda, click clique no botão Param. da tela apresentada anteriormente , para abrir os parâmetros de configuração para geração do contrato de carreteiro, conforme exemplo.

    Image RemovedImage Added

    Após o preenchimento dos parâmetros click , clique no botão OK e em seguida em Ok novamente para o início do processamento do calculo cálculo do contrato de carreteiro.

    No término da Interação será exibida , será apresentada uma mensagem semelhante ao a demonstrado na figura a baixo:
    Image RemovedImage Added

 

 



Situações comuns

Erros de integração:

CódigoErroRota de integraçãoSituação
0Tradução EAI2 não encontrada!PROTHEUS>DATASULNão encontrada tradução para a TAG '&1' - Valor: &2.
360Tradução da Empresa &1 não encontrada na Matriz &2 !PROTHEUS>DATASUL

Cadastre na Matriz de Tradução de Unidade Organizacional Externa &2, a correspondente da empresa &1 no Datasul-EMS.

361Tradução do Estabelecimento &1 não encontrado na Matriz &2 !PROTHEUS>DATASULCadastre na Matriz de Tradução de Unidade Organizacional Externa &2, o correspondente do estabelecimento &1 no Datasul-EMS.
691Matriz da Unidade Organizacional não cadastrada !PROTHEUS>DATASULA Matriz da Unidade Organizacional informada não está cadastrada.
854Documento de Transporte já existente !PROTHEUS>DATASULJá existe uma ocorrência na tabela &1 para Estab: &3 e Número: &5 - SubTipo: &6.
7431Tabela Progressiva do imposto inválida para este período !PROTHEUS>DATASULVerifique no cadastro de Tabela Progressiva Imposto se há uma sequência de validade correspondente a data atual para a Tabela Progressiva &1.
8148Não existe tradução para a moeda !PROTHEUS>DATASULNão existe tradução para a moeda &1 na matriz &2.
10769Fornecedor Financeiro não cadastrado para a Empresa &1 !PROTHEUS>DATASULO Fornecedor financeiro &2, não está cadastrado para a Empresa &1.
11447Unidade de Federação não cadastrado!PROTHEUS>DATASULA unidade de federação &1 não existe para o País &2 nos cadastros do EMS5. Informe uma unidade de federação válida.
22359Seleção do Pagamento Padrão Inexistente ou Inválida !PROTHEUS>DATASULConsulte o cadastro de Seleção de Pagamento Padrão. Empresa: &8, Transação: &3, Cod Trans: &7, Estab: &4, Fornecedor: &6.
22360Rateio Padrão Pagamento não encontrado !PROTHEUS>DATASULNão foi encontrado Rateio Padrão para o Pagamento Padrão: &3.
22361Condição de Pagamento Inexistente !PROTHEUS>DATASULNão encontrada nenhuma Condição de Pagamento cadastrada para o Fornecedor: &2.
22384Fornecedor não encontrado !PROTHEUS>DATASULFornecedor da Empresa: &1, com CPF/CNPJ: &2 e Inscrição Estadual: &3, não está cadastrado.
22393Parâmetro POL não
econtrado
encontrado.PROTHEUS>DATASULParâmetro Plataforma Operador Logístico do Estabelecimento: &1, não encontrado.
22412Nenhum Título encontrado.PROTHEUS>DATASULNão foram encontrados Títulos relacionados ao Estab:  &1, Documento de Transporte: &2.
22413Título não encontrado.PROTHEUS>DATASULParâmetro Plataforma Operador Logístico do Estabelecimento: &1, não encontrado.
22428Erro ao Integrar o Documento !PROTHEUS>DATASULPara a Transação: &1, o valor do Documento deve ser maior que zero.
22429Erro ao Integrar o Documento !PROTHEUS>DATASULPara a Transação: &1, ao menos um dos valores de Documento de Transporte, Pedágio, Antecipação, Custo de Transporte, Taxa de Operador de Frete, devem ser maiores que zero.
22439País inexistente ou inválido !PROTHEUS>DATASULNão foi possível localizar o País com o código internacional &1 informado. Favor verificar na manutenção de país se existe um país com código do País DIRF igual ao código internacional &1 informado.
22450País inexistente ou inválido !PROTHEUS>DATASULCódigo internacional de País &1 não informado ou inválido.
22471Imposto do Fornecedor Financeiro &2 não
garado
gerado !PROTHEUS>DATASULVerifique na Manutenção de Fornecedor Financeiro se o Imposto do Tipo "&3" com País "&4", Unidade de Federação "&5" e Alíquota "&6" está vinculado ao Fornecedor Financeiro "&2" da Empresa "&1" ou existe algum bloqueio causado por Valor Máximo/Mínimo de retenção.
22478Tipo de Imposto &1 inválido !PROTHEUS>DATASULO Tipo de Imposto informado &1 é inválido, não existe um correspondente para a lista de impostos disponíveis no Cadastro de Impostos.
22479Não encontrada faixa de valor para Tabela Progressiva &1 !PROTHEUS>DATASULA Tabela Progressiva &1, Sequência de Validade &2, do Imposto &3, Classificação &4, não possui uma Faixa cadastrada para o valor do imposto &5. Verifique o Cadastros de Validade da Tabela Progressiva (utb104ab).
22482Parametrização do Fornecedor &1 inválida para Imposto &2 !PROTHEUS>DATASULPara receber Impostos do Tipo &2, o parâmetro "&3" não deve ser informado para o Fornecedor &1, Empresa &4. Verifique no Cadastro de Fornecedores (bas_fornecedor).