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

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.

1. 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 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. Como 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 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 Inicial1-   

1. Cadastrar o Adapter pelo

1. Módulo Configurador (SIGACFG) e informar a rotina EAI (MATA020B) referente a Mensagem Padronizada – CUSTOMERVENDORRESERVEID.
   A interface de cadastro pode ser acessada pelo

1. módulo de

1. Configuração (SIGACFG) pelo caminho:

1.  Ambiente / Schedule / Adapter EAI.
   

1. Clique em Incluir e em seguida cadastre o Adapter conforme tabela de campos

1. informada abaixo:

tabela Tabela de campos 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 porém é importante ter um roteamento apontando para cada marca envolvida na integração por meio desse adapter.

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

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

           Acesso   Acesse: Ambiente / Schedule / Cadastro Rotas Ea 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            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      5 - Exemplo de Utilização

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

Acesso pelo menu do Modulo TMS 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). 

Image Added

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:

Image Added

Finalize preenchendo os demais campos e clique 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 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.