Démarrage rapide
Créez votre premier tiers et lancez une évaluation en quelques minutes.
Prérequis
Avant de commencer, assurez-vous d'avoir :
- Un token JWT valide (voir Authentification)
- Votre accountId (récupéré via GET /api/v1/account)
Étape 1 : Ajouter un tiers
Importez un tiers dans votre portefeuille en utilisant son identifiant légal.
POST/api/v1/account/:accountId/thirdparties
curl -X POST https://edge.aprovall.com/api/v1/account/123/thirdparties \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"companyIdType": "CIT001",
"companyIdValue": "50382936800010"
}'Types d'identifiants
| companyIdType | Description | Example |
|---|---|---|
CIT001 | SIRET (entreprises françaises, 14 chiffres) | 50382936800010 |
CIT002 | Numéro de TVA intracommunautaire | FR69503829368 |
CIT003 | Numéro DUNS (9 chiffres) | 260004250 |
La réponse contient le thirdpartyId créé, nécessaire pour les étapes suivantes.
Étape 2 : Créer un dossier d'évaluation
Lancez une évaluation en créant un dossier pour ce tiers.
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 YOUR_JWT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"dossierTypeCode": "VIGILANCE"
}'Le dossierTypeCode correspond à un type de dossier prédéfini : un ensemble de documents à collecter dans le cadre de l'évaluation (rapport, formulaire, qualification professionnelle, etc.).
Étape 3 : Récupérer les informations du dossier
Consultez le statut du dossier et l'avancement de la collecte documentaire.
GET/api/v1/account/:accountId/dossiers/:dossierId
curl -X GET https://edge.aprovall.com/api/v1/account/123/dossiers/456 \
-H "Authorization: Bearer YOUR_JWT_TOKEN"Dossier d'évaluationAction requise
TiersAprovall
Date de création15/01/2025
Procédure collectiveNon
Documents requis
Justificatif d'immatriculation
Conforme
Attestation d'assurance RC professionnelle
Action requise
Liste nominative des salariés étrangers
Conforme
Régularité sociale
Conforme