Informações Gerais

Objetivo

Permitir que os Cadastros de Cliente e Fornecedor sejam replicados para um Produto externo, utilizando o Conceito de Mensagem Única através do EAI2.

Definição da Regra de Negócio

Mensagem

Ao Incluir, Alterar ou Excluir um Cliente/Fornecedor, será enviada uma Mensagem XML a partir do Datasul, pertencente a Transação “CustomerVendor” versão 1.000.

O Datasul irá realizar o o envio através do Adapter criado para o módulo UTB - Tabelas Universais, baseado no XSD: “CustomerVendor_1_000.xsd”, que está disponível no TFS, no caminho abaixo:

http://tfs2015.totvs.com.br:8080/tfs/TOTVSMSGXML/STABLE/_versionControl?path=%24%2FSTABLE%2Fxmlschema%2Fgeneral%2Fevents%2FCustomerVendor_1_000.xsd

Observações:

• O Envio a partir do Datasul estará disponível independente do projeto do Operador Logístico.
• Para que o envio aconteça, basta que a transação "CustomerVendor" esteja habilitada para envio no EAI2. Desta forma, esta mensagem poderá ser utilizada por qualquer projeto futuro.
• Para garantir que não haja impacto nas releases anteriores, o envio somente será realizador se o Pré-Processador "BF_FIN_CLIEN_FORNEC_EAI2" estiver disponível. Este pré-processador será liberado a partir da 12.1.17 do Datasul.

Ajuste nos Adapters

O Adapter para transação "CustomerVendor" já existe e está disponível no caminho "com\totvs\datasul\universal\utb\CustomerVendorAdapter.cls", mas atualmente ele somente trata o Recebimento da mensagem. Portanto, ele será alterado para tratar também o Envio da mensagem.

Atualmente já existe um Adapter de Envio, disponível no caminho "com\totvs\datasul\universal\CustomerVendorAdapter.cls", mas ele pertencente ao projeto de Integração com o PIMS que foi suspenso. Desta forma, este Adapter será eliminado, e quando o projeto for retornado, ele deverá utilizar o Adapter mencionado acima.

As mesmas regras descritas acima, valem para o arquivo de Factory da mensagem "CustomerVendorFactory.cls".

Montagem do XML

Segue abaixo a Listas das TAG do XML da mensagem, e a indicação de como elas serão atualizadas:

Informações Principais

Endereço

Informações abaixo da TAG "Address":

Endereço de Entrega

Informações abaixo da TAG "ShippingAddress":

Lista das Informações de Comunicação

Informações abaixo da TAG "ListOfCommunicationInformation/CommunicationInformation":

Lista de Contatos

Informações abaixo da TAG "ListOfContacts/Contact":

Lista de Informações Bancárias

Informações abaixo da TAG "ListOfBankingInformation/BankingInformation":

Observação:

• Para Cliente, serão consideras as informações Bancárias do Cliente Financeiro;
• Para Fornecedor, será considera da Lista de Contas Correntes do Fornecedor Financeiro.

Endereço de Cobrança

Informações abaixo da TAG "BillingInformation":

Informações de Fornecedor

Informações abaixo da TAG "VendorInformation":

Informações Fiscais

Informações abaixo da TAG "FiscalInformation":

Lista de Impostos Vinculados

Informações abaixo da TAG "FiscalInformation/TaxPayer":

Informações de Análise de Crédito

Informações abaixo da TAG "CreditInformation":

Observações:

• Informações disponíveis apenas no módulo de Avaliação de Crédito, portanto as informações serão buscadas de lá no momento da geração do XML;
• Estas informações estão disponíveis no programa: CM0102 - Informações de Crédito do Cliente.

Chamada do Apdater nos Programas de Cadastro

Programa Fachada

Não deve ser feita referência as variáveis do Adpater (CustomerVendor), diretamente dentro dos programas já existem, pois teremos problemas em liberações especiais em releases anteriores. Portanto, será construído um programa novo (fachada), que será intermediário para chamada do Adapter;

