Anfügen einer Bestellung und Abschließen von Bestelldetails

  • Artikel

Geeignete Rollen: Globaler Administrator | 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 J
currency String J
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 J
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.

Beispiel für eine Anfrage

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