Área: Area Business Intelligence

SC Consulta eConsignado

O Smart Consulta eConsignado permite buscar as informações do Crédito do Trabalhador na DATAPREV e registrar o resultado no ERP. Você pode consultar os empréstimos de uma competência ou atualizar o saldo e o percentual de garantia de empréstimos já cadastrados. Ao concluir, o Smart disponibiliza uma planilha para conferir o que foi feito e o que precisa de correção.

Objetivo

Apoiar o departamento pessoal na consulta e no acompanhamento de empréstimos consignados, evitando a digitação manual das informações recebidas da DATAPREV.

Consulta mensal: busca os empréstimos da empresa para o mês informado, cadastra os novos empréstimos e gera os respectivos lançamentos de desconto no ERP. Empréstimos já cadastrados para o mesmo período não são duplicados.
Consulta rescisória: consulta um ou mais empréstimos já cadastrados e atualiza somente o saldo devedor e o percentual de garantia. Não calcula as verbas da rescisão nem altera os demais dados do empréstimo.

Onde as informações são utilizadas

Os empréstimos consultados ficam disponíveis em 1148 - Controle Empréstimos e Vales. Na consulta mensal, também são gerados os lançamentos de desconto correspondentes. Na consulta rescisória, os cadastros existentes recebem a atualização de saldo e garantia.

A execução começa pelo próprio Smart. Não é necessário usar um atalho de importação no recurso 1148.

Pré-requisitos

Ter permissão para executar o Smart e acessar os dados da empresa consultada.
Conferir se você está trabalhando na empresa correta. O Smart utiliza a empresa da execução; não é necessário digitar seu CNPJ nos filtros.
Ter um certificado digital A1 válido, com a senha correta e vinculado à empresa em 1396 - Configuração Certificado. O Smart utiliza essa configuração automaticamente; não solicita certificado ou senha a cada consulta.
Quando o certificado for de um procurador, ter uma procuração válida que permita consultar os dados da empresa na DATAPREV. Conseguir acessar o eSocial não garante, por si só, essa autorização.
Ter acesso à internet e ao serviço da DATAPREV.
Para a consulta mensal, ter os colaboradores cadastrados e o evento de desconto do Crédito do Trabalhador configurado com a rubrica eSocial 9253. O mês consultado também precisa estar liberado para consulta pela DATAPREV.
Para a consulta rescisória, ter os empréstimos cadastrados na empresa, com banco e número do contrato preenchidos, e conhecer seus identificadores no ERP.

Fluxo Principal

Consulta mensal

Acesse a área de execução de Smarts do ERP e abra Consulta eConsignado.
Confira a empresa em que a execução será feita.
No campo Tipo de consulta, mantenha ou selecione Consulta mensal.
No campo Ambiente, escolha Produção para consultar os dados reais ou Homologação para testes orientados pelo responsável. Confira os cuidados descritos em Observações Gerais.
Preencha Competência com uma data do mês desejado. Por exemplo, 15/02/2026 consulta fevereiro de 2026. O dia informado não muda o mês da consulta.
Inicie a execução pelo comando padrão do Smart e acompanhe o processamento.
Ao concluir, leia a mensagem de resultado e baixe a planilha disponibilizada.
Confira os empréstimos criados, os itens ignorados e os erros. Se houver rejeições, corrija os motivos indicados antes de executar novamente.

Consulta rescisória

Abra Consulta eConsignado na área de execução de Smarts e confira a empresa.
Selecione Consulta rescisória no campo Tipo de consulta.
Escolha o Ambiente que será utilizado.
No campo Contratos, informe o identificador de cada cadastro de empréstimo no ERP. Para vários cadastros, separe os identificadores por ponto e vírgula: 125;130;148. Para apenas um cadastro, informe somente seu identificador, como 125.
Não preencha competência ou data de rescisão. Esta consulta busca o saldo e a garantia informados pela DATAPREV no momento da execução; não faz um cálculo com base em uma data de desligamento.
Inicie a execução e acompanhe o processamento.
Baixe a planilha e confira, para cada cadastro, os valores anteriores, os novos valores e o resultado da atualização.

Orientação para preenchimento de campos

Nome do campo	Objetivo	Orientação de preenchimento
Tipo de consulta	Define o que o Smart fará.	Obrigatório. Escolha Consulta mensal para buscar os empréstimos de um mês ou Consulta rescisória para atualizar saldo e garantia de cadastros existentes. Ao abrir, a opção inicial é Consulta mensal.
Ambiente	Define onde as informações serão consultadas.	Obrigatório nas duas consultas. Selecione Homologação ou Produção. O campo não vem preenchido automaticamente. A escolha vale para toda a execução; o sistema não troca de ambiente se ocorrer um erro.
Competência	Define o mês da consulta mensal.	Obrigatório somente na Consulta mensal. Informe uma data do mês desejado, no formato de data apresentado pelo ERP. O dia é desconsiderado. Na Consulta rescisória, esse campo não é exibido.
Contratos	Indica quais empréstimos existentes serão consultados.	Obrigatório somente na Consulta rescisória. Informe os identificadores dos cadastros no ERP separados por ;. Exemplo: 125;130;148. Não use o número do contrato bancário, vírgulas, letras ou separadores sem um número entre eles. Se não souber o identificador, confirme-o com o responsável pelo cadastro antes de executar. Na Consulta mensal, esse campo não é exibido.

Funcionalidades

Consulta sem arquivo de entrada

O Smart busca os dados diretamente na DATAPREV. Não é necessário preparar ou enviar um arquivo para iniciar a consulta. A planilha é o resultado da execução, não um arquivo de importação.

Processamento de vários empréstimos

Na consulta rescisória, você pode informar vários cadastros na mesma execução. Se repetir um identificador, ele será considerado apenas uma vez.

Quando um item apresenta um erro durante o processamento, os demais itens válidos podem ser concluídos. O erro não desfaz os empréstimos já criados ou atualizados. Porém, filtros inválidos ou problemas na configuração necessária para executar o Smart podem impedir o início de toda a consulta.

Conferência da planilha

A planilha possui uma aba Resultado. Confira primeiro a empresa, o ambiente, o tipo de consulta e a competência, quando aplicável. Depois, verifique a ação, o status e a mensagem de cada linha.

Informação	Como interpretar
Ação: CRIADO	Um novo cadastro de empréstimo e seus lançamentos foram gravados pela consulta mensal.
Ação: ATUALIZADO	O saldo e a garantia do cadastro foram atualizados pela consulta rescisória.
Ação: NENHUMA	Não houve criação ou atualização nessa linha. Confira o status e a mensagem para entender o motivo.
Status: SUCESSO	O item foi concluído. Confira também qual ação foi realizada.
Status: IGNORADO	O sistema não precisou alterar o item, por exemplo porque o empréstimo já estava cadastrado ou os valores consultados eram iguais aos existentes.
Status: ERRO	O item não foi concluído. Leia a mensagem, corrija o motivo e avalie uma nova execução.
Status: SEM_DADOS	Não foram encontradas informações para a consulta. Isso não significa que um empréstimo foi criado.
Identificador solicitado e Identificador cadastro	Ajudam a relacionar o resultado com o cadastro do ERP. O identificador solicitado aparece na consulta rescisória mesmo quando o cadastro não é encontrado.
Saldo anterior e Saldo novo	Permitem conferir a mudança de saldo na consulta rescisória. Se o item foi rejeitado, o campo Saldo novo fica vazio, pois não houve atualização.
Garantia anterior e Garantia nova	Permitem conferir a mudança no percentual de garantia. Por exemplo, 20 representa 20%. Se o item foi rejeitado, Garantia nova fica vazia.

O resultado geral pode ser Sucesso, Atenção ou Erro. Atenção pode indicar conclusão parcial, itens ignorados ou ausência de dados. Por isso, não considere apenas a mensagem geral: confira as linhas e os totais da planilha.

Se o Smart for bloqueado antes de iniciar a consulta, uma planilha pode não ser disponibilizada. Nesse caso, corrija a orientação exibida na tela.

Problemas e Soluções

Problema	Solução
"Selecione um Ambiente válido: Homologação ou Produção."	Escolha uma das duas opções no campo Ambiente e tente novamente.
A consulta mensal não inicia por falta de competência.	Informe uma data válida do mês que deseja consultar.
O campo Contratos está vazio ou possui um formato inválido.	Informe pelo menos um identificador de cadastro. Use 125;130;148, por exemplo. Corrija entradas como 125,130, 125;;130 ou 125;, pois impedem o início da consulta.
Um cadastro informado não foi encontrado ou não pode ser acessado.	Confira o identificador, a empresa da execução e sua permissão de acesso. Não informe o número do contrato bancário nesse campo.
Certificado ausente, vencido ou com senha incorreta.	Solicite ao responsável a revisão do certificado vinculado à empresa no recurso 1396 - Configuração Certificado. Não compartilhe a senha na planilha ou em mensagens de atendimento.
A consulta é recusada por falta de autorização ou procuração.	Confirme com o responsável se o certificado e a procuração permitem consultar os dados dessa empresa na DATAPREV.
A competência ainda não está liberada para consulta.	Confira o mês informado e aguarde sua liberação pela DATAPREV. Informar um mês anterior não garante que ele já esteja disponível.
Não foram encontrados empréstimos para a empresa e o mês.	Confira empresa, ambiente e competência. Se estiverem corretos, não houve dados disponíveis para importar nessa consulta.
"Nenhum colaborador da empresa corresponde à matrícula e ao CPF informados"	Confira o cadastro do colaborador, sua matrícula eSocial, o CPF e o vínculo com a empresa. Após a correção, execute novamente.
Há divergência nos dados do colaborador, da empresa ou do contrato.	Confira os cadastros envolvidos. Se os dados estiverem corretos no ERP, encaminhe a mensagem e a identificação do item ao suporte para análise.
"Contrato já cadastrado no período"	O sistema identificou um empréstimo existente e não criou outro. Confira o cadastro indicado na planilha; não é necessário repetir a consulta apenas para esse item.
O saldo ou a garantia recebidos não permitem a atualização.	Confira a mensagem da linha e solicite análise ao responsável ou ao suporte. O cadastro rejeitado mantém o saldo e a garantia anteriores.
Não foi possível comunicar com a DATAPREV ou o serviço está indisponível.	Confira a conexão, aguarde o restabelecimento e avalie uma nova execução. Antes disso, veja se outros itens já foram concluídos.
Alguns itens deram certo e outros apresentaram erro.	Confira as linhas da planilha e corrija os itens rejeitados. Os itens concluídos permanecem gravados; não é necessário desfazê-los para tratar os demais.
O processamento gravou dados, mas houve falha ao gerar a planilha.	Confira a mensagem e os cadastros antes de executar novamente. Procure o suporte para analisar a falha no arquivo; a ausência da planilha não significa que nada foi gravado.

