附加采购订单并填写采购订单详细信息

项目
09/28/2024

相应的角色：管理员代理

合作伙伴可能需要提供客户采购订单和/或招标或提案请求（RFP）信息才能在合作伙伴中心内完成交易。本文介绍如何合作伙伴使用合作伙伴中心以编程方式附加采购订单。

先决条件

合作伙伴中心身份验证中所述的凭据。此方案支持使用独立应用和 App+User 凭据进行身份验证。

请求语法

方法	请求 URI
POST	{baseURL}/v1/customers/{customerid}/orders/{orderid}/attachment

URI 正文参数

使用以下正文参数返回采购订单状态。

名称	类型	必需	说明
isPartofTender	布尔值	N	客户招标或提案请求（RFP）的订单部分。
customerPrice	十进制/字符串	Y
currency	字符串	Y
fxRate	十进制/字符串	N
tenderLink	字符串	Y/N	如果 isPartOfTender 为 true 且未提供招标文件，则这是必需的，否则不是必需的。
POfiles	文件	Y
TenderFiles	文件	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"}}

通过