Dossier d'évaluation

Un dossier est un ensemble de documents à collecter auprès d'un tiers dans le cadre d'une évaluation.

Définition

Dans Aprovall, un Dossier représente une demande d'évaluation pour un tiers. Il contient la liste des documents requis (attestations, certificats, formulaires) et suit leur progression jusqu'à validation complète.

Dossier vs Type de dossier

Un type de dossier (dossierTypeCode) est un modèle prédéfini de documents à collecter. Lorsque vous créez un dossier avec un type, les documents requis sont automatiquement configurés.

Types de dossiers

Les types de dossiers sont configurés sur votre compte et définissent un ensemble de documents standards à collecter. Exemples :

Onboarding — Documents de base pour référencer un nouveau fournisseur
Vigilance — Conformité légale (URSSAF, fiscalité, assurances)
CSR — Documents RSE et développement durable
Cybersécurité — Certifications et questionnaires sécurité

GET/api/v1/account/:accountId/dossierTypes

Liste tous les types de dossiers disponibles sur votre compte.

Créer un dossier

Pour créer un dossier d'évaluation, le tiers doit déjà exister dans votre portefeuille. Vous pouvez spécifier un type de dossier ou définir manuellement les documents requis.

POST/api/v1/account/:accountId/thirdparties/:thirdpartyId/dossiers

curl -X POST https://edge.aprovall.com/api/v1/account/123/thirdparties/456/dossiers \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "thirdpartyCode": "FOURNISSEUR_001",
    "dossierReference": "EVAL-2025-001",
    "description": "Évaluation annuelle",
    "dossierTypeCode": "VIGILANCE",
    "thirdpartyEmail": ["contact@fournisseur.com"]
  }'

Paramètres de création

Paramètre	Type	Description
`thirdpartyCode`	string	Code de référence du tiers (votre système)
`dossierReference` *	string	Référence unique du dossier
`dossierTypeCode`	string	Code du type de dossier (préconfigure les documents)
`description`	string	Description libre du dossier
`purchasingCategory`	string	Catégorie achat (usage libre)
`expirationDate`	YYYY-MM-DD	Date d'expiration du dossier
`requiredDocuments`	string[]	Liste des codes documents requis (si pas de dossierTypeCode)
`thirdpartyEmail`	string[]	Emails du tiers (recevront les demandes)
`usersInCharge`	string[]	Emails des utilisateurs responsables du dossier

Statuts des documents

Chaque document d'un dossier possède un statut indiquant sa progression :

Statut	Description
MISSING	Non encore soumis par le tiers
IN_PROGRESS	Collecte/traitement et vérification en cours
ACTION_REQUIRED	En attente de validation ou rejet manuel par le client
VALID	Présent et valide (automatiquement ou manuellement)
NOT_VALID	Rejeté par la vérification Aprovall ou rejet manuel
BELOW_EXPECTATION	Rejeté par le client (sans propagation)

Statut global du dossier

Le statut global d'un dossier est calculé automatiquement en fonction des statuts de tous ses documents.

VALIDNOT_VALIDIN_PROGRESS

Endpoints API

GET/api/v1/account/:accountId/dossiers

Liste tous les dossiers de votre compte avec pagination et filtres.

GET/api/v1/account/:accountId/dossiers/:dossierId

Récupère les détails d'un dossier (documents, statuts, indicateurs).

PUT/api/v1/account/:accountId/dossiers/:dossierId

Met à jour les informations d'un dossier (description, date d'expiration, etc.).

POST/api/v1/account/:accountId/dossiers/:dossierId/stop

Arrête un dossier actif.

POST/api/v1/account/:accountId/dossiers/:dossierId/activate

Réactive un dossier arrêté.

Les notes de dossier

Un dossier accepte des notes : de simples commentaires libres que vous attachez au dossier et qui sont renvoyés lors d'un GET sur celui-ci. Le corps de la requête tient en un champ, content, obligatoire. Les notes sont renvoyées de la plus récente à la plus ancienne.

Changement de chemin

Le chemin des notes est passé du singulier au pluriel : /dossiers/:dossierId/note devient /dossiers/:dossierId/notes. Les intégrations qui utilisaient l'ancien chemin doivent être mises à jour. Le CRUD est par ailleurs complet, avec l'ajout de la lecture (GET) et de la modification (PUT).

GET/api/v1/account/:accountId/dossiers/:dossierId/notes

Liste les notes du dossier, de la plus récente à la plus ancienne.

POST/api/v1/account/:accountId/dossiers/:dossierId/notes

Ajoute une note au dossier. content est obligatoire.

PUT/api/v1/account/:accountId/dossiers/:dossierId/notes/:noteId

Modifie le texte d'une note existante via content.

DELETE/api/v1/account/:accountId/dossiers/:dossierId/notes/:noteId

Supprime une note à partir de son identifiant.

Les autres objets annotables

Le même CRUD — GET, POST, PUT, DELETE avec un unique champ content — s'applique à quatre objets. Seule la racine du chemin change.

Objet	Racine du CRUD
Dossier d'évaluation	`/api/v1/account/:accountId/dossiers/:dossierId/notes`
Tiers	`/api/v1/account/:accountId/thirdparties/:thirdpartyId/notes`
Document (réponse du tiers)	`/api/v1/account/:accountId/thirdparties/:thirdpartyId/responses/:responseId/notes`
Contexte et tiers de contexte	`/api/v1/account/:accountId/contexts/:contextId/notes`