Koppla en inköpsorder och fylla i inköpsorderinformation

Artikel
09/28/2024

Lämpliga roller: Administratörsagent

Partner kan vara skyldiga att tillhandahålla information om kundköpsorder och/eller anbud eller begäran om förslag (RFP) för att slutföra en transaktion i Partnercenter. Den här artikeln beskriver hur partner kan använda Partnercenter för att programmatiskt bifoga inköpsorder.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.

Syntax för begäran

Metod	URI för förfrågan
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

URI-brödtextparameter

Använd följande brödtextparametrar för att returnera inköpsorderstatusar.

Namn	Typ	Obligatoriskt	Beskrivning
isPartofTender	Boolesk	N	Är beställningsdelen av en kunds anbud eller begäran om förslag (RFP).
customerPrice	Decimal/sträng	Y
valuta	String	Y
fxRate	Decimal/sträng	N
tenderLink	String	J/N	Om isPartOfTender är sant och inga anbudsfiler tillhandahålls krävs detta, annars krävs det inte.
POfiles	Filer	Y
TenderFiles	Filer	J/N	Om isPartOfTender är sant och ingen anbudslänk tillhandahålls krävs detta annars krävs det inte.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Exempel på begäran

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

REST-svar

Om transaktionen kräver en uppladdning av inköpsorder när en partner har skapat en beställning eller checkout tas följande svar emot.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och mer felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och fler parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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"}}

Dela via