附加采购订单并完成采购订单详细信息
相应的角色全局管理员 | 管理员代理
合作伙伴可能需要提供客户采购订单和/或 RfP (或请求) 以完成 合作伙伴中心。 本文介绍合作伙伴如何使用 合作伙伴中心以编程方式附加采购订单。
必备条件
- 合作伙伴中心身份验证中所述的凭据。 此方案支持使用独立应用和 App+User 凭据进行身份验证。
请求语法
| 方法 | 请求 URI |
|---|---|
| POST | {baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment |
URI 正文参数
使用以下正文参数返回采购订单状态。
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| isPartofTender | 布尔值 | N | RFP 客户请求或 RFP (的订单部分) 。 |
| customerPrice | Decimal/string | Y | |
| 货币 | 字符串 | Y | |
| fxRate | Decimal/string | N | |
| 将进行链接 | 字符串 | Y/N | 如果 isPartOfTender 为 true 且未提供任何文件,则此为必需项,否则不是必需的。 |
| POfiles | 文件 | Y | |
| Files | 文件 | Y/N | 如果 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"}}