Páginas filhas
  • DI_Integracao_Folha_de_Pagamento_RM_x_BackOffice_Logix

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin
INTEGRAÇÃO FOLHA DE PAGAMENTO

Integração Folha de Pagamento RM X BACKOFFICE LOGIX

Contexto de negócio (Introdução)

A partir do release 12.1.11, estará está disponível aos clientes TOTVS a oferta de Integração do RM Folha de Pagamento ao ERP Logix. Essa integração se fez necessária pois o RH Logix será descontinuado, então o objetivo dessa solução é disponibilizar uma ferramenta de gestão de relacionamento com clientes, que poderá atender e automatizar cadastros de bancos/agências, cliente/fornecedor, item contábil (Área e Linha de Negócio), período contábil, histórico padrão, centro de custo e planos de contas, lançamento contábil e lançamento financeiro permitindo a possibilidade aos clientes para migrarem para o RM integrando o BackOffice Logix como  o RH Logix já fazA integração possibilita a realização de todos os processos de uma folha de pagamento de forma simples e segura, gerando os compromissos a pagar diretamente no financeiro do Logix, assim também os lançamentos contábeis diretamente no módulo contábil do ERP. Além dos lançamentos financeiros e contábeis, também são integrados os cadastros que sustentam estas operações. O funcionamento da integração ocorre de forma “Síncrona” “síncrona” entre os sistemas, utilizando a tecnologia EAI. Ou seja, sempre que o usuário ao cadastrar ou alterar uma informação no Logix e a mesma esta estiver dentro do contexto da integração, a informação será replicada.  


Sistemas Envolvidos

  • ERP Logix: O BackOffice Logix é o produto Totvs responsável por enviar via EAI as mensagens de Cliente/Fornecedor, Banco/AgenciaAgência, Item contábil (Área e Linha de Negócio), Período Contábil, Histórico padrão, Centro de Custo e Plano de Contas.

  • Totvs RM Folha de Pagamento: O RM Folha de Pagamento é o produto RM responsável por receber as mensagens enviadas pelo Logix, e enviar as mensagens de Lançamento Contábil e Financeiro. Além dos cadastros de Funcionários, Seção (unidade funcional), Cargo, Escala e Transferência de funcionários. 


Integração

O objetivo do projeto é integrar o ERP Logix com o Totvs RM Folha de Pagamento, através por meio das mensagens únicas "EAI". Desta forma, será disponibilizado aos clientes do ERP a possibilidade de trabalhar a sua gestão de backOffice de forma integrada ao Totvs RM. 


Escopo

O escopo da integração é a sincronização entre os cadastros de backOffice de ambos sistemas. Para fazer esse controle, as seguintes entidades foram integradas:

  • Banco/AgenciaAgência: Logix envia;
  • Item Contábil (Área e Linha de Negócio): Logix envia;
  • Período Contábil: Logix envia;
  • Histórico Padrão: Logix envia;
  • Centro de Custo: Logix envia;
  • Plano de Contas: Logix envia;
  • Lançamento Contábil: RM envia;
  • Lançamento Financeiro: RM envia

 

Pré-requisitos instalação/implantação/utilização

Para o correto funcionamento da integração é necessário realizar as seguintes configurações nos sistemas envolvidos:

 

RM

 

  1. Configurar o TBC para comunicação do Logix com o RM:

      Seguir a orientação do link abaixo para configurar o TBC:  http://tdn.totvs.com/pages/releaseview.action?pageId=82477609

          Colocar o endereço abaixo nas configurações de webservice do Logix:  http://{ip-servidor-TBC}/TOTVSBusinessConnect/wsEAIService.asmx?wsdl

2. Executar o Configurador para Integração Logix

 

Acesse o módulo Integração: Integração / Ferramentas / Configurar 

 Image Removed

 

Image Removed

  

Na tela do configurador:

 

  1. Digite o Usuário e Senha da base de dados;
  2. Clique em Testar Conexão (O botão avançar só será habilitado caso o resultado do teste retornar sucesso);
  3. Clique em Avançar. 

Image Removed

 

Selecione a integração: TOTVS Folha de Pagamento RM x BackOffice Logix 

Clique em Avançar 

Image Removed

 

 Na tela seguinte clique em Executar, e aguarde o final do processo conforme imagem abaixo. 

Image Removed

 

3. Configurando Integração Logix 

Acesse a integração através do menu: Integração / Mensagem Única / Integrações 

Image Removed

 

Image Removed

 

Edite o registro e insira as configurações necessárias para o webservice Logix. 

Image Removed

 

Verifique e configure (se necessário) os Parâmetros da Integração através do anexo Parâmetro de Integração.

 Image Removed

 

Verifique se todas as Entidades necessárias para a integração foram mapeadas com sucesso. 

Image Removed

 

4. Configurando o De-Para 

Para a integração é necessário criar manualmente um novo registro para o de-para para coligada. 

Acesse: Integração / Integração / Mensagem Única / De-Para.

 

Image Removed

 

Realize um novo cadastro onde:

 

Tabela RM: GCOLIGADA

Chave Primária RM: CODCOLIGADA 

Valor Chave Primária RM: [Código da coligada utilizada para integração] 

Sistema Integrado: LOGIX 

Valor Chave Integração: [Empresa do Logix enviada pela mensagem EAI] 

Image Removed

 

5. Parametrizando o Folha de Pagamento para a Integração 

É necessário parametrizar no modulo Folha de Pagamento a utilização de integração com outros BackOffice. 

Acesse o modulo de Folha de Pagamento: RH / Folha de Pagamento / Configurações / Parametrizador 

Image Removed

 

Image Removed

 

Selecione a configuração: 06.02 – Integrações / 06.02.06 – Outros BackOffice 

Image Removed

 

Ative a opção “Usa integração outros BackOffice”, configure a quantidade de partidas contábeis que serão enviados por pacote. Ao ativar a opção de integração com outros BackOffices, automaticamente o parâmetro “Gera lotes contábeis no Folha de Pagamento antes de enviar para o Saldus” localizado em 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal é marcado e bloqueado para alteração. 

Image Removed

 

Image Removed

 

Para configurar o agrupamento de partidas contábeis e a geração de lançamentos financeiros rateados por: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor, selecione a configuração: 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal. 

Obs.: Os parâmetros deverão ser habilitados somente se o parâmetro “usa integração outros backOffice” estiver marcado. 

Image Removed

 

Para a configuração agrupamento de partidas contábeis, acesse a Etapa 11 (Contabilização) e marque as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

Image Removed

 

Obs.: Os parâmetros dos grupos “Lançamento Contábil (RM Saldus)” e “Contabilização” foram movidos da na Etapa 17 (Geral) para a Etapa 11 (Contabilização). 

Image Removed

 

Image Removed

 

Para a configuração da geração de lançamentos rateados, acesse a Etapa 12 (Lancto Financeiro) e marque as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

Image Removed

Necessário:

  • Versão do sistema: Totvs RM 12.1.11 ou superior.
  • Modulo utilizado: RM Folha de Pagamento.
  • Ferramentas que são necessárias a integração: EAI.

    Logix

    No Logix os seguintes pré-requisitos devem ser atendidos

    1.    Versão 12.1.11 ou superior.

    2.    Build Totvstec na versão 7.00.131227A-20140829 ou superior.

    3.    EAI Logix e WebService instalados e configurados. Mais informações em: http://tdn.totvs.com/pages/releaseview.action?pageId=223159857  

    4.    Configurar a chave MAXSTRINGSIZE que está localizada na seção General do TotvsAppServer.ini. Caso não exista deverá ser adicionada. Ela define o tamanho máximo das mensagens (em MB) que serão trocadas entre os sistemas. Recomendamos qualquer valor acima de 15.

    Exemplo:

    Image Removed

    Mais informações em: http://tdn.totvs.com/pages/viewpage.action?pageId=161349793

    5.    Executar o conversor cap00977.cnv através do programa LOG6000 (Gerenciador de conversores). Será criada a tabela: cap_integracao_inss_auton.

    6.    Executar o conversor de parâmetro fin10089.cnv, através do programa LOG00088 (Processamento de conversores). Será criado ou alterado o parâmetro: “Último número de nota fiscal para integração de títulos por EAI.”

    7.    Cadastrar o Aplicativo externo RM com sua respectiva URL de acesso ao WEB SERVICE no EAI10000.

    8.    Cadastrar o relacionamento DE-PARA de empresas do Logix com as coligadas/filiais do RM, no EAI10000, conforme exemplo abaixo: 

     

    Image Removed

     

    Instalação/Atualização

    Os seguintes procedimentos deverão ser realizados para a implantação da integração entre os sistemas.

    Logix

    Configuração de parâmetros - LOG00087 - Manutenção de parâmetros:  
    Nome: Último número de nota fiscal para integração de títulos por EAI
    Local: Logix Financeiro > Contas a pagar > Apropriação de despesa
    Valor: Qualquer valor maior que zero. 
    Objetivo: Este parâmetro armazena o último gerado automaticamente pelo sistema e atribuído ao campo "Nota fiscal" de títulos a pagar originados de sistemas externos que não possuem tal informação. Este valor será incrementado automaticamente a cada integração. 
    Image Removed

     

    • ;
    • Pagamentos de autônomos: Logix envia (a partir da versão 12.1.13);
    • Lançamentos de comissão para a folha de pagamento: Logix envia (a partir da versão 12.1.13);
    • Devolução de adiantamento de viagem: Logix envia (a partir da versão 12.1.13);
    • Cargo (Função): RM envia (a partir da versão 12.1.13);
    • Unidade Funcional (Seção): RM envia (a partir da versão 12.1.13);
    • Turno e Escala: RM envia (a partir da versão 12.1.13);

    • Funcionário: RM envia (a partir da versão 12.1.13);
    • Transferência de funcionário: RM envia (a partir da versão 12.1.13).


    Pré-requisitos instalação/implantação/utilização

    Para o correto funcionamento da integração é necessário realizar as seguintes configurações nos sistemas envolvidos:


    RM 

    1. Configurar o TBC para comunicação do Logix com o RM:

    Seguir a orientação do link abaixo para configurar o TBC: http://tdn.totvs.com/pages/releaseview.action?pageId=82477609

    Colocar o endereço abaixo nas configurações de webservice do Logix: http://{ip-servidor-TBC}/TOTVSBusinessConnect/wsEAIService.asmx?wsdl


    2. Executar o Configurador para Integração Logix 

    Acessar o módulo Integração: Integração / Ferramentas / Configurar:

     Image Added

     

    Image Added

      

    Na tela do configurador: 

    1. Digitar o Usuário e Senha da base de dados;
    2. Clicar em Testar Conexão (O botão avançar só será habilitado caso o resultado do teste retornar sucesso);
    3. Clicar em Avançar. 

    Image Added

     

    Deverá ser executado o configurador para as seguintes integrações:

    • TOTVS Folha de Pagamento RM x BackOffice Logix;
    • TOTVS Folha de Pagamento RM x Outros Backoffices (Autônomos).

    O configurador só consegue executar uma integração de cada vez, então é necessário que o processo seja repetido para cada integração listada acima.

    Selecionar a integração e clicar em Avançar:

    Image Added

    Image Added


    Na tela seguinte, clicar em Executar e aguardar o final do processo, conforme imagem abaixo. 

    Image Added

     

    3. Configurando Integração Logix 

    Acessar a integração por meio do menu: Integração / Mensagem Única / Integrações: 

    Image Added

    Image Added

     

    Editar o registro, inserir as configurações do webservice Logix, e garantir que no campo Sistema Integrado esteja preenchido com o nome “Logix”. (Repita esse processo para todas as integrações configuradas no passo anterior).

    Image Added

     

    Verificar e configurar (se necessário) os Parâmetros da Integração por meio do anexo Parâmetro de Integração.


    ColigadaNome do ParâmetroTipoValor padrão
    0RH_CLIFORAUTOINCBooleanFalse
    0RH_CODCLASSIFICPAISInteger0
    0RH_CONTACAIXAAUTOINCBooleanFalse
    0RH_CENTROCUSTOAUTOINCBooleanFalse
    0RH_NATUREZAFINANCEIRADEFAULTString" " (vazio)


     Image Added

     

    Verificar se todas as Entidades necessárias para a integração foram mapeadas com sucesso. 


    TOTVS Folha de Pagamento RM x BackOffice Logix;

    Id IntegraçãoEntidadeVersãoAdapter
    1020CUSTOMERVENDOR2.000d25b1b1f-2878-40d4-a7bc-ab27ceca5566
    1020BANK2.0021ee544f5-4b15-45cc-aee3-f0a05fde4644
    1020ACCOUNTINGCALENDAR1.000d1f09a24-9148-4e2d-8e17-bc5a76c9f933
    1020AREAANDLINEOFBUSINESS1.000e9e9d0bf-32d6-4343-9531-92d174f92faf
    1020LISTOFACCOUNTANTDEFAULTHISTORY2.00041559d6e-9713-492f-b395-f1e807c32b22
    1020LISTOFCOSTCENTER2.001670be9e3-f144-4ac9-91f3-1a8eee3c1355
    1020LISTOFACCOUNTANTACCOUNT2.0029f0f85bf-f5c8-4ecb-b439-783acd087e11
    1020ACCOUNTPAYABLEDOCUMENT2.0022810e737-4e2c-4321-ac27-3b398cc4d7fb
    1020ACCOUNTINGENTRY2.002xrf09a24-9148-4e2d-8e17-t15a76c9f999
    1020ROLE1.000--
    1020SCHEDULEWORK1.000--
    1020DEPARTAMENT2.000abe77044-a478-4065-b53f-f7d2a2c16355
    1020EMPLOYEE2.0035f851a7c-af46-4fbf-993e-e86d9a33ebb2
    1020SETEMPLOYEEBRANCHTRANFER1.00063f0726c-5e69-4efb-851d-7b7d800cc1af
    1020MONTHLYPAYROLL1.0000cbbbc17-7672-41d9-91be-c8e17b180ae8


    TOTVS Folha de Pagamento RM x Outros Backoffices (Autônomos).

    Id IntegraçãoEntidadeVersãoAdapter
    1015EXTERNALAUTONOMOUSPAYMENT1.00066fc6ff8-c35b-4a9c-91d4-d126c6a31805


    Image Added

    Image Added

     

    4. Configurando o De-Para 

    Para a integração é necessário criar manualmente um novo registro para o de-para para coligada. 

    Acessar: Integração / Integração / Mensagem Única / De-Para: 

    Image Added

     

    Realizar um novo cadastro em que: 

    CampoValor
    Tabela RMGCOLIGADA
    Chave Primária RMCODCOLIGADA 
    Valor Chave Primária RM[Código da coligada utilizada para integração]
    Sistema IntegradoLOGIX 
    Valor Chave Integração[Empresa do Logix que será vinculada a coligada acima]

    Image Added


    Como o Logix não trabalha com o conceito de filial, para as integrações enviadas para o RM que se faz necessário a utilização desta, o Logix enviará o código da empresa como filial, então no campo Valor Chave Integração os dois campos serão referentes a empresa do Logix.

    CampoValor
    Tabela RMGFILIAL
    Chave Primária RMCODCOLIGADA|CODFILIAL
    Valor Chave Primária RM[Código da coligada utilizada para integração] | [Código da filial utilizada para integração]
    Sistema IntegradoLOGIX 
    Valor Chave Integração[Empresa do Logix que será vinculada a coligada acima] | [Empresa do Logix que será vinculada a coligada acima]

    Image Added


    5. Parametrizando o Folha de Pagamento para a Integração 

    É necessário parametrizar no módulo Folha de Pagamento a utilização de integração com outros BackOffice. 

    Acessar o módulo de Folha de Pagamento: RH / Folha de Pagamento / Configurações / Parametrizador: 

    Image Added

     

    Image Added

     

    Selecionar a configuração: 06.02 – Integrações / 06.02.06 – Outros BackOffice: 

    Image Added 

    Ativar a opção “Usa integração outros BackOffice”, configurar a quantidade de partidas contábeis que serão enviados por pacote. Ao ativar a opção de integração com outros BackOffices, automaticamente o parâmetro “Gera lotes contábeis no Folha de Pagamento antes de enviar para o Saldus” localizado em 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal é selecionado e bloqueado para alteração. 

    Image Added

     

    Image Added

     

    Para configurar o agrupamento de partidas contábeis e a geração de lançamentos financeiros rateados por: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor, selecionar a configuração: 06.01 – Folha de Pagamento / 06.01.03 – Folha Normal. 

    Nota
    titleNota:
    Os parâmetros deverão ser habilitados somente se o parâmetro “usa integração outros backOffice” estiver selecionado. 

    Image Added

     

    Para a configuração agrupamento de partidas contábeis, acessar a Etapa 11 (Contabilização) e selecionar as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

    Image Added 

    Nota
    titleNota:
    Os parâmetros dos grupos “Lançamento Contábil (RM Saldus)” e “Contabilização” foram movidos da Etapa 17 (Geral) para a Etapa 11 (Contabilização). 

    Image Added

     

    Image Added

     

    Para a configuração da geração de lançamentos rateados, acessar a Etapa 12 (Lancto Financeiro) e selecionar as opções: Item Contábil (Área e Linha de Negócio) e/ou Classe de Valor. 

    Image Added


    6. Importação de Fórmulas Visuais

    Para o envio de algumas mensagens se faz necessária a importação das suas respectivas fórmulas visuais. Deverão ser importados os seguintes pacotes:

      • PTOWKF0001 - ScheduleWork.TotvsWF
      • FOPWKF0002 - Role.TotvsWF
      • FOPWKF0003 - Department.TotvsWF
      • FOPWKF0004 - Employee.TotvsWF

    Carga Inicial

      • PTOWKF0001 - ScheduleWork - Carga_Inicial
      • FOPWKF0002 - Role - Carga_Inicial
      • FOPWKF0003 - Department - Carga_Inicial
      • FOPWKF0004 - Employee - Carga_Inicial

    Nota
    titleNota:
    As mensagens ScheduleWork, Role, Departament e Employee estão disponíveis no RM a partir da versão 12.1.13


    Acessar Gestão / Fórmula Visual / Fórmula Visual.

    Executar o processo “Importação de Fórmula Visual”

    Image Added


    Clicar em Adicionar Objetos, e selecionar o pacote a ser importado.

    1 - Selecionar a Fórmula Visual;

    2 – Clicar na aba Parâmetros;

    3 – Inserir a categoria;

    4 – Selecionar a opção de importar gatilho;

    5 – Executar o processo.

    Image Added

    Image Added

    Esse processo deve se repetir para cada um dos pacotes listados acima.


    7. Configuração de Processos de Fórmulas Visuais

    Para o envio da Carga Inicial se faz necessário a configuração das respectivas fórmulas visuais como processo. Para isso deve-se seguir os seguintes passos:


    Acessar a tela de visão de Fórmulas visuais: Gestão / Fórmula Visual / Fórmula Visual

    Image Added

    Image Added


    Logo em seguida acessar: Processos / Fórmula Visual / Gerenciar

    Image Added


    1 – Abra a aba “Processos de Fórmula Visual”;

    2 – Selecione as Fórmulas referente a carga inicial;

    3 – Clique em OK.

    Image Added


    Após adição das Fórmulas no Processo de Fórmula visual elas ficarão disponíveis para execução ao acessar: Processo / Fórmula Visual (Na visão de Fórmulas Visuais).

    Image Added


    Necessário:

    • Versão do sistema: Totvs RM 12.1.11 ou superior.
    • Módulo utilizado: RM Folha de Pagamento.
    • Ferramentas que são necessárias a integração: EAI.


    Logix

    No Logix os seguintes pré-requisitos devem ser atendidos

    1. Versão 12.1.11 ou superior. 

      Informações
      titleImportante:
      Empresas que utilizam a versão 12.1.11 deverão solicitar os seguintes pacotes de chamados/projetos para a área de framework: FRWJOI01-416, FRWJOI01-173, TSTRNJ, TSRLF0, TSRKTG.
    2. Build Totvstec na versão 7.00.131227A-20140829 ou superior.
    3. EAI Logix e WebService instalados e configurados. Mais informações em: http://tdn.totvs.com/pages/releaseview.action?pageId=223159857  
    4. Configurar a chave MAXSTRINGSIZE que está localizada na seção General do TotvsAppServer.ini. Caso não exista, deverá ser adicionada. Ela define o tamanho máximo das mensagens (em MB) que serão trocadas entre os sistemas. Recomendamos qualquer valor acima de 15.
      Exemplo:
      Image Added
      Mais informações em: Seção [general], chave MaxStringSize
    5. Executar o conversor cap00977.cnv por meio do programa LOG6000 (Gerenciador de conversores). Foi criada a tabela: cap_integracao_inss_auton (versão 12.1.13 ou superior).
    6. Executar o conversor de parâmetro fin10089.cnv, por meio do programa LOG00088 (Processamento de conversores). Foi criado/alterado o parâmetro: “Último número de nota fiscal para integração de títulos por EAI” (versão 12.1.13 ou superior).
    7. Executar o conversor de parâmetro con00218.cnv (versão 12.1.13), por meio do programa LOG00088. Foram criados os seguintes parâmetros: "Replicar o plano de contas para todas as empresas que compartilham?" e "Replicar o histórico contábil para todas as empresas que compartilham?".
    8. Cadastrar o Aplicativo externo RM com sua respectiva URL de acesso ao WEB SERVICE no EAI10000.
    9. Cadastrar o relacionamento DE-PARA de empresas do Logix com as coligadas/filiais do RM, no EAI10000, conforme exemplo abaixo:

    Image Added


    Instalação/Atualização

    Os seguintes procedimentos deverão ser realizados para a implantação da integração entre os sistemas.


    Logix

    • Configuração de parâmetros - LOG00087 - Manutenção de parâmetros:
      Nome: Último número de nota fiscal para integração de títulos por EAI.
      Local: Logix Financeiro > Contas a pagar > Apropriação de despesa.
      Valor: Qualquer valor maior que zero. 
      Objetivo: Este parâmetro armazena o último gerado automaticamente pelo sistema e atribuído ao campo "Nota fiscal" de títulos a pagar originados de sistemas externos que não possuem tal informação. Este valor será incrementado automaticamente a cada integração. 

      Image Added
    • Mensagens únicas:
      Para configurar as mensagens que trafegarão entre os sistemas, é necessário primeiramente ter realizado a implantação e configuração do Web service e EAI, conforme descrito no item "Pré-requisitos instalação/implantação/utilização" deste documento. Em seguida acesse o EAI10000, escolha a opção "Aplicativo Hospedeiro" no menu "Configuração". Faça a busca dos adapters de mensagens por meio do botão "Buscar Adapters", conforme demonstrado na figura abaixo. Leia atentamente a mensagem exibida na tela e selecione a opção "Sim" para prosseguir ou "Não" para abortar o processo. 

      Image Added

      As mensagens devem ser ativadas observando a sua versão, rota, e contexto. A lista das mensagens encontra-se na seção "Transações/Entidades/Mensagens únicas" deste documento. 
      Nesta integração todas as mensagens devem ser configuradas para o contexto "padrão". A seguir exemplo de ativação da mensagem CustomerVendor: 

      Image Added

      Image Added
       

    Controle de Versão

    O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.


    Suporte

    O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Logix estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.


    Transações/Entidades/Mensagens únicas

    Método

    ID

    Descrição

    Origem

    Destino

    XSD (versões podem variar)

    Cadastros

    01

    Cliente/Fornecedor

    Logix

    RM

    CustomerVendor_2_000.xsd

    02

    Banco/Agência

    Logix

    RM

    Bank_2_002.xsd

    03

    Item Contábil (Área e Linha de Negócio)

    Logix

    RM

    AreaAndLineOfBusiness_1_000.xsd

    04

    Período Contábil

    Logix

    RM

    AccountingCalendar_1_000.xsd

    05

    Histórico Padrão

    Logix

    RM

    ListOfAccountantDefaultHistory_2_000.xsd

    06

    Centro de Custo

    Logix

    RM

    ListOfCostCenter_2_001.xsd

    07

    Plano de Contas

    Logix

    RM

    ListOfAccountantAcoount_2_002.xsd

    08

    Lançamento Contábil

    RM

    Logix

    AccountingEntry_2_002.xsd

    09

    Lançamento Financeiro

    RM

    Logix

    AccountantPayableDocument_2_002.xsd

    10Unidade Funcional (Seção)RMLogixDepartament_2_000.xsd
    11FunçãoRMLogixRole_1_000.xsd
    12Turno e EscalaRMLogixSchedulework_1_000.xsd
    13FuncionárioRMLogixEmployee_2_003.xsd
    14Transferência de funcionárioRMLogixSetEmployeeBranchTranfer_1_000.xsd 
    15Pagamento de Autônomos Externos - SEFIPLogixRMExternalAutonomousPayment_1_000.xsd 
    16Pagamento de ComissõesLogixRMMonthlyPayroll_1_000.xsd



    Fluxo das Informações

    • Logix envia Cliente/Fornecedor para o RM
      • Cadastro de Cliente/Fornecedor no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Banco/Agência para o RM
      • Será realizado cadastro de:
        • Banco
          • Cadastro de Banco no RM deverá ficar bloqueado para criação/alteração/exclusão.
        • Agência
          • Cadastro de Agência no RM deverá ficar bloqueado para criação/alteração/exclusão.
        • Conta Corrente
          • Cadastro de Conta Corrente no RM deverá ficar bloqueado para criação/alteração/exclusão.
        • Conta Caixa
          • Cadastro de Conta Caixa no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Item Contábil (Área e Linha de Negócio) para o RM
      • Cadastro de Item Contábil (Área e Linha de Negócio) no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Período Contábil para o RM
      • Cadastro de Período Contábil no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Histórico Padrão para o RM
      • Cadastro de Histórico Padrão no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Centro de Custo para o RM
      • Cadastro de Centro de Custo no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Plano de Contas para o RM
      • Cadastro de Plano de Contas no RM deverá ficar bloqueado para criação/alteração/exclusão.

    • RM envia Lançamento Contábil para o Logix
      • Logix consiste o lote e grava para posterior conferência e efetivação pelo contábil.

    • RM envia Lançamento Financeiro para o Logix
      • Logix consiste e efetiva o título para posteriormente ser pago pelo financeiro. 

    • RM envia Unidade Funcional (Seção) para o Logix
      • Cadastro de Unidade Funcional (Seção) no Logix deverá ficar bloqueado para criação/alteração/exclusão.

    • RM envia Cargos/Funções para o Logix
      • Cadastro de funções no Logix deverá ficar bloqueado para criação/alteração/exclusão.

    • RM envia Turno e Escala para o Logix
      • Cadastro de Turno e Escala no Logix deverá ficar bloqueado para criação/alteração/exclusão.

    • RM envia Funcionário para o Logix
      • Cadastro de Funcionário no Logix deverá ficar bloqueado para criação/alteração/exclusão.

    • RM envia Transferência de funcionário para o Logix
      • Cadastro de Transferência de funcionário no Logix deverá ficar bloqueado para criação/alteração/exclusão.

    • Logix envia Pagamentos a Autônomos Externos - SEFIP para o RM
      • RM consiste as informações e as utiliza na confecção do arquivo SEFIP.

    • Logix envia Comissão representante para o RM
      • RM faz o lançamento do provento na folha do funcionário.  

    • Logix envia Devolução de adiantamento de viagem para o RM
      • RM faz o lançamento do desconto na folha do funcionário.  


    Cargas Iniciais

    • Carga inicial de cadastro do RM para Logix

      O objetivo da carga inicial é realizar o cadastro em massa dos registros já existentes na base do RM para o Logix. É indicado que seja executado uma única vez na implantação da integração. Porém, nada impede que seja executado em outros momentos, conforme a necessidade de sincronização dos cadastros. 

      Abaixo a lista das entidades que precisam ser integradas com o Logix por meio da carga inicial. 

      “Carga Inicial de Turno e Escala.”
      “Carga Inicial de Função.”
      “Carga Inicial de Unidade Funcional/Seção.”
      “Carga Inicial de Funcionário.”

    • Carga inicial de cadastro do Logix para RM 

      FIN00000 (Centralização de programas Conversores).

      O objetivo do FIN00000 é prover a carga inicial de cadastros do Logix para sistemas externos. É indicado que seja executado uma única vez na implantação da integração. Porém, nada impede que seja executado em outros momentos, conforme a necessidade de sincronização dos cadastros. 

      Abaixo a lista das entidades que precisam ser integradas com o RM por meio da carga inicial. É importante lembrar que o programa possui filtros, assim pode-se integrar somente os registros que o RM realmente irá utilizar.

      “Carga Inicial de Fornecedores para sistemas Externos.”
      “Carga Inicial de Plano de contas para integrações.”
      “Carga Inicial de Centro de Custos.”
      “Carga Inicial de Área e linha de negócio.”
      "Carga inicial de agências bancárias"
      "Carga inicial de históricos contábeis"
      "Carga inicial de períodos contábeis"


      Image Added ATENÇÃO é imprescindível que a carga inicial das tabelas acima seja realizada pelo FIN00000. Este programa funciona da seguinte maneira: 

      1º - Usuário seleciona a entidade que deseja enviar para o RM;
      2º - Define quais serão os critérios de filtros; 
      3º - Processa a carga; 
      4º - Sistema seleciona as entidades conforme o filtro, para cada registro é enviado um XML para o RM. 
      5º - RM recepciona o XML, consiste e retorna o resultado para o Logix, contendo o código da entidade na Origem (Logix) e Destino (RM). 
      6º - Logix grava o De-para da entidade, que chamamos de "InternalId".

      Nota
      titleNota:
      A comunicação entre os sistemas utiliza o "InternalID" que trata-se do cadastro "De-para" que é gravado em ambos os sistemas. Esta técnica permite a comunicação entre os sistemas que utilizam tipos de dados diferentes como chave das entidades. Sempre que o Logix referenciar uma chave estrangeira em uma mensagem será utilizado o InternalID do Logix, da mesma forma o RM utilizará o seu InternalID nas comunicações com o Logix. O sistema receptor resolverá o código por meio do cadastro "De-para".

      Os seguintes De-para são utilizados na carga de cadastros do Logix: 

    DEPARA_IDTABELA_INTERNACAMPO_INTERNO
    AccountantAccountplano_contascod_empesa|num_conta|num_conta_reduz
    AccountantDefaultHistoryhist_padraocod_empresa|cod_hist
    AccountingCalendarperiodoscod_empresa|per_contabil
    AreaAndLineOfBusinessInternalIdlinha_prodcod_lin_prod|cod_lin_recei|cod_seg_merc|cod_cla_uso
    Bankagencia_bcocod_agen_bco
    CostCentercad_cccod_empresa|cod_cent_cust
    CustomerVendorInternalIdfornecedorcod_fornecedor



    Informações
    titleImportante:

    Os detalhes do funcionamento da carga inicial de cada entidade estão descritos no tópico Cadastro deste documento.

    Cadastros

    • Cliente/Fornecedor

    LOGIX

    O cadastro de clientes e fornecedores é realizado no Logix e integrado ao RM por meio da mensagem CUSTOMERVENDOR versão 2.000. Portanto, a mensagem precisa estar habilitada para envio no EAI10000. Possíveis inconsistências ou erros ocorridos durante o processo de integração serão apresentados em tela e a operação não será efetivada, possibilitando ao usuário tomar a ação de correção ou ajuste da inconsistência. Toda o processo de integração fica registrado no monitor de integração do EAI10000 e pode ser consultado a qualquer momento.

    Image Added

    As integrações são síncronas, ou seja, para a alteração, inclusão ou exclusão ser efetivada o Logix aguarda o OK da mensagem enviada para o RM, As mensagens retornam além do "status" da operação ("OK" ou "ERROR") os códigos do fornecedor na origem (Logix) e no destino (RM), este código é chamado de "InternalID" e é composto pelos campos das chaves primárias do cadastro nos respectivos produtos. 

    Image Added

    O código interno, também pode ser consultado a qualquer momento no EAI10000 > Configuração > Aplicativo Externo. Efetuar a consulta pelo aplicativo RM e utilizar o botão "Consulta De/Para", efetuar a busca conforme o critério desejado:  

    Image Added

    Informações
    titleImportante:

    Para a integração com o RH são integrados somente fornecedores, portanto os clientes não são enviados ao RM, embora a mensagem permita tal integração.

    O Tipo de Fornecedor no Logix, informado na aba Fornecedores, campo Tipo, deverá ser informado como sendo Fornecedor ou Fornecedor/Transportadora, para que seja feito o envio desta mensagem.


    RM

    Para o RM receber a integração de fornecedor é necessário que a entidade CUSTOMERVENDOR na versão 2.000 esteja configurada na integração juntamente ao evento d25b1b1f-2878-40d4-a7bc-ab27ceca5566 (Tratamento de cliente/fornecedor).

     Image Added

    Para esta também é necessário que a integração tenha os parâmetros RH_CLIFORAUTOINC e RH_CODCLASSIFICPAIS configurados.

     Image Added

      Image Added

    O parâmetro RH_CLIFORAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCFO.CODCFO”.

    Caso o parâmetro esteja configurado para não considerar o auto incremento, a máscara do código do Cliente/Fornecedor do RM deve ser configurada de acordo com a máscara do cliente/fornecedor enviada pelo Logix:
    Exemplo: “QQQQQQQQ”. [Permite qualquer caractere limitado a 8 posições].

    Image Added

    Caso o parâmetro esteja configurado para ativar o auto incremento, a máscara deve ser definida como # (numérica) e o parâmetro do financeiro “Usar código sequencial (se máscara for numérica)” deve ser marcado.

    Image Added

    Nota
    titleNota:
    Por padrão a opção “Usar código sequencial (se máscara for numérica)” fica desativada. Esta só é ativada para seleção após definir a máscara como numérica, conforme imagem acima.

    Após o envio da mensagem pelo Logix, é possível verificar o recebimento da mesma por meio da Fila de mensagens únicas que pode ser acessada por meio do caminho: Integração / Integração / Mensagem Única / Fila de mensagens únicas.

    Image Added

    Image Added

    No anexo “Informação de execução de mensagem” acessado por meio da tela de Fila de mensagem pode verificar o status da mensagem enviada pelo Logix.

    Image Added

    Image Added

    Ao receber/atualizar o Cliente/Fornecedor, o EAI deverá criar automaticamente o cadastro De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para:

    Image Added




    • Banco/Agência/Contas bancárias

    Logix

    O cadastro de banco, agências e contas bancárias é de responsabilidade do Logix, para integrar ao RM a mensagem Bank na versão 2.002 deve estar habilitada para envio. 

    A mensagem é disparada a partir dos programas FIN30065 (Agências bancárias) e CAP0120 (Agências). Os dados enviados são: banco, agência bancária e as contas bancárias pertencentes ao banco e agência em questão.

    Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno (Bank) do banco no RM, que será utilizado posteriormente em outras mensagens. 

    Informações
    titleImportante:
    A integração considera somente as contas bancárias da empresa corrente. Portanto, contas bancárias de outras empresas não serão integradas mesmo que pertençam ao mesmo banco e agência.


    RM

    Para o RM receber a integração de Banco/Agência é necessário que a entidade BANK na versão 2.002 esteja configurada na integração juntamente ao evento 1ee544f5-4b15-45cc-aee3-f0a05fde4644 (Tratamento de dados bancários).

    Nesta integração é realizado os cadastros de Banco, Agência, Conta Corrente e Conta Caixa. Agência é um anexo da visão de Banco, assim como Conta Corrente é um anexo da visão de Agência. Na Linha RM são tabelas independentes: Banco (GBANCO), Agência (GAGENCIA), Conta Corrente (FCONTA) e Conta Caixa (FCXA). Com isso, a exclusão da entidade banco no Logix, reflete na exclusão de uma Conta caixa, conta, agencias e banco no Lado RM.

     Image Added

    Para esta também é necessário que a integração tenha o parâmetro RH_ CONTACAIXAAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.

     Image Added

    O parâmetro RH_ CONTACAIXAAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCXA.CODCXA”.

    Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “FCXA.CODCXA” a conta caixa enviada na mensagem.

    Caso o parâmetro esteja configurado para ativar o auto incremento o Código da conta caixa no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o número da conta bancária enviada na mensagem única.

    Ao receber/atualizar o Banco/Agência, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para:

    Image Added




    • Item Contábil (Área e Linha de Negócio)


    Logix 

    A integração ocorre pela mensagem AREAANDLINEOFBUSINESS, portanto deve estar habilitada para envio. Disparamos a mensagem por meio dos programas VDP0340 e VDP10056 (Área Estratégica de Negócio). 

    Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno "AreaAndLineOfBusinessInternalId", que será utilizado nas integrações de títulos, lançamentos contábeis, entre outras. Portanto, é imprescindível o retorno testa informação. 


    RM

    Para o RM receber a integração de Item Contábil (Área e Linha de Negócio) é necessário que a entidade AREAANDLINEOFBUSINESS na versão 1.000 esteja configurada na integração juntamente ao evento e9e9d0bf-32d6-4343-9531-92d174f92faf (Tratamento de item contábil).

     Image Added


    Existem três pontos para visualizar os registros integrados de item contábil (Área e Linha de Negócio):

      • Educacional / Educacional / Integrações / Protheus / Item Contábil;
      • RH / Folha de Pagamento / Encargos / Contabilização – Cadastros / Item Contábil;
      • RH / Folha de Pagamento / Encargos / Financeiro – Cadastros Financeiros / Item Contábil.

    No intuito de evitar cadastros duplicados, e tornar possível utilizar as mesmas informações para mais de uma integração, foi padronizado para que ambos menus apontem para a mesma tela (Tela de item contábil do módulo Educacional).

    Item contábil no módulo Educacional:

     Image Added

     Image Added


    • Item contábil no módulo Folha de Pagamento:

     Image Added

    Image Added

    Image Added

    Ao receber/atualizar o Item Contábil (Área e Linha de Negócios), o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para:

    Image Added

    Após recebimento, o Item Contábil (Área e Linha de Negócio) poderá ser vinculado ao Funcionário, na Seção, e no Agrupamento de Contas por meio do lookup disponibilizado nas respectivas telas.

    RM / Folha de Pagamento / Administração de Pessoal / Funcionários:

    Image Added

    Na tela de cadastro de Funcionários acessar: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Item Contábil.

     Image Added

    RM / Folha de Pagamento / Administração de Pessoal / Seções:

    Image Added

    Na tela de cadastro de Seção acessar: Dados Contábeis / Item Contábil:

    Image Added

    RM / Folha de Pagamento / Encargos / Contabilização – Cadastros / Cadastros Contábeis / Agrupamento de Contas:

    Image Added


    Na tela de cadastro do Agrupamento de Contas: Item Contábil (Área e Linha de Negócio).

    Image Added

    Nota
    titleNota:

    1: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver desmarcado, o campo deverá ficar oculto

    2: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver selecionado e os parâmetros "Agrupar partidas contábeis por Item Contábil" e "Gerar lanctos rateados por Item Contábil" estiverem desmarcados, o campo deverá ficar desabilitado.




    • Período Contábil

    Logix 

    É disparada a mensagem ACCOUNTINGCALENDAR a partir dos programas CON0050 e CON10009 (Períodos contábeis). É importante ressaltar que esta mensagem enviará uma lista contendo todos períodos e segmentos de períodos da empresa corrente. 

    A mensagem só é disparada em operações que envolvam o menor ou maior período cadastrado para a empresa. Sendo assim, ao incluir um período, que seja posterior ao maior período cadastrado, será enviado uma mensagem contendo todos os períodos e segmentos da empresa. Da mesma forma ao incluir um período anterior ao menor período já cadastrado. A modificação ou exclusão do maior e menor período também dispara a mensagem. As demais operações não geram integração, pois para o RM a informação relevante são os limites inferior e posterior de período do calendário.  


    RM

    Para o RM receber a integração de Período Contábil é necessário que a entidade ACCOUNTINGCALENDAR na versão 1.000 esteja configurada na integração juntamente ao evento d1f09a24-9148-4e2d-8e17-bc5a76c9f933 (Período contábil).

     Image Added

    Nesse processo de integração, o lado RM atualizará as datas de período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Logix. No Logix, essas informações são armazenadas em um cadastro, e no RM essas informações são armazenadas nos parâmetros, sendo assim, teremos espaço para armazenar somente uma dataIncial e uma dataFinal.

    Image Added

    Image Added

    Image Added

    Para esta integração não é salvo um cadastro De-Para porque o período contábil é um parâmetro que não tem uma tela de cadastro, para a sua atualização é realizado um update em seu registro direto no banco de dados.




    • Histórico Padrão

    Logix

    A sincronização do histórico padrão ocorre por meio da mensagem LISTOFACCOUNTANTDEFAULTHISTORY e é disparada a partir dos programas CON0020 e CON10002 (Histórico padrão dos lançamentos contábeis). Este código é utilizado no lançamento contábil das movimentações da folha de pagamento para a integração com a contabilidade Logix. 

    Para as empresas que utilizam a centralização do histórico contábil (Empresa histórico padrão) será enviada uma lista em que o histórico padrão será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

    Empresa 01 e 02 compartilham o mesmo cadastro de histórico. Então a mensagem de integração conterá uma lista com informações de histórico para a empresa 01 e para a 02.

    Image Added

    Informações
    titleImportante:
    Será gravado o internalid "AccountantDefaultHistory" no de-para do Logix somente para a empresa do histórico.

    Foi disponibilizado, a partir da versão 12.1.13, a opção de enviar o histórico padrão somente para a empresa do cadastro. Por padrão a integração replica a mensagem para todas as empresas que compartilham o cadastro (empresa_hist).

    Descrição do parâmetro: Replicar o histórico contábil para todas as empresas que compartilham?
    Local: ADMINISTRACAO LOGIX > CONTROLE GERAL > INTEGRACAO ENTRE SISTEMAS
    Valores aceito: S e N.


    Foram disponibilizadas, a partir da versão 12.1.17, as seguintes funcionalidades:

    • Parâmetro para indicar a opção de definir se para as empresas que compartilham a Empresa Plano e a Empresa Histórico, estas irão compor na lista das empresas na mensagem para envio através do EAI

    Descrição do parâmetro: Empresa está habilitada para a réplica: Empresa Histórico Padrão?
    Local: ADMINISTRACAO LOGIX > CONTROLE GERAL > INTEGRACAO ENTRE SISTEMAS 
    Valores aceitos:
    S - Enviará o cadastro do histórico padrão desta empresa na lista das empresas que são compartilhadas pela Empresa Histórico Padrão.
    N - Não enviará o cadastro do histórico padrão  desta empresa na lista de empresas que compartilham o Histórico Padrão.

    Esta parametrização deverá ser feita para todas as empresas que compões a Empresa Histórico. Por padrão, será atribuído S a todas as empresas

    • Novo contexto, definido como recursos_humanos, devendo ser definido o EAI10000, na opção do Aplicativo Hospedeiro, para a mensagem listofaccountantdefaulthistory
      Este contexto irá conter uma regra especifica para tratamento das empresas associadas a Empresa Histórico Padrão, que estão relacionadas ao RHU3330 - Cadastros de Empresas do RH Logix e que estão mapeadas no EAI10000, sendo que somente estas serão levadas para o aplicativo externo ao qual o RH foi migrado. 

    RM

    Para o RM receber a integração de Histórico Padrão é necessário que a entidade LISTOFACCOUNTANTDEFAULTHISTORY na versão 2.000 esteja configurada na integração juntamente ao evento 41559d6e-9713-492f-b395-f1e807c32b22 (Tratamento de histórico padrão).

     Image Added


    Esta integração se fez necessária devido ao Logix permitir vincular o mesmo histórico padrão para um grupo de empresas.

    Exemplo:

    Empresa 01 e 02 utilizam o histórico padrão 01

    Empresa 03, 04 e 05 utilizam o histórico padrão 02

    Considerando que o De-Para de empresas esteja configurado da seguinte forma:

      • Empresa 01 = Coligada 1
      • Empresa 02 = Coligada 2
      • Empresa 03 = Coligada 3
      • Empresa 04 = Coligada 4
      • Empresa 05 = Coligada 5

    O RM deverá salvar da seguinte maneira:

      • Coligada 1 - histórico padrão 01
      • Coligada 2 - histórico padrão 01
      • Coligada 3 - histórico padrão 02
      • Coligada 4 - histórico padrão 02
      • Coligada 5 - histórico padrão 02


    Ao receber/atualizar o Histórico Padrão, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

     Image Added




    • Centro de Custo

    Logix

    A mensagem LISTOFCOSTCENTER é utilizada para a integração do cadastro de centro de custos. 

    Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será enviada uma lista em que o centro de custo será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

    Empresa 01 e 02 compartilham o mesmo cadastro de centro de custo. Então a mensagem de integração conterá uma lista com informações de centro de custos para a empresa 01 e para a 02.

    Image Added

    Informações
    titleImportante:
    Será gravado o internalid "CostCenter" no de-para do Logix somente para a empresa do plano.

    Foi disponibilizado, a partir da versão 12.1.13, a opção de enviar o centro de custo somente para a empresa do cadastro. Por padrão a integração replica a mensagem para todas as empresas que compartilham o cadastro (empresa_plano).

    Descrição do parâmetro: Replicar o plano de contas para todas as empresas que compartilham? 

    Local: ADMINISTRACAO LOGIX > CONTROLE GERAL > INTEGRACAO ENTRE SISTEMAS 

    Valores aceito: S e N. 

    Foram disponibilizadas, a partir da versão 12.1.17, as seguintes funcionalidades:

    • Parâmetro para indicar a opção de definir se para as empresas que compartilham a Empresa Plano e a Empresa Histórico, estas irão compor na lista das empresas na mensagem para envio através do EAI

    Descrição do parâmetro: Empresa está habilitada para a réplica: Empresa Centro de Custo?
    Local: ADMINISTRACAO LOGIX > CONTROLE GERAL > INTEGRACAO ENTRE SISTEMAS 
    Valores aceitos:
    S - Enviará o cadastro do centro de custo desta empresa na lista das empresas que são compartilhadas pela Empresa Plano.
    N - Não enviará o cadastro do centro de custo  desta empresa na lista de empresas que compartilham a Empresa Plano.

    Esta parametrização deverá ser feita para todas as empresas que compões a Empresa Plano. Por padrão, será atribuído S a todas as empresas

    • Novo contexto, definido como recursos_humanos, devendo ser definido o EAI10000, na opção do Aplicativo Hospedeiro, para a mensagem listofcostcenter e costcenter
      Este contexto irá conter uma regra especifica para tratamento das empresas associadas a Empresa Plano, que estão relacionadas ao RHU3330 - Cadastros de Empresas do RH Logix e que estão mapeadas no EAI10000, sendo que somente estas serão levadas para o aplicativo externo ao qual o RH foi migrado. 

    RM

    Para o RM receber a integração de Centro de Custo é necessário que a entidade LISTOFCOSTCENTER na versão 2.001 esteja configurada na integração juntamente ao evento 670be9e3-f144-4ac9-91f3-1a8eee3c1355 (Tratamento de centro de custo).

     Image Added


    Esta integração se fez necessária devido ao Logix permitir vincular o mesmo centro de custo para um grupo de empresas.

    Exemplo:

    Empresa 01 e 02 utilizam o centro de custo 01.01

    Empresa 03, 04 e 05 utilizam o centro de custo 01.02


    Considerando que o de-para de empresas esteja configurado da seguinte forma:

      • Empresa 01 = Coligada 1
      • Empresa 02 = Coligada 2
      • Empresa 03 = Coligada 3
      • Empresa 04 = Coligada 4
      • Empresa 05 = Coligada 5


    O RM deverá salvar da seguinte maneira:

      • Coligada 1 - centro de custo 01.01
      • Coligada 2 - centro de custo 01.01
      • Coligada 3 - centro de custo 01.02
      • Coligada 4 - centro de custo 01.02
      • Coligada 5 - centro de custo 01.02

    Para esta também é necessário que a integração tenha o parâmetro RH_ CENTROCUSTOAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração:

     Image Added


    O parâmetro RH_ CENTROCUSTOAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “GCCUSTO. CODCCUSTO”.

    Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “GCCUSTO. CODCCUSTO” a conta caixa enviada na mensagem de acordo com a máscara do centro de custo enviada pelo Logix.

    Exemplo: “QQQQQQQQ” [permite qualquer caractere limitado a 8 posições].


    Caso o parâmetro esteja configurado para ativar o auto incremento o Código do Centro de Custo no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o código informado na mensagem única. Nesse caso, o parâmetro “Máscara do Centro de Custo” deve ser preenchido como “QQQQQQQ” [qualquer caractere].

    Image Added

    Image Added

    Image Added


    Ao receber/atualizar o Centro de Custo, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

    Image Added

    Nota
    titleNota:
    Os centros de custos serão sincronizados com a GCCUSTO e a PCCUSTO (inclusão/alteração/exclusão).


    Após o recebimento o Centro de Custo poderá ser vinculado ao Funcionário por meio do lookup disponibilizado no cadastro de Funcionários.

    RM / Folha de Pagamento / Administração de Pessoal / Funcionários

    Image Added


    Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Centro de Custo.

    Image Added




    • Plano de Contas

    Logix

    O plano de contas é integrado pela mensagem LISTOFACCOUNTANTACCOUNT que é disparada pelos programas CON0010 e CON10001 (Plano de contas). 

    Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será enviada uma lista na qual a conta contábil será replicada para cada empresa que compartilha o plano. Conforme exemplo:

    Empresa 01 e 02 compartilham o mesmo plano de contas. Então a mensagem de integração conterá uma lista com informações da conta contábil para a empresa 01 e para a 02.


    Image Added

    Informações
    titleNota:
    Será gravado o internalid "AccountingEntry" no de-para do Logix somente para a empresa do plano. 

    Foi disponibilizado, a partir da versão 12.1.13, a opção de enviar a conta contábil somente para a empresa do cadastro. Por padrão a integração replica a mensagem para todas as empresas que compartilham o cadastro (empresa_plano).

    Descrição do parâmetro: Replicar o plano de contas para todas as empresas que compartilham? 

    Local: ADMINISTRACAO LOGIX > CONTROLE GERAL > INTEGRACAO ENTRE SISTEMAS 

    Valores aceito: S e N. 

    Foram disponibilizadas, a partir da versão 12.1.17 as seguintes funcionalidades:

    • Parâmetro para indicar a opção de definir se para as empresas que compartilham a Empresa Plano e a Empresa Histórico, estas irão compor na lista das empresas na mensagem para envio através do EAI

    Descrição do parâmetro: Empresa está habilitada para a réplica: Empresa Plano de Contas?
    Local: ADMINISTRACAO LOGIX > CONTROLE GERAL > INTEGRACAO ENTRE SISTEMAS 
    Valores aceitos:
    S - Enviará o cadastro do plano de contas desta empresa na lista das empresas que são compartilhadas pela Empresa Plano.
    N - Não enviará o cadastro do plano de contas  desta empresa na lista de empresas que compartilham a Empresa Plano.

    Esta parametrização deverá ser feita para todas as empresas que compões a Empresa Plano. Por padrão, será atribuído S a todas as empresas

    • Novo contexto, definido como recursos_humanos, devendo ser definido o EAI10000, na opção do Aplicativo Hospedeiro, para a mensagem AccountantAccount e ListOfAccountantAccount
      Este contexto irá conter uma regra especifica para tratamento das empresas associadas a Empresa Plano, que estão relacionadas ao RHU3330 - Cadastros de Empresas do RH Logix e que estão mapeadas no EAI10000, sendo que somente estas serão levadas para o aplicativo externo ao qual o RH foi migrado. 


    RM

    Para o RM receber a integração de Plano de Contas é necessário que a entidade LISTOFACCOUNTANTACCOUNT na versão 2.002 esteja configurada na integração juntamente ao evento 9f0f85bf-f5c8-4ecb-b439-783acd087e11 (Tratamento de conta contábil).

     Image Added


    Esta integração se fez necessária devido ao Logix permitir vincular o mesmo plano de contas para um grupo de empresas.

    Exemplo:

    Empresa 01 e 02 utilizam o plano de contas P001

    Empresa 03, 04 e 05 utilizam o plano de contas P002


    Considerando que o de-para de empresas esteja configurado da seguinte forma:

      • Empresa 01 = Coligada 1
      • Empresa 02 = Coligada 2
      • Empresa 03 = Coligada 3
      • Empresa 04 = Coligada 4
      • Empresa 05 = Coligada 5


    O RM deverá salvar da seguinte maneira:

      • Coligada 1 - plano de contas P001
      • Coligada 2 - plano de contas P001
      • Coligada 3 - plano de contas P002
      • Coligada 4 - plano de contas P002
      • Coligada 5 - plano de contas P002


    Ao receber/atualizar o Plano de Contas, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para:

    Image Added


    Nota
    titleNota:
    O campo “CCONTA.NATSPED” não é enviado pela mensagem pois este deve estar somente no BackOffice. Por ser obrigatório no RM, ao receber a mensagem de Plano de Contas este será gravado com o valor “00” (Não informada).

     Image Added

    Image Added

    Image Added

    Nota
    titleNota:

    Máscara

    A máscara parametrizada da conta contábil no RM será validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado sem máscara contábil para possibilitar o recebimento pelo Logix. Com isso o sistema poderá montar a árvore de plano de contas que atenda o Logix e esteja dentro das regras do RM.

    Contas Agrupadoras (Sintéticas)

    Considerando que no RM não é possível existir uma conta analítica sem que esteja associada a uma conta sintética (agrupadora) previamente cadastrada, sempre que uma conta for atualizada no Logix, caberá a este enviar para o RM não somente a mensagem referente a atualização da conta em si, mas também as mensagens referentes a todas as contas agrupadoras à estas associadas.

    Exemplo:

    Considerando que a conta 1.1.1.5 tenha sido atualizada no Logix. Então, o RM deverá receber as mensagens de atualização de todas as contas da árvore:

    • 1 (Conta Sintética)
    • 1.1 (Conta Sintética)
    • 1.1.1 (Conta Sintética)
    • 1.1.1.5 (Conta Analítica)



    • Unidade Funcional (Seção)


    RM

    Para o RM enviar a integração de Unidade Funcional (Seção) é necessário que a entidade DEPARTAMENT na versão 2.000 esteja configurada na integração juntamente ao evento abe77044-a478-4065-b53f-f7d2a2c16355 (Tratamento de Departamento (Seção/Unidade Funcional)). 

    Image Added

    Nesta integração é realizado o envio do cadastro de Seção para o Logix. A integração será acionada ao realizar os seguintes processos no RM:

      • Cadastro de Seção (Inclusão/Alteração/Exclusão).
        • Mensagem incluindo/alterando a unidade funcional (seção).
      • Alteração da Filial da Seção
        • Mensagem incluindo a unidade funcional (seção) com a nova filial.
        • Mensagem de alteração de funcionário relacionado a unidade funcional (seção) alterada.
        • Mensagem deletando a unidade funcional (seção) com filial antiga.
      • Processo para trocar código da seção.
        • Mensagem incluindo a seção com o código novo.
        • Mensagem de alteração de funcionário relacionado a seção alterada.
        • Mensagem deletando a unidade funcional com código antigo.
      • Reestruturação da seção (existem 2 pontos para a integração)
        • Será enviado a integração após finalizar o processo de Reestruturação
        • A integração poderá ser executada por meio do processo “Integrar Reestruturação” na visão de Reestruturação de Seções


    Para o processo de Reimplantação da Estrutura de Seções, o RM seguirá os seguintes processos de envio para o Logix:

          • Mensagem incluindo uma unidade funcional temporária no Logix. Ex: #TEMP#_08
          • Mensagem atualizando os funcionários para a unidade funcional temporária.
          • Mensagem deletando as unidades funcionais antigas
          • Mensagem incluindo as unidades funcionais da proposta.
          • Mensagem atualizando os funcionários com sua respectiva unidade funcional da proposta.
          • Mensagem deletando a unidade funcional temporária.

    Para o processo de Alteração do Código das Seções, o RM seguirá os seguintes processos de envio para o Logix:

          • Mensagem incluindo as unidades funcionais (seções) novas
          • Mensagem de alteração de funcionário com a nova unidade funcional (seção)
          • Mensagem deletando as unidades funcionais (seções) antigas


    Ao enviar a integração Departament (Unidade Funcional/Seção), o EAI deverá atualizar automaticamente os cadastros De-Para referente a esta integração.


    Nota
    titleNota:

    Houve a necessidade de manipulação no adapter para incluir o código da filial como chave primária para que a seção seja identificada no Logix ao realizar a troca da filial, então ao salvar o registro de De-Para a chave primária RM ficará da seguinte maneira: CODCOLIGADA|CODFILIAL|CODIGO.


    Integração / Integração / Mensagem Única / De-Para

    Image Added


    Carga Inicial:

    A execução do processo de fórmula visual referente a Carga Inicial de Seção/Unidade Funcional enviará os cadastros que já existem na base do RM para incluir/atualizar os cadastros no Logix via integração.

    A integração respeitará o seguinte filtro:

      • Serão integradas as seções das coligadas que estejam configuradas para integração e com a situação (SecaoDesativada) igual a "ativa" (0).

     Para acionar a carga inicial dessa integração é necessário acessar na tela de cadastro de Fórmula Visual: Processos / Fórmula Visual / FOPWKF0003 - Department - Carga_Inicial

    Image Added


    Ao ser acionada, a fórmula chamará a integração DEPARTAMENT para cada registro de Seção/Unidade Funcional encontrado na base RM.


    Logix

    A mensagem DEPARTAMENT deve ser ativada no EAI10000 para recebimento. No Logix o cadastro de unidade funcional deve ser configurado para permitir somente consultas, pois quaisquer alterações realizadas não serão replicadas para o RM. 




    • Função 

    RM

    Para o RM enviar a integração de Função é necessário que a entidade ROLE na versão 1.000 esteja configurada na integração.

    Image Added 

    Nesta integração é realizado o envio do cadastro de Função para o Logix. A integração será acionada ao realizar os seguintes processos no RM:

      • Cadastro de função (inclusão/alteração/exclusão)
        • Para a alteração do cadastro será disparado gatilho para integração somente se houver modificação no campo “Nome”.
      • Cópia de função entre coligadas

    Nota
    titleNota:

    A tabela do RM PFuncao não contém coligada, portanto deve-se parametrizar no Logix uma empresa como centralizadora para que os registros enviados sejam cadastrados nela. Com isso não haverá necessidade do cadastro de Função para cada empresa do Logix.


    Ao enviar a integração de Função, o EAI deverá atualizar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

    Image Added


    Carga Inicial:

    A execução do processo de fórmula visual referente a Carga Inicial de Função enviará os cadastros que já existem na base do RM para adicionar/atualizar os cadastros no Logix via integração.

    A integração respeitará o seguinte filtro:

      • Serão integradas as funções das coligadas que estejam configuradas para integração.

    Para acionar a carga inicial dessa integração é necessário acessar na tela de cadastro de Fórmula Visual: Processos / Fórmula Visual / FOPWKF0002 - Role - Carga_Inicial

    Image Added

    Ao ser acionada, a fórmula chamará a integração ROLE para cada registro de Função encontrado na base RM.


    Logix

    A mensagem ROLE deve ser ativada no EAI10000 para recebimento. No Logix o cadastro de cargos deve ser configurado para permitir somente consultas, pois quaisquer alterações realizadas não serão replicadas para o RM. 

    A mensagem ROLE utiliza a parametrização de empresa matriz do programa RHU3330 - Informações adicionais da empresa.




    • Turno e Escala 

    RM

    Para o RM enviar a integração de Turno e Escala é necessário que a entidade SCHEDULEWORK na versão 1.000 esteja configurada na integração.

    Image Added

    Nesta integração é realizado o envio do horário para o Logix. A integração será acionada ao realizar os seguintes cadastros/processos no RM:

      • Horário por intervalo:
        • Criar jornada planejada
        • Configurar jornada planejada
        • Copiar jornada planejada
        • Remover jornada planejada
        • Exclusão de horário (caso tenha mapeamento no de-para)
        • Cópia de horário (caso tenha jornada planejada cadastrada)
        • Cópia de horário entre coligadas (caso tenha jornada planejada cadastrada)
        • Importar horário
        • Horário por jornada
        • Cadastro do índice da jornada (inclusão/alteração/exclusão)
        • Cópia de índice da jornada

    Nota
    titleNota:

    A tabela relacionada a Turno e Escala não contém coligada, portanto deve-se parametrizar no Logix uma empresa como centralizadora para que os registros enviados sejam cadastrados nela. Com isso não haverá necessidade do cadastro de Turno e Escala para cada empresa do Logix.


    Ao enviar a integração de Turno e Escala, o EAI deverá atualizar automaticamente os cadastros De-Para referente a esta integração com a chave primária dos cadastros de horário por jornada e horário por intervalo.

    Integração / Integração / Mensagem Única / De-Para

    Image Added


    Carga Inicial:

    A execução do processo de fórmula visual referente a Carga Inicial de Turno e Escala enviará os cadastros que já existem na base do RM para incluir/atualizar os cadastros no Logix via integração.

    A integração respeitará o seguinte filtro:

      • Serão integrados os turno e escala das coligadas que estejam configuradas para integração.

     Para acionar a carga inicial dessa integração é necessário acessar na tela de cadastro de Fórmula Visual: Processos / Fórmula Visual / PTOWKF0001 - ScheduleWork - Carga_Inicial

    Image Added

    Ao ser acionada, a fórmula chamará a integração SCHEDULEWORK para cada registro de Turno e Escala encontrado na base RM.


    Logix

    A mensagem SCHEDULEWORK deve ser ativada no EAI10000 para recebimento. No Logix o cadastro de escalas deve ser configurado para permitir somente consultas, pois quaisquer alterações realizadas não serão replicadas para o RM. 

    A mensagem SCHEDULEWORK utiliza a parametrização de empresa acesso tabela "escala" do programa RHU3330 - Informações adicionais da empresa.




    • Funcionário  

    Para o RM enviar a integração de Funcionário é necessário que a entidade EMPLOYEE na versão 2.003 esteja configurada na integração.

    Image Added

    Nesta integração é realizado o envio do cadastro do funcionário para o Logix. A integração será acionada ao realizar os seguintes cadastros/processos no RM:

      • Cadastro de funcionário (inclusão/alteração)
      • Exclusão de funcionário
      • Lançamento de férias
      • Finalização de férias
      • Rescisão (exceto tipos 5 e 6 - transferência)
      • Rescisão coletiva
      • Cancelar Rescisão
      • Reestruturação de Seções (Realocação de Pessoal)

    O XSLT dessa mensagem foi evoluído para contemplar as seguintes alterações:

      • No campo DepartmentCode, deverá enviar o código da seção, e não mais o código do departamento da seção.
      • No campo DepartmentInternalid, deverá enviar a chave da seção, e não mais a chave do departamento da seção.


    Nota
    titleNota:

    Como houve a necessidade da alteração do internalId na mensagem Departament (Unidade Funcional/Seção), também se fez necessário adaptar o campo DepartamentInternalId da mensagem Employee (Funcionário) para o correto funcionamento da integração. Para isso houve uma manipulação no adapter no qual preenche o campo com a seguinte composição: CODCOLIGADA|CODFILIAL|CODSECAO.


    Ao enviar a integração de Funcionário, o EAI deverá atualizar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

    Image Added


    Carga Inicial:

    A execução do processo de fórmula visual referente a Carga Inicial de Funcionário enviará os cadastros que já existem na base do RM para incluir/atualizar os cadastros no Logix via integração.

    A integração respeitará o seguinte filtro:

      • Só serão integrados funcionários da coligada corrente e com a situação (CodSituacao) diferente de "demitido" (D).


    Para acionar a carga inicial dessa integração é necessário acessar na tela de cadastro de Fórmula Visual: Processos / Fórmula Visual / FOPWKF0004 - Employee - Carga_Inicial

    Image Added

    Ao ser acionada, a fórmula chamará a integração EMPLOYEE para cada registro de Funcionário encontrado na base RM.


    Logix

    A mensagem EMPLOYEE deve ser ativada no EAI10000 para recebimento. No Logix o cadastro de funcionários deve ser configurado para permitir somente consultas, pois quaisquer alterações realizadas não serão replicadas para o RM. 




    • Transferência de funcionário 

    Para o RM enviar a integração de Transferência de Funcionário é necessário que a entidade SETEMPLOYEEBRANCHTRANFER na versão 1.000 esteja configurada na integração juntamente ao evento 63f0726c-5e69-4efb-851d-7b7d800cc1af (SetEmployeeBranchTranfer_Event).

    Image Added

    Nesta integração é realizado o envio do cadastro do funcionário para o Logix. A integração será acionada ao realizar o seguinte processo no RM:

      • Rescisão dos tipos 5 (Transferência sem ônus p/ Cedente) e 6 (Transferência com ônus p/ Cedente)

    O XSLT dessa mensagem foi evoluído para contemplar as seguintes alterações:

      • No campo DepartmentCode, deverá enviar o código da seção, e não mais o código do departamento da seção.
      • No campo DepartmentInternalid, deverá enviar a chave da seção, e não mais a chave do departamento da seção.

    Para o processo de Rescisão dos tipos 5 e 6, o RM seguirá os seguintes processos de envio para o Logix:

      • Será enviada uma mensagem de transferência do funcionário (SetEmployeeTransferBranch) contendo os dados do funcionário que está sendo transferido e do novo funcionário.
      • Será enviada uma mensagem de funcionário (Employee) contendo a atualização do registro do funcionário que foi transferido.


    Nota
    titleNota:
    • Como houve a necessidade da alteração do internalId na mensagem Departament (Unidade Funcional/Seção), também se fez necessário adaptar o campo DepartamentInternalId da mensagem SetEmployeeBranchTransfer (Transferência de Funcionário) para o correto funcionamento da integração. Para isso houve uma manipulação no adapter no qual preenche o campo com a seguinte composição: CODCOLIGADA|CODFILIAL|CODSECAO.
    • Na integração não é contemplado o envio na mensagem dos dados de centro de custo e rateio por centro de custo.


    Ao enviar a integração de Transferência de Funcionário, o EAI deverá atualizar automaticamente os cadastros De-Para referente a esta integração, então o registro do novo funcionário será criado na tabela.

    Integração / Integração / Mensagem Única / De-Para

    Image Added

    Logix

    A mensagem SETEMPLOYEEBRANCHTRANFER deve ser ativada no EAI10000 para recebimento. No Logix o cadastro de transferência de funcionário deve ser configurado para permitir somente consultas, pois quaisquer alterações realizadas não serão replicadas para o RM. 




    • Comissão de representante

    Parâmetros Logix: 

    • Mensagem MonthlyPayroll_1_000 configurada para envio no EAI10000; 
    • centro_custo_comis_folha - Centro de custo para integração de saldo de comissão na folha (LOG00087 ) - opcional; 
    • Matrícula do representante (FIN10020);
    • Verba/Evento (FIN30159): Cadastrar o código da verba/evento que será utilizada pela folha RM. Utilizando o parâmetro verba "provento_comis_folha" e o código da verba desejado;

           O processamento da integração das comissões de representantes continua a ser realizado pelo FIN10036, utilizando a opção "integração RHU", o programa utilizará os parâmetros acima listados para integrar os eventos a folha RM.

    Mensagens únicas:
    Para configurar as mensagens que trafegarão entre os sistemas é necessário primeiramente ter realizado a implantação e configuração do Web service e EAI, conforme descrito no item "Pré-requisitos instalação/implantação/utilização" deste documento. Em seguida acesse o EAI10000, escolha a opção "Aplicativo Hospedeiro" no menu "Configuração". Faça a busca dos adapters de mensagens através do botão "Buscar Adapters", conforme demonstrado na figura abaixo. Leia atentamente a mensagem exibida na tela e selecione a opção "Sim" para prosseguir ou "Não" para abortar o processo. 
    Image Removed
    As mensagens devem ser ativadas observando a sua versão, rota, e contexto. A lista das mensagens encontra-se na seção "Transações/Entidades/Mensagens únicas" deste documento. 
    Nesta integração todas as mensagens devem ser configuradas para o contexto "padrão". A seguir exemplo de ativação da mensagem CustomerVendor: 
    Image Removed
    Image Removed
     

    RM

    Insira aqui as informações pertinentes ao RM.

    Controle de Versão

    O grupo TOTVS, representado por suas marcas, irá administrar as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

     

    Suporte

    O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Logix estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

     

    Transações/Entidades/Mensagens únicas

    Método

    ID

    Descrição

    Origem

    Destino

    XSD (versões podem variar)

    Cadastros

    01

    Cliente/Fornecedor

    Logix

    RM

    CustomerVendor_2_000.xsd

    02

    Banco/Agência

    Logix

    RM

    Bank_2_002.xsd

    03

    Item Contábil (Área e Linha de Negócio)

    Logix

    RM

    AreaAndLineOfBusiness_1_000.xsd

    04

    Período Contábil

    Logix

    RM

    AccountingCalendar_1_000.xsd

    05

    Histórico Padrão

    Logix

    RM

    ListOfAccountantDefaultHistory_2_000.xsd

    06

    Centro de Custo

    Logix

    RM

    ListOfCostCenter_2_001.xsd

    07

    Plano de Contas

    Logix

    RM

    ListOfAccountantAcoount_2_002.xsd

    08

    Lançamento Contábil

    RM

    Logix

    AccountingEntry_2_002.xsd

    09

    Lançamento Financeiro

    RM

    Logix

    AccountantPayableDocument_2_002.xsd

     

     

    Fluxo das Informações

    Logix envia Cliente/Fornecedor para o RMCadastro de Cliente/Fornecedor no RM deverá ficar bloqueado para criação/alteração/exclusão.
    Logix envia Banco/Agência para o RMSerá realizado cadastro de:
  • Banco
    • Cadastro de Banco no RM deverá ficar bloqueado para criação/alteração/exclusão.
  • Agência
    • Cadastro de Agência no RM deverá ficar bloqueado para criação/alteração/exclusão.
  • Conta Corrente
    • Cadastro de Conta Corrente no RM deverá ficar bloqueado para criação/alteração/exclusão.
  • Conta CaixaCadastro de Conta Caixa no RM deverá ficar bloqueado para criação/alteração/exclusão.
    Logix envia Item Contábil (Área e Linha de Negócio) para o RMCadastro de Item Contábil (Área e Linha de Negócio) no RM deverá ficar bloqueado para criação/alteração/exclusão.
    Logix envia Período Contábil para o RMCadastro de Período Contábil no RM deverá ficar bloqueado para criação/alteração/exclusão.
    Logix envia Histórico Padrão para o RMCadastro de Histórico Padrão no RM deverá ficar bloqueado para criação/alteração/exclusão.
    Logix envia Centro de Custo para o RMCadastro de Centro de Custo no RM deverá ficar bloqueado para criação/alteração/exclusão.
    Logix envia Plano de Contas para o RMCadastro de Plano de Contas no RM deverá ficar bloqueado para criação/alteração/exclusão.
    RM envia Lançamento Contábil para o LogixCadastro de Lançamento Contábil no Logix deverá ficar bloqueado para criação/alteração/exclusão.
    RM envia Lançamento Financeiro para o Logix
    • Cadastro de Lançamento Financeiro no Logix deverá ficar bloqueado para criação/alteração/exclusão.

    Cadastros

    Cliente/Fornecedor

    LOGIX

    O cadastro de clientes e fornecedores é realizado no Logix e através da mensagem CUSTOMERVENDOR versão 2.000 integrado ao RM. Portanto, a mensagem precisa estar habilitada para envio no EAI10000. Possíveis inconsistências ou erros ocorridos durante o processo de integração serão apresentados em tela e a operação não será efetivada, possibilitando ao usuário tomar a ação de correção ou ajuste da inconsistência. Toda o processo de integração fica registrado no monitor de integração do EAI10000 e pode ser consultado a qualquer momento.

    Image Removed

    As integrações são síncronas, ou seja, para a alteração, inclusão ou exclusão ser efetivada o Logix aguarda o OK da mensagem enviada ao RM, As mensagens retornam além do "status" da operação ("OK" ou "ERROR") os códigos do fornecedor na origem (Logix) e no destino (RM), este código é chamado de "InternalID"  e é composto pelos campos da chaves primárias do cadastro nos respectivos produtos. 

    Image Removed

     

    O código interno, também pode ser consultado a qualquer momento no EAI10000 > Configuração > Aplicativo Externo. Efetue a consulta pelo aplicativo RM e utilize o botão "Consulta De/Para", faça a busca conforme o critério desejado:  

    Image Removed

    Atenção: Para a integração com o RH são integrados somente fornecedores, portanto os clientes não são enviados ao RM, embora a mensagem permita tal integração. 

     

    RM

    Para o RM receber a integração de fornecedor é necessário que a entidade CUSTOMERVENDOR na versão 2.000 esteja configurada na integração juntamente com o evento d25b1b1f-2878-40d4-a7bc-ab27ceca5566 (Tratamento de cliente/fornecedor).

     Image Removed

    Para a mesma também é necessário que a integração tenha os parâmetros RH_CLIFORAUTOINC e RH_CODCLASSIFICPAIS configurados.

     Image Removed

      Image Removed

     

    O parâmetro RH_CLIFORAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCFO.CODCFO”.

    Caso o parâmetro esteja configurado para não considerar o auto incremento, a máscara do código do Cliente/Fornecedor do RM deve ser configurada de acordo com a máscara do cliente/fornecedor enviada pelo Logix:
    Ex: “QQQQQQQQ”. [Permite qualquer caractere limitado a 8 posições].

    Image Removed

    Caso o parâmetro esteja configurado para ativar o auto incremento, a máscara deve ser definida como # (numérica) e o parâmetro do financeiro “Usar código sequencial (se máscara for numérica)” deve ser marcado.

    Image Removed

    Obs.: Por default a opção “Usar código sequencial (se máscara for numérica)” fica desativada. A mesma só é ativa para seleção após definir a máscara como numérica, conforme imagem acima.

     

    Após o envio da mensagem pelo Logix, é possível verificar o recebimento da mesma através da Fila de mensagens únicas que pode ser acessada através do caminho: Integração / Integração / Mensagem Única / Fila de mensagens únicas.

    Image Removed

    Image Removed

     

    No anexo “Informação de execução de mensagem” acessado através da tela de Fila de mensagem pode verificar o status da mensagem enviada pelo Logix.

    Image Removed

    Image Removed

     

    Ao receber/atualizar o Cliente/Fornecedor, o EAI deverá criar automaticamente o cadastro De-Para referente a esta integração.

     Integração / Integração / Mensagem Única / De-Para

    Image Removed

     

     

    Banco/Agência/Contas bancárias

    Logix

    O cadastro de banco, agencias e contas bancárias é de responsabilidade do Logix, para integrar ao RM a mensagem Bank na versão 2.002 deve estar habilitada como envio. 

    A mensagem é disparada a partir dos programas FIN30065 (Agências bancárias) e CAP0120 (Agências).  Os dados enviados são: banco, agencia bancária e as contas bancárias pertencentes ao banco e agência em questão. 

    Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno (Bank) do banco no RM que será utilizado posteriormente em outras mensagens. 

    Atenção: A integração leva somente as contas bancárias da empresa corrente. Portanto, contas bancárias de outras empresas não serão integradas mesmo que pertençam ao mesmo banco e agência. 

     

    RM

    Para o RM receber a integração de Banco/Agência é necessário que a entidade BANK na versão 2.002 esteja configurada na integração juntamente com o evento 1ee544f5-4b15-45cc-aee3-f0a05fde4644 (Tratamento de dados bancários).

    Nesta integração é realizado os cadastros de Banco, Agência, Conta Corrente e Conta Caixa. Agência é um anexo da visão de Banco, assim como Conta Corrente é um anexo da visão de Agência. Na Linha RM são tabelas independentes: Banco (GBANCO), Agência (GAGENCIA), Conta Corrente (FCONTA) e Conta Caixa (FCXA). Com isso, a exclusão da entidade banco no Logix, reflete na exclusão de uma Conta caixa, conta, agencias e banco no Lado RM.

     Image Removed

    Para a mesma também é necessário que a integração tenha o parâmetro RH_ CONTACAIXAAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.

     Image Removed

     

    O parâmetro RH_ CONTACAIXAAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “FCXA.CODCXA”.

    Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “FCXA.CODCXA” a conta caixa enviada na mensagem.

    Caso o parâmetro esteja configurado para ativar o auto incremento o Código da conta caixa no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o número da conta bancária enviada na mensagem única.

     

    Ao receber/atualizar o Banco/Agência, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

     Integração / Integração / Mensagem Única / De-Para

    Image Removed

     

     

    • Item Contábil (Área e Linha de Negócio)

    Logix 

    A integração ocorre pela mensagem AREAANDLINEOFBUSINESS, portanto deve estar habilitada para envio. Disparamos a menagem através dos programas VDP0340 e VDP10056 (Área Estratégica de Negócio). 

    Possíveis erros e inconsistências são exibidos em tela e também ficam registrados no monitor do EAI. A mensagem é síncrona e retorna o código interno "AreaAndLineOfBusinessInternalId" que será utilizado nas integrações de títulos, lançamentos contábeis, entre outras. Portanto, é imprescindível o retorno testa informação. 

    RM

    Para o RM receber a integração de Item Contábil (Área e Linha de Negócio) é necessário que a entidade AREAANDLINEOFBUSINESS na versão 1.000 esteja configurada na integração juntamente com o evento e9e9d0bf-32d6-4343-9531-92d174f92faf (Tratamento de item contábil).

     Image Removed

     

    Existem três pontos para visualizar os registros integrados de item contábil (Área e Linha de Negócio):

      • Educacional / Educacional / Integrações / Protheus / Item Contábil
      • RH / Folha de Pagamento / Encargos / Contabilização – Cadastros / Item Contábil
      • RH / Folha de Pagamento / Encargos / Financeiro – Cadastros Financeiros / Item Contábil

    No intuito de evitar cadastros duplicados, e tornar possível utilizar as mesmas informações para mais de uma integração, foi padronizado para que ambos menus apontem para a mesma tela (Tela de item contábil do módulo Educacional).

    Item contábil no módulo Educacional:

     Image Removed

     Image Removed

     

    • Item contábil no módulo Folha de Pagamento:

     Image Removed

    Image Removed

    Image Removed

     

    Ao receber/atualizar o Item Contábil (Área e Linha de Negócios), o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

    Image Removed

     

    Após recebimento, o Item Contábil (Área e Linha de Negócio) poderá ser vinculado ao Funcionário, na Seção, e no Agrupamento de Contas através do lookup disponibilizado nas respectivas telas.

     

    RM / Folha de Pagamento / Administração de Pessoal / Funcionários

    Image Removed

     

    Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Item Contábil.

     Image Removed

     

    RM / Folha de Pagamento / Administração de Pessoal / Seções

    Image Removed

     

    Na tela de cadastro de Seção acesse: Dados Contábeis / Item Contábil.

    Image Removed

     

    RM / Folha de Pagamento / Encargos / Contabilização – Cadastros / Cadastros Contábeis / Agrupamento de Contas

    Image Removed

     

    Na tela de cadastro do Agrupamento de Contas: Item Contábil (Área e Linha de Negócio).

    Image Removed

     

    Obs 1: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver desmarcado, o campo deverá ficar oculto

    Obs 2: Caso o parâmetro "Usa integração outros backOffice" (Parametrizador -> Integrações -> Outros BackOffice) estiver marcado e os parâmetros "Agrupar partidas contábeis por Item Contábil" e "Gerar lanctos rateados por Item Contábil" estiverem desmarcados, o campo deverá ficar desabilitado.

     

     

    • Período Contábil

    Logix 

    Disparamos a mensagem ACCOUNTINGCALENDAR  a partir dos programas CON0050 e CON10009 (Períodos contábeis). É importante ressaltar que esta mensagem enviará uma lista contendo todos períodos e segmentos de períodos da empresa corrente. 

    A mensagem só é disparada em operações que envolvam o menor ou maior período cadastrado para a empresa. Sendo assim ao incluir um período, que seja posterior ao maior período cadastrado, a mensagem será disparada contendo todos os períodos e segmentos da empresa. Da mesma forma ao incluir um período anterior ao menor período já cadastrado. A modificação ou exclusão do maior e menor período também dispara a mensagem. As demais operações não geram integração, pois para o RM a informação relevante são os limites inferior e posterior de período do calendário.  

    RM

    Para o RM receber a integração de Período Contábil é necessário que a entidade ACCOUNTINGCALENDAR na versão 1.000 esteja configurada na integração juntamente com o evento d1f09a24-9148-4e2d-8e17-bc5a76c9f933 (Período contábil).

     Image Removed

     

    Nesse processo de integração, o lado RM atualizará as datas de período contábil sempre de acordo com a menor data inicial e a maior data final enviada pelo Logix. No Logix, essas informações são armazenadas em um cadastro, e no Rm essas informações são armazenadas nos parâmetros, sendo assim, teremos espaço para armazenar somente uma dataIncial e uma dataFinal.

    Image Removed

    Image Removed

    Image Removed

     

    Para esta integração não é salvo um cadastro De-Para porque o período contábil é um parâmetro que não tem uma tela de cadastro, para a sua atualização é realizado um update em seu registro direto no banco de dados.

     

     

    • Histórico Padrão

    Logix

    A sincronização do histórico padrão ocorre através da mensagem LISTOFACCOUNTANTDEFAULTHISTORY e é disparada a partir dos programas CON0020 e CON10002 (Histórico padrão dos lançamentos contábeis). Este código é utilizado no lançamento contábil das movimentações da folha de pagamento para a integração com a contabilidade Logix, 

    Para as empresas que utilizam a centralização do histórico contábil (Empresa histórico padrão) será envia uma lista onde o histórico padrão será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

    Empresa 01 e 02 compartilham o mesmo cadastro de histórico. Então a mensagem de integração conterá uma lista com informações de histórico para a empresa 01 e para a 02.

    Image Removed

    Atenção:  será gravado o internalid "AccountantDefaultHistory" no de-para do Logix somente para a empresa do histórico. 

     

    RM 

    Para o RM receber a integração de Histórico Padrão é necessário que a entidade LISTOFACCOUNTANTDEFAULTHISTORY na versão 2.000 esteja configurada na integração juntamente com o evento 41559d6e-9713-492f-b395-f1e807c32b22 (Tratamento de histórico padrão).

     Image Removed

     

    Esta integração se fez necessária devido ao Logix permitir vincular o mesmo histórico padrão para um grupo de empresas.

    Ex:

    Empresa 01 e 02 utilizam o histórico padrão 01

    Empresa 03, 04 e 05 utilizam o histórico padrão 02

    Considerando que o De-Para de empresas esteja configurado da seguinte forma:

      • Empresa 01 = Coligada 1
      • Empresa 02 = Coligada 2
      • Empresa 03 = Coligada 3
      • Empresa 04 = Coligada 4
      • Empresa 05 = Coligada 5

    O RM deverá salvar da seguinte maneira:

      • Coligada 1 - histórico padrão 01
      • Coligada 2 - histórico padrão 01
      • Coligada 3 - histórico padrão 02
      • Coligada 4 - histórico padrão 02
      • Coligada 5 - histórico padrão 02

     

    Ao receber/atualizar o Histórico Padrão, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

     Image Removed

     

     

    • Centro de Custo

    Logix

    A mensagem LISTOFCOSTCENTER é utilizada para a integração do cadastro de centro de custos. 

    Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será envia uma lista onde o centro de custo será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

    Empresa 01 e 02 compartilham o mesmo cadastro de centro de custo. Então a mensagem de integração conterá uma lista com informações de centro de custos para a empresa 01 e para a 02.

    Image Removed

    Atenção:  será gravado o internalid "CostCenter" no de-para do Logix somente para a empresa do plano. 

     

    RM

    Para o RM receber a integração de Centro de Custo é necessário que a entidade LISTOFCOSTCENTER na versão 2.001 esteja configurada na integração juntamente com o evento 670be9e3-f144-4ac9-91f3-1a8eee3c1355 (Tratamento de centro de custo).

     Image Removed

     

    Esta integração se fez necessária devido ao Logix permitir vincular o mesmo centro de custo para um grupo de empresas.

    Ex:

    Empresa 01 e 02 utilizam o centro de custo 01.01

    Empresa 03, 04 e 05 utilizam o centro de custo 01.02

     

    Considerando que o de-para de empresas esteja configurado da seguinte forma:

      • Empresa 01 = Coligada 1
      • Empresa 02 = Coligada 2
      • Empresa 03 = Coligada 3
      • Empresa 04 = Coligada 4
      • Empresa 05 = Coligada 5

     

    O RM deverá salvar da seguinte maneira:

      • Coligada 1 - centro de custo 01.01
      • Coligada 2 - centro de custo 01.01
      • Coligada 3 - centro de custo 01.02
      • Coligada 4 - centro de custo 01.02
      • Coligada 5 - centro de custo 01.02

    Para a mesma também é necessário que a integração tenha o parâmetro RH_ CENTROCUSTOAUTOINC configurado. O registro fica disponível em: Integração / Mensagem Única / Integrações / Anexo - Parâmetros de Integração.

     Image Removed

     

    O parâmetro RH_ CENTROCUSTOAUTOINC definirá se essa integração utilizará Auto Incremento ou não para o campo “GCCUSTO. CODCCUSTO”.

    Caso o parâmetro esteja configurado para não considerar o auto incremento, será gravado no campo “GCCUSTO. CODCCUSTO” a conta caixa enviada na mensagem de acordo com a máscara do centro de custo enviada pelo Logix.

    Ex: “QQQQQQQQ” [permite qualquer caractere limitado a 8 posições].

     

    Caso o parâmetro esteja configurado para ativar o auto incremento o Código do Centro de Custo no RM será um valor a partir da tabela GAUTOINC, sempre ignorando o código informado na mensagem única. Nesse caso, o parâmetro “Máscara do Centro de Custo” deve ser preenchido como “QQQQQQQ” [qualquer caractere].

    Image Removed

    Image Removed

    Image Removed

     

    Ao receber/atualizar o Centro de Custo, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

    Image Removed

     

    Obs.: Os centros de custos serão sincronizados com a GCCUSTO e a PCCUSTO (inclusão/alteração/exclusão).

     

    Após o recebimento o Centro de Custo poderá ser vinculado ao Funcionário através do lookup disponibilizado no cadastro de Funcionários.

    RM / Folha de Pagamento / Administração de Pessoal / Funcionários

    Image Removed

     

    Na tela de cadastro de Funcionários acesse: Rotinas Mensais/Anuais – Dados Contábeis / Dados Contábeis – Centro de Custo.

    Image Removed

     

     

    • Plano de Contas

    Logix

    O plano de contas é integrado pela mensagem LISTOFACCOUNTANTACCOUNT que é disparada pelos programas CON0010 e CON10001 (Plano de contas). 

    Para as empresas que utilizam a centralização do plano de contas contábil (Empresa plano) será envia uma lista onde a conta contábil será replicado para cada empresa que compartilha o histórico. Conforme exemplo:

    Empresa 01 e 02 compartilham o mesmo plano de contas. Então a mensagem de integração conterá uma lista com informações da conta contábil para a empresa 01 e para a 02.

     

    Image Removed

    Atenção:  será gravado o internalid "AccountingEntry" no de-para do Logix somente para a empresa do plano. 

    RM

    Para o RM receber a integração de Plano de Contas é necessário que a entidade LISTOFACCOUNTANTACCOUNT na versão 2.002 esteja configurada na integração juntamente com o evento 9f0f85bf-f5c8-4ecb-b439-783acd087e11 (Tratamento de conta contábil).

     Image Removed

     

    Esta integração se fez necessária devido ao Logix permitir vincular o mesmo plano de contas para um grupo de empresas.

    Ex:

    Empresa 01 e 02 utilizam o plano de contas P001

    Empresa 03, 04 e 05 utilizam o plano de contas P002

     

    Considerando que o de-para de empresas esteja configurado da seguinte forma:

      • Empresa 01 = Coligada 1
      • Empresa 02 = Coligada 2
      • Empresa 03 = Coligada 3
      • Empresa 04 = Coligada 4
      • Empresa 05 = Coligada 5
    O RM deverá salvar da seguinte maneira:
      • Coligada 1 - plano de contas P001
      • Coligada 2 - plano de contas P001
      • Coligada 3 - plano de contas P002
      • Coligada 4 - plano de contas P002
      • Coligada 5 - plano de contas P002
    Ao receber/atualizar o Plano de Contas, o EAI deverá criar automaticamente os cadastros De-Para referente a esta integração.

    Integração / Integração / Mensagem Única / De-Para

    Image Removed

     

    Obs 1: O campo “CCONTA.NATSPED” não é enviado pela mensagem pois o mesmo deve estar somente no BackOffice. Por ser obrigatório no RM, ao receber a mensagem de Plano de Contas o mesmo será gravado com o valor “00” (Não informada).

     Image Removed

    Image Removed

    Image Removed

     

    Obs 2: A máscara parametrizada da conta contábil no RM será validada no processo de inclusão da conta contábil. Portanto, o parâmetro de máscara contábil deve ser cadastrado sem máscara contábil para possibilitar o recebimento pelo Logix. Com isso o sistema poderá montar a árvore de plano de contas que atenda o Logix e esteja dentro das regras do RM.

     

     

     

    Processos

     

    • Lançamento Contábil

    RM 

    Para o RM enviar a integração de Lançamento Contábil ao Logix é necessário que a entidade ACCOUNTINGENTRY na versão 2.002 esteja configurada na integração juntamente com o evento xrf09a24-9148-4e2d-8e17-t15a76c9f999 (Envio de lançamentos contábeis).

     Image Removed

     

    Gerar os lançamentos contábeis

    Para o processo de geração de lançamentos contábeis segue os critérios de aceitação:

      • O cálculo respeitará a seguinte prioridade do cadastro de Item Contábil (Área e Linha de Negócio)/classe de valor:
        • 1º: Funcionário
        • 2º: Agrupamento de Contas
        • 3º: Seção

     

      • Para esta integração foi criado duas novas colunas na tabela PPARTIDA: Item Contábil (Área e Linha de Negócio) (IDITEMCONTABIL) e Classe de Valor (IDCLASSEVALOR)

     Image Removed

     

    Obs.: O parâmetro "Utiliza o cálculo por centro de custo" deverá estar desmarcado.

     

    Para enviar o lançamento Contábil via integração com Logix é necessário acionar o processo:

    RH / Folha de Pagamento / Encargos / Contabilização – Lançamentos / Lançamentos / Processos – Integração contábil com outros BackOffices

    Image Removed

    Image Removed

     

    Ao finalizar o processo é criado um registro na Fila de Mensagem do EAI, nele é possível consultar o status da mensagem enviada ao Logix.

    Image Removed

    Image Removed

    Image Removed

     

    Logix 

    Para que o Logix recepcione e processo com sucesso a mensagem de lançamento contábil (ACCOUNTINGENTRY)  é necessário efetuar as seguintes configurações: 

  • Cadastrar e configurar o sistema gerador "RM" no CON1640 ou CON10049 (Sistemas geradores); 
  • De-para de empresas configurado. 
  • Plano de contas do Logix e RM integrados previamente. 
  • Cadastro de Área estratégica de negócio previamente integrado. 
  • Cadastro de histórico padrão integrado. 

    Os lançamentos gerados pela integração são gravados na tabela "ctb_lanc_ctbl_ctb", pois sua origem não é o Logix.

    Na recepção da mensagem são efetuadas algumas validações, como:  período contábil valido, conta contábil ativa, AEN válida, valor de crédito e debito corretos, entre outras validações. Caso encontre alguma inconsistência a mensagem é devolvida com indicador  "ERROR" e a descrição do erro encontrado, a operação é desfeita ou seja, os lançamentos não são gravados. 

    Após a recepção ser efetuada com sucesso o lote poderá ser consultado no CON10000 (Consulta de lançamentos por origem)  utilizando o botão de origem "Contabilidade". 

    Os lotes integrados pelo EAI não são automaticamente efetivados. A efetivação deve ser realizada pelo CON10019 (Consistência/Efetivação de lançamentos) . Na aba "Lotes manuais" selecionar os lotes a serem efetivados. 

    Image Removed

     

    A mensagem de lançamento contábil está preparada para receber lotes contábeis de forma particionada. Isto é, em situações em que o volume de lançamentos é muito grande, pode ocorrer queda no desempenho do processamento gerando lentidão e até mesmo erro de "TIME OUT". Então, disponibilizamos a opção da integração segmentada em partes menores, conforme regras abaixo: 

    • A consistência e efetivação do lote só será permitida após a recepção com sucesso de todas as partes que compõem o lote. 
    • A capa do lote é gravada juntamente com o ultimo segmento do lote. 
    • Ocorrendo erro ou inconsistência em algum segmento, o RM enviará mensagem de exclusão de todo o lote. 
    • Para garantir a integridade dos lançamentos em ambos os sistemas, sempre que houver alteração no lote será enviada uma mensagem de exclusão e posteriormente novas inclusões. 
    • No XML o indicador do segmento do lote é a TAG "Sublot", que deve obedecer o seguinte padrão "NN|TT", onde "NN" é o número do segmento e "TT" é o total de segmentos. 

    Image Removed

     

    • Lançamento Financeiro

    RM 

    Para o RM enviar a integração de Lançamento Financeiro ao Logix é necessário que a entidade ACCOUNTPAYABLEDOCUMENT na versão 2.002 esteja configurada na integração juntamente com o evento 2810e737-4e2c-4321-ac27-3b398cc4d7fb (AccountPayableDocument_2_002).

     Image Removed

     

    Gerar os lançamentos financeiros:

    Para ratear o lançamento financeiro por Item Contábil (Área e Linha de Negócio)/Classe de valor é necessário seguir os seguintes critérios de aceitação:

      • O cálculo deverá respeitar a prioridade do cadastro de Item Contábil (Área e Linha de Negócio):
        • 1º: Funcionário
        • 2º: Seção

     

      • Para esta integração foi criado duas novas colunas na tabela PRATFINANCEIRO: Item Contábil (Área e Linha de Negócio) (IDITEMCONTABIL) e Classe de Valor (IDCLASSEVALOR)

    Image Removed

     

      • O lançamento deve ser salvo na tabela PFINANCEIRO e o rateio dentro da PRATFINANCEIRO com as seguintes informações: 
        • Centro de Custo
        • Item Contábil (Área e Linha de Negócio)
        • Classe de Valor

     

    Para enviar o lançamento Financeiro via integração com Logix é necessário acionar o processo:

    RH / Folha de Pagamento / Encargos / Contabilização – Lançamentos / Lançamentos / Processos – Integração contábil com outros BackOffices

     Image Removed

    Image Removed

     

    Ao finalizar o processo é criado um registro na Fila de Mensagem do EAI, nele é possível consultar o status da mensagem enviada ao Logix.

     Image Removed

    Image Removed

    Image Removed

     

    LOGIX 

    Abaixo encontra-se o detalhamento da Integração Financeira, na qual os Títulos do RM serão integrados no módulo Financeiro Logix. 

    Pré-requisitos: 

  • Cadastro fornecedor previamente integrado;
  • Parâmetro:  "Último número de nota fiscal para integração de títulos por EAI" configurado;
  • De-para de empresas configurado; 
  • Cadastro de Área estratégica de negócio previamente integrado; 
  • Parametrizar a geração automática de APs para todos os fornecedores envolvidos na integração. Conforme abaixo:
    VDP10000 Fornecedores > Informações bancárias > campo “Gera ordem de pagamento?” = “NF’S e conhecimento”. Ou no VDP0815: Fornecedores  > Inf. Bancárias >  campo “Indicador de geração de APs” = “S”;

  • A entidade Tipo de Despesa utilizada no contas a pagar do Logix, equivale ao parâmetro: "RH_NATUREZAFINANCEIRADEFAULT" no RM. No entanto no Logix esta entidade só aceita números, por isso é necessário cadastrar o de-para dos códigos no VDP10141 (De-para geral) da seguinte forma: 
    Image Removed
    CampoConteúdo
    TabelaTIPO_DESPESA
    Sistema integraçãoRM

    DE:

    CampoConteúdo
    cod_empresa<informar o código da empresa no Logix>
    cod_tip_despesa<informar o código do tipo de despesa no Logix>

    Para:

    Valor<informar o valor correspondente ao tipo de despesa no RM>
    Atenção: Repetir o cadastro para todos os tipos de despesas que serão utilizados na integração.

    Nota: Este procedimento não será necessário no caso dos códigos em ambos os sistemas serem iguais. 

    Os títulos gerados pelo RM serão incluídos como AD (Apropriação de Despesas) no Logix, na inclusão também será gerada a AP (Autorização de pagamento). Em caso de inconsistência ou erro a mensagem de integração será recusada e o motivo gravado para consulta no monitor do EAI (EAI10000). 

     Após a implantação do título ser efetuada com sucesso o Logix retornará uma resposta (XML) contendo informações do processamento e o número do título na origem (RM) e destino (LOGIX). Esta informação também pode ser consultada no monitor no EAI. 

    Image Removed

    O título poderá ser consultado no Fin30058 (Apropriações de despesa). Note que a origem da AD será: "INCLUÍDA VIA INTEGRAÇÃO COM OUTROS SISTEMAS" e a aba de informações complementares conterá a chave do título no RM. 

    Image Removed

    A relação dos títulos na origem e no destino também poderá ser consultada no EAI10000 > Aplicativos Externos > "Consulta De/para", utilizando o filtro abaixo: 

    Image Removed

     

    A integração também permite modificar e excluir títulos, porém somente será permitido se as regras de negócio aplicadas ao Logix foram atendidas, como: titulo não pode estar pago, não pode estar contabilizado, entre outras validações  do produto padrão Logix. 

    A integração de títulos utiliza a mesma API (fin80030) de manutenção de títulos do produto padrão Logix, isso significa que títulos implantados pela integração ou manualmente no financeiro passarão pelas mesmas etapas de validação e processamento. Sendo assim, processo de contabilização, lançamento no fluxo de caixa, calculo de impostos etc. permanecem inalterados. 

    Após a integração o título fica sob responsabilidade do módulo financeiro, usuário do CAP poderá fazer alterações, cancelamento/exclusão, e/ou pagamento. Estas operações não geram retorno ao RM. 

     

     


    Checklist de suporte da aplicação

    Checklist de Verificações:

    Passos para Integração RM x ERP Logix:

    1. Executar o Configurador para instalar a integração com o BackOffice Logix.
    2. Parametrizar a integração criada com o BackOffice Logix.
    3. Configurar o De-Para referente a Coligada.
    4. Parametrizar o Folha de Pagamento para integração dos lançamentos.
    Anexos