Anfügen einer Bestellung und Abschließen von Bestelldetails

Artikel
09/28/2024

Geeignete Rollen: Administrator-Agent

Partner müssen möglicherweise Kundenauftrags- und/oder Angebots- oder Angebotsanfrage (RFP)-Informationen bereitstellen, um eine Transaktion im Partner Center abzuschließen. In diesem Artikel wird beschrieben, wie Partner das Partner Center verwenden können, um Bestellungen programmgesteuert anzufügen.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

Anforderungssyntax

Methode	Anforderungs-URI
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

URI-Textparameter

Verwenden Sie die folgenden Textparameter, um Bestellstatus zurückzugeben.

Name	Type	Erforderlich	Beschreibung
isPartofTender	Boolescher Wert	N	Ist der Auftragsteil eines Kundenangebots oder antrag auf Vorschlag (RFP).
Kundenpreis	Dezimal/Zeichenfolge	Y
currency	String	Y
fxRate	Dezimal/Zeichenfolge	N
tenderLink	String	J/N	Wenn isPartOfTender wahr ist und keine Ausschreibungsdateien bereitgestellt werden, ist dies erforderlich, andernfalls nicht erforderlich.
POfiles	Dateien	Y
TenderFiles	Dateien	J/N	Wenn isPartOfTender wahr ist und keine Ausschreibungslink bereitgestellt wird, ist dies erforderlich, andernfalls ist sie nicht erforderlich.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungsbeispiel

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-Antwort

Wenn für die Transaktion ein Upload einer Bestellung erforderlich ist, sobald ein Partner die Erstellung einer Bestellung oder das Auschecken abgeschlossen hat, wird die folgende Antwort empfangen.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und weitere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und weitere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

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

Freigeben über