Exemplos de Uso

Buscar os empréstimos de um mês

Você precisa consultar os empréstimos de fevereiro de 2026. Confira a empresa, selecione Consulta mensal, escolha Produção e informe 15/02/2026 em Competência.

O Smart consulta fevereiro de 2026. Ao concluir, confira quais empréstimos foram criados, quais já existiam e quais precisam de correção. Informar 01/02/2026 ou 28/02/2026 consulta o mesmo mês.

Atualizar três empréstimos existentes

Você precisa atualizar saldo e garantia dos cadastros identificados no ERP por 125, 130 e 148. Selecione Consulta rescisória, escolha o ambiente correto e informe 125;130;148 em Contratos.

Se dois cadastros forem atualizados e um apresentar erro, o resultado geral será Atenção. Os dois concluídos permanecem atualizados. Leia a mensagem do terceiro para corrigir o problema antes de uma nova consulta.

Observações Gerais

Homologação é o ambiente de testes da DATAPREV, mas não é uma prévia sem gravação no ERP. Dados válidos recebidos nesse ambiente também podem criar ou atualizar cadastros conforme o tipo de consulta. Use-o com orientação do responsável e em uma base apropriada para testes.
Produção consulta o ambiente real da DATAPREV. Confira a empresa e os filtros antes de executar.
A consulta mensal não substitui automaticamente os dados de um empréstimo já cadastrado para o mesmo período.
A consulta rescisória atualiza somente saldo e garantia. Não modifica colaborador, evento, valor da parcela, período de desconto ou os lançamentos existentes.
O Smart não calcula verbas rescisórias, não recalcula a folha, não contrata empréstimos e não envia os descontos pagos à DATAPREV.
Na consulta rescisória, não é necessário informar a data do desligamento. O saldo consultado é o disponibilizado pela DATAPREV no momento da consulta, não uma posição histórica escolhida por data.
Guarde e confira a planilha de resultado. Ela pode conter informações pessoais e financeiras dos colaboradores; compartilhe-a somente com pessoas autorizadas. O CPF é apresentado de forma parcialmente ocultada.
Não informe certificado ou senha nos filtros do Smart. A configuração é aproveitada automaticamente do cadastro da empresa.

Benefícios do Recurso

Reduz a digitação manual das informações de empréstimos recebidas da DATAPREV.
Permite consultar vários empréstimos existentes em uma única execução.
Facilita a conferência dos itens concluídos e dos motivos de rejeição.
Evita a criação de empréstimos duplicados para o mesmo período e preserva os itens já concluídos quando outro item apresenta erro.

Glossário de Termos

Smart: ferramenta do ERP que executa uma tarefa a partir das opções informadas pelo usuário.
eConsignado / Crédito do Trabalhador: empréstimo consignado cujas informações são consultadas por este Smart.
DATAPREV: serviço de onde o Smart obtém as informações dos empréstimos.
Competência: mês e ano a que a consulta mensal se refere.
Identificador do cadastro: número que identifica um registro de empréstimo dentro do ERP. Não é o número do contrato bancário.
Saldo devedor: valor ainda devido no empréstimo, conforme a informação recebida na consulta.
Percentual de garantia: percentual relacionado à garantia do empréstimo informado pela DATAPREV. Não representa, sozinho, o valor de uma verba rescisória.
Certificado digital A1: identificação digital cadastrada no sistema e utilizada para autorizar a comunicação em nome da empresa ou de seu procurador.
Procuração: autorização para que outra pessoa ou empresa consulte as informações em nome da empresa.

Links Relacionados

1148 - Controle Empréstimos e Vales: consulta dos cadastros de empréstimos utilizados e alimentados pelo Smart.
1396 - Configuração Certificado: cadastro do certificado utilizado na consulta.