Вложение заказа на покупку и указание сведений о заказе на покупку
Соответствующие роли: агент по администрированию
Партнерам может потребоваться предоставить заказ на покупку клиента и (или) запрос на предложение (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 | Файлы | Y | |
TenderFiles | Файлы | Да/нет | Если 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
Если транзакция требует отправки заказа на покупку после завершения партнером создания заказа или получения заказа, будет получен следующий ответ.
Коды успешного выполнения и ошибок в ответе
Каждый ответ поставляется с кодом состояния 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"}}