O módulo de predições identifica dívidas com alta probabilidade de inadimplência antes que se tornem irrecuperáveis. Usa modelos estatísticos baseados em histórico de pagamento, comportamento conversacional e dados do bureau.
Endpoints
#Todos os endpoints requerem autenticação via JWT (Authorization: Bearer TOKEN).
Dívidas em risco
Retorna as dívidas classificadas com maior risco de inadimplência, ordenadas por probabilidade. Inclui os fatores de risco e ação recomendada (contato urgente, desconto preventivo, etc.).
Estatísticas de predições
Retorna indicadores do modelo preditivo: total de dívidas analisadas, acurácia histórica, distribuição por faixa de risco e valor total em risco.
Disparar scoring preditivo
Dispara o cálculo preditivo para todas as dívidas ativas. O processo roda em background via fila (BullMQ) e atualiza os scores conforme completa.
O scoring preditivo é um processo intensivo. Recomendamos executar no máximo uma vez por dia.