INTEGRAÇÃO PROTHEUS SIGATMS X DATASUL - CONTAS A RECEBER

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 . 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 Receber (ACR):

- O Módulo de Contas a Receber visa auxiliar o gerenciamento administrativo, controlando movimentações de títulos e outros. Maiores detalhes, consultar: ACR - Contas a Receber

Integração

O módulo SIGATMS da linha Microsiga Protheus, possui integração nativa com os módulos de

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 Faturamento (SIGAFAT), fiscal Fiscal (SIGAFIS), financeiro Financeiro (SIGAFIN) e contábil 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ábil)Contábil).

Este documento especificamente apresenta os detalhes da integração do SIGATMS com o módulo Datasul: Contas a Receber.

Premissas
- Possibilitar a integração de cadastros principais como Produto, Cliente, Fornecedor, Transportador e Local de Entrega;
- Integrar o módulo SIGATMS da linha Protheus com os módulos de faturamento, fiscal, financeiro e contábil do BackOffice Datasulo módulo Financeiro do BackOffice Datasul: Contas a Receber;

Arquitetura (Tecnologia)

Integração

através

por intermédio do EAI - Enterprise Application Integration com o padrão de Mensagem Única;

Escopo

Image Added

Escopo

Office PowerPoint

name	PROTHEUS SIGATMS X DATASUL BACKOFFICE.pptx
width	800
height	450

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

Datasul

Protheus

Versão mínima	12.1.18
Módulo implantado	ACR - Contas a Receber
Ferramentas necessárias	Configuração do WebService EAI2

Protheus

Pré-requisitos necessários:

Versão mínima 12.1.
17
18
Módulo implantado SIGATMS - Gestão de Transportes
Funcionalidades implantadas Conhecimento de Transporte Eletrônico (Ct-e)
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).
Acessar o ambiente Protheus / Programa inicial: APWEBWIZARD;
Servidor Internet (HTTP/FTP) / HTTP;
Altere o parâmetro: TimeOut de Sessions WEBEX para 900;

InstalaçãoInstalação/Atualização

Datasul

Configurações Iniciais

Realizar as configurações descritas para o Datasul no documento: DI_SIGATMS_x_Datasul_Cadastros_restore

Configurações EAI

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
Configurar no EAI do Datasul as mensagens de Transação do Contas a Receber 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
  TransportInvoice 2.000 Recebimento
  TransportInvoiceStatus 2.000 Envio
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 "TransportInvoiceStatus", deve ser selecionada e marcada a opção "Habilitado".

Configurações Gerais

No Menu do Datasul, através do programa "Recebimento Padrão", deverá ser incluído um novo registro conforme abaixo:
1. Para cada Fatura gerada no TMS Protheus, será gerado um Título no Contas a Receber, portanto, deve ser informado no Recebimento Padrão, as informações que serão utilizadas para geração deste título, espécie, série, portador, carteira, etc...
2. A princípio, o Código do Cliente não precisa ser informado. Ele somente será informado, caso seja necessário gerar o Título com parametrizações diferentes para um determinado cliente.
No Menu do Datasul, através do programa "Seleção Recebimento Padrão", deverá ser realizada parametrização conforme abaixo:
1. Através deste programa, é realizada a parametrização para determinar qual Recebimento Padrão será utilizado para geração do Título no Contas a Receber, a partir da integração de Faturas do TMS Protheus;
2. Caso, o Título deve ser gerado sempre da mesma forma, pode ser criado um único registro de Seleção mais genérico, deixando os campos "Código Transação" e "Clientes" em branco e informado um único Recebimento Padrão;
3. Mas, também é possível criar parâmetros mais específicos, por exemplo, informando um Cliente, desta forma, na geração do Título, caso a Fatura seja para o cliente que está parametrizado, será utilizado o Recebimento Padrão informado para aquela Seleção. Caso seja outro cliente, será utilizado o Recebimento Padrão da parametrização mais genérica;
4. O campo "Código Transação" equivale ao Tipo de Documento do Conhecimento de Transporte parametrizado no TMS Protheus. Portanto, é possível criar uma Seleção de Recebimento Padrão diferenciada por Tipo de Conhecimento que faz parte da Fatura.
É possível parametrizar o Datasul para que, a cada Conhecimento (ou CT-e) registrado no TMS Protheus, seja criado um Título no Contas a Receber para representá-lo, para fazer isto deve-se:
1. Para as Naturezas de Operação que foram marcadas como "Natureza Transporte TMS" (conforme descrito no documento: DI_SIGATMS_x_Datasul_Faturamento_Fiscal) deve ser marcada a opção "Emite Duplicata";
2. Desta forma, para cada CT-e registrada no TMS Protheus, será realizada uma integração com o Faturamento do Datasul, para geração de uma Nota Fiscal, que posteriormente será integrada com o Contas a Receber para geração de um Título;
3. Caso o Datasul seja parametrizado desta forma, o Título gerado no Contas a Receber a partir da integração da Fatura do TMS Protheus, será criado a partir de uma Substituição, onde, os títulos de Origem serão os que foram criados a partir da Nota Fiscal criada no Faturamento a partir da CT-e.
Para mais detalhes sobre as configurações, acessar a FAQ: http://tdn.totvs.com/x/TiscEQ

