CONTEÚDO

01. VISÃO GERAL

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.

Para acessar esse menu, é necessário realizar as configurações dos parâmetros utilizados: o parâmetro MV_CONSIG, para ativação da chave do Consignado, e os parâmetros MV_CSAUTID e MV_CSAUTSE preenchidos com os dados de autenticação de cada cliente, conforme documentações: TOTVS Consignado - Parâmetro MV_CONSIG e  TOTVS Consignado - Parâmetros MV_CSAUTID e MV_CSAUTSE.

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 operadora 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 operadora parceira de crédito tenha enviado as parcelas para a plataforma do TOTVS Consignado, para que elas possam ser disponibilizadas ao cliente, via API.

Além disso, é necessário que 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 operadora 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.


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.

Figura 4 - Rotina de Import. Parcelas com o período 202008 parametrizado.




Figura 5 - 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:

Figura 6 - Rotina de Import. Parcelas sem nenhuma parcela selecionada.


Figura 7 - 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:


Figura 8 - Rotina de Import. Parcelas com apenas uma parcela selecionada.


Figura 9 - 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:

Figura 10 - 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:

Figura 11 - Log de confirmação de importação de duas parcelas.


Figura 12 - Log de confirmação de importação das parcelas.


Lançamento importado na RGB do funcionário, conforme rotina Lançamentos por funcionário:

Figura 13 - Lançamentos por funcionário com a parcela importada - Mat.: 091250.


Figura 14 - Lançamentos por funcionário com a parcela importada - Mat.: 091341.

Após a chamada da API, as três parcelas são selecionadas e a importação é confirmada:

Figura 15 - Log de confirmação de importação de três parcelas.


Figura 16 - Log de confirmação de importação das parcelas.


Lançamento importado na RGB do funcionário, conforme rotina Lançamentos por funcionário:

Figura 17 - Lançamentos por funcionário com a parcela importada - Mat.: 091250.


Figura 18 - Lançamentos por funcionário com a parcela importada - Mat.: 091310.


Figura 19 - Lançamentos por funcionário com a parcela importada - Mat.: 091341.

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 091341:


Figura 20 - Lançamentos por funcionário com a parcela importada - Mat.: 091341.


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:


Figura 21 - Consulta de cálculo por funcionário com a parcela importada - Mat.: 091341.


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



 

Figura 22 - Tela da rotina de Import. Parcelas, com o campo para informar o período de consulta da API.



CampoDescrição
PeríodoCampo para especificação do período desejado para consulta das parcelas.

04. TELA - Parcelas disponíveis

Principais Campos e Parâmetros


Figura 23 - Tela com a parcela disponibilizada



CampoDescrição
Op. Créd.Código da operadora 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.
ContratoCódigo do contrato de empréstimo solicitado pelo funcionário.

05. TABELAS UTILIZADAS

06. ASSUNTOS RELACIONADOS


<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>