Child pages
  • Integração Protheus Logix - Integração Movimento Contábil e Financeiro
Skip to end of metadata
Go to start of metadata

Integração Protheus Logix - Integração Movimento Contábil e Financeiro

Contexto de negócio (Introdução)

Visando ofertar uma solução de RH mais adequada a necessidade do cliente, foi implementado UPGRADE do ERP Logix RH para o produto Microsiga Protheus RH. Desta forma, é possível poderá optar por uma solução que atenda melhor a sua gestão de administração de pessoal e gestão de capital humano.

Para permitir que o cliente Logix RH que realizou o UPGRADE para o produto Microsiga Protheus® possa continuar utilizando da s funcionalidades dos módulos da Contabilidade e Financeiro Logix, foram desenvolvidas novas formas de integração com o módulo de Gestão de Pessoal (GPE) Protheus:

  • Integração por meio de mensagem única utilizando o Enterprise Application Integration (EAI), dos lançamentos de Títulos Financeiros do Protheus GPE diretamente no sistema Logix, gerando desta forma todo o pagamento destas informações no módulo Financeiro Logix.
  • Integração dos lançamentos contábeis gerados pelo Protheus GPE para o sistema da Contabilidade Logix, por meio de arquivo texto, realizando a importação por meio do CON4050/ CON10051 (Integração com sistemas geradores).
  • A partir da versão 12.1.13 o lançamento contábil poderá ser realizado via EAI, por meio da mensagem AccountingEntry 2.000.

 

Escopo

Faz parte do escopo desta integração:

  • Sincronização do cadastro Fornecedores, para permitir a definição dos Títulos do GPE;
  • Sincronização do Plano de Contas, para permitir a Definição Contábil no Protheus;
  • Sincronização do Centro de Custo, para permitir a atualização no Protheus;
  • Inclusão, Manutenção e Estornos de Títulos a Pagar, incluídos pelo Protheus GPE e integrados ao Logix Financeiro;
  • Contabilização de lançamentos do Protheus GPE para o Logix Contábil, por meio de arquivo texto.

 

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

Os seguintes pré-requisitos devem ser verificados:

  • Logix
    • Versão Logix: 10.2 ou 11.0.
    • EAI Logix e WebService instalados e configurados;
    • • Será necessária a leitura do boletim técnico Integração WMS Logix X Protheus, disponível no TDN no endereço: http://tdn.totvs.com/pages/viewpage.action?pageId=22479163. Na integração entre o Logix X Protheus GPE, serão utilizadas a seguintes funcionalidades deste boletim:
      • Fornecedores;
      • Cidade.
    • Pacote 02/2013 atualizado.
  • Protheus
    • Versão Protheus: 11.0 ou superior;
    • O sistema Protheus deverá ser instalado em um SGBD (Sistema Gerenciador de Banco de Dados). Não poderá ser utilizado este processo em arquivos DBF;
    • Na importação no sistema Protheus não está previsto o conceito de Gestão de Corporativa. Dessa forma, deve-se utilizar somente o conceito de Empresa/Filial;
    • Protheus GPE implantado;
    • Será necessária a leitura do boletim técnico Integração WMS Logix X Protheus ERP Protheus, liberado por meio do chamado TGAGR1. Na integração entre o Logix X Protheus GPE, serão utilizadas a seguintes funcionalidades deste boletim:
      • Fornecedores;
      • Cidade;
    • Configurar os novos procedimentos do Schedule conforme boletim técnico 7912/2008 publicado pelo FrameWork em 13/02/2009 e revisado em 16/03/2012;
    • Configurar os novos procedimentos do EAI (Enterprise Application Integration) conforme boletim técnico 07/2009 publicado pelo frame em 16/06/2009 e revisado em 16/03/2012;
    • O Plano de Contas Protheus não poderá permitir manutenções no seu cadastro, pois todas as informações virão do sistema Logix.

 

Instalação/Atualização

Parâmetros gerais LOGIX

Executar o programa LOG00087 (Manutenção de Parâmetros) e acessar os seguintes caminhos: ADMINISTRAÇÃO LOGIX → CONTROLE GERAL → INTEGRAÇÃO ENTRE SISTEMAS

O parâmetro abaixo faz parte desta integração e deve ser devidamente atualizado antes da utilização: 

Parâmetro

Objetivo

Permite informar empresa/filial externa no cadastro de empresas?

