Projeto: FS008963- Integração RM Folha X SENIOR

Nome do Cliente: Federação Nacional das Industrias de Pernambuco - FIEPE


Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | Parâmetros

Após serem liberados nas permissões de perfil dos usuários teremos acesso as customizações no módulo Educacional através do caminho: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | Parâmetros

Dados da Conexão

  • Endereço (Lançamentos Financeiros): Neste parâmetro o usuário deverá informar a URL do servidor SAPIENS referente ao método do Webservice de inclusão de lançamentos financeiros. 
  • Endereço (Exclusão de Lançamentos Financeiros): Neste parâmetro o usuário deverá informar a URL do servidor SAPIENS referente ao método do Webservice de exclusão de lançamentos financeiros.
  • Endereço (Inclusão de Lotes Contábeis): Neste parâmetro o usuário deverá informar a URL do servidor SAPIENS referente ao método do Webservice de inclusão de lote contábeis.
  • Endereço (Inclusão de Lançamentos Contábeis): Neste parâmetro o usuário deverá informar a URL do servidor SAPIENS referente ao método do Webservice de inclusão de lançamentos contábeis.
  • Endereço (Processamento de Lotes Contábeis): Neste parâmetro o usuário deverá informar a URL do servidor SAPIENS referente ao método do Webservice de processar os lotes contábeis.
  • Endereço (Exclusão de Lotes Contábeis): Neste parâmetro o usuário deverá informar a URL do servidor SAPIENS referente ao método do Webservice de exclusão de lotes contábeis.
  • Senha: Neste parâmetro o usuário deverá informar o senha para autenticação de acesso
  • Usuário: Neste parâmetro o usuário deverá informar o usuário para autenticação de acesso. 


Dados da Integração

  • Código de Transação para Exportação do Lançamento Financeiro: neste parâmetro o usuário deverá informar o código de tipo de transação do SAPIENS referente a entrada de títulos (contas a pagar).


Para o correto funcionamento da customização, todos os dados deverão ser parametrizados corretamente.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | DE|Para | Filial


Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens - Anexos De|Para | Filial - Integração Folha SAPIENS


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Filial do RM, os códigos de Filial e de Projeto correspondentes no SAPIENS.

A interface de DE|PARA poderá ser acessada por dois caminhos:


Menu customização: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | DE|PARA | Filial.


No cadastro nativo de Filial TOTVS BackOffice | Gestão Fiscal | Filiais | Anexos | Filial - Integração SAPIENS



Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro.  



Ao incluir ou editar, será exibida a interface com os campos:

Código Filial RM: campo do tipo Lookup para informar o código da Filial no RM que precisará de DE|PARA com o código SENIOR.
Código Filial SENIOR: campo do tipo texto livre, para informar o código da filial do SENIOR que corresponde à filial do cadastro do RM. 
Código Projeto SENIOR: campo do tipo texto livre, para informar o código do projeto do SENIOR que corresponde à filial cadastrada. 


Este cadastro de De|Para é separado por Coligada, sendo necessário realizar os cadastros em todas as coligadas em que a Exportação de Lançamentos Financeiros serão utilizadas.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | DE|Para | Cliente/Fornecedor



Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens - Anexos De|Para | Cliente/Fornecedor - Integração Folha SAPIENS


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Cliente/Fornecedor do RM, os correspondentes no SAPIENS.

A interface de DE|PARA poderá ser acessada por dois caminhos:


Menu customização: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | DE|PARA | Cliente/Fornecedor.


No cadastro nativo de Filial TOTVS BackOffice | Gestão Financeira | Cliente/Fornecedor| Anexos | DE|PARA - Cliente/Fornecedor



Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro.



Ao incluir ou editar, será exibida a interface com os campos:

Código RM: campo do tipo Lookup para informar o código do Cliente/Fornecedor no RM.
Código Externo: campo do tipo texto livre, para informar o código do Cliente/Fornecedor do SAPIENS que corresponde ao Cliente/Fornecedor do cadastro do RM. 

