Informações Gerais

Objetivo

Criar um Adapter de Negócio do Datasul, responsável em receber um XML com informações referentes a uma Fatura proveniente do TMS Protheus. A partir desta Fatura, serão gerados Títulos no Conta a Receber do Datasul.

Este documento descrevem as Regras de Negócio envolvidas na recepção do XML pelo Datasul através do EAI, utilizando o conceito de Mensagem Única TOTVS. Os detalhes da criação da API de Negócio, que irá realizar a criação dos Títulos no Contas a Receber, estão descritos documento: http://tdn.totvs.com/display/LDT/ER_MANFIN01-1029_ELLECE-TMSxACR-Mensagem_Recebimento_Fatura_XML_API

Definição da Regra de Negócio

Mensagem

Ao gerar uma Fatura no TMS Protheus, será enviada uma Mensagem XML para o Datasul pertencente a Transação “TransportInvoice” versão 1.000.

O Datasul irá receber esta XML através de um novo Adapter criado para o módulo Contas a Receber, baseado no XSD: “TransportInovice_1_000.xsd”, que está disponível no TFS, no caminho abaixo:

http://172.16.93.88:8080/tfs/web/UI/Pages/Scc/ViewSource.aspx?path=%24%2FDEV%2Fxmlschema%2Fgeneral%2Fevents%2FTransportInvoice_1_000.xsd

Observação: Nesta mesma Mensagem e Adapter, também será tratado a Alteração e o Cancelamento de Fatura.

Tradução das Informações

Como as plataformas Protheus e o Datasul possuem conceitos um pouco diferentes relacionados aos cadastros de Empresa e Estabelecimento, será realizado um processo de tradução destas informações, através do “de-para” do EAI. Neste processo, será traduzido a informação do Aplicativo Externo (TMS Protheus), para o equivalente no Foundation do Datasul.

Para isto, serão utilizadas as estruturas de de-para abaixo:

Para que a integração funcione corretamente, estes de-para’s devem estar previamente cadastrados no EAI, com a relação de Empresa/Estabelecimento do Protheus versus Empresa/Estabelecimento do Datasul. Portanto, caso o Adpater não encontre a tradução, o processo não será realizado e será retornado um erro para o Protheus.

Informações da Fatura

As informações das Fatura serão enviadas no “BusinessContent” conforme tabela abaixo.

Ver diagrama da mensagem nos Protótipos de Tela (BusinessContent).

Lista de Conhecimentos

Na mensagem, também será envaida a Lista de Conhecimentos vinculados a Fatura. As informações estarão disponíveis na Estrutura de TAG’s “ListOfTransportDocuments/TransportDocument” do “BusinessContent” conforme tabela abaixo.

Ver diagrama da mensagem nos Protótipos de Tela (BusinessContent).

Informações dos Títulos

Após executar a API de negócio, o Adapter irá devolver as informações dos Títulos criados no “ReturnContent”, conforme tabela abaixo. Como poderá ser gerado mais de um Título, as informações estarão abaixo da Estrutura de TAG’s “ListOfAccountReceivableDocument/AccountReceivableDocument”.

Ver diagrama da mensagem nos Protótipos de Tela (ReturnContent).

Informações de Cobrança do Título

Na mensagem, também serão envaidas as informações de Cobrança do Título. Elas estarão disponíveis juntamente com as informações do Título no “ReturnContent” conforme tabela abaixo.

Ver diagrama da mensagem nos Protótipos de Tela (ReturnContent).

Chave única da Fatura

O Datasul também irá devolver a chave única da Fatura criada nele (gerada internamente para relacionar os Títulos criados a partir da Fatura). Isto é necessário para que o Protheus possa criar a relação de “de-para” entre a Fatura dele e a do Datasul e utilizar nas consultas futuras. Esta informação será enviada na Estrutura de TAG’s “ListOfInternalId” conforme tabela abaixo:

Tratativa no Cancelamento

Ao receber uma mensagem de Cancelamento, o Datasul irá procurar os Títulos relacionados a Fatura. Caso não encontre, será retornando uma mensagem de Erro para o Protheus. Em tese, este problema somente irá ocorrer caso exista uma inconsistência de base, onde o Protheus possui a informação, mas o Datasul não.

Se neste caso o Datasul retornar como erro, a Fatura nunca poderá ser cancelada no Protheus, já que, ao receber uma mensagem do tipo “Erro”, o próprio EAI já desfaz a transação.

Para que seja possível realizar o Cancelamento da Fatura no Protheus, esta mensagem será alterada para o tipo “informação”, desta forma, o EAI apenas irá registrar a mensagem, mas vai possibilitar que a regra de negócio (cancelamento da Fatura) possa ser realizada do lado do Protheus. Neste caso, será registrado no Histórico da Fatura que os Títulos não foram encontrados no Datasul. Obs: Efetivamente a Fatura não é cancelada, ela fica disponível, mas com o Status "Cancelada", desta forma é possível consultar o Histórico.

Protótipo de Tela

BusinessContent

ReturnContent

Fluxo do Processo

Não há.

Dicionário de Dados

Não há.

Grupo de Perguntas

Não há.

Consulta Padrão

Não há.

Estrutura de Menu

Não há.