Réseau de fournisseurs et répartition classée dans l’API Acheteur
Interrogez votre réseau de fournisseurs et classez les fournisseurs du réseau privé pour un emplacement et un type de problème afin d’automatiser la répartition avec l’API Acheteur OpenWrench.
Deux familles d’endpoints répondent à « qui peut effectuer ce travail » : la liste des établissements fournisseurs (l’ensemble de votre réseau) et l’endpoint du réseau privé classé (la liste courte ordonnée pour un emplacement et un type de problème donnés). Combinés au patch de réaffectation de bon de travail, ils vous permettent d’automatiser la répartition.
Tous les exemples supposent :
Votre réseau de fournisseurs
GET /v1/buyer/supplier_facilities retourne chaque relation fournisseur non supprimée pour votre entreprise. Contrairement à la plupart des endpoints de liste, il prend en charge un ensemble de filtres documentés :
Récupérez un seul établissement avec GET /v1/buyer/supplier_facilities/{id}.
Fournisseurs classés du réseau privé
Pour la répartition automatisée, demandez la liste classée pour une paire (emplacement, type de problème) :
GET /v1/buyer/private_network/buyer_supplier_relationships/ranked/{locationId}/{problemTypeId} retourne les relations acheteur-fournisseur, chacune hydratée avec les détails de votre relation (contacts et adresses courriel d’acheminement).
Le rang est transmis par l’ordre du tableau. Tout sort_by que vous passez est délibérément ignoré afin que l’ordre du tableau soit toujours égal au rang. L’endpoint est paginé (par défaut 10, maximum 25 par page), donc le rang continue à travers les pages : le premier élément de la deuxième page est le rang 11.
Modèle de répartition automatisée
- Un bon de travail arrive (ou est créé non assigné).
- Appelez l’endpoint classé pour le
locationId et le problemTypeId du bon de travail.
- Prenez l’établissement fournisseur de la première relation et affectez-le, soit au moment de la création (
supplierFacilityId dans le corps de création), soit après avec PATCH /v1/buyer/work_order/work_orders/{id}.
- Si le fournisseur refuse, le bon de travail retourne à
PendingApproval (ou un fournisseur du réseau privé peut être choisi automatiquement, selon votre configuration). Sur refus, réexécutez le classement et assignez le candidat suivant.
Les échelles d’escalade, les délais d’intervention par entente de service et les décomptes de refus peuvent tous être superposés à cette boucle; l’endpoint de classement vous donne les candidats ordonnés, et les statusChanges du bon de travail vous disent comment chaque tentative s’est déroulée.
