Histórico da Página

(Obrigatório)

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 pessoal 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. E permite que os cadastros sejam integrados com o mesmo código, desde que pertença a mesma pessoal 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 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 reprenta 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 MATA020 ou 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. Como demonstrado abaixo:

• Se MATA020, atualiza o campo A2_COD;

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

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 Iniciais

1-    Cadastrar o Adapter pelo Modulo Configurador(SIGACFG) e informar a rotina MATA020B referente a Mensagem Padronizada – CUSTOMERVENDORRESERVEID.

A interface de cadastro pode ser acessada pelo modulo de configuração(SIGACFG) pelo caminho: Ambiente / Schedule / Adapter EAI

Click em Incluir e em seguida cadastre o Adapter conforme tabela de campos informada logo 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, porem é importante ter um roteamento apontando para cada marca envolvida na integração por meio desse adapter.

Para cadastrar o roteamento pasta 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

Acesso: 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.

           Acesso: Ambiente / Schedule / Cadastro Rotas Ea

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 Modulo TMS: 

Caminho: Atualizações/ Cadastros/ Clientes

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

Image Added

Preencha os campos obrigatórios, ao preencher os campos CNPJ/CPF (A1_CGC) e Ins.Est(A1_INSCR) será disparado a integração EAI que solicitará o código único. Aguarde a integração conforme figura abaixo:

Image Added

Finalize preenchendo os demais campos e click no botão salvar para finalizar o cadastro.

Image Added

Observações:

• Toda vez que no ato de cadastro for trocado o CNPJ/CPF ou Inscrição Estadual será disparada a Integração e isso fara 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