Histórico da Página
Cadastros Integração Protheus 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: |
| ||||||||||||||||||||||
Parâmetro(s): | MV_TMSERP - ERP que está integrado ao SIGATMS (0-Protheus |1-Datasul) | ||||||||||||||||||||||
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 Foram realizadas integrações dos cadastros de Produtos, Fornecedores, Clientes, Locais de Entrega e Código Único, gerados pelo módulo SIGATMS módulo SIGATMS (Transportation Management System) da linha Microsiga Protheus® com o Datasul Datasul®.
O Protheus 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 Protheus e o Datasul, além de fazer o controle de filas das mensagens a serem integradas.
Com o código único o sistema controlará de forma única e sequencial a numeração para qualquer cadastro integrado com a rotina de Código Único disponibilizada pela Integração do Datasul via Mensagem Padronizada – EAI Protheus® (Enterprise Application Integrator). e permitirá 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
É necessário que o
Definição da Regra de Negócio
Para que se cumpra o objetivo deste requisito, deverão ser criadas verificações para os processos de inclusão, alteração e exclusão dos itens relacionados, mantendo assim, tanto o SIGATMS quanto o DATASUL com informações idênticas, sempre assegurando a integridade dos dados.
O parâmetro MV_TMSERP deverá estar setado configurado como "1", onde significa que o sistema integrará com outra marca, neste caso, o DATASUL Datasul®, solicitando a inclusão, alteração e exclusão de registros e solicitando retorno em forma síncrona.
O Adapter EAI deve estar cadastradoconfigurado, indicando o(s) cadastro(s) que integrará com a outra marca.
O sistema deverá tratar tratará os cadastros com uma numeração única um Código Único para os registros integrados, onde terá um código informado pelo DATASUL 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 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.
|
Como funcionaAo 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:
- 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.
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.
| Informações | ||
|---|---|---|
| ||
Os campos Código Cliente (A1_COD) ou Código Fornecedor (A2_COD) devem ser preenchido com inicializador padrão. 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
Exemplo:
- Ao incluir, alterar ou excluir um registro, o sistema deverá verificar o parâmetro MV_TMSERP e se existe o Adapter EAI cadastrado para o determinado cadastro, verificando as seguintes situações:
- INCLUIR: Verificar se o registro já existe no destino, caso caso SIM, atualizar as informações de acordo com a origem, caso caso NÃO, incluir no destino e atualizar a origem com o código de numeração única disponibilizado pelo destino..
- ALTERAR: Verificar se registro se registro já existe no destino, caso caso SIM, atualizar as informações de acordo com a origem, caso caso NÃO, incluir no destino e destino e atualizar a origem com o código de numeração única disponibilizado pelo destino.
- EXCLUIR: Verificar Verificar se existe algum processo e/ou cadastro em que o registro esteja atrelado, tanto na origem, como no destino, caso caso SIM, notificar através de mensagem e não permitir a exclusão, caso caso NÃO, excluir na origem e no destino.
Procedimento para Configuração
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Configure o(s) parâmetro(s) a seguir:
Itens/Pastas | Descrição |
Nome: | MV_TMSERP |
Tipo: | |
Cont. Por.: | |
Descrição: |
|
CONFIGURAÇÃO DE ADAPTER'S EAI
2. 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étodo | 1- Síncrono |
| Operação | 1- Todas |
| Canal Envio | 2- EAI |
| Versão de Envio | 3.001 |
Mensagem Unica | 1-Sim |
Rotina | MATA020 |
Mensagem | CUSTOMERVENDOR |
Descrição | FORNECEDOR |
Envia | 1- Sim |
Recebe | 1- Sim |
| Método | 1- Síncrono |
| Operação | 1- Todas |
| Canal Envio | 2- EAI |
| Versão de Envio | 1.000 |
Mensagem Unica | 1-Sim |
Rotina | MATA020B |
Mensagem | CUSTOMERVENDORRESERVEID |
Descrição | CODIGO UNICO |
Envia | 1- Sim |
Recebe | 1- Sim |
| Método | 1- Síncrono |
| Operação | 1- Todas |
| Canal Envio | 2- EAI |
| Versão de Envio | 1.000 |
Mensagem Unica | 1-Sim |
Rotina | MATA030 |
Mensagem | CUSTOMERVENDOR |
Descrição | CLIENTES |
Envia | 1- Sim |
Recebe | 1- Sim |
| Método | 1- Síncrono |
| Operação | 1- Todas |
| Canal Envio | 2- EAI |
| Versão de Envio | 1.000 |
Mensagem Unica | 1-Sim |
Rotina | TMSA450 |
Mensagem | CUSTOMERSHIPPINGADDRESS |
Descrição | LOCAL DE ENTREGA |
Envia | 1- Sim |
Recebe | 1- Sim |
| Método | 1- Síncrono |
| Operação | 1- Todas |
| Canal Envio | 2- EAI |
| Versão de Envio | 1.001 |
Procedimento para Utilização
- Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
- Localização da rotina no menu;
- Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
- Caso seja necessário ter algum cadastro feito previamente, faça uma observação.
Exemplo:
1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).
O sistema apresenta a janela de produtos cadastrados.
2. Posicione o cursor em um produto e clique em Alterar.
3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.
4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).
O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.
5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:
Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.
6. Confira os dados e confirme.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas