Připojení nákupní objednávky a dokončení podrobností nákupní objednávky

Článek
09/28/2024

Příslušné role: Agent pro správu

K dokončení transakce v Partnerském centru můžou být partneři muset zadat nákupní objednávku zákazníka nebo žádost o nabídku (RFP). Tento článek popisuje, jak můžou partneři používat Partnerské centrum k programovému připojení nákupních objednávek.

Požadavky

Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.

Syntaxe požadavku

metoda	Identifikátor URI žádosti
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

Základní parametr identifikátoru URI

K vrácení stavů nákupní objednávky použijte následující základní parametry.

Name	Type	Požadováno	Popis
isPartofTender	Logická hodnota	N	Je součástí nabídky nebo žádosti o návrh zákazníka (RFP).
customerPrice	Desetinné číslo nebo řetězec	Y
měna	String	Y
fxRate	Desetinné číslo nebo řetězec	N
tenderLink	String	A/N	Pokud je argument isPartOfTender pravdivý a nejsou k dispozici žádné soubory nabídek, je to povinné, jinak není vyžadováno.
POfiles	Soubory	Y
TenderFiles	Soubory	A/N	Pokud je argument isPartOfTender pravdivý a není poskytnut žádný odkaz na nabídku, je to povinné, jinak to není povinné.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Příklad požadavku

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

Odpověď REST

Pokud transakce vyžaduje nahrání nákupní objednávky, jakmile partner dokončí vytvoření objednávky nebo rezervace, obdrží se následující odpověď.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

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

Sdílet prostřednictvím