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.

...

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


  • 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 customização, todos os dados deverão ser parametrizados corretamente.

Expandir
titleParametrosParâ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 | 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).
  • 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
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



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 LuisaLuí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.




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.

...

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

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. 




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. 



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 parametro 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 parametroparâmetro, caso a quantidade de partidas ultrapasse o valor informado no parametro parâmetro um novo envio será realizado até que não existam partidas pendentes de envio para o lote.

...