Este cadastro é separado por Coligada, podendo ser utilizados valores da própria coligada ou globais e que se necessário devem ser cadastrados em outra coligada para utilização na mesma.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | DE|Para | Natureza Financeira



Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens - Anexos De|Para | Natureza Financeira - Integração Folha SAPIENS



Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Natureza Orçamentária Financeira do RM, os correspondentes no SAPIENS.

A interface de DE|PARA poderá ser acessada por dois caminhos:


Menu customização: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | DE|PARA | Natureza Financeira.



No cadastro nativo de Filial TOTVS BackOffice | Gestão Financeira | Cadastros | Movimentos | Natureza Orçamentária Financeira | Anexos | Natureza Financeira - Integração Folha SAPIENS



Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro. 




Ao incluir ou editar, será exibida a interface com os campos:

Código RM: campo do tipo Lookup para informar o código de Natureza Financeira no RM.
Código Externo: campo do tipo texto livre, para informar o código da Natureza Financeira do SAPIENS que corresponde ao cadastro do RM. 

Este cadastro de De|Para é separado por Coligada, sendo necessário realizar os cadastros em todas as coligadas em que a Exportação de Lançamentos Financeiros serão utilizadas.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | DE|Para | Centro de Custo

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens - Anexos De|Para | Centro de Custo - Integração Folha SAPIENS


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Centro de Custo do RM, os correspondentes no SAPIENS.

A interface de DE|PARA poderá ser acessada por dois caminhos:


Menu customização: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | DE|PARA | Centro de Custo.



No cadastro nativo de Filial RH| Folha de Paramentos | Administração de Pessoal | Cadastros | Centros de Custo | Anexos | DE|PARA - Centro de Custo



Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro. 




Ao incluir ou editar, será exibida a interface com os campos:

Código RM: campo do tipo Lookup para informar o código do Centro de Custo no RM.
Código Externo: campo do tipo texto livre, para informar o código do Centro de Custo do SAPIENS que corresponde ao cadastro do RM. 

Este cadastro de De|Para é separado por Coligada, sendo necessário realizar os cadastros em todas as coligadas em que a Exportação de Lançamentos Financeiros serão utilizadas.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | DE|Para | Conta Contábil

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens - Anexos De|Para | Conta Contábil - Integração Folha SAPIENS


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Conta Contábil (Plano de Contas) do RM, os correspondentes no SAPIENS.

A interface de DE|PARA poderá ser acessada por dois caminhos:


Menu customização: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | DE|PARA | Conta Contábil


No cadastro nativo de Filial TOTVS BackOffice | Gestão Contábil | Cadastros | Plano de Contas | Contábil | Anexos | DE|PARA - Conta Contábil



Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro. 




Ao incluir ou editar, será exibida a interface com os campos:

Código RM: campo do tipo Lookup para informar o código da Conta Contábil no RM.
Código Externo: campo do tipo texto livre, para informar o código da Conta Contábil do SAPIENS que corresponde ao cadastro do RM. 

Este cadastro de De|Para é separado por Coligada, sendo necessário realizar os cadastros em todas as coligadas em que a Exportação de Lançamentos Financeiros serão utilizadas.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | DE|Para | Histórico Padrão


Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens - Anexos De|Para | Histórico Padrão - Integração Folha SAPIENS


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Histórico Padrão do RM, os correspondentes no SAPIENS.

A interface de DE|PARA poderá ser acessada por dois caminhos:


Menu customização: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | DE|PARA | Histórico Padrão.


No cadastro nativo de Filial TOTVS Folha de Pagamento| Encargos | Cadastros | Históricos Padrões| Anexos | Histórico Padrão - Integração Folha SAPIENS



Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro. 




Ao incluir ou editar, será exibida a interface com os campos:

Código RM: campo do tipo Lookup para informar o código do Histórico Padrão no RM.
Código Externo: campo do tipo texto livre, para informar o código do Histórico Padrão do SAPIENS que corresponde ao cadastro do RM. 


Este cadastro de De|Para é separado por Coligada, sendo necessário realizar os cadastros em todas as coligadas em que a Exportação de Lançamentos Financeiros serão utilizadas.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | Exportação lançamentos financeiros para SAPIENS



Para mais detalhes de como liberar no perfil dos usuários, acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Detalhamento do processo

Foi criado um processo customizado de Exportação de Lançamentos Financeiros da Folha, para enviar os lançamentos financeiros gerados durante a emissão da Folha de Pagamento do módulo TOTVS RH, para o sistema SAPIENS, disponível em: TOTVS RH | Folha de Pagamento |Encargos | Lançamentos Financeiros| Exportação lançamentos financeiros para SAPIENS. 

O usuário poderá selecionar um ou vários registros para integração.





A FIEPE precisa garantir que exista no SAPIENS apenas um lançamento financeiro por tipo de pagamento / evento (folha, encargos, férias, etc.) para todas as filiais. Para isso, só deverá existir um lançamento por tipo de pagamento no RM. 

O RM não trata rateio por filial na geração do lançamento. Portanto, a customização realizará o rateio por filial, na hora do envio para o SAPIENS, considerando a filial de lotação do funcionário (Filial da Seção). De acordo com o exemplo abaixo:


Lançamento financeiro: 100

Tipo de pagamento/evento: Líquido Salarial

Natureza Financeira: Salários

Centro de Custo: Educação

Total lançamento: R$ 150.000,00, referente aos funcionários:


Funcionários

Filial de lotação do funcionário (Seção)

Filial / Projeto Sapiens

Salário Líquido

Gustavo Henrique

Recife

100 / 001

R$ 10.000,00

Daniel Lucas

Recife

100 / 001

R$ 20.000,00

Alice Maria

Porto de Galinhas

200 / 002

R$ 30.000,00

Rosa Helena

Jaboatão dos Guararapes

300 / 003

R$ 40.000,00

Maria Luisa

Jaboatão dos Guararapes

300 / 003

R$ 50.000,00

Rateio enviado ao SAPIENS para o lançamento 100:

Projeto

(filial)

Fase

Valor

Centro de Custo CR

Percentual Rateio cc

Natureza Financeira

Percentual rateio nat

001

Única

R$ 30.000,00

Educação

100%

Salários

100%

002

Única

R$ 30.000,00

Educação

100%

Salários

100%

003

Única

R$ 90.000,00

Educação

100%

Salários

100%

O lançamento deverá ser gerado no RM utilizando a quebra da empresa. Desta forma, todos os funcionários de todas as seções/filiais farão parte do mesmo lançamento gerado, podendo ser identificados na aba rastreabilidade.




Ao executar o processo, a customização consumirá a API disponibilizada pelo SAPIENS e enviará os dados dos lançamentos financeiros da folha gerados através do SGE, para serem criados no SAPIENS.


Após a exportação dos dados, as informações enviadas para o SAPIENS ficarão armazenadas no Monitor de log com a funcionalidade:  Exportação de Lançamentos Financeiros da Folha e pode ser acessado através dos menus: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | Monitor de Log e RH | Folha de Pagamento | Encargos | Financeiro | Lançamentos (Folha de Pagamento) | Anexos | Log - Integração Financeira SAPIENS


Este processo deverá ser executado manualmente pelo usuário, não sendo permitido seu agendamento. 

A FIEPE não utiliza rateio por centro de custo no RM. Portanto, caso ele aconteça no RM, ele será ignorado no momento do envio para o SAPIENS.

Correção de lançamentos e reenvio:

  • A interface de lançamentos financeiros não permite edições manuais nos lançamentos. Caso seja identificada a necessidade de correção, o usuário deverá executar novamente o processo de geração de lançamentos e será gerado um novo registro, que precisará ser exportado para o SAPIENS. O lançamento errado deverá ser excluído através do processo Excluir lançamento financeiro do SAPAIENS. Caso ele já tenha sido exportado para o SAPIENS, será excluído do SAPIENS e também do RM.

Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | Excluir lançamentos financeiros do SAPIENS


Para mais detalhes de como liberar no perfil dos usuários, acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Detalhamento do processo

Foi criado um processo customizado de Exclusão dos lançamentos financeiros, para enviar os dados de lançamentos de Folha de pagamento que precisam ser excluídos do SAPIENS, disponível em: TOTVS RH | Folha de Pagamento | Encargos | Lançamentos Financeiros | Excluir lançamentos financeiros do SAPIENS.

Este processo deverá ser executado manualmente pelo usuário, não sendo permitido seu agendamento.

O usuário poderá selecionar um ou mais registros e clicar no processo. Ao executar, a customização irá chamar a API SAPIENS para exclusão do(s) lançamento(s)  selecionado(s). 





Caso o SAPIENS execute com sucesso a exclusão, o registro também será excluído da interface no RM. Caso a API retorne algum erro, o registro continuará sendo exibido na interface do RM, o status da integração será atualizado para “Integrado - Exclusão não permitida” e o erro será exibido no log do processo e no monitor de log.

Após a exportação dos dados, as informações enviadas para o SAPIENS ficarão armazenadas no Monitor de log com a funcionalidade:  Exportação de Lançamentos Financeiros da Folha e pode ser acessado através dos menus: RH | Folha de Pagamento | Customização | Integração Folha x Sapiens | Monitor de Log e RH | Folha de Pagamento | Encargos | Financeiro | Lançamentos (Folha de Pagamento) | Anexos | Log - Integração Financeira SAPIENS


É de responsabilidade do SAPIENS controlar se o registro poderá ou não ser excluído, já que as movimentações financeiras, incluindo a baixa, serão feitas apenas no SAPIENS. 

Foi criado um campo de status da integração com o Sapiens (Status Integração Sapiens), nele a customização consultará o status da integração através das tabelas de controle das entidades correspondentes com as telas.

Lançamento Financeiro

Disponível através do menu: TOTVS RH | Folha de Pagamentos | Encargos | Lançamentos Financeiros.

Lançamento Contábil

Disponível através do menu: TOTVS RH | Folha de Pagamentos | Encargos | Contabilização | Lançamentos | Lançamentos (Folha de Pagamento)


A exibição do campo será conforme exemplo:

  • Pendente: Integração não realizada. 
  • Sucesso: Integração realizada com sucesso, preenchido pelo processo de exportação de lançamentos financeiros. 
  • Erro: Erro na integração, preenchido pelo processo de exportação de lançamentos financeiros.  
  • Integrado - Erro na exclusão: registro integrado no
    SAPIENS e apresentou erro na exclusão do SAPIENS, preenchido pelo processo de exclusão de lançamentos financeiros do SAPIENS.



Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | Exportação lançamentos financeiros para SAPIENS



Para mais detalhes de como liberar no perfil dos usuários, acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Detalhamento do processo

Foi criado um processo customizado de Exclusão dos lotes contábeis, para enviar os dados dos lotes que serão excluídos pelo usuário, disponível em: TOTVS RH | Folha de Pagamento | Encargos | Lançamentos (Folha de Pagamento)|Excluir lançamentos contábeis no SAPIENS.



O usuário poderá selecionar um ou mais registros e clicar no processo. Será exibida a opção para o usuário excluir ou não o registro do RM, já que a exclusão pode estar sendo feita para permitir alguma alteração no cadastro. Por padrão, este campo virá marcado (Excluir registro do RM). 

Ao executar, a customização irá chamar a API SAPIENS para exclusão do(s) lotes(s)  contábeis selecionado(s). 



É de responsabilidade do SAPIENS controlar se o registro poderá ou não ser excluído, já que as movimentações contábeis serão feitas apenas no SAPIENS. 

Caso o SAPIENS execute com sucesso a exclusão, o registro também será excluído da interface no RM, se o usuário optar por esse comportamento. Caso a API retorne algum erro, o registro continuará sendo exibido na interface do RM, o status da integração será atualizado para “Integrado - Exclusão não permitida” e o erro será exibido no log do processo e no monitor de log.