Indica se será ou não permitido informar o código da empresa e código da filial externa, para que seja possível exportar os códigos de Empresas/Filiais para o sistema Protheus, conforme as Empresas Logix.

As empresas que utilizam o conceito de Área Estratégica e Negócios (AEN) precisam configurar os parâmetros de AEN Padrão, informados abaixo. As empresas que utilizam dois níveis de AEN devem configurar somente os dois primeiros parâmetros.

Parâmetro

Objetivo

Linha produto padrão

Definir o código da linha de produto padrão

Linha receita padrão

Definir o código da linha de receita padrão

Segmento mercado padrão

Definir o código do segmento de mercado padrão

Classe uso padrão

Definir o código da classe de uso padrão


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. Os programas de cadastros das entidades abaixo listadas estão preparados para enviar os dados ao Protheus sempre que houver inclusão, exclusão ou modificação.

Abaixo a lista das entidades que precisam ser integradas com o Protheus por meio da carga inicial. É importante lembrar que o programa possui filtros, assim pode-se integrar somente os registros que o Protheus 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.”

 

Sistema Logix – Relacionamento De/Para de Empresa Logix X Empresa/Filial:

Para as informações que são integradas através de sistemas externos, é necessário que seja associada à Empresa Logix, os códigos de

Empresa e Filial do sistema externo.

Estas informações são registradas no LOG00083 (Cadastro de Empresas): 

Nota:

Para que estes campos possam ser informados é necessário ativar o parâmetro “Permite informar  empresa/filial externa no cadastro de empresas?”, no LOG00087.

Sistema Protheus – Relacionamento De/Para de Empresa/Filial Protheus X Empresa/Filial Sistema Externo:

Será necessário associar à Empresa/Filial Protheus o código da Empresa Logix em que será efetuada a Integração Financeira e Exportação do arquivo Contábil.

 

Limitações/Restrições

  • O sistema Protheus deverá ser instalado em um SGBD (Sistema Gerenciador de Banco de Dados). Não poderá ser utilizado este processo em arquivos DBF.
  • Na importação no sistema Protheus não está previsto o conceito de Gestão de Corporativa. Dessa forma, deve-se utilizar somente o conceito de Empresa/Filial.
  • A integração dos lançamentos contábeis gerados no Protheus poderá ser feita via arquivo texto ou mensagem única EAI (a partir da versão 12.1.13).
  • As mensagens de Plano de Contas (ACCOUNTANTACCOUNT), Centro de Custos (COSTCENTER) e Área  Estratégica de Negócio (AREAANDLINEOFBUSINESS.), estão preparadas somente para o envio, portanto, não será possível receber dados do Protheus através destas mensagens, exceto status e textos de erros.
  • O projeto de Integração Financeira não contempla o bloqueio de cancelamento ou exclusão de Títulos a Pagar no Logix. 
    Portanto, será possível excluir um título no Logix sem que seja excluído no Protheus.  Orienta-se que havendo a necessidade de excluir ou cancelar títulos oriundos do Protheus, que o mesmo seja realizado no sistema de origem e, este por sua vez, integrará o cancelamento/exclusão ao Logix via EAI. 

 

Situações comuns

  • A integração das operações efetuadas no Protheus não ocorre, ou seja, os dados não constam no Logix. Isso pode ocorrer quando o EAI do Logix não está configurado corretamente. Verifique as configurações do EAI10000 (Controle de mensagens EAI).
  • A integração de títulos a pagar está retornando a consistência: “O indicador de geração de AP automático está ativo, porém Fornecedor não está parametrizado para gerar AP!”. Para corrigir esta situação basta acessar o Cadastro de Fornecedores (VDP0815/VDP10000) e na aba informações bancárias informar “S” no campo “indicador de geração de APS”. Na versão 11 o mesmo campo chama-se “Gerar ordem de pagamento?” e deve-se selecionar a opção “NF’S e conhecimento”.

 

Checklist de suporte da aplicação

  • Deve-se verificar no sistema operacional, se as pastas onde serão gravados os arquivos possuem permissões para acesso à leitura/gravação.
  • Deve-se verificar se está habilitada e configurada a integração por meio de mensagem única (EAI) entre os sistemas Logix e Protheus.

 

Detalhamento Técnico das Migrações

1. Integração Contábil

Abaixo encontra-se o detalhamento da Integração Contábil, na qual os Lançamentos Contábeis do Protheus GPE serão integrados no módulo Contábil Logix. 

