Присоединение заказа на покупку и заполнение его деталей

Статья
03/07/2025

Соответствующие роли: агент по администрированию

Партнерам может потребоваться предоставить покупательский заказ и/или запрос предложения (RFP), чтобы завершить транзакцию в Центре партнеров. В этой статье описывается, как партнеры могут использовать Центр партнеров для программного присоединения заказов на покупку.

Предварительные условия

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью автономных учетных данных приложения и учетных данных приложения и пользователя.

Синтаксис запроса

Способ	URI запроса
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/вложение

Параметр основного кода ресурса (URI)

Используйте следующие параметры тела для получения статусов заказа на покупку.

Имя.	Тип	Обязательно	Описание
являетсяЧастьюТендера	Boolean	N	Является ли заказ частью тендера или запроса на предложение (RFP) клиента?
ценаЗаказчика	десятичное/строковое	Y
валюта	Строка	Y
fxRate	Десятичное/строковое	N
tenderLink	Строка	Да/нет	Если isPartOfTender имеет значение true, и не предоставляются файлы тендеров, то это необходимо, в противном случае не требуется.
POfiles	Файлы	Y
TenderFiles	Файлы	Да/нет	Если isPartOfTender имеет значение true, но ссылка на тендер не указана, это является обязательным; иначе не требуется.

Заголовки запросов

Дополнительные сведения см. в разделе заголовки REST API Центра партнеров.

Пример запроса

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

Если транзакция требует отправки заказа на покупку после завершения партнером создания заказа или получения заказа, будет получен следующий ответ.

Коды успеха и ошибок в ответе

Каждый ответ поставляется с кодом состояния HTTP, который указывает на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. См. полный список кодов ошибок.

Пример ответа

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

Поделиться через