Caso a exclusão seja feita no SAPIENS e o usuário opte por manter o registro do RM, o status da integração será atualizado para Pendente e o número do lote no SAPIENS ficará vazio. Este registro estará disponível para ser integrado novamente.

Caso seja necessário excluir o registro do RM, o usuário poderá utilizar a opção nativa de exclusão, na interface de lançamentos contábeis. 


A partir do momento que o lote foi gerado no Sapiens (primeira parte da exportação de lançamento contábil), mesmo que os lançamentos contábeis não tenham sido enviados com sucesso é necessário excluir o lote pelo processo customizado, uma vez que os bloqueios de alteração e geração de lote não deixaram que essa operação seja realizada fora do processo.

Detalhamento do processo

Atualmente, o processo de geração dos lançamentos contábeis está disponível para execução a qualquer momento pelo usuário, mesmo que já existam lançamentos gerados no RM para um lote específico. Isso pode ser feito através da interface nativa disponível em: TOTVS Educacional| RH| Folha de Pagamento | Encargos | Contabilização |Geração dos Lançamentos.

Quando o usuário executar o processo de geração dos lançamentos contábeis, caso o lote do lançamento já esteja integrado ao Sistema SAPIENS, será exibida mensagem para o usuário informando que o lançamento não poderá ser gerado novamente.


Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração Folha x Sapiens.

Disponível em: Serviços Globais | Perfil | Folha de Pagamento| Customização | Integração Folha x Sapiens | Monitor de Log



Detalhamento do processo

Foi criada uma interface de Log para armazenar informações e status dos dados que foram exportados do SGE para o SAPIENS, referentes aos lançamentos financeiros e contábeis da folha de pagamento. 

O histórico das exportações de dados para o SAPIENS serão registrados e poderão ser acessados por dois caminhos distintos:

  • Menu customização: TOTVS RH | Customizações | Integração SAPIENS | Monitor de Log.



  • Interface de Lançamentos Financeiros da Folha TOTVS RH | Folha de Pagamento | Encargos | Lançamentos Financeiros| Anexos | Monitor de Log - Lançamentos Financeiros.




  • Interface de Lançamentos Contábeis da Folha TOTVS RH | Folha de Pagamento | Encargos | Contabilização | Lançamentos Contábeis | Anexos | Monitor de Log.



Será apresentada ao usuário uma visão com a relação de registros importados e exportados.

  • Id Log: Identificador sequencial de Log.
  • Data de Criação: Data de Criação do registro.
  • Data da última alteração: Data da última alteração do registro.
  • Status: Situação da Integração (Sucesso ou Erro).
  • Id. Job: Ultimo job executado que resulto criação ou alteração do log.
  • Descrição do módulo: Descrição que permite identificar o módulo.
  • Cód. Filial: Código da Filial associada ao registro.
  • Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação Moodle).
  • Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
  • Valores Chave: Chave primária do registro integrado.
  • Última mensagem do item de log: Ultima mensagem do item do log.
  • Download de arquivos associados: Permitirá o download de arquivo associado ao logo caso exista.


Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item de Log. Estarão disponíveis os seguintes campos:


  • Id. Item Log: Identificador sequencial de log.
  • Id. Log: Identificador sequencial de log.
  • Mensagem: Mensagem com o status da integração do item.
  • Status: Situação da integração do item selecionado.
  • Dados Enviados: Relação dos dados enviados para integração.
  • Dados Recebidos: Relação dos dados recebidos.
  • Data de Criação: Data de criação do registro.
  • Data da última Alteração: Data da última alteração do registro.


Foram criadas as seguintes funcionalidades no Monitor, são elas:

  1. Exportação de Lançamentos Financeiros da Folha
  2. Exclusão de Lançamentos Financeiros da Folha
  3. Exportação de Lotes contábeis
  4. Cancelamento da Integração dos Lotes contábeis