CONTEÚDO
01. VISÃO GERAL
Informações
Quer saber mais e contratar o TOTVS Consignado? Acesse o nosso site https://www.totvs.com/techfin/consignado, clique em "Ligamos para você" para prosseguir com a contratação do TOTVS Consignado! Ou ainda, contate o Executivo de Serviços e Negócios da sua conta para mais esclarecimentos.
Criação do menu Import. Parcelas para uso pelos clientes TOTVS Consignado.
O menu é utilizado para chamada de API com as parcelas disponíveis para importação, no período solicitado e para a filial logada.
Ao acessar a rotina pelo menu de Import. Parcelas (SIGAGPE > Miscelanea > 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.
Tela da rotina de Import. Parcelas, com o campo para informar o período de consulta da API e as situações do funcionário.
A relação de possíveis situações da folha selecionáveis para Importação de Parcelas estão listadas abaixo:
Possíveis situações da folha para Importação de Parcelas
Após a confirmação na tela de parametrização, será exibida uma lista com as parcelas disponíveis para aquela filial, no período solicitado e respeitando as situações na folha selecionadas. Em cada registro, estarão relacionados os campos que identifiquem a parcela, considerando qual a instituição de crédito, dados do funcionário, dados da parcela e do empréstimo.
É possível selecionar cada parcela individualmente (clicando na caixa de seleção individual) ou todas as parcelas disponíveis (clicando no retângulo cinza, acima do primeiro registro, na área com os nomes dos campos). Ao clicar em confirmar, serão feitas validações das parcelas selecionadas, verificando se estão aptas para a importadas para a tabela RGB.
Exemplo de parcelas disponíveis para importação para a RGB.
02. EXEMPLO DE UTILIZAÇÃO
Para que o cliente possa fazer importação das parcelas, é necessário que:
- A instituição de crédito tenha enviado as parcelas para a plataforma do TOTVS Consignado, para que elas possam ser disponibilizadas ao cliente, via API;
- O período de cálculo selecionado para importação esteja 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.
Tabela S137, configurada para a D MG 01.
Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D MG 01, o período para importação de 202008 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, conforme explicado no item 01. VISÃO GERAL deste documento, o usuário pode clicar no Ok e verificar a disponibilidade de parcelas para importação e posterior desconto na folha do funcionário.
Rotina de Import. Parcelas com o período 202008 parametrizado.
Rotina de Import. Parcelas com o período 202007 parametrizado e nenhuma parcela disponível para importação no período selecionado.
Após a chamada da API, nenhuma parcela é selecionada e a importação é confirmada:
Rotina de Import. Parcelas sem nenhuma parcela selecionada.
Log de confirmação de importação sem nenhuma seleção de parcela.
Após a chamada da API, apenas uma parcela é selecionada e a importação é confirmada:
Rotina de Import. Parcelas com apenas uma parcela selecionada.
Log de confirmação de importação de apenas uma 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.
Após a chamada da API, duas das três parcelas são selecionadas e a importação é confirmada:
Log de confirmação de importação de duas parcelas.
Log de confirmação de importação das parcelas.
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.: 091250.
Lançamentos por funcionário com a parcela importada - Mat.: 091230.
Após a chamada da API, todas as cinco parcelas são selecionadas e a importação é confirmada:
Log de confirmação de importação de três parcelas.
Log de confirmação de importação das parcelas.
Lançamento importado 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.: 091250.
Lançamentos por funcionário com a parcela importada - Funcionário em situação normal - Mat.: 091230.
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 a opção "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.
Obs.: Caso uma mesma parcela seja importada mais de uma vez, ela será sobrescrita na RGB.
03. TELA - Parametrização para consulta à API
Principais Campos e Parâmetros
Tela da rotina de Import. Parcelas, com o campo para informar o período de consulta da API.
| Campo | Descrição |
|---|---|
| Período | Campo para especificação do período desejado para consulta das parcelas. |
| Situações | Campo para seleção de possíveis situações na folha do funcionário, podendo ser Situação Normal, Afastado Temp., Demitido, Férias ou Transferido. |
04. TELA - Parcelas disponíveis
Principais Campos e Parâmetros
Tela com a parcela disponibilizada
| Campo | Descrição |
|---|---|
| Op. Créd. | Código da instituição de crédito. |
| CPF Func. | CPF do funcionário que terá a parcela do consignado importada na RGB. |
| Mat. Func. | Matrícula do funcionário que terá a parcela do consignado importada na RGB. |
| Num. Parc. | Número da parcela importada para desconto do consignado para o funcionário. |
| Vl. Parc. | Valor da parcela importada para desconto do consignado para o funcionário. |
| Parc.Falt. | Quantidade de parcelas restantes para finalização do empréstimo do funcionário. |
| Total Emp. | Valor total do empréstimo solicitado pelo funcionário. |
| Contrato | Código do contrato de empréstimo solicitado pelo funcionário. |
Para ter essas novas funcionalidades na base do Protheus, é importante realizar a atualização do dicionário de dados, via UPDDISTR, e estar com o pacote de expedição contínua aplicado na base, conforme última versão disponibilizada na Central de Downloads.
05. TABELAS UTILIZADAS
- RCC - Parâmetros
- RCF - Períodos;
- RCH - Período de Calculo;
- RGB - Incidências
- SX6 - Parâmetros do Sistema
- SRA - Funcionários
- SRV - Verbas
06. ASSUNTOS RELACIONADOS
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas