Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

  

Informações Gerais 

Especificação

Produto

PROTHEUS

Módulo

SIGATMS

Segmento Executor

 

Projeto1

LOGTMS01

IRM/EPIC1

 LOGTMS01-1469

Requisito/Story/Issue1

 

Subtarefa1

 

Chamado/Ticket2

 

País

( X ) Brasil  (  ) Argentina  (  ) México  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colômbia   (  ) Outro _____________.

Outros

<Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>.

   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: 

Rotina

Tipo de Operação

Opção de Menu

Regras de Negócio

MATA020B - Integração

[Chamada de Integração

 

-

MATI020B – Rotina EAI

[Disparo da Integração]

 

-

MATA030 - Cadastro de ClientesCadastro  
MATA020 - Cadastro de FornecedoresCadastro  

 

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

Campo

Conteúdo

Mensagem Única

1-SIM

Rotina

MATA020B

Mensagem

CUSTOMERVENDORRESERVID

Descrição

Sugerido – Integ-Codigo Único

Envia

1-SIM

Recebe

1-SIM

Método

Embora não seja requerida essa configuração. É obrigatório que seja informado 1-Síncrono.

Operação

1-Todas

Canal Envio

2-EAI

Versão de Envio (Atual 1.000)

O cadastro preenche automaticamente a ultima versão definida na rotina de integração. Caso a versão na marca receptora seja inferior, basta mudar para a versão abaixo ao que ele preencheu no campo, se for superior deverá ser atualizada a versão do XSD da mensagem.

 

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:

CampoDescrição
ProdutoPressione F3 ou dê duplo clique no campo, clicando em seguida na lupa para apresentar a tela de seleção de registro. Selecione a rota disponível para a marca da qual deseja se comunicar pela Integração EAI.
EnviaInforme 'SIM' para que seja realizada a integração dependendo de como foram configurados os campos Envia e Recebe.

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:

Campo

Conteúdo

Referencia*

Informar descrição da referencia externa, pode ser a marca ou produto. Como por exemplo: “DATASUL” ou “PROTHEUS”.

Company*

Informar o código da empresa da marca externa.

Branch

Filial da marca externa.

Grupo Emp.Protheus*

Informar o código da empresa associada ao recebimento da integração (Empresa do Protheus).

Fil.Protheus*

Informar a filial que está associada ao recebimento da integração (Filial do Protheus).

         

       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:

Campo

Conteúdo

Produto*

Descrição da marca externa. Exemplo: “Datasul” ou “Protheus”.

Aplicação*

Informe o nome da aplicação externa que é associada a mensagem recebida da marca externa.

Url*

Endereço / Url do servidor de webservice do Datasul. Obter essa informação com a equipe de integração da marca externa.

Client WS*

Quando Datasul informar WSEAIDATASUL.

Quando Protheus manter o valor já preenchido por padrão, que é: WSEAISERVICE.

Método*

Manter como receiveMessage.

Usuário

Informe o usuário de autenticação do webservice quando requerido.

Senha

Informe a senha de autenticação do webservice quando requerido.

      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. 
Informações
titleImportante:

Informações adicionais sobre o uso do EAI no Protheus podem ser acessadas pelos links abaixo:

EAI Protheus

A camada do EAI 

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.