Protheus

Parâmetros de Integração

Protheus

Alterações de Dicionário de Dados

Acessar o ambiente Protheus / Programa inicial: SIGACFG;
Base de Dados / Dicionário / Bases de Dados;
Altere o Grupo de Campos "Codigo Cliente/Fornecedor" para o tamanho 9, para que o campo fique equivalente ao do Datasul;
Deixe o Grupo de Campos "Loja Cliente/Fornecedor" com o tamanho 2. O conceito de loja não existe no Datasul;
Aviso
Lembre-se de ajustar o parâmetro MV_CLIGEN após realizar a alteração no Grupo de Campos.

Parâmetros de Integração

Acessar o ambiente Protheus / Programa inicial: SIGACFG;
Ambiente / Cadastros / Parâmetros;

Busque e altere os parâmetros:

Parâmetro	Descrição	Valor	Relação
MV_TMSERP	ERP que está integrado ao SIGATMS. 0 - Protheus, 1 - Datasul.	1	Geral
MV_TMSMFAT	Modo de Faturamento do TMS. 1- Faturamento a partir do SE1; 2- Faturamento a partir do DT6	2	Financeiro
MV_TMSOPEC	Código da natureza de operação do Datasul que será utilizado em CT-e Cortesia.	<COD NATUREZA DTS>	Faturamento/Fiscal
MV_TMSOPEN	Código da natureza de operação do Datasul que será utilizado em CT-e Normal.	<COD NATUREZA DTS>	Faturamento/Fiscal
MV_TMSOPNF	Código da natureza de operação do Datasul que será utilizado em Nota Fiscal.	<COD NATUREZA DTS>	Faturamento/Fiscal
MV_ESPECIE	Relação entre a série e o tipo de documento fiscal. Exemplo: 1=CTE;UNI=NF (Indica que a série "1" será de documento do tipo CTE e a série "UNI" será de nota fiscal	<SÉRIE=CTE/NF;>	Faturamento/Fiscal

Configurações EAI

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:

Acessar o ambiente Protheus / Programa inicial: SIGACFG;
Ambiente / Schedule / Cadastro Rotas Eai;
Produto Aplicação URL Client WS Método Usuário Senha
DATASUL PROTHEUS http://<HOST>:<PORTA>/eai2-ws/EAIService * Ambiente Datasul WSEAIDATASUL receiveMessage <USUÁRIO> <SENHA>

Realize o cadastro de De/Para de Empresas Mensagem Única:

Acessar o ambiente Protheus / Programa inicial: SIGACFG;
Ambiente / Schedule / Emp.filial Mensagem Única
Referência Company Branch Emp.Protheus Fil.Protheus
DATASUL <EMPRESA DATASUL> <EMPRESA PROTHEUS> <FILIAL PRINCIPAL>
Informações
Cadastre o De/Para para todas as empresas que possuírem integração

Devem ser realizados os seguintes cadastros de adapters EAI:

Acessar o ambiente Protheus / Programa inicial: SIGACFG;.
Ambiente / Cadastros / Parâmetros.
Busque e altere os parâmetros:
Parâmetro Descrição Valor
MV_TMSERP ERP que está integrado ao SIGATMS. 0 - Protheus, 1 - Datasul. 1
MV_TMSMFAT Modo de Faturamento do TMS. 1- Faturamento a partir do SE1; 2- Faturamento a partir do DT6 2

Configurações EAI

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, por meio 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)
Por intermédio do cadastro de rotas:

