Ver código fonte para 1132 Cadastro Evento Consignado

[[Modulo_Folha_Pagamento]]

O controle de empréstimos e vales permite cadastrar valores descontados do colaborador em parcelas mensais, gerar os lançamentos e consultar onde eles foram utilizados na folha de pagamento.

O cadastro pode ser feito manualmente ou pela importação de uma planilha. Na importação, o sistema cadastra os empréstimos e gera suas parcelas automaticamente.

__TOC__

== Acesso ao recurso ==

Acesse a área de '''RH > Gestão de Departamento Pessoal > Controle de Empréstimos e Vales'''. Conforme a apresentação do menu, a tela também pode aparecer como '''Cadastro Evento Consignado'''.

== Importação de empréstimos por planilha ==

=== Antes de importar ===

Confira os seguintes itens:

* Os colaboradores estão cadastrados e '''ativos'''.
* A matrícula da planilha corresponde ao '''número de registro''' do colaborador no sistema.
* A empresa está cadastrada com o CNPJ informado na planilha.
* Existe uma '''configuração de importação de dados da folha''' adequada ao arquivo, com origem '''Empréstimo Consignado'''.
* Os cabeçalhos da planilha correspondem ao layout padrão ou aos nomes alternativos definidos na configuração.
* O evento que será usado no desconto está preenchido no cadastro de RH da empresa.

'''Evento de desconto:''' nesta importação, o sistema utiliza o evento do campo '''Ajuda Compensatória''' da configuração de RH da empresa identificada pelo CNPJ da linha. Solicite ao responsável pelo RH a conferência desse campo antes de importar. O evento não é escolhido em uma coluna da planilha.

A configuração é procurada primeiro pelo nome do arquivo. Se não houver correspondência, o sistema utiliza a primeira configuração encontrada para a origem '''Empréstimo Consignado'''. Por isso, confirme o nome e o layout do arquivo com o responsável pela configuração, principalmente quando houver mais de um modelo cadastrado.

Consulte também [[Configuração de importação de dados da folha]].

=== Organização do arquivo ===

Prefira uma planilha '''Excel (.xlsx)'''. A leitura também reconhece arquivos '''.xls''' e '''.csv'''. Para CSV, utilize o padrão de separação e de números homologado pela empresa.

* Coloque os dados na '''primeira aba''' do arquivo Excel.
* Utilize a primeira linha como cabeçalho, sem títulos ou observações acima dela.
* Informe '''um empréstimo por linha'''. Não informe uma linha para cada parcela: o sistema gera as parcelas a partir da quantidade e do valor informados.
* Evite linhas vazias no meio dos dados, células mescladas e linhas de totais.
* Preencha os valores monetários como números, sem digitar o símbolo de moeda dentro da célula.
* Mantenha matrícula, contrato e CNPJ como texto para preservar zeros à esquerda e evitar notação científica.
* Para as competências, utilize texto no formato '''MM/AAAA''', por exemplo <code>10/2026</code>.
* Para a data de início do contrato, prefira uma célula de data do Excel, apresentada como '''DD/MM/AAAA'''.

=== Colunas da planilha ===

A tabela apresenta os cabeçalhos padrão. Copie os nomes exatamente como estão, incluindo os pontos. Caso a empresa use cabeçalhos diferentes, os nomes alternativos precisam estar previstos na configuração de importação.

{| class="wikitable"
! Cabeçalho padrão !! Informação !! Exemplo e orientação
|-
| <code>matricula</code> || Número de registro do colaborador || <code>000123</code>. Deve identificar um colaborador ativo.
|-
| <code>numeroInscricaoEstabelecimento</code> || CNPJ da empresa do empréstimo || <code>12345678000190</code>. Use o CNPJ cadastrado no sistema e confira a empresa encontrada.
|-
| <code>ifConcessora.codigo</code> || Código do banco || <code>1</code>. Informe o código numérico da instituição.
|-
| <code>ifConcessora.descricao</code> || Nome da instituição consignatária || <code>Banco Exemplo</code>.
|-
| <code>contrato</code> || Número do contrato do empréstimo || <code>179491292</code>. Prefira o formato texto.
|-
| <code>competenciaInicioDesconto</code> || Primeiro mês de desconto || <code>10/2026</code>. Necessário para gerar os lançamentos.
|-
| <code>competenciaFimDesconto</code> || Último mês de desconto || <code>12/2026</code>. Mantenha coerência com o início e a quantidade de parcelas.
|-
| <code>totalParcelas</code> || Quantidade de parcelas || <code>3</code>. Informe um número inteiro maior que zero.
|-
| <code>valorParcela</code> || Valor de cada parcela || <code>100,00</code>. Informe um valor numérico maior que zero.
|-
| <code>valorEmprestimo</code> || Valor do empréstimo || <code>300,00</code>. Confira conforme os dados do contrato e a regra adotada pela empresa.
|-
| <code>valorLiberado</code> || Valor liberado ao colaborador || <code>280,00</code>. Pode ser diferente do valor do empréstimo.
|-
| <code>dataInicioContrato</code> || Data de início do contrato || <code>23/09/2026</code>.
|}

