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.

Esse comportamento é acionado em cenários como:

• Indisponibilidade temporária do serviço da Dataprev
• Processamento ainda pendente
• Inconsistências momentâneas de margem
• Falhas técnicas transitórias

Durante todo o período de tentativas, a operação permanece com o status PENDING_GUARANTEE. O processo segue até uma das seguintes condições:

• Sucesso na averbação — a operação avança normalmente para a próxima etapa do fluxo
• Fim do período de tentativas — a operação é cancelada, retornando o motivo da última tentativa

Importante: É esperado que operações fiquem por mais tempo em PENDING_GUARANTEE durante períodos de instabilidade ou indisponibilidade externa. Esse comportamento é normal e faz parte da estratégia para aumentar a taxa de sucesso das averbações.

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