Status

Third party (Tiers)

Un tiers représente toute entité externe avec laquelle votre organisation entretient une relation commerciale : fournisseur, sous-traitant ou partenaire.

Définition

Dans Aprovall, un Third party (ou tiers) désigne une entreprise tierce que vous souhaitez évaluer. Il peut s'agir de :

  • Fournisseurs — Entreprises qui vous vendent des biens ou services
  • Sous-traitants — Entreprises qui réalisent des prestations pour votre compte
  • Partenaires — Entreprises avec lesquelles vous collaborez
Portefeuille de tiers

L'ensemble de vos tiers constitue votre portefeuille. Chaque tiers est identifié de manière unique par son thirdpartyId.

Structure d'un tiers

Un tiers dans Aprovall est composé de plusieurs types d'informations :

🏢

Informations identitaires

Données légales et administratives de l'entreprise.

  • Raison sociale, SIRET, TVA intracommunautaire
  • Adresse du siège social
  • Code NAF, activité principale
  • Dirigeants, effectifs
  • Statut (actif, en procédure collective, radié)
GET /thirdparties/:id
🏷️

Attributs personnalisés

Données métier propres à votre organisation.

  • Catégorie (IT, BTP, Services...)
  • Criticité (High, Medium, Low)
  • Montant d'achat annuel
  • Business Unit
  • Référencement interne
GET /thirdparties/:id/attributes
📋

Dossiers d'évaluation

Évaluations en cours ou terminées pour ce tiers.

  • Type de dossier (Vigilance, Onboarding, CSR...)
  • Statut du dossier
  • Documents requis et collectés
  • Date d'expiration
GET /thirdparties/:id/dossiers
📊

Indicateurs

Scores de conformité et de risque calculés par SmartPilot.

  • Conformité légale
  • Risque financier
  • Score cybersécurité
  • Impact environnemental
GET /thirdparties/:id/indicators

Identification d'un tiers

Pour ajouter un tiers à votre portefeuille, vous devez fournir un identifiant légal. Aprovall supporte plusieurs types d'identifiants :

CodeType d'identifiantFormatPays
CIT001SIRET14 chiffresFrance
CIT002TVA intracommunautaireFR + 11 caractèresUnion Européenne
CIT003DUNS9 chiffresInternational

Rechercher un tiers

Avant d'ajouter un tiers à votre portefeuille, vous pouvez le rechercher par dénomination, numéro SIRET, TVA ou DUNS. Aprovall s'appuie sur des fournisseurs de données référents :

  • Altares — Pour les entreprises françaises
  • Dun & Bradstreet (Direct Plus) — Pour les entreprises internationales
POST/api/v1/account/:accountId/thirdparties/search
curl -X POST https://edge.aprovall.com/api/v1/account/123/thirdparties/search \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "countryCode": "FR",
    "searchBy": "NAME",
    "value": "Aprovall"
  }'

Paramètres de recherche

searchByDescriptionRestriction
NAMERecherche par dénomination—
SIRETNuméro SIRET (14 chiffres)countryCode = FR
SIRENNuméro SIREN (9 chiffres)countryCode = FR
VATNuméro de TVA intracommunautaire—
DUNSIdentifiant Dun & Bradstreet—
LOCAL_IDIdentifiant local du paysHors France

Cycle de vie d'un tiers

Un tiers suit généralement le cycle suivant dans Aprovall :

1
Création

Ajout du tiers via son identifiant légal

→
2
Enrichissement

Récupération automatique des données identitaires

→
3
Évaluation

Création de dossiers et collecte documentaire

→
4
Suivi

Monitoring continu et renouvellement

Endpoints API

GET/api/v1/account/:accountId/thirdparties

Liste tous les tiers de votre portefeuille avec pagination.

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

Ajoute un nouveau tiers à partir de son identifiant légal. Voir le guide de démarrage rapide pour un exemple complet.

GET/api/v1/account/:accountId/thirdparties/:thirdpartyId

Récupère les informations détaillées d'un tiers.

Attributs personnalisés

Les attributs permettent d'enrichir vos tiers avec des données métier propres à votre organisation (catégorie, criticité, montant d'achat, business unit, etc.).

Lister les attributs disponibles

Récupérez d'abord la liste des attributs configurés sur votre compte :

GET/api/v1/account/:accountId/attributes?bondType=thirdparty

Retourne tous les attributs disponibles pour les tiers de votre compte.

Types d'attributs

TypeDescriptionExemple de valeur
stringTexte libre"Fournisseur stratégique"
booleanVrai / Fauxtrue
dateDate"2025-01-15"
decimalNombre décimal150000.50
percentagePourcentage25
list_uniqueListe à choix unique"High"
list_multipleListe à choix multiple["IT", "Cloud"]

Ajouter ou modifier un attribut

POST/api/v1/account/:accountId/thirdparties/:thirdpartyId/attributes
curl -X POST https://edge.aprovall.com/api/v1/account/123/thirdparties/456/attributes \
  -H "Authorization: Bearer VOTRE_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "CATEGORY",
    "values": ["IT"]
  }'
Label de l'attribut

Le champ label correspond au nom de l'attribut tel que retourné par l'endpoint GET /attributes. Pour les attributs de type list_multiple, vous pouvez passer plusieurs valeurs dans le tableau values.

Prochaines étapes