'''Preencha explicitamente a quantidade de parcelas.''' Se a coluna não for encontrada, o sistema assume uma parcela. Se as colunas de valor não forem encontradas, os respectivos valores são inicialmente considerados zero; o valor da parcela precisa ser maior que zero para o cadastro ser aceito. Não utilize esses valores padrão como substitutos da conferência do layout.

Não há coluna de saldo a preencher. O saldo é calculado na tela a partir do valor do empréstimo e dos valores vinculados à folha.

=== Exemplo de preenchimento ===

Exemplo fictício de uma linha de empréstimo:

{| class="wikitable"
! Campo !! Conteúdo
|-
| Matrícula || 000123
|-
| CNPJ do estabelecimento || 12345678000190
|-
| Código do banco || 1
|-
| Instituição || Banco Exemplo
|-
| Contrato || 179491292
|-
| Início do desconto || 10/2026
|-
| Final do desconto || 12/2026
|-
| Total de parcelas || 3
|-
| Valor da parcela || 100,00
|-
| Valor do empréstimo || 300,00
|-
| Valor liberado || 280,00
|-
| Início do contrato || 23/09/2026
|}

Com esses dados, serão gerados três lançamentos de R$ 100,00: outubro, novembro e dezembro de 2026. Cada lançamento corresponde ao período do respectivo mês.

'''O exemplo só será importado se a matrícula e o CNPJ forem substituídos por dados válidos da sua empresa.''' Use os cabeçalhos padrão da tabela anterior na linha inicial da planilha.

=== Como executar a importação ===

# Abra a tela de controle de empréstimos e vales.
# No menu de ações, selecione '''Importar Planilha Emprestimos Consignados'''.
# Selecione e envie o arquivo preparado.
# Acompanhe a tarefa '''Importar Arquivo Emprestimos''' até sua conclusão.
# Leia o resultado completo: a tarefa pode apresentar cadastros concluídos e erros no mesmo processamento.
# Atualize a consulta de empréstimos e localize os registros importados.
# Confira colaborador, empresa, contrato, evento, valores e competências das parcelas.

'''Não é necessário clicar em Criar Lançamentos para os empréstimos importados.''' A importação já gera os lançamentos e salva os cadastros aprovados.

=== Resultado e reimportação ===

O processamento trata cada linha individualmente. Uma linha com erro pode ser recusada enquanto outras são salvas. Portanto, '''a existência de erros não significa que nenhum empréstimo foi importado'''.

Para corrigir:

# Identifique as linhas recusadas no resultado da tarefa.
# Confira quais empréstimos já foram cadastrados.
# Corrija os dados da planilha ou os cadastros necessários.
# Prepare preferencialmente um arquivo contendo apenas as linhas pendentes.
# Importe novamente e confira o novo resultado.

A importação '''não atualiza um empréstimo já existente'''. Quando encontra um registro considerado duplicado, informa o problema e ignora aquela linha.

A identificação de duplicidade considera '''matrícula, data inicial do desconto, quantidade de parcelas e valor da parcela'''. O banco e o número do contrato não são os únicos critérios de identificação. Alterar esses dados de desconto para tentar reimportar pode criar outro cadastro, em vez de corrigir o anterior. Em contratos distintos com os mesmos dados de identificação, procure o responsável pelo processo antes de prosseguir.

=== Problemas frequentes ===

{| class="wikitable"
! Situação !! O que conferir
|-
| Colaborador não encontrado || Confira a matrícula, os zeros à esquerda, o número de registro e se o colaborador está ativo. Se a mensagem vier acompanhada de detalhes de uma linha, examine também o resultado completo da tarefa.
|-
| Evento de desconto não informado || Confira o CNPJ da linha, o cadastro da empresa e o campo Ajuda Compensatória na configuração de RH dessa empresa.
|-
| Empréstimo já cadastrado || Pesquise o cadastro existente e compare matrícula, início, quantidade e valor das parcelas. A importação não substitui os dados anteriores.
|-
| Valor da parcela ou quantidade inválidos || Confira se são números positivos e se os cabeçalhos foram reconhecidos. Não confunda valor da parcela com valor total do empréstimo.
|-
| Competência ou data inválida || Use MM/AAAA nas competências e confira o conteúdo da data do contrato. Evite conversões automáticas que alterem o conteúdo das células.
|-
| Configuração não encontrada || Solicite a conferência da configuração de importação para a origem Empréstimo Consignado e do nome do arquivo utilizado.
|-
| Apenas parte dos empréstimos aparece na consulta || Leia o resultado por linha. Algumas linhas podem ter sido salvas e outras recusadas. Atualize a consulta após a conclusão da tarefa.
|-
| Quantidade ou valores diferentes dos esperados || Confira os cabeçalhos e a configuração escolhida pelo nome do arquivo. Abra o empréstimo e revise as parcelas antes de utilizá-las na folha.
|}

