Les API Demandes d'Achat et Bons de Commande
Les API Demande d'Achat (DA) et Bon de Commande (BDC) font partie des API LittleBig Connection et vous aident dans la phase d'approvisionnement (Procure) du cycle de vie de vos missions. Voyons dans cet article quand et comment vous pouvez les utiliser, et quelles sont les informations qu'elles contiennent.
Dans cet article
- Présentation des API Demandes d'Achat et Bons de Commande
- Utiliser l'API Demandes d'Achat (DA)
- Utiliser l'API Bons de Commande (BDC)
.
Présentation des API Demandes d'Achat et Bons de Commande
Ces API vous permettent de gérer les missions à venir et en cours en synchronisation avec vos outils internes.
En effet, une fois qu'un Responsable opérationnel a sélectionné un expert, il peut avoir besoin de créer une DA et de la faire valider par votre service Achats (facultatif). Au lieu de dupliquer les informations de la plateforme LittleBig dans vos outils internes, l'API Demandes d'Achat peut connecter la plateforme à vos outils afin que la DA soit créée et validée/rejetée une seule fois dans votre outil. La décision est ensuite communiquée à la plateforme LB.
Après la validation de la DA (s'il y a) ou directement après la sélection du profil, le BDC correspondant est automatiquement généré pour permettre à votre service Achats d'allouer les ressources nécessaires à la mission. Certaines informations peuvent devoir être ajoutées à ce BDC, et au lieu de faire des allers-retours entre vos outils et la plateforme LittleBig, l'API BDC peut simplifier ces actions.
Lorsque la mission est pres de sa fin, , vous pouvez utiliser l'option de Renouvellement pour déclencher le renouvellement direct (si applicable), en indiquant les nouvelles dates et le nouveau montant. Si cela est fait correctement, un nouvel AO sera créé, prêt à être publié et à créer le renouvellement.
Voici un exemple d'utilisation des deux API lorsque la fonctionnalité DA est activée :
Voici un exemple d'utilisation de l'API Bons de Commande lorsque la fonctionnalité DA n'est pas activée :
.
Utiliser l'API Demandes d'Achat (DA)
.
Recherche des DA en cours
L'opération API SearchPurchaseRequest vous permet de filtrer les DA en cours.
Grâce à cette opération, vous pourrez également effectuer une recherche en temps réel en indiquant une période spécifique, dans le but de cibler vos résultats avec plus de précision. Consultez la page Documentation API pour plus de détails sur les critères de recherche.
La réponse que vous recevrez contiendra les informations suivantes concernant les DA recherchées :
- ID de la demande d'achat
- Dates du BDC
- Statut de la DA
- Statut handicap
- Champs personnalisés (s'il y a)
- Informations sur l'Appel d'Offre (mêmes informations que dans cette opération API Appel d'Offres)
- Information sur la proposition sélectionnée (mêmes informations que dans cette opération API Propositions)
.
Mise à jour d'une DA (validation/refus/ajout d'un numéro externe)
Après avoir récupéré les DA en cours, avec l'opération API UpdatePurchaseRequest, vous pouvez mettre à jour les détails des DA (en ajoutant un identifiant externe) et les valider ou les rejeter.
Si votre requête aboutit, la réponse contiendra les informations mises à jour pour la DA en question. Dans le cas contraire, un message d'erreur sera affiché.
.
Utiliser l'API Bons de Commande (BDC)
Une fois le BDC généré, il sera possible d'accéder aux données qu'il contient via l'API, afin de les synchroniser avec vos outils internes.
Il sera également possible de modifier certains de ses détails et d'ajouter des pièces jointes.
.
Récupérer les BDC en cours
L'opération API SearchPurchaseOrders vous permet de filtrer les BDC en cours.
Grâce à cette opération, vous pourrez également effectuer une recherche en temps réel en indiquant une période spécifique, dans le but de cibler vos résultats avec plus de précision. Consultez la page Documentation API pour plus de détails sur les critères de recherche.
La réponse que vous recevrez contiendra les informations suivantes sur les BDC recherchés :
|
|
.
Mise à jour d'un BDC
L'opération API UpdatePurchaseOrder permet de mettre à jour les informations relatives au Bon de Commande (en ajoutant un numéro externe au BDC et/ou un identificant au consultant), une fois que celui-ci a été récupéré.
Si la requête aboutit, la réponse contiendra le BDC mis à jour. Dans le cas contraire, un message d'erreur sera affiché.
.
Joindre un fichier à un BDC
L'API vous offre la possibilité de télécharger et de joindre des documents à votre BDC grâce à l'opération API UploadPurchaseOrderDocument.
Si la requête aboutit, la réponse contiendra un message indiquant que le fichier a été ajouté au BDC. Dans le cas contraire, un message d'erreur sera affiché.
.
Déclencher le renouvellement directe d'une mission existente
Quand la mission est près de sa fin, vous pouvez utiliser l'option de Renouvellement pour déclencher le renouvellement directe (si applicable), en indiquant les nouvelles dates et le nouveau montant.
Si cela est fait correctement, un nouvel AO sera créé, prêt à être publié et à créer le renouvellement.