Árvore de páginas

CADASTROS E CÓDIGO ÚNICO - INTEGRAÇÃO PROTHEUS SIGATMS X DATASUL

Características do Requisito

Linha de Produto:

Microsiga Protheus® e DATASUL®

Segmento:

Supply Chain - Logística

Módulo:

SIGATMS - Gestão de Transportes

Rotina:

Rotina

Nome Técnico

MATA010

Cadastro de Produtos / Itens

MATI010Responsável por montar a mensagem de EAI - Cadastro de Produtos / Itens
MATA020Cadastro de Fornecedores
MATI020Responsável por montar a mensagem de EAI - Cadastro de Fornecedores
MATA020BRotina de Integração código único
MATI020BResponsável por montar a mensagem de EAI - Código Único
MATA030Cadastro de Clientes
MATI030Responsável por montar a mensagem de EAI - Cadastro de Clientes
TMSA450Cadastro de locais de entregas
TMSI450Responsável por montar a mensagem de EAI - Cadastro de locais de entregas

Requisito/Story/Issue (informe o requisito relacionado):

LOGTMS01-1092

País(es):

Todos

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

  • SB1 – Cadastro de Produtos.
  • SA7 – Cadastro de Produtos X Clientes.
  • SA1 – Cadastro de Clientes.
  • SA2 – Cadastro de Fornecedores.
  • DUY – Cadastro de Regiões.
  • SYA – Cadastro de Países.
  • CC2 – Cadastro de Municípios.
  • SX5 – Cadastro de Estados - Tabela 12.
  • CCH – Cadastro de País.
  • DUL – Cadastro de Endereço de Solicitantes e Clientes.
  • DUE – Cadastro de Solicitantes.

Sistema(s) Operacional(is):

Windows® / Linux®

Descrição

Foram realizadas integrações dos cadastros de Produtos, Fornecedores, Clientes, Locais de Entrega e Código Único, gerados pelo módulo SIGATMS (Transportation Management System) da linha Microsiga Protheus® com o Datasul®.

O Microsiga Protheus® usa como ferramenta de Integração o EAI Protheus® (Enterprise Application Integrator), o EAI por sua vez, tem a responsabilidade de trafegar mensagens de XML entre o Microsiga Protheus® e o Datasul®, além de fazer o controle de filas das mensagens a serem integradas.

Para os cadastros de Fornecedores (MATA020) e Clientes (MATA030), o sistema controlará de forma única e sequencial a numeração integrando com a rotina de Código Único disponibilizada pela Integração do Datasul® via Mensagem Padronizada –  (EAI Protheus® (Enterprise Application Integrator), e permitirá que os sistemas utilizem 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

É necessário que o Adapter EAI esteja configurado, indicando o(s) cadastro(s) que integrará com a outra marca.

O sistema tratará os cadastros com um Código Único para os registros integrados, onde terá um código informado pelo Datasul®, para ser atualizado também no registro de origem, permitindo assim, que pelo mesmo código possa ser consultado o registro tanto na origem como no destino.

Código Único

O que é Código Único 

É um controle de numeração automático que é disponibilizado e controlado pelo Datasul®. Ele permite que os cadastros sejam integrados com o mesmo código em todos os sistema que estão integrados, 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. 

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 de Código Único (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 Microsiga 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 utilizando o código Único:

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

  1. Ao preencher os campos referente 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 Loja do Cliente (A1_LOJA) ou Loja do Fornecedor (A2_LOJA), podem ser preenchidos com o inicializador padrão para facilitar no momento do preenchimento caso seja utilizado o código único.

A rotina de integração verifica internamente para qual das rotinas Cadastro de Fornecedores (MATA020) ou Cadastro de Clientes (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. 

Validações na manipulação dos registros

  • Ao incluir, alterar ou excluir um registro, o sistema verificará se existe o Adapter EAI cadastrado para o determinado cadastro, verificando as seguintes situações:
  1. INCLUIR: Verificar se o registro já existe no destino, caso SIM, atualizar as informações de acordo com a origem, caso NÃO, incluir no destino e atualizar a origem com o código de numeração única disponibilizado pelo destino.
  2. ALTERAR: Verificar se o registro já existe no destino, caso SIM, atualizar as informações de acordo com a origem, caso NÃO, incluir no destino e atualizar a origem com o código de numeração única disponibilizado pelo destino.
  3. EXCLUIR: Verificar se existe algum processo e/ou cadastro em que o registro esteja atrelado, tanto na origem, como no destino, caso SIM, notificar por meio de mensagem e não permitir a exclusão, caso NÃO, excluir na origem e no destino.
     

Procedimento para Configuração 

CONFIGURAÇÃO DE ADAPTER'S EAI

1.  No Configurador (SIGACFG), acesse Ambientes/Schedule/Adapter E.a.i.(CFGA020). Cadastre os Adapter's a seguir:

Mensagem Unica

1-Sim

Rotina

MATA010

Mensagem

ITEM

Descrição

PRODUTO

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio3.001

Mensagem Unica

1-Sim

Rotina

MATA020

Mensagem

CUSTOMERVENDOR

Descrição

FORNECEDOR

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio1.000

Mensagem Unica

1-Sim

Rotina

MATA020B

Mensagem

CUSTOMERVENDORRESERVEID

Descrição

CODIGO UNICO

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio1.000

Mensagem Unica

1-Sim

Rotina

MATA030

Mensagem

CUSTOMERVENDOR

Descrição

CLIENTES

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio1.000

Mensagem Unica

1-Sim

Rotina

TMSA450

Mensagem

CUSTOMERSHIPPINGADDRESS

Descrição

LOCAL DE ENTREGA

Envia

1- Sim

Recebe

1- Sim

Método1- Síncrono
Operação1- Todas
Canal Envio2- EAI
Versão de Envio1.001

Observação

Caso seu sistema possua integração com mais de um produto, será necessário cadastrar o Roteamento EAI Protheus e realizar o vinculo em cada um dos Adapter's.

 

CONFIGURAÇÃO DO DE/PARA DE EMPRESAS MENSAGEM ÚNICA

2.  No Configurador (SIGACFG), acesse Ambientes/Schedule/Emp.filial Mensagem Única (APCFG050). Cadastre os De/Para a seguir:

Referência

Informar a descrição da referência 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).

Informações

Para mais informações, acesse De/Para EAI Protheus®