Evaluation Dossier
A dossier is a collection of documents to be gathered from a third party as part of an assessment.
Definition
In Aprovall, a Dossier represents an evaluation request for a third party. It contains the list of required documents (attestations, certificates, forms) and tracks their progress until complete validation.
A dossier type (dossierTypeCode) is a predefined template of documents to collect. When you create a dossier with a type, the required documents are automatically configured.
Dossier Types
Dossier types are configured on your account and define a standard set of documents to collect. Examples:
- Onboarding — Basic documents for registering a new supplier
- Vigilance — Legal compliance (URSSAF, tax, insurance)
- CSR — CSR and sustainable development documents
- Cybersecurity — Security certifications and questionnaires
Lists all dossier types available on your account.
Create a Dossier
To create an evaluation dossier, the third party must already exist in your portfolio. You can specify a dossier type or manually define the required documents.
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"]
}'Creation Parameters
| Parameter | Type | Description |
|---|---|---|
thirdpartyCode | string | Third party reference code (your system) |
dossierReference * | string | Unique dossier reference |
dossierTypeCode | string | Dossier type code (preconfigures documents) |
description | string | Free dossier description |
purchasingCategory | string | Purchasing category (free use) |
expirationDate | YYYY-MM-DD | Dossier expiration date |
requiredDocuments | string[] | List of required document codes (if no dossierTypeCode) |
thirdpartyEmail | string[] | Third party emails (will receive requests) |
usersInCharge | string[] | Emails of users responsible for the dossier |
Document Statuses
Each document in a dossier has a status indicating its progress:
| Status | Description |
|---|---|
| MISSING | Not yet submitted by the third party |
| IN_PROGRESS | Collection/processing and verification in progress |
| ACTION_REQUIRED | Awaiting manual validation or rejection by client |
| VALID | Present and valid (automatically or manually) |
| NOT_VALID | Rejected by Aprovall verification or manual rejection |
| BELOW_EXPECTATION | Rejected by client (without propagation) |
The overall dossier status is automatically calculated based on the statuses of all its documents.
API Endpoints
Lists all dossiers on your account with pagination and filters.
Retrieves dossier details (documents, statuses, indicators).
Updates dossier information (description, expiration date, etc.).
Stops an active dossier.
Reactivates a stopped dossier.