Funcionalidades do Atualizador
Contexto de negócio
O atualizador do De-Para de Cliente/Fornecedor - EAI 2.0 tem por finalidade disponibilizar opções que facilitem a conversão de De-Para's existentes em situações que a chave de integração irá ser alterada.
Objetivo
Este documento tem como objetivo apresentar as funcionalidades desenvolvidas no atualizador para que sejam ajustados os registros incorretos do De-Para no RM e no Protheus, para que não ocorra inconsistências ao integrar o Cliente/Fornecedor.
Premissas
Para o uso desse processo é necessário realizar as seguintes configurações:
- Integração EAI 2.0 ativa e algum pacote instalado (por exemplo, Manutenção de Ativos x BackOffice RM).
- Habilitar o perfil de segurança para utilizar o processo Atualizar De-Para Cliente/Fornecedor - EAI 2.0 no módulo Gestão Financeira. No cadastro do perfil do usuário acesse: Acesso a Menus | [07] Utilitários | [07.04] Outros | [07.04.03] Mais... | [07.04.03.05] Atualizar De-Para Cliente/Fornecedor - EAI 2.0:
- Cadastrar o Adapter de atualização de De-Para no módulo SigaCFG do Protheus. Em Ambiente | Schedule | Adapter E.a.i, informe:
- Mensagem Única: Sim
- Rotina: INTXATU01
- Mensagem: INTERNALIDLOAD
- Descrição: INTERNALIDLOAD
- Envia: Não
- Recebe: Sim
- Método: Síncrono
- Operação: Todas
- Canal Envio: EAI
- Versão Envio: 1.000
- Aplicar o patch [InternalIdLoad.ptm] que disponibiliza o uso desta funcionalidade no SigaCFG do Protheus, caso o 3º passo não tiver sido executado.
- Para aplicações de patch, consulte o documento PSIGABD0073 - TOTVS Developer Studio - Aplicação de pacote de atualização (patch).
- Após aplicar o patch, repita o passo 3.
- Atenção: Versão do patch homologada: 12.1.17 - Lobo Guará.
Contexto de Execução
O processo de Atualizar De-Para Cliente/Fornecedor - EAI 2.0 pode ser executado em três situações:
- Após a conversão da integração Manutenção de Ativos x BackOffice RM para o EAI 2.0;
- Pelo menu Executar, disponível no canto superior direito do RM.exe;
- Pelo módulo TOTVS Gestão Financeira | Utilitários | Mais... | Atualizar De-Para Cliente/Fornecedor - EAI 2.0.
Funcionalidades
Esse processo disponibiliza três opções para execução, são elas:
Cada funcionalidade é explicada abaixo, de acordo com a opção selecionada.
A primeira opção, quando selecionada, irá realizar a atualização de todos os De-Para's da mensagem CUSTOMERVENDOR existentes na versão 1.000 para a versão 2.002, tanto no RM, quanto no Protheus.
Atenção: Ao selecionar esse modo de execução, além de seguir as premissas citadas no início deste documento, é necessário que o Adapter CUSTOMERVENDOR esteja cadastrado no Protheus na versão de mensagem 2.002.
Na versão de mensagem 1.000 da CUSTOMERVENDOR o De-Para é criado da seguinte forma:
VALORRM: CODCFO {Código do Cliente/Fornecedor}
VALOREXTERNO: CODCFO+LOJA {Código do Cliente/Fornecedor + Loja definida no Inicializador Padrão dos campos A1_LOJA ou A2_LOJA, para a integração Manutenção de Ativos x BackOffice RM}
Ao executar o processo o sistema irá buscar todos os Cliente/Fornecedores integrados nas condições citadas acima, ou seja, há o registro de De-Para (GEAIDEPARA) para o Cliente/Fornecedor e esse existe na FCFO. Este Cliente/Fornecedor deve existir também nas tabelas do Protheus (SA1180 ou SA2180), não sendo necessário existir o De-Para na tabela XXF.
Após iniciar a execução do processo o sistema irá enviar uma mensagem INTERNALIDLOAD para cada registro do De-Para de Cliente/Fornecedor encontrado no RM para atualização. Caso a mensagem seja processada com sucesso, o registro antigo é apagado no RM e o novo é criado no Protheus e no RM.
Observações:
*Caso utilize a integração Manutenção de Ativos x BackOffice RM é necessário informar no cadastro de Parâmetros adapter o valor default definido no Inicializador Padrão do campo SA2.A2_LOJA do Protheus no parâmetro CODLOJADEFAULT.
Essa informação será utilizada para atualizar corretamente os registros de De-Para dos Clientes/Fornecedores que tenham a classificação do tipo "Ambos".
*Quando ocorrer a atualização do De-Para de Cliente(s)/Fornecedor(es) do tipo "Ambos", no RM será gravado apenas o De-Para do Fornecedor (pois a tabela é a mesma), mas no Protheus será criado um De-Para para cada tipo, Cliente e Fornecedor, uma vez que são tabelas distintas.
Cliente/Fornecedor Global
Quando o Cliente/Fornecedor integrado for Global (Coligada = 0), ao executar o processo, o De/Para será atualizado com a Coligada do contexto, ou seja, a Coligada em que o usuário está logado no momento.
Aqui vai a explicação da opção 2.
Aqui vai a explicação da opção 3.