Вложение заказа на покупку и указание сведений о заказе на покупку

Статья
01/02/2024

Соответствующие роли: глобальный администратор | агент по администрированию

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

Необходимые компоненты

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

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

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

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

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

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

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

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

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

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

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

Коды успешного выполнения и ошибок в ответе

Каждый ответ поставляется с кодом состояния 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"}}

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