Acessar o ambiente Protheus / Programa inicial: SIGACFG.
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>

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>
  Informações
  Cadastre o De/Para, para todas as empresas que possuírem integração.
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 TMSA851 TRANSPORTINVOICE FATURA DE TRANSPORTE A RECEBER 1 - Sim 2 - Não
  Schedule / Adapter E.a.i;
  Cadastre os seguintes registros:
  Mensagem única?RotinaMensagemDescriçãoEnvia?Recebe?MétodoOperaçãoCanal EnvioXSDVersão Envio1 - SimTMSA851TRANSPORTINVOICEFATURA DE TRANSPORTE A RECEBER1 - Sim2 - Não1 - Síncrono1 - Todas2 - EAI 1.0001 - SimTMSI852TRANSPORTINVOICESTATUSSTATUS DA FATURA DE TRANSPORTE2 - Não1 - Sim2 - Assíncrono1 - Todas2 - EAI 1.0001 - SimTMSAE76ELECTRONICTRANSPORTDOCUMENTCTE PARA FATURAMENTO DATASUL1 - Sim1 - Sim2 - Assíncrono1 - Todas2 - EAI 1.0001 - SimMATA010ITEMPRODUTO1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 3.0011 - SimMATA020CUSTOMERVENDORFORNECEDOR1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 1.0001 - SimMATA030CUSTOMERVENDORCLIENTE1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 1.0001 - SimMATA050CARRIERTRANSPORTADOR1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 2.0001 - SimTMSA450CUSTOMERSHIPPINGADDRESSLOCAL DE ENTREGA1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 1.0011 - SimTMSA070TRANSPORTDOCUMENTCUSTO DE TRANSPORTE1 - Sim1 - Sim
  1 - Síncrono 1 - Todas 2 - EAI
  1
  2.000
  1 - Sim
  TMSA240
  TMSI852
  TRANSPORTDOCUMENT
  TRANSPORTINVOICESTATUS
  COMPLEMENTO
  STATUS DA
  VIAGEM
  FATURA DE TRANSPORTE
  1
  2 -
  Sim
  Não 1 - Sim
  1
  2 -
  Síncrono
  Assíncrono 1 - Todas 2 - EAI
  1.0001 - SimTMSA250TRANSPORTDOCUMENTCONTRATO CARRETEIRO1 - Sim
  1 - Sim1 - Síncrono1 - Todas
  2
  - EAI 1
  .000
  1 - Sim
  Aviso
  TMSA310TRANSPORTDOCUMENTFECHAMENTO DA VIAGEM1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 1.0001 - SimTMSA330TRANSPORTDOCUMENTFECHAMENTO DE SEGURO1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 1.0001 - SimTMSA370TRANSPORTDOCUMENTINDENIZAÇÃO1 - Sim1 - Sim1 - Síncrono1 - Todas2 - EAI 1.000
  Aviso
  title Observaçã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).

Informações necessárias em Cadastros

Cadastro no menu	Informações necessárias	Relação	Observação
Atualizações / Cadastros / Clientes	Nome, endereço, estado, CEP, Cd. Município, País, CNPJ/CPF, Insc. Estadual, Reg. Cliente	Faturamento/Fiscal	Estas informações são necessárias para o correto funcionamento da integração do CTe e NFST com o Faturamento/Fiscal Datasul. A relação entre os clientes cadastrados no Protheus e os clientes cadastrados no Datasul é dada através do CNPJ + Inscrição estadual.
Atualizações / Cadastros / Produtos	Código	Faturamento/Fiscal	O código dos produtos de cálculos do SIGATMS devem ser correspondentes aos códigos de itens cadastrados no Datasul.

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

Método	ID	Descrição	Origem	Destino	XSD (versões podem variar)
Cadastros	01
Processos	02	Envio CTE/NFST para DTS	Protheus	Datasul	ElectronicTransportDocument_1_000.xsd
	03	Fatura de Transporte a Receber	Protheus	Datasul	TransportInvoice_1_000.xsd
	04	Status da Fatura de Transporte	Datasul	Protheus	TransportInvoiceStatus_1_000.xsd