A partir da versão 12.1.13 estará disponível a integração dos lançamentos contábeis por meio de mensagem única (EAI), além da integração via arquivo texto. 


1.1 Pré-Requisitos

1.1.1 Centro de Custo

  •  Habilitar para integrações o cadastro de Centro de Custos (CTT). Este cadastro será obrigatório, pois todo o cadastramento de Centro de Custos que houver será centralizado no sistema de Contabilidade Logix. A função CBTA030 (nome da mensagem: CostCenter) deverá ser cadastrada no Schedule Protheus para receber informações de sistemas externos.


1.1.2 Conta Contábil

  • Habilitar para integrações o cadastro de Conta Contábil (CT1). Este cadastro será obrigatório, pois todo o cadastramento do Plano de Contas que houver será centralizado no sistema de Contabilidade Logix. A função CBTA020 (nome da mensagem: AccountantAccount) deverá ser cadastrada no Schedule Protheus para receber informações de sistemas externos.

 

1.1.3 Item Contábil

  • Habilitar para integrações o cadastro de Item Contábil (CTD). Este cadastro será obrigatório nestas situações, pois todo o cadastramento de Itens que houver será centralizado no sistema de Contabilidade Logix. A função CBTA040 (nome da mensagem: AreaAndLineOfBusiness) deverá ser cadastrada no Schedule Protheus para receber informações de sistemas externos.

 

1.1.4 Empresa/Filial Protheus X Empresa Logix

  • Relacionar as Empresas/Filiais Protheus às Empresas Logix, por meio do programa de DE/PARA de Empresas Mensagem Única. Este relacionamento será obrigatório no Protheus, para enviar o código da Empresa do Logix no arquivo texto, caso a exportação seja realizada para o sistema Logix.

Nota:

Este de/para será utilizado somente se o parâmetro MV_ERPLOGI estiver habilitado (com o valor igual a 1).


1.1.5 Parâmetro MV_RHCONEX

  • Informar o parâmetro MV_RHCONEX – Indica se a rotina de Fechamento Contábil será processada em Sistema.
    Externo
  • Este parâmetro indicará se há ou não uma integração contábil do RH com algum sistema externo, gerando desta forma um arquivo TXT.
    • Conteúdo Default: .F. (não gera  TXT).
    • Alterar o conteúdo do parâmetro para .T.
  • A rotina de Geração da Contabilização, GPEM110, lerá este parâmetro e se estiver configurado para gerar o TXT, será apresentada a tela abaixo, onde o usuário irá informar o destino a ser gerado o arquivo texto.
  • Esta tela será apresentada somente na primeira execução. O conteúdo informado pelo usuário será armazenado no parâmetro MV_PASCON. Nas próximas execuções da Contabilização, será buscado o valor desse parâmetro para gravar na pasta o arquivo contábil.


1.1.6 Parâmetro MV_ERPLOGI

  • Informar o parâmetro MV_ERPLOGI – Indica se há integração com o ERP LOGIX.
  • Este parâmetro indicará se haverá ou não integração com o sistema Logix.
    • Conteúdo Default : 2
    • Alterar o conteúdo do parâmetro para 1

 

1.1.7 Parâmetro MV_PASCON

  • Parâmetro que contém o caminho (configurável no momento da execução da rotina) onde serão salvos os arquivos da integração da Contabilização da Folha.


1.2 Configuração do Protheus GPE para contabilização

1.2.1 Definição dos lançamentos contábeis

Cadastro do Lançamento Padrão:

Informar os Lançamentos padrões para a Folha de Pagamento, que posteriormente serão associados às Verbas. Os códigos de Lançamento Padrão devem ser Alfanuméricos.

Na aba Entidades, informar as Contas de Débito e Crédito (contas estas vindas do Logix, caso utilize a integração com Logix) e os Centros de Custo (de acordo com a fórmula, com o campo vindo da tabela SRZ) que referem-se ao Lançamento Contábil. Também pode ser informado o Item Débito e Crédito, caso seja utilizado o conceito de Item Contábil no sistema.

Na aba Valores, informar a Moeda (a moeda a ser contabilização deve ser informada como 1) e o valor, a buscar da tabela SRZ (SRZ->RZ_VAL).

