ER LOGTMS01-1469 Integração Código Único de Cadastros - Protheus x Datasul

Informações Gerais 

   Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos). 

Objetivo 

Fornecer e controlar de forma única e sequencial a numeração para qualquer cadastro integrado com o Código Único disponibilizado pela Integração do Datasul via Mensagem Padronizada – EAI. Também permite que cadastros de clientes e fornecedores, possuam o mesmo código para consulta e alteração desde que pertença a mesma pessoa física ou jurídica.  

Definição da Regra de Negócio

 O que é Código Único

É um controle de numeração automático que é disponibilizado e controlado pelo Datasul. Permite que os cadastros sejam integrados com o mesmo código, desde que pertença a mesma pessoa física ou jurídica, garantindo assim que a consulta de um cadastro especifico seja realizado em qualquer um dos sistemas integrados pelo mesmo código de pesquisa.

Rotinas Envolvidas na Integração: 

Como funciona

Ao realizar um cadastro de Cliente ou Fornecedor e após preencher os campos CNPJ/CPF (A1_CGC) e Inscrição Estadual (A1_INSCR), será disparada a integração pela rotina Integração (MATA020B) que solicita o código único para o Datasul (responsável pelo controle e distribuição do código). A rotina de integração do Protheus recebe o próximo código disponível e verifica qual rotina de cadastro fez a solicitação de uso do código e vincula o valor ao respectivo campo que representa o código de cadastro podendo ser A1_COD ou A2_COD.

Ao confirmar o cadastro, após o preenchimento dos principais campos é realizada uma segunda integração que envia para o Datasul o código único fornecido na primeira integração e completa com a inscrição federal (CPF ou CNPJ) e a inscrição estadual.

Momentos da Integração:

A integração acontece em 2 estágios:

1. Ao preencher os campos referentes ao CPF/CNPJ e Inscrição Estadual, estando esses campos validos e preenchidos é disparada a integração via EAI solicitando o próximo código disponível. Na integração realizada, neste momento é enviado para o Datasul apenas as informações dos campos CPF/CNPJ e Inscrição Estadual.
2. Na confirmação do cadastro é disparada outra integração via EAI informando o código único que o Datasul disponibilizou. Neste momento é informado o CNPJ/CPF e a Inscrição Estadual para atualizar o controle de numeração pelo Datasul.

Observação:

Os campos A1_LOJA ou A2_LOJA deve ser preenchido com inicializador padrão.

A rotina de integração verifica internamente para qual das rotinas Fornecedores (MATA020) ou Cliente (MATA030), está solicitando o código único e de acordo com o nome da rotina passada será atualizado com o código único o campo de código. Conforme demonstrado abaixo:

• Se Fornecedores (MATA020), atualiza o campo A2_COD;

• Se Cliente (MATA030), atualiza o campo A1_COD;

Observação:

O campo A1_LOJA ou A2_LOJA, deve ser preenchido com inicializador padrão.

Importação do XML de Nota Fiscal

Fonte TMSAE80.PRW (Integração Totvs Colaboração Notas Fiscais de Clientes)

Nesta rotina existe a chamada de rotina automática pela function TMSAE80Inc(), quando houver a leitura de um destinatário será executada a rotina automática para o cadastro de Clientes (MATA030). Estando o adapter de código único cadastrado será realizada a chamada via Integração EAI do código único e esse cadastro será gravado com esse código.

Configuração Inicial

1. Cadastrar o Adapter pelo Módulo Configurador (SIGACFG) e informar a rotina EAI (MATA020B) referente a Mensagem Padronizada – CUSTOMERVENDORRESERVEID.
   A interface de cadastro pode ser acessada pelo módulo de Configuração (SIGACFG) pelo caminho: Ambiente / Schedule / Adapter EAI.
   Clique em Incluir e em seguida cadastre o Adapter conforme tabela de campos informada abaixo:

Tabela de Campos - Integração do Código Único

Ainda nessa tela, existe na parte inferior que se refere ao cadastro do Roteamento de mensagens, esse cadastro é opcional, porém é importante ter um roteamento apontando para cada marca envolvida na integração por meio desse adapter.

Para cadastrar o roteamento basta preencher os seguintes campos:

Observação

Quando falamos de mensagem única com método de envio Síncrono, devemos tomar o cuidado para que apenas uma marca esteja com o campo Envia='SIM'.

        2 - Cadastrar o De/Para de Empresa / Filial informando os campos

             Acesse: Ambiente / Schedule / Emp.filial Mensagem Única.

Preencha os campos conforme descrição informada na tabela de campos, logo abaixo:

       3 - Cadastrar a Rota EAI de acesso ao Webservice da marca externa.

           Acesse: Ambiente / Schedule / Cadastro Rotas EAI

Esse cadastro é necessário para que o Adapter entenda para onde a integração deve apontar para realizar o envio do XML de integração.

Preencha os seguintes campos descrito na tabela abaixo:

      4 - Opcional:

           Incluir no inicializador padrão dos campos A1_LOJA e A2_LOJA, o conteúdo inicial para preenchimento desses campos na abertura do cadastro. Caso não seja configurado, a rotina integradora assume o conteúdo para esses campos como sendo “01”.

     5 - Exemplo de Utilização

Exemplo de cadastro de cliente com código único:

Acesso pelo menu do Módulo Gestão de Transportes (SIGATMS): 

Caminho: Atualizações / Cadastros / Clientes (MATA030)

Na tela de Cadastro, os campos referente a Código e Loja, estarão vazios (caso não tenha adicionado um inicializador padrão). 

Preencha os campos obrigatórios.

Ao preencher os campos CNPJ/CPF (A1_CGC) e Ins.Est (A1_INSCR) será disparada a Integração EAI que solicitará o código único.

Aguarde a integração conforme figura abaixo:

Finalize preenchendo os demais campos e clique no botão Salvar para finalizar o cadastro.

Observações:

• Toda vez que no ato de cadastro for trocado o CNPJ/CPF ou a Inscrição Estadual, será disparada a Integração, e isso fará com que o código único seja subistituído no campo "Código" (A1_COD).
• Lembre-se que para o código único funcionar, deve-se configurar o Adapter conforme descrito nesta documentação na seção Configurações Iniciais.