Fluxo das Informações

Cadastros

Processos

Autorização CTe / NFST
Tipo de Fluxo: Protheus -> Datasul
Mensagem: ElectronicTransportDocument_1_000
Versão: 1.000
Modo: Assíncrono
O processo de autorização do CTe pelo SEFAZ ou NFST pela prefeitura dentro do módulo SIGATMS irá disparar a integração com o módulo de Faturamento Datasul que por sua vez integrará com o módulo Fiscal automaticamente e com o módulo Financeiro manualmente se executado o programa Atualização do Contas a Receber (FT0603). Assim também o Cancelamento do CTe e NFST e a Inutilização do CTe.
O processo de autorização, cancelamento e inutilização se mantém o mesmo já existente no módulo SIGATMS, porém, quando houver integração com o ERP Datasul (ativação através do parâmetro MV_TMSERP), também será realizado esta integração com o backoffice.

Este processo ocorre somente após:
CTe: do retorno do SEFAZ autorizando o mesmo;
NFST: do retorno da prefeitura autorizando a mesma (caso a integração com a prefeitura ocorra de forma eletrônica) ou alterando o registro fiscal no módulo de Livros Fiscais do Protheus indicando o status SEFA e Nr Eletrônico que indique autorização ou cancelamento;

Fatura por Documento e Fatura Automática
Tipo de Fluxo: Protheus -> Datasul
Mensagem: TransportInvoice_1_000
Versão: 1.000
Modo: Síncrono
O processo de geração de fatura por documento e fatura automática no SIGATMS, quando ativado a integração com o ERP Datasul, não realizará a criação da tabela financeira do Contas a Receber do módulo Protheus SIGAFIN e sim uma nota tabela intermediária do módulo SIGATMS (DRT - Fatura de Transporte a Receber). O processo de geração de fatura permanece o mesmo já existente no produto para ambas as rotinas de Fatura por Documento e Fatura Automática, porém, na efetivação será criado um registro na nova tabela e será disparado a integração com o módulo de Contas a Receber Datasul onde será criado o título para cobrança. Em relação ao processo de cancelamento da fatura, será acionado também pelas rotinas de faturamento do SIGATMS Protheus e integrado ao backoffice para cancelamento do título gerado.

Notas:

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

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

Descreva limitações e restrições para cada fluxo descrito no tópico anterior. Exemplo:

ERP1 envia ITEM cadastrado para o ERP2

ERP1 somente enviará o ITEM se este estiver em uma das famílias cadastradas no parâmetro FAMILIA_INTEGRACAO.

Se o tipo de valorização do estoque for FIFO.

ERP2 envia PEDIDO cadastrado para o ERP1

O pedido recebido no ERP1 vindo do ERP2 estará bloqueado para alteração.

Como fazer

Autorização CTe / NFST
CT-e - Inclusão

Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;

Inclua um novo documento com um lote Eletrônico para geração do conhecimento de transporte eletrônico;

Calcule o documento em Outras Ações / Cálculo Frete / Calcular;

Acesse o Monitor CT-e, selecione o documento e clique em Transmitir;

É necessário que o retorno da SEFAZ esteja como 100 - Autorizado o uso do CT-e, para que seja disparada a integração, por isso, enquanto estiver em processamento é necessário consultar o Status até que o retorno seja atualizado;

Após ser autorizado, a mensagem de integração pode ser consultada em Miscelânea / Monitor EAI (Código da função: ELECTRONICTRANSPORTDOCUMENT);

Também serão criados registros na tabela DJQ e DJR ao ser acionada a integração. Através da rotina Atualizações / Recebimento / Reenvio DTS, poderá ser consultado os registros enviados ao EAI e caso ocorra algum erro retornado pela resposta Datasul, após corrigi-los, a mensagem pode ser reenviada através deste monitor;

1. title Observaçã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 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	01	Fatura de Transporte a Receber	Protheus	Datasul	TransportInvoice_2_000.xsd
Processos	02	Status da Fatura de Transporte	Datasul	Protheus	TransportInvoiceStatus_2_000.xsd

Fluxo das Informações

Processos

Fatura por Documento e Fatura Automática
Tipo de Fluxo: Protheus > Datasul
Mensagem: TransportInvoice_2_000
Versão: 2.000
Modo: Síncrono

