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 > Import. Parcelas), o sistema exibirá ao usuário a tela com a parametrização para consulta à API. Será necessário informar apenas o período no qual se deseja realizar a importação (no formato AAAAMM), pois será considerada a filial que o usuário está logado para disponibilização das parcelas que serão importadas.

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


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


Figura 2 - 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.


Figura 3 - Tabela S137, configurada para a D MG 01.


Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D MG 01 e o período para importação de 202007. Os parâmetros para consulta das parcelas em aberto disponíveis na API, aptas para importação na RGB, são o CNPJ da filial (identificado de acordo com a filial logada) e o período informado, no formato AAAAMM. 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 202007 parametrizado.




Após a chamada da API, nenhuma parcela é selecionada e a importação é confirmada:

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


Figura X - 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 X - Rotina de Import. Parcelas com apenas uma parcela selecionada.


Figura X - 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 X - 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 X - Log de confirmação de importação de duas parcelas.


Figura X - 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 X - Lançamentos por funcionário com a parcela importada - Mat.: 091250.


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








03. TELA - Parametrização para consulta à API

Principais Campos e Parâmetros



 

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