Joindre un bon de commande et compléter les détails d’un bon de commande

Article
09/28/2024

Rôles appropriés : Agent d’administration

Les partenaires peuvent être tenus de fournir un bon de commande client et/ou des informations d’appel d’offres ou de demande de proposition (RFP) pour effectuer une transaction dans l’Espace partenaires. Cet article décrit comment les partenaires peuvent utiliser l’Espace partenaires pour attacher des bons de commande par programmation.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.

Syntaxe de la requête

Method	URI de demande
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

Paramètre de corps d’URI

Utilisez les paramètres de corps suivants pour retourner les états des bons de commande.

Nom	Type	Requise	Description
isPartofTender	Booléen	N	Partie commande d’un client Appel d’offres ou demande de proposition (RFP).
customerPrice	Décimal/chaîne	Y
currency	Chaîne	Y
fxRate	Décimal/chaîne	N
tenderLink	Chaîne	O/N	Si isPartOfTender a la valeur true et qu’aucun fichier d’appel d’offres n’est fourni, cela n’est pas obligatoire.
Fichiers POfiles	Fichiers	Y
TenderFiles	Fichiers	O/N	Si isPartOfTender a la valeur true et qu’aucun lien d’appel d’offres n’est fourni, cela est requis sinon, il n’est pas obligatoire.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Exemple de requête

POST https://api.partnercenter.microsoft.com/v1/customers/<customerid>/orders/<orderid>/attachment
Authorization: Bearer <Token>
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryaLQBO4IgpABK3wdj
Accept: application/json

------WebKitFormBoundaryaLQBO4IgpABK3wdj
Content-Disposition: form-data; name="metadata"
{"isPartofTender":true,"customerPrice":"156.87","currency":"CAD","fxRate":"1.2","tenderLink":https://onedrive.com/ishdruiwiojfdhajhgdfgjhgj}
------WebKitFormBoundaryaLQBO4IgpABK3wdj
Content-Disposition: form-data; name="pofiles"; filename="PO_Part1.pdf"
Content-Type: application/pdf

Réponse REST

Si la transaction nécessite un chargement de bon de commande une fois qu’un partenaire a terminé la création d’une commande ou d’un paiement, la réponse suivante est reçue.

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et plus d’informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

HTTP/1.1 201 Created
Content-Length: 393

{"totalCount":3,"items":[{"attachmentId":"ed64c99f750115","fileName":"PO_Part1.pdf","sizeInKB":2051,"attachmentType":"POAttachment"},{"attachmentId":"ef8fe74c39e264","fileName":"PO_Part2.pdf","sizeInKB":1313,"attachmentType":"POAttachment"},{"attachmentId":"32a312ca64567a","fileName":"Tender.pdf","sizeInKB":2223,"attachmentType":"TenderAttachment"}],"attributes":{"objectType":"Collection"}}

Partager via