Statuts
Référence complète des statuts utilisés dans l'API Aprovall pour les documents et les dossiers.
Statuts des documents
Chaque document demandé dans un dossier possède un statut indiquant sa progression dans le workflow de vérification.
| Statut | Description | Acteur |
|---|---|---|
| MISSING | Non encore soumis par le tiers | — |
| IN_PROGRESS | Collecte/traitement et vérification en cours | Aprovall |
| ACTION_REQUIRED | En attente de validation ou rejet manuel par le client | Client |
| VALID | Présent et valide (automatiquement ou manuellement) | Aprovall / Client |
| NOT_VALID | Rejeté par la vérification Aprovall ou rejet manuel | Aprovall / Client |
| BELOW_EXPECTATION | Rejeté par le client sans propagation au tiers | Client |
Workflow de vérification
Le statut d'un document évolue selon un workflow précis impliquant plusieurs acteurs :
Le client crée un dossier avec des documents requis. Statut : MISSING
Le tiers dépose le document. Statut : IN_PROGRESS
Vérification automatique par IA et/ou sources externes.
Selon le résultat : VALID (auto-validation), NOT_VALID (rejet auto), ou ACTION_REQUIRED (validation manuelle requise).
Certains comptes ont une étape de vérification client supplémentaire activée. Dans ce cas, même après validation Aprovall, le document peut passer en ACTION_REQUIRED pour validation manuelle finale.
Statuts des dossiers
Le statut global d'un dossier est calculé automatiquement à partir des statuts de tous ses documents :
| Statut | Condition |
|---|---|
| VALID | Tous les documents sont au statut VALID |
| IN_PROGRESS | Au moins un document est MISSING, IN_PROGRESS ou ACTION_REQUIRED |
| NOT_VALID | Au moins un document est NOT_VALID ou BELOW_EXPECTATION |
Actions possibles sur un document
Selon le statut du document, différentes actions sont disponibles via l'API :
| Statut actuel | Actions disponibles |
|---|---|
| ACTION_REQUIRED | approve → passe en VALIDreject → passe en NOT_VALID ou BELOW_EXPECTATION |
| VALID | Télécharger le document (PDF) |
| NOT_VALID | Nouvelle demande automatique au tiers |
Différence NOT_VALID vs BELOW_EXPECTATION
Ces deux statuts indiquent un rejet mais avec des comportements différents :
| Statut | Propagation | Cas d'usage |
|---|---|---|
| NOT_VALID | Le tiers est informé et doit fournir un nouveau document | Document non conforme, illisible, expiré |
| BELOW_EXPECTATION | Pas de notification au tiers | Document acceptable mais ne répond pas aux attentes internes du client |