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.

Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

• Sistema/Módulo vertical - Qual o módulo, qual marca, suas principais características, funcionalidades, escopo do módulo, etc
• BackOffice(s) - Qual(ais) marca(s), o que o ERP engloba, quais são seus pontos fortes, funcionalidades, etc, explanações principalmente no que diz respeito às funcionalidades do ERP que serão utilizadas pela integração (mas sem citar a integração)

Integração

O que levou a criação da integração / o porquê da integração (Finalidade/Objetivo), de forma macro, o que será integrado do, por exemplo, Vertical com o ERP (BackOffice)

Explique o contexto de negócio ou do problema na qual esta integração estará inserida. Isto inclui o funcionamento da(s) ponta(s) envolvida(s).

Apresentar a integração como uma melhoria para o cenário ou como uma solução para o problema.

• Premissas
  Gerais, do Vertical, do BackOffice e dos demais artefatos/sistemas envolvidos
  Premissas Gerais
  Premissas A
  Premissas B

• Arquitetura (Tecnologia)

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.

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.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

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 Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Transações/Entidades/Mensagens únicas

Apresente quais as transações/entidades que são trocadas e quem envia a informação para quem. Pode (e recomenda-se) ter um diagrama, uma tabela ou afins que apresente este fluxo.

Relacione quais são as mensagem únicas (TOTVSMessage) utilizadas e qual o seu relacionamento com as entidades já existentes do ERPs envolvidos.

Exemplos:

 Image Removed

Image Removed

Fluxo das Informações

Para cada fluxo de informação descreva, se necessário, alterações de comportamento que o respectivo produto irá sofrer. Por exemplo: quando o Logix recebe o PEDIDO de OUTRO ERP, este pedido não poderá ser alterado no Logix.

Liste quais as entidades integradas e como é o mapeamento entre as diferentes estruturas. Por exemplo: Classe no sistema A vira categoria no sistema B, o campo X é refletido no campo Y etc.

Liste quais transações/operações a integração fará com as entidades relacionadas. Exemplo: Insert de PEDIDO, Insert, update de ITEM, buscar saldo em estoque do ITEM no dia X ou buscar dados do FUNCIONÁRIO.

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. 

Processos

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Processo>

Tipo de Fluxo: Protheus -> RM

Mensagem: Request_1_000

Versão: 1.000

Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.

Acrescentar um diagrama do processo.

A seguir descrever as variações, particularidades da mensagem e processos (desta integração) de acordo com cada marca

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita. 

Como fazer (opcional)

Descreva os passos que viabilizem a integração.

Exemplo:

Os passos para viabilizar a integração são:

• No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.
• No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.
• No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
• No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
• No Protheus consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
• No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
• No Protheus verificar se foi efetuado corretamente o relacionamento entre os dois documentos.
• No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.
• No Protheus efetuar o faturamento do pedido de venda recebido.
• No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).
• No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.
• No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido está disponível no programa WMS6411 (Movimentos a Faturar).

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.

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: 

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.

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): 

Image Added

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.

Image Added

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.

Image Added

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.

Image Added

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.

Image Added

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).

Image Added

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.

Image Added

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”.

Image Added

1.2.3 Contabilização

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

Image Added

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

Image Added

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

Image Added

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.

Image Added

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.

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).

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

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.

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

Image Added

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.

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

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.

Image Added

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.

Image Added

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:
  Image Added

• A equivalência deste código deve ser o Tipo de Despesa cadastrado no sistema Logix:
  Image Added
• 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.

Image Added

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.

Image Added

Image Added

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.

Image Added

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).

Image Added

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.

Image Added

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:

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:

Image Added

2.5 Atributos Integrados

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

xxxxxxxxxxxxxx

• 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.