O processo de geração de Fatura por Documento e Fatura Automática no SIGATMS, quando ativada a integração com o ERP Datasul, não realizará a criação da tabela financeira do Contas a Receber do módulo Protheus SIGAFIN e sim uma nota tabela intermediária do módulo SIGATMS (DRT - Fatura de Transporte a Receber). O processo de geração de fatura permanece o mesmo já existente no produto para ambas as rotinas de Fatura por Documento e Fatura Automática, porém, na efetivação será criado um registro na nova tabela e será disparada a integração com o módulo de Contas a Receber Datasul, onde será criado o título para cobrança. Em relação ao processo de cancelamento da fatura, será acionado também pelas rotinas de faturamento do SIGATMS Protheus e integrado ao BackOffice para cancelamento do título gerado.
Status da Fatura
Tipo de Fluxo: Datasul > Protheus
Mensagem: TransportInvoiceStatus_2_000
Versão: 2.000
Modo: Assíncrono

Nota

title	Notas:

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

Aviso

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

Fatura por Documento e Fatura Automática

Para efetuar corretamente a geração da fatura, é necessário que o CTe e NFST estejam devidamente integrados ao Datasul Faturamento Fiscal. Detalhes no documento de integração: DI_SIGATMS_x_Datasul_Faturamento_Fiscal.
Alguns cadastros devem estar relacionados em ambos os sistemas: Protheus SIGATMS e BackOffice Datasul. Detalhes no documento de integração: DI_SIGATMS_x_Datasul_Cadastros_restore.

Como fazer

Fatura por Documento e Fatura Automática
Os procedimentos para utilização do processo de fatura no módulo SIGATMS integrando com o BackOffice Datasul, estão descritos no documento técnico Integração SIGATMS x ERP Datasul Finanças ACR.

Situações comuns

Erros de integração:

Código	Erro	Rota de integração	Situação
707	Valor do Título Inválido ! \| O valor do título deve ser maior que 0 (zero).	PROTHEUS>DATASUL	Ao disparar a integração entre a Fatura do SIGATMS com o Contas a Receber Datasul, a geração do título foi realizada, porém, a fatura não foi criada (alguns motivos possíveis: Ocorreu Timeout durante a execução (é necessário aumentar o tempo de Timeout nas configurações do servidor HTTP Protheus), a sessão Protheus fechou ou foi finalizada incorretamente durante o processo). Realize manualmente o estorno do título no financeiro.
360	Tradução da Empresa &1 não encontrada na Matriz &2 !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: 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	Situação de negócio retornada do Datasul Contas a Receber: Cadastre na Matriz de Tradução de Unidade Organizacional Externa &2, o correspondente do estabelecimento &1 no Datasul-EMS.
446	Cliente Financeiro &1 inexistente !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Verifique se existe tal ocorrência no cadastro de &2.
691	Matriz da Unidade Organizacional não cadastrada !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: A Matriz da Unidade Organizacional informada não está cadastrada.
8148	Não existe tradução para a moeda !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Não existe tradução para a moeda &1 na matriz &2.
22358	Cliente não encontrado !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Cliente da Empresa: &1, com CPF/CNPJ: &2 e Inscrição Estadual: &3, não está cadastrado.
22359	Seleção do Recebimento Padrão Inexistente ou Inválida !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Consulte o cadastro de Seleção de Recebimento Padrão. Empresa: &8, Transação: &3, Cod Trans: &7, Estab: &4, &5: &6.
22360	Rateio Padrão Recebimento não encontrado !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Não foi encontrado Rateio Padrão para o Recebimento Padrão: &3.
22361	Condição de Pagamento Inexistente !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Não encontrada nenhuma Condição de Pagamento cadastrada para o &1: &2.
22364	Nenhum Conhecimento Informado !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Para gerar Título(s) no ACR é necessário selecionar pelo menos um Conhecimento.
22365	Título do Contas a Receber não encontrado !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Título ACR de Origem Faturamento não encontrado. Estab: &1, Série: &2, Conhecimento: &3.
22386	Nenhum Título encontrado.	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Não foram encontrados Títulos relacionados ao Estab: &1, Fatura: &2.
22387	Título não encontrado.	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Título relacionado a Fatura, não encontrado. Estab: &1, Esp: &2, Série: &3, Título: &4, Parcela: &5.
22391	Tipo de Conhecimento inválido !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Os Conhecimentos agrupados para Faturamento não possuem a mesma parametrização de atualização do financeiro, conforme Natureza de Operação. &1
22393	Parâmetro POL não encontrado.	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Parâmetro Plataforma Operador Logístico do Estabelecimento: &1, não encontrado.
22394	Condição de Pagamento Inválida !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: O campo 'Permite Fatura Parcelada' do Parâmetro Plataforma Operador Log¡stico do Estabelecimento: &1, está marcado como 'Não' e a Condição de Pagamento do Cliente: &2, está parametrizado para gerar mais de uma Parcela.
22395	Recebimento Padrão inválido.	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Os Conhecimentos informados possuem Recebimento Padrão diferentes. Verifique o cadastro de Seleção Recebimento Padrão. &1
22427	Erro ao buscar informações da Nota Fiscal !	PROTHEUS>DATASUL	Situação de negócio retornada do Datasul Contas a Receber: Nota Fiscal não encontrada para o Conhecimento do Estabelecimento: &1, Série: &2, Fatura: &3.