Na aba Histórico, devem ser definidos os históricos e origens dos lançamentos. A configuração abaixo para o histórico é um exemplo de fórmula, em que é gerado o código e a descrição da verba. A origem do lançamento abaixo é composta pelo módulo (GPE), código do lançamento padrão (A01) e a sequência (001). Esta regra é um exemplo, podendo ser configurados conforme a necessidade.

 

1.2.2 Definição das Verbas

Cadastro de Verbas

Para que a verba seja contabilizada deve ser relacionado ao lançamento padrão no campo “Lcto Padrão”.

 

1.2.3 Contabilização

Após a folha calculada e conferida, executar o processo de Contabilização da Folha de Pagamento Protheus:

Acessar a opção Parâmetros, e deixar como Sim a opção Mostra Lançamentos?

Após a confirmação, visualizar os lançamentos e conferi-los.

Deverá ser selecionada a opção Confirmar. Após esta confirmação, será habilitada a tela com as informações a serem geradas no arquivo e o caminho de Destino dos lançamentos que serão exportados.

Após a confirmação, será realizado o processamento para a geração do arquivo texto que irá gerar as informações do movimento contábil para ser importado no Logix.

Nota:

A Geração do arquivo TXT é genérica e poderá ser disponibilizada independente da integração com Logix, desde que o parâmetro MV_RHCONEX esteja informado.

 

1.3 Configuração do módulo Contábil Logix para importação do arquivo contábil Protheus

1.3.1 CON1640 / CON10049 – Parâmetros dos Sistemas Geradores

Criar um novo sistema gerador denominado “GPE” – Gestão de pessoas.   Desmarcar (N) o campo “É sistema Logix?” indicando que a origem dos lançamentos do sistema GPE é externa ao Logix. Definir a forma de contabilização como “Via arquivo texto”.

 

1.3.2 CON1650/ CON10050 – Controle de Lotes Contábeis

Definir o último lote recebido para o sistema GPE. Esta informação será utilizada nos programas de contabilização por arquivo texto do Logix (CON4050 ou CON10051).

Importante:

Está será uma rotina mensal, em todos os fechamentos contábeis o sistema GPE gerará um arquivo texto com os dados da contabilização. Quando o responsável pelo departamento contábil receber este arquivo, ele deve informar o número do lote recebido no CON1650 ou no CON10050. Após esta etapa o arquivo estará apto a ser processado pelo CON1640 ou CON10051 (Integração com Sistemas Geradores).

Nota:

Para ser processado o arquivo deve ser colocado no Diretório padrão UNL, parametrizar no LOG1100 (Caminhos de diretórios).

 

1.3.3 CON4050/ CON10051 – Integração com Sistemas Geradores

Importante:

Se a empresa optar pelo processo de integração via EAI, deve-se pular para o item 1.7 deste documento.

Os Lançamentos Contábeis oriundos do módulo de Gestão de Pessoal do Protheus (GPE) poderão integrados à contabilidade Logix via arquivo texto. Portanto, é necessário que o responsável pela área contábil mensalmente receba o arquivo de lançamentos contábeis e efetue a integração manualmente pelo CON4050 ou CON10051, conforme descrito nos itens anteriores.  Caso ocorra qualquer  inconsistência  o programa listará no relatório emitido ao término do processamento.

Importante:

Se a empresa utiliza o Logix na versão 10.02 o CON4050 exige que o nome do arquivo siga a seguinte formatação: <empresa><módulo gerador><número do lote>.CON. Exemplo: 50GPE001.CON

Para as empresas que utilizam o Logix 11.00 não existe esta restrição no CON10051, basta selecionar a opção de tela “Importar um único arquivo” e informar o nome do arquivo no campo “Nome arquivo”.

 

1.4 Fluxo

 

1.5 Atributos Integrados

Abaixo está o mapeamento dos campos que serão exportados. A coluna Campo Logix contempla os campos do arquivo texto que serão preenchidos pela coluna Campo Protheus. Na coluna Observação estão as regras para o preenchimento dos valores que serão exportados.

