Páginas filhas
  • Manual Operacional - Integração Folha x Sapiens

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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

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

...


Expandir
titleParametrosImportante! Configurações iniciais
  • Configuração Integração com outros BackOffice: Para que as tabelas intermediárias entre o Folha e os outros BackOffice sejam utilizadas, é necessário parametrizar o RM para utilização de outros BackOffice. Para isso, acessar o menu TOTVS Folha de Pagamento | Ambiente | Parâmetros | Folha de Pagamento. Selecionar a opção: Integrações → Outros BackOffice. Ao avançar, marcar o parâmetro: "Usa Integração outros BackOffice".

Image Added


  • Cadastros básicos necessários: Para a integração com SAPIENS, alguns cadastros do RM são necessários. 
    • Cliente Fornecedor
    • Centro de Custo
    • Natureza Orçamentária/Financeira


  • Parametrização de máscaras: Para alguns cadastros citados, é necessário parametrizar as máscaras dos códigos antes da realização dos cadastros. São eles: Natureza Orçamentária/Financeira, Cliente/Fornecedor, Centro de Custo. Para definição das máscaras, acessar o menu....


Parametrização de rateios



Informações
titleImportante

Para o correto funcionamento da

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

Image Removed

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

Image Removed

Dados da Conexão

Image Removed

  • Endereço (Exclusã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 exclusão de lançamentos contábeis. 
  • 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 (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 (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. 
  • 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

Image Removed

  • 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).
Informações
titleImportante

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

Filial
Expandir
titleDe|Para
Expandir
title
Parâmetros

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

Image Removed

Parâmetros

Image Added

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 |

Disponível em: Serviços Globais | Perfil |

Folha de Pagamento | Customização | Integração Folha x Sapiens | Parâmetros

Image Added

Dados da Conexão

Image Added

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

Image Added

  • 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).
  • Código da Origem para Exportação de Lote Contábil: neste parâmetro o usuário deverá informar o código da origem dos lotes/lançamentos contábeis do SAPIENS.
  • Código da Empresa, armazenado no SGE por Coligada. Neste parâmetro, o usuário poderá definir qual código de empresa precisa ser enviado na integração de lançamentos financeiros e contábeis, para cada Coligada do SGE.  
  • Qtde. partidas enviadas por pacote contábil,  para informar o número máximo de lançamentos contábeis que podem ser enviados para o SAPIENS na mesma requisição. Esse parâmetro foi necessário pois o Sapiens possui limitação da quantidade de partidas contábeis que podem ser processadas por requisição. Quando a quantidade de lançamentos é maior que o parâmetro, o envio do lote é particionado. 


Informações
titleImportante

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

Expandir
titleDe|Para
- Anexos De|Para | Filial - Integração Folha SAPIENS

Image Removed

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.

Image Removed

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

Image Removed

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.  

Image Removed

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. 

Expandir
titleFilial

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

Aviso
titleAtenção

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.

Expandir
titleCliente/Fornecedor

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

Image Removed

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

Image Removed

Filial

Image Added


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

Image Added


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Cliente/Fornecedor 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 | Cliente/FornecedorFilial.

Image RemovedImage Added


No cadastro nativo de Filial TOTVS BackOffice | Gestão Financeira Fiscal | Cliente/FornecedorFiliais | Anexos | DE|PARA - Cliente/FornecedorFilial - Integração SAPIENS


Image AddedImage Removed


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.  


Image RemovedImage Added


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

Código Filial RM: campo do tipo Lookup para informar o código do Cliente/Fornecedor da Filial no RM que precisará de DE|PARA com o código SENIOR.
Código ExternoFilial SENIOR: campo do tipo texto livre, para informar o código do Cliente/Fornecedor do SAPIENS que corresponde ao Cliente/Fornecedor 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. 


Aviso
titleAtenção

Este cadastro de De|Para é 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

sendo necessário realizar os cadastros em todas as coligadas em que a Exportação de Lançamentos Financeiros serão utilizadas.

Expandir
titleNatureza FinanceiraCliente/Fornecedor

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 FinanceiraCliente/Fornecedor


Image AddedImage Removed


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


Image RemovedImage Added

Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Natureza Orçamentária Financeira 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 | Natureza FinanceiraCliente/Fornecedor.

Image RemovedImage Added


No cadastro nativo de Filial TOTVS BackOffice | Gestão Financeira | Cadastros Cliente/Fornecedor| Movimentos | Natureza Orçamentária Financeira | Anexos | Natureza Financeira - Integração Folha SAPIENSAnexos | DE|PARA - Cliente/Fornecedor


Image AddedImage Removed


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. 


Image RemovedImage Added

Image Removed


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 do Cliente/Fornecedor no RM.
Código Externo: campo do tipo texto livre, para informar o código da Natureza Financeira do Cliente/Fornecedor do SAPIENS que corresponde ao Cliente/Fornecedor do cadastro do RM. 

title
Aviso
AtençãoEste 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 utilizadaspodendo 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.
Expandir
titleCentro de CustoNatureza Financeira

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 CustoNatureza Financeira


Image AddedImage Removed


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


Image RemovedImage Added


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Centro de Custo 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 | Centro de CustoNatureza Financeira.


Image RemovedImage Added


No cadastro nativo de Filial RH| Folha de Paramentos | Administração de Pessoal | Cadastros | Centros de Custo | Anexos | DE|PARA - Centro de Custo TOTVS BackOffice | Gestão Financeira | Cadastros | Movimentos | Natureza Orçamentária Financeira | Anexos | Natureza Financeira - Integração Folha SAPIENS


Image AddedImage Removed


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. 


Image RemovedImage Added


Image RemovedImage Added


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 Natureza Financeira no RM.
Código Externo: campo do tipo texto livre, para informar o código do Centro de Custo do da Natureza Financeira do SAPIENS que corresponde ao cadastro do RM. 

Aviso
titleAtenção

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.

Expandir
titleConta ContábilCentro de Custo

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ábilCentro de Custo

Image AddedImage Removed

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

Image RemovedImage Added


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Conta Contábil (Plano de Contas) 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 | Conta ContábilCentro de Custo.


Image AddedImage Removed


No cadastro nativo de Filial TOTVS BackOffice | Gestão Contábil RH| Folha de Paramentos | Administração de Pessoal | Cadastros | Plano Centros de Contas Custo | Contábil | Anexos | DE|PARA - Conta ContábilCentro de Custo


Image AddedImage Removed


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. 


Image RemovedImage Added


Image RemovedImage Added


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 do Centro de Custo no RM.
Código Externo: campo do tipo texto livre, para informar o código da Conta Contábil do Centro de Custo do SAPIENS que corresponde ao cadastro do RM. 

Aviso
titleAtenção

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.

Expandir
titleHistórico PadrãoConta Contábil

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ãoConta Contábil

Image RemovedImage Added

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

Image RemovedImage Added


Detalhamento do processo

Foi criada uma interface de DE|PARA para o usuário definir para cada Histórico Padrão 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 | Histórico Padrão.Conta Contábil


Image AddedImage Removed

No cadastro nativo de Filial TOTVS Folha de Pagamento| Encargos BackOffice | Gestão Contábil | Cadastros | Históricos PadrõesPlano de Contas | Contábil | Anexos | Histórico Padrão - Integração Folha SAPIENSDE|PARA - Conta Contábil


Image AddedImage Removed


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. 


Image RemovedImage Added


Image RemovedImage Added


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 da Conta Contábil no RM.
Código Externo: campo do tipo texto livre, para informar o código da Conta Contábil do Histórico Padrão do SAPIENS que corresponde ao cadastro do RM. 

Aviso
titleAtenção

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.

Expandir
title
Exportação de Lançamentos Financeiros
Histórico Padrão

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

Image Removed

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

| DE|Para | Histórico Padrão

Image Added


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

Image Added


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:

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

|Encargos | Lançamentos Financeiros| Exportação lançamentos financeiros para SAPIENS. 

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

Image Removed

Image Removed

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%

Aviso
titleGeração dos Lançamentos no RM

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.

Image Removed

Image Removed

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

Informações
titleImportante

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.

Aviso
titleAlerta

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.

| Customização | Integração Folha x Sapiens | DE|PARA | Histórico Padrão.

Image Added


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


Image Added


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. 


Image Added


Image Added


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. 


Aviso
titleAtenção

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.

Expandir
titleExportação de Lançamentos Financeiros

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


Image Added


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.


Image Added


Image Added



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 Luísa

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%

Aviso
titleGeração dos Lançamentos no RM

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.


Image Added


Image Added


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

Expandir
titleExclusão de Lançamentos Financeiros

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

Image Removed

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.

Image Removed

Image Removed

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. O usuário poderá selecionar um ou vários lançamentos na interface para serem integrados (tabela PFINANCEIRO).

Será de responsabilidade do usuário identificar na interface e enviar, através deste processo, todos os lançamentos financeiros referentes à folha de pagamento, inseridos ou alterados no RM. Nesta interface será possível visualizar o status de integração atualizado por registro: Pendente, Sucesso ou Erro.

Exemplo do envio do rateio por filial:

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%

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.

Após a exportação dos dados, as informações enviadas para o SAPIENS ficarão armazenadas no Monitor de log (menu customização e anexo dos lançamentos financeiros).

Monitor de Log e RH | Folha de Pagamento | Encargos | Financeiro | Lançamentos (Folha de Pagamento) | Anexos | Log - Integração Financeira SAPIENS


Informações
titleImportante

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.

Aviso
titleAlerta

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.
Expandir
titleExclusão de Lançamentos Financeiros

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

Image Added


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


Image Added


Image Added


Existem os casos de exclusão em que o lançamento nem foi exportado para o SAPIENS: o usuário identifica um erro antes de exportá-lo e o lançamento precisa ser excluído. Neste caso o processo irá verificar primeiro se o lançamento já foi exportado. Caso negativo, ele será excluído do RM, seguindo as regras nativas de exclusão (sem necessidade de consultar o SAPIENS). 

Caso já tenha sido exportado,  o processo permanece sem alterações: ele precisará ser excluído primeiro do SAPIENS antes de ser excluído do RM. 

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


Aviso
titleAlerta

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

Expandir
titleStatus de Integração 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.

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.


Image Added

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:

  • Sucesso: Lote, lançamentos e processamento (contabilização) integrados com sucesso no Sapiens.
  • Erro no Lote: Erro ao integrar o lote contábil.
  • Erro no Lançamento: Lote integrado com sucesso, mas ocorreu um erro ao integrar os lançamentos do lote.
  • Erro no Processamento: Lote e lançamentos integrados com sucesso, mas ocorreu um erro ao realizar o processamento do lote (contabilização no Sapiens).
  • Pendente: Integração com o Sapiens pendente.
  • Integrado - Erro na Exclusão: Lote integrado com sucesso, mas ocorreu um erro no processo de exclusão do lote.
  • Sucesso Parcial:
    • O lote foi integrado com sucesso, mas as outras etapas não foram processadas.
    • O lote e os lançamentos foram integrados com sucesso, mas a etapa de contabilização não foi concluída.


Image Added

Expandir
titleExportação de Lotes contábeis 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 | Exportar lotes contábeis para o SAPIENS

Image Added

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

Os lotes contábeis serão gerados no RM através das funções nativas do produto. Ao finalizar a geração dos lotes, conferência dos lançamentos (partidas) e rateios, o usuário deverá executar o processo de exportação para o SAPIENS. A customização não fará cálculos no envio das informações, ela será responsável por enviar ao SAPIENS, os dados gerados através das funções nativas.


Aviso
titleLote Por Filial

Como o SAPIENS não aceita que um lote contábil tenha lançamentos de mais de uma filial, no RM o lote deve ser gerado de forma que os lançamentos contábeis (partida) fiquem separados em lotes por filial.


Para isso foi criado um processo customizado Exportação de Lotes Contábeis, disponível em: TOTVS Educacional | RH | Folha de Pagamento | Encargos | Lançamentos Contábeis| Exportar lotes contábeis para o SAPIENS.

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

O usuário poderá selecionar um ou vários registros de lotes (gerados pela folha) para integração. 


Image Added


Image Added


Ao executar o processo, a customização enviará os lotes contábeis selecionados e seus respectivos lançamentos para o SAPIENS. Para cada lote do RM, será necessário enviar seus dados principais e seus lançamentos, além de enviar o processamento do lote.

Número do Lote:

O número do lote no SAPIENS é gerado automaticamente na inclusão e devolvido para o RM no momento da requisição da API. Ele será armazenado no RM, na interface nativa de Lotes Contábeis pelo campo Id. Lote Sapiens.

Correção de lançamentos e reenvio:

Caso seja necessário alterar algum lote ou lançamento do lote, ela será permitida conforme recursos nativos, caso o lote ainda não tenha sido exportado para o SAPIENS. Caso contrário, será necessário excluir o lote do SAPIENS pelo processo customizado, para então proceder com o ajuste ou nova geração de lote. 


Image Added


Todas as alterações permitidas na interface nativa lançamentos contábeis da Folha: inclusão de partidas, rateio, nome do lote, por exemplo, serão bloqueadas caso o lote já tenha sido integrado ao SAPIENS. 


Aviso
titleImportante

Não será tratado envio de lotes contábeis e lançamentos que não forem originados da Folha de Pagamento. 

Caso a conta contábil esteja com o valor "Contas de Resultado" no campo "Natureza da Conta para emissão do SPED" a mesma será enviada com rateio para o SAPIENS, portanto a conta contábil do SAPIENS correspondente deve estar parametrizada para receber lançamentos com rateio.

A partir da versão 12.1.2302.007 da customização o envio dos lançamentos dos lotes para o Sapiens vão respeitar o parâmetro "Qtde. partidas enviadas por pacote contábil", isso significa que cada envio para o Sapiens vai ter a quantidade de partidas contábeis limitadas pelo valor informado no parâmetro, caso a quantidade de partidas ultrapasse o valor informado no parâmetro um novo envio será realizado até que não existam partidas pendentes de envio para o lote.

Expandir
titleExclusão de Lotes contábeis 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


Image Added


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.


Image Added


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


Image Added


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


Aviso
titleExclusão do Lote

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.

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

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.

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 menu definido no Req.05. Caso ele já tenha sido exportado para o SAPIENS, será excluído do SAPIENS e também do RM.
  • Caso seja necessário enviar um lançamento que já tenha sido exportado, será necessário excluí-lo do SAPIENS, através do processo detalhado no Req.05, e executar o processo de exportação novamente. 

    Expandir
    titleBloqueio na Geração de Lançamento Contábil

    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.


    Image Added

    Informações
    titleImportante
    Aviso
    titleAlerta
    Expandir
    titleMonitor de Log

    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

    ...