創(chuàng)建采購單,返回采購單號,具體訂單創(chuàng)建結果由消息側通知。訂單創(chuàng)建完成之后,客戶可以通過訂單接口查詢采購單下附屬的訂單信息。
接口說明
創(chuàng)建采購單,返回采購單號,具體訂單創(chuàng)建結果由消息側通知。訂單創(chuàng)建完成之后,客戶可以通過訂單接口查詢采購單下附屬的訂單信息。
警告 請注意,因采購單創(chuàng)建為異步任務,如分銷商調用本接口返回異常時(如 503 錯誤碼),建議勿立即執(zhí)行業(yè)務側的 toC 退款;請分銷商等待并消費 PurchaseOrderCreate 消息(采購單創(chuàng)建結果消息)后正常判斷訂單狀態(tài)(如消費訂單狀態(tài)同步消息判斷訂單狀態(tài))后再處理業(yè)務邏輯,以免造成資損。
注意 調用采購單創(chuàng)建接口后如未接收到 PurchaseOrderCreate 消息(采購單創(chuàng)建結果消息),請在技術對接群中提交工單查詢原因。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求語法
POST /opensaas-s2b/opensaas-s2b-biz-trade/v2/purchaseOrders HTTP/1.1
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
body | PurchaseOrderCreateCmd | 是 | 創(chuàng)建采購單 |
{
"outerPurchaseOrderId": "outer00****0",
"deliveryAddress": {
"divisionCode": "610102",
"addressDetail": "陜西省西安市***大廈",
"receiverPhone": "187****1553",
"receiver": "閆先生",
"townDivisionCode": "61010212"
},
"buyerId": "yt12345085",
"productList": [
{
"quantity": 1,
"productId": "6600622091****6736",
"purchaserId": "PID2****09",
"skuId": "6600622091****6737"
}
]
}
返回參數(shù)
{
"requestId": "48A34399-A72C-1E23-8388-7E63****E927",
"purchaseOrderId": "6696070481****5680"
}
示例
正常返回示例
JSON
格式
{
"purchaseOrderId": "6692****5696",
"requestId": "841471F6-5D61-1331-8C38-2****B55"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2023-09-18 | API 內部配置變更,不影響調用 | 查看變更詳情 |