Campo LogixCampo ProtheusObservação
cod_empresaEmpresa
  • • Para a buscar a empresa Logix no DE/PARA deverá verificar se o parâmetro MV_ERPLOGI está ativado (1). Caso esteja, na tabela de DE/PARA, será considerado como sistema externo o nome LOGIX.
  • Se este parâmetro não estiver habilitado, não será verificado na tabela de DE/PARA de Empresas e será enviado o código da Empresa/Filial do Protheus no layout.
  • Enviar o código da Empresa Logix, conforme o cadastro de De/Para de Empresas Protheus X Sistema Externo (APCFG050), cadastrado no Configurador. Será convertido o Código da Empresa Protheus e Código da Filial Protheus para o código da Empresa Logix.
  • Se no momento da exportação não houver a definição de alguma Empresa/Filial Protheus para uma Empresa Logix, será emitida a mensagem de erro e não exportará os registros da contabilização.
    • Não há DE/PARA de códigos entre Empresa/Filial Protheus X Empresa Logix (APCFG050) no Configurador. 
CT2_FILIAL
num_loteCT2_SEQUENEste código será necessário para identificar no Logix o lote que está sendo exportado. Deve ser gerado um número sequencial conforme cada geração da contabilização do Protheus para o Logix e enviá-lo.
cod_sistemaGPE
  • Sistema Gerador. Este código será cadastrado fixo no Logix. Quando a integração for do sistema de Folha de Pagamento Protheus (GPE), será enviado o código fixo GPE. Dessa forma na importação será identificado que estes lançamentos vieram do sistema Protheus GPE.
    • Gerar fixo o valor GPE.
dat_referCT2_DATA
  • Data de processamento dos lançamentos contábeis. Será considerada a competência do período informado, sendo atribuído neste campo no formado DD/MM/AAAA, sendo considerado no DD o último dia do mês.
  • Caso a integração não seja com Logix, levar a informação gerada originalmente.
num_contaCT2_DEBITO/ CT2_CREDITO
  • Campo correspondente a conta contábil. Para o Logix será enviado o número da conta e a diferenciação se ela é débito ou crédito será por meio do campo Tipo de Lançamento.
  • Caso a integração não seja com Logix, levar a informação gerada originalmente.
  • Neste caso no Protheus, a informação gerada é sem máscaras e tem que utilizar um De/Para para exportar de acordo com o que está cadastrada no LOGIX.
ies_tipo_lancCT2_DC
  • No Protheus estes valores podem assumir 1 – Débito; 2 – Crédito, 3 – Partida Dobrada, 4 – Cont. Hist, 5 – Rateio, 6 – Lact Padrão. Para a integração com o Logix estaremos tratando somente 1 – Débito; 2 – Crédito, 3 – Partida Dobrada. Nos casos em que haja partida dobrada, deverão ser gerados dois lançamentos (dois registros no arquivo), informando no campo Número da Conta o valor do campo CT2_DEBITO e o tipo de Lançamento como 1 – Débito e outro Lançamento com o valor do campo CT2_CREDITO, e o Tipo de Lançamento como 2 – Crédito.
  • Enviar da seguinte forma:
    • Para Débito, enviar D;
    • Para Crédito, enviar C;
    • Para os casos em que o parâmetro MV_ERPLOGI esteja desabilitado, será enviado o valor do Protheus.
    • Caso a integração não seja com Logix, levar a informação gerada originalmente.
dat_movtoCT2_DATA
  • Gerar a data do lançamento, no formato DD/MM/YYYY.
val_lancCT2_VALOR
  • Gerar o valor do lançamento.
cod_rateio0
  • Gerar fixo o valor 0.
cod_hist000
  • Fornecido pelo usuário (até três números).
tex_complCT2_HIST
  • Gerar o valor do campo da Descrição do Histórico, que será cadastrado no Lançamento Padrão.
ies_sit_lancN
  • Gerar fixo o valor N.
cod_lin_prodCTD_ITEMD/ CTD_ITEMC
  • Campo correspondente ao Item Contábil. Para o Logix será enviado o Item Contábil, se é débito ou crédito através do campo Tipo de Lançamento.
  • O item contábil deverá ser dividido de duas em duas posições, para indicar a área e linha no Logix.
  • Exemplo 1: Se o Item Contábil tiver o seguinte código 01020304, deverá dividir no arquivo: 01|02|03|04
  • Exemplo 2: Se o Item contábil tiver o seguinte código: 0102, deverá dividir no arquivo: 01|02|0|0
  • Se não houver valores de item contábil, deve-se enviar |0|0|0|0
  • Caso a integração não seja com Logix, levar a informação gerada originalmente.
cod_lin_recei
cod_seg_merc
cod_cla_uso

 

1.6 Layout do arquivo

  • O arquivo será gerado conforme o modelo abaixo, caso haja integração com o Logix:
    50|100|GPE|31/12/2012|9.9.9.9.98|D|16/12/2012|100.00|0|1|teste|N|0|0|0|0
    50|100|GPE|31/12/2012|9.9.9.9.98|C|16/12/2012|150.00|0|1|teste|N|0|0|0|0

    A nomenclatura do arquivo será gerada da seguinte forma:
    • 50GPE100.CON
      • Em que:
        • 50 – Refere-se ao código da empresa, atribuído conforme o DE/PARA de Empresas do Protheus X Empresa Logix.
        • GPE – Sistema Gerador. Sempre será gerado este código fixo.
        • 100 – Número do lote. Este número será incremental, à medida que for gerado os lotes para o Logix.

  • Caso não haja integração com o Logix, arquivo será gerado conforme o modelo abaixo:
    99|01|100|GPE|29/12/2012|9.9.9.9.98|1.1.1.1.11|3|16/12/2012|100.00|0|1|teste|N||
    99|01|100|GPE|29/12/2012|9.9.9.9.98|1.1.1.1.22|3|16/12/2012|100.00|0|1|teste|N|XXXXXXXX|YYYYYYYY
    • Em que:
      • 99 – Empresa Protheus
      • 01 – Filial Protheus
      • 100 – Sequência do Lote, conforme CT2
      • GPE – Fixo GPE
      • 29/12/2012 – Data original gerada pela CT2
      • 9.9.9.9.98 – Número da conta de débito, conforme a CT2, caso houver
      • 1.1.1.1.11 – Número da conta de crédito, conforme a CT2, caso houver
      • 3 – Tipo de Lançamento, conforme a CT2
      • 16/12/2012 – Data de Movimento, conforme a CT2
      • 100.00 – Valor do lançamento, conforme a CT2
      • 0 – Fixo 0
      • 1 – Fixo 1
      • Teste – Descrição do histórico, conforme a CT2
      • N – fixo N
      • XXXXXXXX – Item contábil de Débito, caso houver, conforme a CT2
      • YYYYYYYY – Item contábil de Crédito, caso houver, conforme a CT2
  • A nomenclatura do arquivo deverá ser gerada da seguinte forma:
    5001GPE100.CN
    • Em que:

      • 50 – Código da Empresa Protheus

      • 01 – Código da Filial Protheus

      • GPE – Sistema Gerador. Sempre será gerado este código fixo

      • 100 – Número do lote. Este número será incremental, à medida que for gerado os lotes

      • CON – indica a extensão do arquivo .CON – indica a extensão do arquivo

    Nota:

    O número do lote é configurável. No configurador, basta acessar as opções de configuração de auto numeração (SEX/SF ( _CT) ) e configurar para o valor desejado (atual e próximo).

 

1.7 Integração Contábil via EAI

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 "GPE" no CON1640 ou CON10049 (Sistemas geradores);
  • De-para de empresas configurado.
  • Plano de contas do Logix e Protheus integrados previamente.
  • Cadastro de Área estratégica de negócio previamente 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.

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 último segmento do lote.
  • Ocorrendo erro ou inconsistência em algum segmento, o Protheus 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 padrão "NN|TT", onde "NN" é o número do segmento e "TT" é o total de segmentos.

 

2 Integração Financeira

Abaixo encontra-se o detalhamento da Integração Financeira, na qual os Títulos do Protheus GPE serão integrados no módulo Financeiro Logix. A integração abaixo será realizada por meio de Mensagem Única (EAI).

 

2.1 Pré-Requisitos

2.1.1 Cadastro de Fornecedores

  • Habilitar para integrações o cadastro de Fornecedores (SA2) (mensagem: CustomerVendor). Este cadastro será obrigatório para a Definição do Titulo para o envio da mensagem financeira. A função MATA020 deverá ser cadastrada no Schedule Protheus para receber informações de sistemas externos. Mensagem Única: Sim

Rotina: MATA020
Mensagem:
CustomerVendor Envia / Recebe: Não/ Sim Método: Síncrono
Operações: Todas
Canal de Envio: EAI

 

