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 (SIGAFAT), fiscal (SIGAFIS), financeiro (SIGAFIN) e 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 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 outros. O SIGATMS controla todos os processos de um transportador, abrangendo as áreas: operacional, comercial, seguros, faturamento, logística e SAC. Solução totalmente integrada com a área administrativa (financeiro, fiscal e contábil).

Linha Datasul (BackOffice)

• Financeiro:
  • Contas a Pagar (APB):

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 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 (faturamento, fiscal, financeiro e contábil). Este documento especificamente apresenta os detalhes da integração do SIGATMS com o módulo Datasul: Contas a Pagar.

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

• Arquitetura (Tecnologia)
  • Integração através do EAI - Enterprise Application Integration com o padrão de Mensagem Única;

Escopo

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

Datasul

Protheus

Pré-requisitos necessários:

Instalação/Atualização

Datasul

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âmetro	Descrição	Valor
   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 (Este serviço é necessário para processamento das mensagens);
   
   

2. Configure a rota para o ambiente Datasul que será integrado, através da alteração dos parâmetros ou do cadastro de rotas:

   (Lib inferior a label 20170208)

   Parâmetro	Descrição	Valor
   MV_EAIWS	Nome do Client WS do EAI para envio a outro EAI.	WSEAIDATASUL
   MV_EAIURL2	Nome do canal configurado no EAI para envio a outro EAI.	http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente Datasul
   MV_EAIMETH	Método de envio do EAI para envio a outro EAI	receiveMessage
   MV_EAIXSD	Diretórios dos XSD usados na validação	<DIRETÓRIO XSD>
   MV_EAIUSER	Usuário para autenticação	<USUÁRIO>
   MV_EAIPASS	Senha para autenticação	<SENHA>

    

   (Lib igual ou superior label 20170208)
   Através do cadastro de rotas:

   1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;

   2. Ambiente / Schedule / Cadastro Rotas Eai;

      Produto	Aplicação	URL	Client WS	Método	Usuário	Senha
      DATASUL	<Aplicação Datasul>	http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente Datasul	WSEAIDATASUL	receiveMessage	<USUÁRIO>	<SENHA>

      
3. Realize o cadastro de De/Para de Empresas Mensagem Única:
   1. Acessar o ambiente Protheus / Programa inicial: SIGACFG;

   2. Ambiente / Schedule / Emp.filial Mensagem Única

      Referência	Company	Branch	Emp.Protheus	Fil.Protheus
      DATASUL	<EMPRESA DATASUL>		<EMPRESA PROTHEUS>	<FILIAL PRINCIPAL>

      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 o ambiente Protheus / Programa inicial: SIGACFG;
   2. Ambiente / Schedule / Adapter E.a.i;

   3. Cadastre os seguintes registros:

      Mensagem única?	Rotina	Mensagem	Descrição	Envia?	Recebe?	Método	Operação	Canal Envio	XSD	Versão Envio
      1 - Sim	TMSA240	TRANSPORTDOCUMENT	COMPLEMENTO DA VIAGEM	1 - Sim	1 - Sim	1 - Síncrono	1 - Todas	2 - EAI		1.000
      1 - Sim	TMSA250	TRANSPORTDOCUMENT	CONTRATO CARRETEIRO	1 - Sim	1 - Sim	1 - Síncrono	1 - Todas	2 - EAI		1.000
      1 - Sim	TMSA310	TRANSPORTDOCUMENT	FECHAMENTO DA VIAGEM	1- Sim	1- Sim	1- Síncrono	1- Todas	2- EAI		1.000
      1 - Sim	TMSA330	TRANSPORTDOCUMENT	FECHAMENTO DE SEGURO	1- Sim	1- Sim	1- Síncrono	1- Todas	2- EAI		1.000
      1 - Sim	TMSA370	TRANSPORTDOCUMENT	INDENIZACAO	1- Sim	1- Sim	1- Síncrono	1- Todas	2- EAI		1.000
      1 - Sim	TMSI250BX	TRANSPORTDOCUMENTSTATUS	STATUS CONTRATO CARRETEIRO	2- Não	1- Sim	1- Síncrono	1- Todas	2- EAI		1.000

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

Fluxo das Informações

Processos

TMSA070  - Movimentos de Custo de Transporte

TMSA370 - Registro de Indenizações

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

Tmsa330 - Fechamento de Seguro

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.

TMSA250 - Contrato de Carreteiro

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

TMSA251 - Liberação do Contrato de Carreteiro

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

A geração do título de adiantamento da viagem passou a ocorrer em dois 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 a integração com o Datasul para geração do título no financeiro.

TMSA310 - Fechamento de Viagem

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.

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

Integração no modo síncrono: 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.

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

3. Cadastro de Adapter
   Para o correto funcionamento da integração deve-se cadastrar os adapters conforme a tabela de cadastro de adapter
   

4. Inclusão Viagem Entrega

   Acesse Atualizações / Viagens / Rodoviário Entrega / Viagem (Mod.2)
   
5. Na tela de browser exibida previamente, click no botão incluir ou pressione a tecla “i” para acessar a tela de inclusão da viagem.
   

   Caso solicitado informe a filial da viagem.

   
6. Informe os parâmetros da viagem
   

7. Uma vez na tela de viagem informe os campos conforme tabela de campos da viagem.
   

   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 no botão Outras Ações 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.
   

9. Será exibida a seguinte tela:
   
   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 de frete a terceiros através 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 fechada ou fracionada.
   Grid – Complemento da Viagem	Item	Sequencia do registro
   	Cod.Veículo	Informe o veículo que realizará o transporte
   	Modelo	Modelo do Veiculo 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 ser informado acessando Outras Ações / Adiantamento / Despesas.

Situações comuns

Erros de integração: