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.

Erro por Instabilidade na API

Em casos de instabilidade temporária na API da Dataprev:

O sistema realiza tentativas automáticas de averbação até a data limite de desembolso.
Caso a averbação não seja concluída até essa data, a operação será:
- Cancelada automaticamente

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
- Do código de erro retornado pela Dataprev

Códigos de Erro Retornados pela Dataprev

A tabela abaixo lista os códigos de erro possíveis e suas descrições.

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