2.1.2 Configuração DE/PARA Logix – Tipo de Despesa Logix X Tipo de Título Protheus

  • Devido a obrigatoriedade de envio do atributo FinancialCode na mensagem para o sistema Financeiro Logix e não haver nenhum programa de equivalência entre os sistemas Logix e Protheus, será necessário a configuração do cadastro de DE-PARA no Logix associando o Tipo de Despesa Logix ao código do Tipo de Título.
  • Será enviado na mensagem única do sistema Protheus o código do Tipo de Título que foi criado na Definição do Título:
  • A equivalência deste código deve ser o Tipo de Despesa cadastrado no sistema Logix:
  • No Logix deverá ser configurado no cadastro de DE\PARA do EAI (VDP10141), o valor do Tipo de Despesa Logix, nos campos DE e o valor equivalente ao Tipo de Título no campo PARA.
  • No momento da integração da mensagem no Logix, será consistido se o valor enviado na tag FinancialCode, que irá corresponder ao Tipo de Título do Protheus, está cadastrado no DE\PARA.
  • Se não houver relação, será rejeitada a mensagem

 

8.2.1.3 Geração de Títulos

  • Habilitar para integrações o processo de Geração de Títulos. A função GPEM670 deverá ser cadastrada no Schedule Protheus para enviar as informações a sistemas externos.

 

2.1.4 Manutenção de Títulos

  • Habilitar para integrações o processo de Manutenção de Títulos. A função GPEM660 deverá ser cadastrada no Schedule Protheus para enviar as informações a sistemas externos.


2.2 Processo para a Integração Financeira – Protheus GPE

2.2.1 Definição dos Títulos

Os títulos devem ser definidos no Protheus, por meio do programa Títulos (Gestão de Pessoa > Miscelânea > Títulos > Definição). Informar todos os campos obrigatórios.

Atentar para o campo Tipo Título. Este campo será obrigatório, quando a integração for com o sistema Logix, pois irá identificar o Tipo de Despesa. Deverá ser preparado o DE-PARA no Logix, incluindo uma equivalência dos códigos entre estes dois produtos.

 

2.2.2 Geração dos Títulos/Manutenção

Os títulos devem ser gerados (Gestão de Pessoal > Miscelânea > Títulos > Geração) no Protheus para ser efetuadas manutenções (Gestão de Pessoal > Miscelânea > Títulos > Manutenção), caso necessário.

 

2.2.3 Integração com Financeiro

Efetuada a geração e as manutenções, os títulos devem ser integrados com o Financeiro (Gestão de Pessoal > Miscelânea > Títulos > Integr. Financeiro). A rotina será verificada se está habilitado à integração com o Enterprise Application Integration (EAI). Dessa forma, ao invés dos títulos serem gerados no Financeiro Protheus, será enviado por meio de mensagem única para os sistemas externos cadastrados no EAI.

 

2.2.1 Manutenções/Exclusões de Títulos

Os títulos Integrados com o Logix apresentarão a indicação como Liberado no programa de Manutenção de Títulos. Para consultar a equivalência dos códigos de Títulos que foram gerados do Protheus com o código do Logix (AD – Apropriação de Despesas), poderão ser consultados por meio do programa DE/PARA Conteúdos Mensagem Única (tabela XXF), disponibilizado no Configurador (SIGACFG).

Para os títulos em que houveram Inconsistências na integração, estes permanecerão com este status e deverá ser verificada a inconsistência que ocorreu. Para visualizar a inconsistência, deverá ser acessado o Configurador Protheus, acessando o programa de Schedule e buscando o título onde houve a inconsistência e visualizar o erro.

Identificada a inconsistência, deverá ser dada a manutenção no Título no GPE e alterando o status de integração como Não Liberado. Deverá ser processada novamente a Geração de Títulos, permitindo que o título alterado seja integrado novamente. 

Os títulos também poderão ser excluídos, desde que não estejam liquidados no Financeiro Logix.

 

2.3 Processo para a Integração Financeira – Logix Financeiro

2.3.1 VDP0815/VDP10000 (Cadastro de Fornecedores)

Deve-se parametrizar a geração automática de APs para todos os fornecedores envolvidos na integração. Conforme abaixo:

Versão 10.02: VDP0815 > Fornecedores > Inf. Bancárias > campo “Indicador de geração de APs” = “S”;

Versão 11.00: VDP10000 > Fornecedores > Informações bancárias > campo “Gera ordem de pagamento?” = “NF’S e conhecimento”.

 

2.3.2 VDP1075/VDP10141(DE/PARA Geral)

A entidade Tipo de Despesa utilizada no Contas a Pagar do Logix, equivale ao Tipo de Título no Protheus. No entanto no Logix esta entidade só aceita números e no Protheus é alfanumérico, por isso é necessário cadastrar os códigos equivalentes nos dois sistemas da seguinte forma:

Campo

Conteúdo

Tabela

TIPO_DESPESA

Sistema integração

PROTHEUS_GPE

CAMPOS:
Cod_empresa<Empresa Logix>
Cod_tip_despesa<Tipo de despesa Logix>

Valor:

<Tipo de título no Protheus>

Nota:

Repetir o cadastro para todos os tipos de despesas que serão utilizados na integração.

 

2.3.3 FIN30058 (Apropriação de Despesas)

Os títulos gerados pelo Protheus serão incluídos como AD (Apropriação de Despesas) no Logix. Neste programa deverá ser feita a conferência dos títulos que foram integrados.

 

2.4 Fluxo

O processo seguirá o fluxo abaixo:

 

2.5 Atributos Integrados

Abaixo, os campos das informações Financeiras PROTHEUS  GPE  (RC1) com as tags da Mensagem  Única AccountPayableDocument:

CampoTAGObservação
 CompanyId
  • Código da Empresa (conforme número da tabela RC1XX0)
RC1_FILTITBranchId
  • Código da Filial
 DocumentPrefix
  • Quando a integração for com o sistema Financeiro Logix, será enviado o valor Fixo “U”.
  • Para os demais sistemas financeiros externos que integrarem com o Protheus GPE, este campo não será preenchido.
 DocumentNumber
  • Será enviada a chave do Título do Protheus GPE: EMPRESA|RC1_FILTIT|RC1_CODTIT|RC1_PREFIX|RC1_NUMTIT
RC1_PARCDocumentParcel
  • Parcela
 DocumentTypeCode
  • Tipo do título;
  • Não será enviado nenhum valor.
 ListOfSourceDocument
  • Não será necessário o envio de nenhum valor
RC1_EMISSAIssueDate
  • Data de Emissão do título
 DueDate
  • Data de vencimento Original;
  • Não será enviado nenhum valor.
RC1_VENREARealDueDate
  • Data de vencimento Real
RC1_FORNECVendorCode
  • Código do fornecedor;
  • Código previamente integrado com o sistema externo.
 StoreId
  • Loja;
  • Não será enviado nenhum valor.
 NetValue
  • Valor líquido;
  • Não será enviado nenhum valor.
RC1_VALORGrossValue
  • Valor Bruto
 CurrencyCode
  • Moeda;
  • Não será enviado nenhum valor.
 CurrencyRate
  • Taxa de Moeda;
  • Não será enviado nenhum valor.
 Taxes
  • Impostos;
  • Não será enviado nenhum valor.
ApportionmentDistribution – Distribuição de rateio. A estrutura poderá ser incrementada para conter outros tipos de rateio.
 CostCenterCode
  • Para o Logix, este campo é considerado como Área/Linha de Negócio. Como no Protheus não há este conceito, será enviado 0.
  • No Logix, este campo é obrigatório. Será feito um tratamento na entrada do Título no Logix, para atribuir um valor padrão de área/linha de negócio definido em um parâmetro, caso a empresa no Logix trabalhe com este conceito.
RC1_VALORValue
  • Será enviado o mesmo valor do título.
  • Como não haverá rateio, em virtude de não trabalhar com área/linha de negócio no Protheus, será o próprio valor do título.
RC1_TIPOFinancialCode
  • Este campo no Logix corresponderá ao Tipo de Despesa.
  • É um campo obrigatório para todos os títulos que entram no Contas a Pagar Logix.
  • Será enviado o valor do campo RC1_TIPO, e no Logix, haverá um DE-PARA para relacionar ao Tipo de Despesa.
  • O DE-PARA deverá ser cadastrado manualmente no VDP10141 no momento da implantação do processo de integração:
    Tabela: TIPO_DESPESA
    Sistema integração: PROTHEUS_GPE (manter igual a tag ‘ORIGIN’ para ser reaproveitado em outras integrações)
    Campo: Cod_empresa = <código da empresa> Cod_tip_despesa = < tipo de despesa do logix>
    VALOR (PARA): Conteúdo do RC1_tipo correspondente ao tipo de despesa do Logix.
 Observation
  • Observação;
  • Não será enviado nenhum valor.
 Origin
  • Origem;
  • Será enviado fixo PROTHEUS_GPE.