Os programas de Inclusão, Alteração e Exclusão de Cliente/Fornecedor serão alterados para chamar este novo programa;

Este novo programa irá verificar se a Transação "CustomerVendor" está habilitada para envio no EAI2 (transactionstatus.i), caso não esteja, o programa não irá chamar o Adapter.

Programas Chamadores

De forma geral, os programas alterados para chamada do programa fachada, serão os mesmos que hoje já fazem a chamada do Adapter do EAI1, mas alguns deles não serão alterados, pois a Mensagem Única utilizada no EAI2, não possui todas as informação que são tratadas pelo EAI1.

Abaixo segue a lista dos programas que devem e os que não devem ser alterados.

Programas que devem ser alterados

Programas que NÃO devem ser alterados

Os programas listados abaixo fazem a execução do Adapter do EAI1, mas NÃO devem ser alterados para executar o Adapter do EAI2, pois as informações alteradas, não existem na nova mensagem do EAI2.

Tratamento Específico para o Operador Logístico

De forma geral, se a transação "CustomerVendor" estiver configurado no EAI2, o mensagem será envida, mas teremos um tratamento específico quando o produto estiver parametrizado para o Operador Logístico, onde será realizado um filtro daqueles cadastros que devem ou não serem replicados.

Este filtro será feito com base nos Grupos de Cliente ou Fornecedor, onde o usuário irá indicar quais devem ser considerados para envio.

Esta parametrização será feita nos Parâmetros do Operador Logístico, conforme descrito abaixo.

Alteração no Parâmetros do Operador Logístico (CD00596)

Será alterado o Parâmetros do Operador Logístico, conforme protótipo de tela (Parâmetros do Operador Logístico), para permitir ao usuário parametrizar a lista de Grupos de Cliente e Fornecedor que serão utilizados para replicação do cadastro;

Estas listas serão salvas em dois novos campos, conforme descrito em Dicionário de Dados.

Será feito um tratamento para salvar as informações em campos livres para as releases anteriores, portanto será criado um programa de acerto para estes campos novos;

Para seleção dos Grupos, será construída uma nova tela, conforme protótipo de tela (Seleção de Grupo de Cliente/Fornecedor).

Existira um tratamento para que o usuário possa escolher a opção "*", que irá valer para todos os Grupos, desta forma, não haverá filtro, os cadastros serão sempre enviados.

Controle do Envio

O novo programa criado (Programa Fachada) será alterar para somente fazer a chamada do Adapter se o Grupo de Cliente/Fornecedor estiver parametrizado para Envio no Parâmetros do Operador Logístico;

Para seleção do Parâmetro, será utilizado o Estabelecimento Corrente do Usuário, caso ele não tenha sido informado (em Troca do Estabelecimento do Usuário Financeiro), será considerado o Estabelecimento Principal da Empresa Corrente;

Mesmo que o Cadastro seja Ambos (exista com Cliente e com Fornecedor), será verificado o Grupo referente ao Cadastro que está sendo Incluir/Alterado/Excluído naquele momento, isto é, se estiver alterando o Fornecedor, irá olhar o Grupo de Fornecedor, e se estiver alterando o Cliente, será verificado o Grupo de Cliente;

Este tratamento somente será feito se, pelo menos, uma das Funções do Operador Logístico ("TMS Transportador" ou "WMS Operador Logistico") estiver ligada no HUB. Se as duas estiverem desligadas, não será verificado os Grupos e sempre irá chamar o Adapter;

Caso a Lista parametrizada estiver em Branco, ou conter o valor "*", sempre ir chamar o Adapter, independente do Grupo do Cliente/Fornecedor.

Protótipo de Tela

Parâmetros do Operador Logístico

Seleção de Grupo de Cliente/Fornecedor

Fluxo do Processo

Não se Aplica.

Dicionário de Dados

Tabela 

Atributos

Atributos Livres Utilizados

Grupo de Perguntas

Não se Aplica.

Consulta Padrão

Não se Aplica.

Estrutura de Menu

Não se Aplica.