CONTEÚDO
01. VISÃO GERAL
Para a importação das parcelas no módulo do ERP TOTVS de folha de pagamento, utilizamos um recurso implementado pelo TOTVS Consignado, que permite a conferência do movimento a ser integrado, dando autonomia para o usuário responsável da folha de pagamento, analisar os dados a serem importados para a folha mensal da competência vigente.
Também utilizaremos neste processo de integração, o cadastro de grupo de eventos, que a partir do movimento importado como temporário, possibilita realizar o lançamento deste movimento em folha de pagamento no ERP TOTVS para a linha RM, conforme processo de rotina padrão de lançamentos mensais.
Os valores usados para o preenchimento dos campos são específicos para cada cliente e serão disponibilizados para que sejam realizadas as validações. Os dados usados na validação dos campos das imagens são apenas exemplos, para demonstração do funcionamento do assistente.
02. PRÉ-CONDIÇÕES PARA CONEXÃO
Parametrização do TOTVS Consignado no ERP
03. CARGA DE DADOS INTEGRADA
O processo de integração dos dados do TOTVS Consignado com o ERP é simples e precisa como interação do usuário, apenas a confirmação da realização de execução do processo interno neste momento. Lembrando que todos os cadastrados e parametrizações precisam ter sido previamente realizados coforme as informações no item 02. PRÉ-CONDIÇÕES.
O processo irá considerar os dados enviados pela instituição financeira de crédito conveniada e apurados pelo TOTVS Consignado para a competência vigente em questão.
As telas são auto explicativas para conclusão deste processo.
Utilize a rotina Import. Parcelas para integração das parcelas no movimento mensal em aberto . Para fazer essa importação, confirme estar na filial onde se deseja realizar a importação e informe o período de consulta. Será retornada todas as parcelas abertas disponíveis para importação no período em questão. As parcelas selecionadas e importadas, ficam gravadas na rotina Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário) - RGB, com o código da verba configurada na tabela S137 - Verbas - Empréstimo Consignado (Manutenção de Tabelas (SIGAGPE > Atualizações > Definições Cálculos > Manutenção tabelas)).
A(s) parcela(s) importada(s) na RGB, serão conciliadas e informadas esta averbação ao parceiro após cálculo e fechamento da folha.
Para que que a integração ocorra sem falhas no movimento mensal, é importante observar os seguintes itens:
- A instituição de crédito parceira ter enviado as parcelas para a plataforma do TOTVS Consignado dentro do período analisado;
- O período de cálculo selecionado para importação tem que se encontrar aberto e ativo;
- A configuração da tabela S137, na Manutenção de Tabelas, esteja correta, ou seja, é necessário que haja a configuração das verbas e da instituição de crédito, que deve ser a mesma do contrato da parcela. Para maiores informações, consultar o documento TOTVS Consignado - Manutenção de tabelas - Verbas do Consignado;
- A verba cadastrada na S137 esteja cadastrada na filial onde se realizará a importação das parcelas;
- A verba cadastrada na S137 esteja com o campo Qtde.Lancto (RV_QTDLANC) com o preenchimento respeitando a quantidade de lançamentos que serão feitos por funcionário. Recomenda-se que o campo Qtde.Lancto (RV_QTDLANC) esteja com o preenchimento igual ao valor máximo permitido pelo sistema (9);
- A verba cadastrada na S137 esteja com o campo Lcto Diario (RV_LCTODIA) esteja com o preenchimento igual à "N - Nao".
Ao acessar a rotina pelo menu de Import. Parcelas (SIGAGPE > Miscelânea > Consignação > Import. Parcelas), o sistema exibirá ao usuário a tela com a parametrização para consulta à API. Será necessário informar o período (no formato AAAAMM) e quais as situações do funcionário (RA_SITFOLH) no qual se deseja realizar a importação. O CNPJ será considerado conforme a filial que o usuário está logado para disponibilização das parcelas, com status "Aberta", que serão importadas.
Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D PR 01, o período para importação de 202201 e todas as situações da folha selecionadas, que são os parâmetros para consulta das parcelas em aberto disponíveis na API, aptas para importação na RGB (Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário). Com esses dados e com os parâmetros configurados, o usuário pode clicar no Ok e verificar a disponibilidade de parcelas para importação e posterior desconto na folha do funcionário.
Foi criado um parâmetro (MV_IMPMFIL) que se habilitado (possuir valor igual a .T.), possibilita a ativação da rotina de Importação para Múltiplas filiais, uma vez que o parâmetro é ativado, será possível escolher as Filiais que deseja buscar as parcelas e realizar a importação. Importante ressaltar que por padrão o parâmetro estará desabilitado. Dessa forma a importação atual seguirá apenas para os funcionários da filial logada.
No caso abaixo o valor da MV_IMPMFIL está setado como .F.
Figura 1 - Rotina de Import. Parcelas com o período 202201 parametrizado.
Figura 2 - Exemplo: Rotina de Import. Parcelas com as retornadas as parcelas disponíveis (ordenados por contrato) para importação no período de 202201.
Para o caso do parâmetro MV_IMPMFIL setado como .T. irá aparecer a tela de seleção de Filial antes da tela de seleção de parcelas e logo após selecionar o período:
Figura 3 - Exemplo: Rotina de Import. Parcelas com as Filiais.
É possível selecionar todas as parcelas/filiais ou apenas uma ou mais, conforme necessidade do analista. Existem diferentes tratamentos para diferentes situações que podem ocorrer durante a utilização dessa rotina:
No caso de não haver nenhuma parcela disponível para o período selecionado, é exibido o log a seguir:
Rotina de Import. Parcelas com o período 202202 parametrizado e nenhuma parcela disponível para importação no período selecionado.
Caso nenhuma parcela seja selecionada e a importação é confirmada:
Log de confirmação de importação sem nenhuma seleção de parcela.
No caso de não existir verba associada a uma Instituição de Crédito, é exibido o log a seguir:
Log mostrando que não foi encontrado vínculo de verba com Instituição de Crédito.
No caso de não encontrar um roteiro FOL para o período atual, é exibido o log a seguir:
Log mostrando que não foi encontrado roteiro FOL para o período atual.
No caso de não encontrar um período ativo/aberto com o valor informado no filtro, é exibido o log a seguir:
Log mostrando que não foi possível encontrar um período ativo/aberto.
Após a chamada da API, apenas 1 das parcelas é selecionada e a importação é confirmada:
Rotina de Import. Parcelas com a parcela selecionada.
Log de confirmação de importação da parcela.
Lançamento importado na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Lançamentos por funcionário com a parcela importada - Mat.: 000014.
Após a chamada da API, 2 parcelas são selecionadas e a importação é confirmada:
Rotina de Import. Parcelas com as parcelas selecionadas.
Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário.
Lançamentos por funcionário com a parcela importada - Mat.: 000014. 
Lançamentos por funcionário com a parcela importada - Mat.: 00039.
Após a chamada da API, todas as parcelas são selecionadas e a importação é confirmada:
Rotina de Import. Parcelas com as parcelas selecionadas.
Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Lançamentos por funcionário com a parcela importada - Funcionário afastado - Mat.: 000014.
Lançamentos por funcionário com a parcela importada - Funcionário em situação normal - Mat.: 00039.
Lançamentos por funcionário com a parcela importada - Funcionário demitido - Mat.: 091500.
Lançamentos por funcionário com a parcela importada - Funcionário transferido - Mat.: 091591.
Lançamentos por funcionário com a parcela importada - Funcionário em férias - Mat.: 091592.
Com o parâmetro "Situações" é possível escolher qual será a situação na folha importada, podendo-se selecionar uma opção ou todas as opções disponíveis.
No exemplo abaixo, será selecionada apenas o filtro de Situação Normal.
Parametrização de importação de parcelas considerando o período 202008 e situação normal.
Ao confirmar os parâmetros, é exibida apenas uma parcela disponível para importação com as características solicitadas:
Parcela disponível para importação, considerando o período 202008 e situação normal.
Para exemplificar o cálculo da folha de um funcionário que teve a importação da parcela do consignado, será utilizada a matrícula 091230:
Lançamentos por funcionário com a parcela importada - Mat.: 091230.
Após o cálculo da folha, a parcela importada na RGB é levada para a SRC, conforme rotina Consulta de Cálculo por Funcionário:
Consulta de cálculo por funcionário com a parcela importada - Mat.: 091230.
Para exemplificar o Fechamento do Período da folha de um funcionário que teve a importação da parcela do consignado, será utilizada a matrícula 091341:
Log de fechamento do período.
Após o fechamento, o recibo de pagamento do funcionário pode ser consultado:
Recibo de Pagamento - Mat.: 091341.
Após o processo de importação da parcela, cálculo e fechamento da folha, os dados referentes ao pagamento da parcela são enviados à Carol, na tabela SRD, para consumo e tratamento no TOTVS Consignado, para disponibilização de dados atualizados da parcela conciliada à instituição de crédito.
04. TABELAS UTILIZADAS
As seguintes tabelas do Protheus são utilizadas nesse projeto:
- RCB - Configuração de Parâmetros
- RCC - Parâmetros
- RGB - Incidências
- SX6 - Parâmetros do Sistema
- SR8 - Controle de Ausências
- SRA - Funcionários
- SRC - Movimento do Período
- SRD - Históricos de Movimentos
- SRG - Rescisões
- SRK - Movimento de Valores futuros
- SRR - Itens de Férias e Rescisões
- SRV - Verbas
05. LINKS ÚTEIS
06. ASSUNTOS RELACIONADOS
Visão Geral
Import HTML Content
Conteúdo das Ferramentas