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.

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

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.

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:

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.

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.

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 informado 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, onde é 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.

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

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

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.

Anexos