CT-e - Cancelamento

Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;

Selecione o documento desejado para ser cancelado e vá em Outras Ações / Cálculo Frete / Estornar;

Marque o documento que deve ser estornado e clique em Confirmar;

Será apresentado um Help indicando que o cancelamento deve ser autorizado pelo SEFAZ;

Para transmitir os documentos cancelados é necessário acessar o Monitor CT-e em Outras Ações / Cálculo Frete / CT-e;

Não selecione nenhum documento e clique em Transmitir, será apresentado uma questão indicando se devem ser transmitidos os documentos cancelados, clique em sim;

Quando houver a autorização de cancelamento pelo SEFAZ, será disparado a integração com o Datasul;

Caso ocorra algum erro durante o cancelamento, após corrigi-los, a mensagem de integração poderá ser reenviada pela rotina Atualizações / Recebimento / Reenvio DTS;
CT-e - Inutilização

No Protheus, caso na transmissão do documento ao SEFAZ ocorra algum erro no retorno (Exemplo: 002 - Não foi possível assinar o CT-e...) e seja realizado o estorno deste documento, automaticamente é transmitido ao SEFAZ a solicitação de inutilização;

Quando o SEFAZ autoriza a inutilização é chamado a integração com o Faturamento e Fiscal Datasul;
NFST - Inclusão

Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;

Inclua um novo documento com um lote Normal para geração da NFST;

Calcule o documento em Outras Ações / Cálculo Frete / Calcular;

Para efetuar o processo de autorização desta NFST, é necessário acessar o módulo Livros Fiscais (09);

Miscelânea / Acertos / Acertos Fiscais;

Posicione no registro fiscal relacionado a NFST e clique em Alterar;

Será apresentado uma mensagem de aviso de alteração, clique em Sim;

Informe o Nr. Eletr. e o Retorno SEFA como 100 (Autorizado), após clique em Salvar;

Neste momento é disparado a integração com o Faturamento Datasul que irá atualizar o módulo de Fiscal;
NFST - Cancelamento

Acesse o ambiente Protheus, módulo SIGATMS, Atualizações / Recebimento / Entrada Documento de Clientes;

Selecione o documento desejado para ser cancelado e vá em Outras Ações / Cálculo Frete / Estornar;

Marque o documento que deve ser estornado e clique em Confirmar;

Acesse o módulo Livros Fiscais (09), Miscelânea / Acertos / Acertos Fiscais;

Posicione no registro fiscal relacionado a NFST e clique em Alterar;

Será apresentado uma mensagem de aviso de alteração, clique em Sim;

Informe o Retorno SEFA como 101 (Cancelado), após clique em Salvar;

Neste momento é disparado a integração com o backoffice Datasul;

Fatura por Documento e Fatura Automática
Os procedimentos para utilização do processo de fatura no módulo SIGATMS integrando com o backoffice Datasul estão descritos no documento técnico Integração SIGATMS x ERP Datasul Finanças ACR.

Situações comuns

Problemas de integração (Protheus):

Situação	Possíveis Causas	Solução	Relação
Ao realizar a autorização do CT-e no SIGATMS, não disparou a mensagem de integração para o Faturamento Datasul (ELECTRONICTRANSPORTDOCUMENT).	Adapter não está cadastrado corretamente; Série informada para o CT-e não está parametrizada corretamente no parâmetro MV_ESPECIE;	O adapter para a transação ELECTRONICTRANSPORTDOCUMENT deve estar conforme orientação deste documento no tópico de configuração; Relacione a série utilizada com os tipos de documento: CTE e NF no parâmetro MV_ESPECIE;	Faturamento/Fiscal
NFSE Chave Registro: 9999999999999\|999\|9999999 Relacionamento Série X Estabelecimento não cadastrado.	A série enviada pelo SIGATMS na integração com o Faturamento Datasul não está cadastrada no Datasul; Não há a relação no Datasul da série enviada pelo SIGATMS com o estabelecimento;	É necessário que o SIGATMS e o Datasul trabalhem com os mesmos códigos de séries; É necessário relacionar a série com o estabelecimento no programa FT0114;	Faturamento/Fiscal

Erros de integração:

Código	Erro	Rota de integração	Situação	Relação
EAI005	Adapter com.totvs.datasul.logistics.dis.ElectronicTransportDocumentAdapter gerou uma exceção...	DATASUL -> PROTHEUS	Verifique o log de processamento da mensagem no Datasul (logs: RPW e Appserver), pois foi gerado um erro Progress que gerou a exceção.	Faturamento/Fiscal
56	Unidade da Federação: SP inexistente.	DATASUL -> PROTHEUS	É provável que o código IBGE do País da Unidade de Federação não tenha sido informado no cadastro do cliente (Protheus) em um dos clientes relacionados ao conhecimento (remetente, destinatário, devedor, consignatário).	Faturamento/Fiscal
707	Valor do Título Inválido ! \| O valor do título deve ser maior que 0 (zero).	DATASUL -> PROTHEUS	Ao disparar a integração entre a Fatura do SIGATMS com o Contas a Receber Datasul, a geração do título foi realizada, porém, a fatura não foi criada (alguns motivos possíveis: Ocorreu Timeout durante a execução (é necessário aumentar o tempo de Timeout nas configurações do servidor HTTP Protheus), a sessão Protheus fechou ou foi finalizada incorretamente durante o processo). Realize manualmente o estorno do título no financeiro.	Financeiro
8	Não foi enviada a data do cancelamento	DATASUL -> PROTHEUS	Durante o processo de cancelamento de uma NFST, foi realizado a alteração do status SEFA do registro fiscal Protheus antes de realizar o estorno do cálculo do conhecimento e por isso a data não foi enviada na mensagem de integração. Realize o estorno do cálculo do conhecimento e após reenvie a mensagem de cancelamento através da rotina de Atualizações / Recebimento / Reenvio DTS.	Faturamento/Fiscal

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

Identificar o funcionamento da integração;
Identificar a ocorrências de problemas;
Coletar evidências do mau funcionamento relatado pelo cliente;
Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos

18
Módulo implantado	SIGATMS - Gestão de Transportes
Funcionalidades implantadas	Conhecimento de Transporte Eletrônico (Ct-e)
Ferramentas necessárias	¹ Servidor WebServices Protheus iniciado

Transação	Versão	Modo Habilitado
TransportInvoice	2.000	Recebimento
TransportInvoiceStatus	2.000	Envio

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 51

Nova versão 122

Chave

INTEGRAÇÃO PROTHEUS SIGATMS X DATASUL - CONTAS A RECEBER

Introdução

Sistemas Envolvidos

Integração

Integração

Escopo

Escopo

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

Datasul

Protheus

Protheus

InstalaçãoInstalação/Atualização

Datasul

Configurações EAI

Configurações Gerais

Protheus

Parâmetros de Integração

Protheus

Alterações de Dicionário de Dados

Parâmetros de Integração

Configurações EAI

Configurações EAI

Informações necessárias em Cadastros

Controle de Versão

Suporte

Transações/Entidades/Mensagens únicas

Fluxo das Informações

Cadastros

Processos

Limitações / Restrições Gerais

Como fazer

Controle de Versão

Suporte

Transações/Entidades/Mensagens únicas

Fluxo das Informações

Processos

Limitações / Restrições Gerais

Como fazer

Situações comuns

Situações comuns

Checklist de suporte da aplicação