Erros de Averbação – Integração Dataprev

Esta página descreve os possíveis erros retornados durante o processo de averbação de empréstimos, bem como o comportamento do sistema em cenários de instabilidade ou falhas definitivas na API da Dataprev.

Mecanismo de Reprocessamento ("Teimosinha")

O sistema conta com um mecanismo automático de reprocessamento de averbação, conhecido internamente como "Teimosinha". Quando a primeira tentativa de averbação não é concluída com sucesso, novas tentativas são realizadas automaticamente, sem necessidade de ação por parte do originador.

Entenda com detalhes na página "Teimosinha"

Erro Definitivo na Etapa de Averbação

Quando ocorre um erro definitivo retornado pela Dataprev durante a averbação:

A operação é cancelada automaticamente
O webhook de status da operação é atualizado
O motivo do cancelamento pode ser consultado por meio do status da operação ou do código de erro retornado pela Dataprev

Códigos de Erro Retornados pela Dataprev

Código	Descrição
AO	Nome inválido
AP	Competência de início de desconto ou data de início ou fim de contrato inválida
AZ	Valores de número de parcelas e valor da parcela são iguais aos valores atuais do empréstimo
BC	Requisição sem CBC ou CBC inválido
BL	Valor da parcela inválido
BQ	Valor liberado inválido
CA	Código do banco inválido
ES	Empregador suspenso para averbações de empréstimo
EV	Um ou mais campos possuem valores inválidos
HT	Início do desconto informado já ultrapassado
HU	Vínculo inelegível para empréstimo pelo trabalhador
HV	Quantidade de parcelas inválida
HW	Margem consignável excedida
HX	Empréstimo já cadastrado
HY	Empréstimo inexistente
IO	Valor do IOF inválido
ME	Motivo de exclusão do empréstimo inválido
NC	Requisição sem número de contrato
OH	Número do contrato inválido
ON	Operação não permitida
OT	Tamanho de um ou mais campos incorreto
OU	Taxa de juros anual inválida ou menor que a taxa mensal
OV	Valor do custo efetivo (anual ou mensal) inválido
OZ	Operação suspensa
PI	Valor do empréstimo inválido. Deve ser maior que o valor de referência
SB	Identificador da proposta inválido
SF	CPF ausente ou com dígito verificador inválido
SG	Código de inscrição do empregador deve ser informado
SH	Número de inscrição do empregador deve ser informado
SI	Matrícula do trabalhador deve ser informada
SM	Proposta expirada
SN	Proposta já utilizada para averbação de empréstimo
TX	Valor da taxa de juros mensal inválido
TO	Taxa de juros mensal maior que a informada na proposta
TP	Data do primeiro desconto inválida