Contexte
Le contexte décrit le cadre dans lequel vous travaillez avec un tiers — un contrat, un marché, un projet, une réglementation — et sous lequel vos évaluations sont déclenchées, qualifiées et pilotées.
Le contexte se comporte comme le tiers : c'est une entrée primaire. À la différence du dossier et du document, qui ne peuvent qu'être rattachés à un tiers, un contexte peut exister seul. Il n'est pas obligatoire pour suivre un tiers ou ajouter un dossier : les intégrations existantes restent valables.
Pourquoi un nouvel objet ?
La plateforme est construite autour de trois objets : Tiers, Dossier et Document. Le dossier est le réceptacle de toute demande de document — mais selon les usages, il s'est vu investi de deux rôles incompatibles.
Un dossier par contrat, avec sa référence et sa date de fin, regroupant l'ensemble des demandes de toute nature du contrat.
Un dossier déclenché par une règle, défini par sa cohérence fonctionnelle : Anticorruption, Travail dissimulé, Cyber, Socle, Onboarding…
Référence, date de fin, montant d'achat, type de relation : les données du contrat vivent désormais ici.
Le dossier redevient une compilation d'évaluations déclenchée par règle, libérée de toute référence contractuelle.
Position dans le modèle de données
Un contexte peut être créé indépendamment, sans être rattaché à un tiers, et les tiers s'y rattachent ensuite — comme un contexte se rattache à un tiers depuis sa fiche. La relation est multiple des deux côtés.
- Un même contexte peut être associé à plusieurs tiers.
- Un même tiers peut être associé à plusieurs contextes.
- Un contexte est lié à un seul modèle de contexte.
- Les contextes sont accessibles au-dessus des dossiers, dans une vue Contextes autonome.
Les chemins possibles
Le contexte ouvre deux chemins de navigation supplémentaires, sans invalider l'existant :
Le modèle de contexte
Avant de créer un contexte, on définit un modèle de contexte depuis la configuration du compte, où il peut être créé, modifié et supprimé. Un contexte est du même type que son modèle et n'est lié qu'à un seul d'entre eux — le modèle fixe le vocabulaire (« Contrat », « Zéro Déforestation », « Minerais de conflit ») et le jeu d'attributs à renseigner.
Afin de ne pas dégrader l'usage actuel, l'ajout manuel d'un contexte n'est possible que sur un compte pour lequel au moins un modèle de contexte est paramétré. Les comptes sans modèle conservent exactement le fonctionnement actuel.
Les attributs de contexte
À l'instar des attributs de tiers et de dossier, les attributs de contexte sont saisis par l'utilisateur.
Multi-Tier Supply Chain Discovery
Un contexte peut aussi servir à déclencher une déclaration en cascade de la chaîne d'approvisionnement : le fournisseur est sollicité pour déclarer ses propres sous-traitants, qui sont à leur tour sollicités, jusqu'à la découverte de l'entièreté de la chaîne. Chaque tiers déclaré porte son rang dans le contexte — 1 pour le fournisseur direct, 2 pour son sous-traitant, et ainsi de suite — et rejoint automatiquement le portefeuille du client.
L'objet contexte est accessible à l'ensemble des comptes ; l'option Découverte de la Supply Chain est réservée aux comptes ayant souscrit à l'abonnement.
Et côté API ?
Les endpoints Contexte sont désormais documentés : ils figurent dans la collection Postman et dans la documentation API, répartis en deux sections — Contexts et Third parties contexts, 25 endpoints au total. La page Évolutions suit le calendrier de mise en service.
Le parcours type
- Lister les modèles de contexte disponibles sur votre compte, pour récupérer le nom du modèle à utiliser.
- Créer le contexte à partir de ce modèle, en renseignant sa référence, sa description et ses attributs.
- Rattacher les tiers, au premier niveau ou sous forme d'arbre supply-chain complet.
- Suivre le contexte : attributs, dossiers d'évaluation et notes.
Endpoints Contexte
Liste les modèles de contexte disponibles sur votre compte. C'est le modelName renvoyé ici que l'on utilise à la création.
Liste les contextes du compte. active=true renvoie les contextes en cours, active=false les contextes archivés. Filtrable par modelId, paginé via limit et offset.
Détail complet d'un contexte : référence, description, valeurs d'attributs et tiers rattachés.
Crée un contexte à partir d'un modèle. Le paramètre optionnel supplyChainDepth active l'arbre supply-chain et fixe le nombre de niveaux de sous-traitance autorisés ; sans lui, le contexte reste à plat.
Met à jour la valeur d'un attribut du contexte. L'attribut est identifié dans l'URL, la nouvelle valeur passe dans values. Envoyer [null] vide l'attribut.
Archive (arrête) le contexte. Un motif peut être précisé via deactivationReason.
Réactive un contexte précédemment archivé.
Endpoints Tiers du contexte
Un tiers de contexte est un tiers de votre portefeuille rattaché à un contexte. Chacun possède son propre identifiant — le context third party id — distinct de l'identifiant du tiers, et c'est celui-ci que l'on réutilise pour rattacher un enfant, créer un dossier ou ajouter une note.
Liste les tiers rattachés au contexte, c'est-à-dire l'arbre supply-chain. withAttributes=true inclut les valeurs d'attributs de chaque tiers.
Rattache un ou plusieurs tiers au contexte. Le corps est une liste ; sans parentId, les tiers sont rattachés au premier niveau, avec parentId ils sont placés sous un autre tiers de l'arbre.
Détail d'un tiers au sein du contexte.
Valeurs des attributs d'un tiers au sein du contexte.
Met à jour la valeur d'un attribut d'un tiers du contexte, selon la même mécanique que les attributs de contexte.
Crée un dossier d'évaluation pour un tiers du contexte. dossierTypeCode est obligatoire ; dossierReference, description et thirdpartyEmail sont optionnels.
Retire (archive) un tiers du contexte. Ses sous-traitants sont archivés en même temps.
Réactive un tiers précédemment archivé dans le contexte.
Le parentId attend le context third party id — le champ id renvoyé par la liste des tiers du contexte — et non l'identifiant du tiers dans votre portefeuille. Le tiers parent doit par ailleurs autoriser la déclaration de sa supply chain.
Notes de contexte
Un contexte et chacun de ses tiers acceptent des notes — de simples commentaires libres, renvoyés du plus récent au plus ancien. Le CRUD est identique à celui des autres objets : voir la section Notes du guide Dossier.