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.
Linha Microsiga Protheus
Linha Datasul (BackOffice)
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.
Pré-requisitos necessários:
Versão mínima | 12.1.17 |
---|---|
Módulo implantado | SIGATMS - Gestão de Transportes |
Funcionalidades implantadas | Contrato de Carreteiro |
Ferramentas necessárias | ¹ Servidor WebServices Protheus iniciado |
Schedule Protheus configurado |
¹ Ajuste o timeout do servidor HTTP na qual o WebService Protheus estará para acima de 15 minutos (900 segundos).
|
Busque e altere os parâmetros:
Parâmetro | Descrição | Valor |
---|---|---|
MV_TMSERP | ERP que está integrado ao SIGATMS. 0 - Protheus, 1 - Datasul. | 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);
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:
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> |
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 |
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). |
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.
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.
Método | ID | Descrição | Origem | Destino | XSD (versões podem variar) |
Processos | 01 | Complemento da Viagem | Protheus | Datasul | TransportDocument_1_000.xsd |
02 | Contrato de Carreteiro | Protheus | Datasul | TransportDocument_1_000.xsd | |
03 | Fechamento da Viagem | Protheus | Datasul | TransportDocument_1_000.xsd | |
04 | Fechamento de Seguro | Protheus | Datasul | TransportDocument_1_000.xsd | |
05 | Indenização | Protheus | Datasul | TransportDocument_1_000.xsd | |
06 | Status Contrato Carreteiro | Datasul | Protheus | TransportDocumentStatus_1_000.xsd |
TMSA070 - Movimentos de Custo de Transporte
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
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.
Com a integração ativa, a rotina de 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, através do EAI. |
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).
É 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 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.
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
Erros de integração:
Código | Erro | Rota de integração | Situação |
---|---|---|---|
0 | Tradução EAI2 não encontrada! | PROTHEUS>DATASUL | Não encontrada tradução para a TAG '&1' - Valor: &2. |
360 | Traduçã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. |
361 | Tradução do Estabelecimento &1 não encontrado na Matriz &2 ! | PROTHEUS>DATASUL | Cadastre na Matriz de Tradução de Unidade Organizacional Externa &2, o correspondente do estabelecimento &1 no Datasul-EMS. |
691 | Matriz da Unidade Organizacional não cadastrada ! | PROTHEUS>DATASUL | A Matriz da Unidade Organizacional informada não está cadastrada. |
854 | Documento de Transporte já existente ! | PROTHEUS>DATASUL | Já existe uma ocorrência na tabela &1 para Estab: &3 e Número: &5 - SubTipo: &6. |
7431 | Tabela Progressiva do imposto inválida para este período ! | PROTHEUS>DATASUL | Verifique no cadastro de Tabela Progressiva Imposto se há uma sequência de validade correspondente a data atual para a Tabela Progressiva &1. |
8148 | Não existe tradução para a moeda ! | PROTHEUS>DATASUL | Não existe tradução para a moeda &1 na matriz &2. |
10769 | Fornecedor Financeiro não cadastrado para a Empresa &1 ! | PROTHEUS>DATASUL | O Fornecedor financeiro &2, não está cadastrado para a Empresa &1. |
11447 | Unidade de Federação não cadastrado! | PROTHEUS>DATASUL | A 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. |
22359 | Seleção do Pagamento Padrão Inexistente ou Inválida ! | PROTHEUS>DATASUL | Consulte o cadastro de Seleção de Pagamento Padrão. Empresa: &8, Transação: &3, Cod Trans: &7, Estab: &4, Fornecedor: &6. |
22360 | Rateio Padrão Pagamento não encontrado ! | PROTHEUS>DATASUL | Não foi encontrado Rateio Padrão para o Pagamento Padrão: &3. |
22361 | Condição de Pagamento Inexistente ! | PROTHEUS>DATASUL | Não encontrada nenhuma Condição de Pagamento cadastrada para o Fornecedor: &2. |
22384 | Fornecedor não encontrado ! | PROTHEUS>DATASUL | Fornecedor da Empresa: &1, com CPF/CNPJ: &2 e Inscrição Estadual: &3, não está cadastrado. |
22393 | Parâmetro POL não econtrado. | PROTHEUS>DATASUL | Parâmetro Plataforma Operador Logístico do Estabelecimento: &1, não encontrado. |
22412 | Nenhum Título encontrado. | PROTHEUS>DATASUL | Não foram encontrados Títulos relacionados ao Estab: &1, Documento de Transporte: &2. |
22413 | Título não encontrado. | PROTHEUS>DATASUL | Parâmetro Plataforma Operador Logístico do Estabelecimento: &1, não encontrado. |
22428 | Erro ao Integrar o Documento ! | PROTHEUS>DATASUL | Para a Transação: &1, o valor do Documento deve ser maior que zero. |
22429 | Erro ao Integrar o Documento ! | PROTHEUS>DATASUL | Para 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. |
22439 | País inexistente ou inválido ! | PROTHEUS>DATASUL | Nã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. |
22450 | País inexistente ou inválido ! | PROTHEUS>DATASUL | Código internacional de País &1 não informado ou inválido. |
22471 | Imposto do Fornecedor Financeiro &2 não garado ! | PROTHEUS>DATASUL | Verifique 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. |
22478 | Tipo de Imposto &1 inválido ! | PROTHEUS>DATASUL | O Tipo de Imposto informado &1 é inválido, não existe um correspondente para a lista de impostos disponíveis no Cadastro de Impostos. |
22479 | Não encontrada faixa de valor para Tabela Progressiva &1 ! | PROTHEUS>DATASUL | A 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). |
22482 | Parametrização do Fornecedor &1 inválida para Imposto &2 ! | PROTHEUS>DATASUL | Para 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). |