Integrações

Páginas filhas
  • Atualizar De-Para Cliente/Fornecedor - EAI 2.0

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:

  1. Integração EAI 2.0 ativa e algum pacote instalado (por exemplo, Manutenção de Ativos x BackOffice RM).
  2. 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:
  3. Cadastrar o Adapter de atualização de De-Para no módulo SigaCFG do Protheus. Em Ambiente | Schedule | Adapter E.a.i, informe:
    1. Mensagem Única: Sim
    2. Rotina: INTXATU01
    3. Mensagem: INTERNALIDLOAD
    4. Descrição: INTERNALIDLOAD
    5. Envia: Não
    6. Recebe: Sim
    7. Método: Síncrono
    8. Operação: Todas
    9. Canal Envio: EAI
    10. Versão Envio: 1.000
  4. Aplicar o patch [InternalIdLoad.ptm] que disponibiliza o uso desta funcionalidade no SigaCFG do Protheus, caso o 3º passo não tiver sido executado.
    1. Para aplicações de patch, consulte o documento PSIGABD0073 - TOTVS Developer Studio - Aplicação de pacote de atualização (patch).
    2. Após aplicar o patch, repita o passo 3.
    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.