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.

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 10/2026.
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.

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

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:

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

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

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.