== Cadastro manual ==

# Inicie um novo cadastro.
# Informe o '''colaborador''' e o '''evento''' que será utilizado no desconto.
# Preencha o '''valor da parcela''', o '''número de parcelas''' e a '''data de início do desconto'''.
# Confira a data final calculada a partir do início e da quantidade de parcelas.
# Preencha os valores do empréstimo e liberado, a pessoa e os dados do contrato, conforme o caso.
# Clique em '''Criar Lançamentos'''.
# Confira os meses e os valores na grade.
# Clique em '''Salvar'''.

O valor da parcela e a quantidade devem ser maiores que zero. Para salvar, o cadastro precisa ter pelo menos um lançamento, além de colaborador, evento e início do desconto preenchidos.

== Valores e parcelas ==

{| class="wikitable"
! Campo !! Significado
|-
| Valor Parcela || Valor utilizado para gerar cada lançamento mensal.
|-
| Número Parcelas || Quantidade de lançamentos mensais a gerar.
|-
| Valor Empréstimo || Valor informado para o empréstimo. Confira-o com o contrato e com o critério adotado pela empresa.
|-
| Valor Liberado || Valor efetivamente liberado ao colaborador, informado no cadastro ou na planilha.
|-
| Valor Saldo || Campo de consulta calculado na tela: valor do empréstimo menos a soma dos valores dos vínculos de folha, 13º, férias e rescisão. Não é digitado pelo usuário.
|}

'''O saldo reflete os lançamentos vinculados aos movimentos do sistema.''' A indicação de uso na folha não é, por si só, uma confirmação de pagamento bancário ao credor.

Pequenas diferenças de arredondamento podem ser ajustadas automaticamente na última parcela. Diferenças maiores entre o valor do empréstimo e a soma das parcelas, como as decorrentes de juros, não são eliminadas automaticamente. Confira os valores gerados.

== Consulta do uso na folha ==

Na grade de lançamentos, a coluna '''Usado na Folha''' indica se o lançamento possui vínculo com algum movimento.

Quando existem vínculos, a tela apresenta a relação dos movimentos, que pode incluir:

* Folha mensal.
* Décimo terceiro salário.
* Férias.
* Rescisão.

Confira o lançamento, o tipo de movimento, os períodos, a data de pagamento quando disponível e o valor vinculado. Uma parcela apenas gerada, sem vínculo com esses movimentos, não reduz o saldo calculado na tela.

== Correção, exclusão e renegociação ==

Depois de salvar, os dados que definem os descontos ficam bloqueados: '''valor da parcela, valor do empréstimo, quantidade de parcelas, início do desconto, colaborador e evento'''. Os lançamentos não podem ser gerados novamente para o mesmo cadastro salvo.

Se for necessário corrigir esses dados e '''nenhum lançamento tiver sido utilizado''', exclua o cadastro e faça um novo lançamento com os dados corretos.

Se algum lançamento já tiver sido usado em folha, 13º, férias ou rescisão, '''a exclusão será bloqueada'''. Para encerrar os descontos desse cadastro, marque '''Renegociado''' e salve. Essa ação inativa seus lançamentos e preserva o histórico; não cria automaticamente outro empréstimo nem um novo parcelamento.

Antes de marcar como renegociado, confira o acordo com o colaborador e os movimentos já processados com o responsável pela folha.

== Conferência final da importação ==

* A tarefa terminou e seu resultado foi lido integralmente.
* Os empréstimos aceitos aparecem na consulta.
* Os colaboradores e as empresas estão corretos.
* O evento de desconto corresponde ao utilizado pela empresa.
* O número do contrato e a instituição foram conferidos.
* A quantidade, os valores e as competências das parcelas estão corretos.
* As linhas recusadas foram separadas para correção, sem presumir que todo o arquivo falhou.
* Os vínculos de folha e o saldo foram conferidos quando aplicável.