Histórico da Página
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ísticakLogística | ||||||||||||||||||||||
Módulo: | SIGATMS - Gestão de Transportes | ||||||||||||||||||||||
Rotina: |
| ||||||||||||||||||||||
Cadastros Iniciais: | Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito. | ||||||||||||||||||||||
Parâmetro(s): | Informe os parâmetros utilizados. | ||||||||||||||||||||||
Informe o ponto de entrada relacionado (link). | |||||||||||||||||||||||
Tickets relacionados | Informe o(s) chamado(s) relacionado(s). | ||||||||||||||||||||||
Requisito/Story/Issue (informe o requisito relacionado): Informe o requisito relacionado (Issue). | LOGTMS01-1092 | ||||||||||||||||||||||
País(es): | Informe o(s) Pais(es).Todos | ||||||||||||||||||||||
Banco(s) de Dados: | Informe o(s) Banco(s) de Dados utilizado(s).Todos | ||||||||||||||||||||||
Tabelas Utilizadas: |
SA4 - Cadastro de Transportadoras CC2 -
| ||||||||||||||||||||||
Sistema(s) Operacional(is): | Informe o(s) sistema(s) operacional(is) utilizados. |
Descrição
Escreva aqui a descrição da nova implementação ou melhoria.
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente! A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:
Nome da Variável: | Informe o Nome da Variável |
Tipo: | Informe o Tipo |
Descrição: | Informe a Descrição |
Valor Padrão: | Informe o Valor Padrão |
Atualizações do Compatibilizador
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
- Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:
Pergunte | (X1_PERGUNT) |
Nome |
|
Grupo | (X1_GRUPO) |
Ordem | (X1_ORDEM) |
Tipo | (X1_TIPO) |
Tamanho | (X1_TAMANHO) |
2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
B04 (X2_CHAVE) | Dente/Região (X2_NOME) | C (X2_MODO) | N (X2_PYME) |
3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:
Chave | Ex.: AR |
Descrição | Ex.: Tabela de IR de Aplicações Financeiras |
4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:
- Tabela BGD - Prod x Cob x Proc x Co-Part:
Campo | (X3_CAMPO) |
Tipo | (X3_TIPO) |
Tamanho | (X3_TAMANHO) |
Decimal | (X3_DECIMAL) |
Formato | (X3_PICTURE) |
Título | (X3_TITULO) |
Descrição | (X3_DESCRIC) |
Nível | (X3_NÍVEL) |
Usado | (X3_USADO) Informe Sim ou Não |
Obrigatório | (X3_OBRIGAT) Informe Sim ou Não |
Browse | (X3_BROWSE) Informe Sim ou Não |
Opções | (X3_CBOX) |
When | (X3_WHEN) |
Relação | (X3_RELACAO) |
Val. Sistema | (X3_VALID) |
Help | Descreva o conteúdo informado para Help de Campo no ATUSX |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLS:
Alias | (XB_ALIAS) |
Tipo | (XB_TIPO) |
Sequência | (XB_SEQ) |
Coluna | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
6. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice | AA1 |
Ordem | 6 |
Chave | AA1_FILIAL+AA1_CODVEN |
Descrição | Cod. Vendedor |
Proprietário | S |
7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | (X6_VAR) |
Tipo | (X6_TIPO) |
Descrição | (X6_DESCRIC + X6_DESC1 + X6_DESC2) |
Valor Padrão | (X6_CONTEUD) |
8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:
- Tabela BD5 – Contas Médicas:
Campo | Informe o conteúdo do (X7_CAMPO) |
Sequência | Informe o conteúdo do (X7_SEQUENC) |
Campo Domínio | Informe o conteúdo do (X7_CDOMIN) |
Tipo | Informe o conteúdo do (X7_TIPO) |
Regra | Informe o conteúdo do (X7_REGRA) |
Posiciona? | Informe o conteúdo do (X7_SEEK) |
Chave | Informe o conteúdo do (X7_CHAVE) |
Condição | Informe o conteúdo do (X7_CONDIC) |
Proprietário | Informe o conteúdo do (X7_PROPRI) |
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), osistema 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 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 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.
- 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 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:
- 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.
- 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.
- 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é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 |
Informações | ||
---|---|---|
| ||
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
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas | Descrição |
Nome: |
|
Tipo: | Informe o Tipo do parâmetro |
Cont. Por.: | Informe o Conteúdo padrão |
Descrição: |
|
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções Schedule/Emp.filial Mensagem Única (APCFG050). Cadastre os De/Para a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
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.
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
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® |
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Return aCab