CreatePurchaseOrder - 创建采购单_企业商城 LinkedMall(LinkedMall)-阿里云帮助中心

创建采购单，返回采购单号，具体订单创建结果由消息侧通知。订单创建完成之后，客户可以通过订单接口查询采购单下附属的订单信息。

接口说明

创建采购单，返回采购单号，具体订单创建结果由消息侧通知。订单创建完成之后，客户可以通过订单接口查询采购单下附属的订单信息。

警告请注意，因采购单创建为异步任务，如分销商调用本接口返回异常时（如 503 错误码），建议勿立即执行业务侧的 toC 退款；请分销商等待并消费 PurchaseOrderCreate 消息（采购单创建结果消息）后正常判断订单状态（如消费订单状态同步消息判断订单状态）后再处理业务逻辑，以免造成资损。

注意调用采购单创建接口后如未接收到 PurchaseOrderCreate 消息（采购单创建结果消息），请在技术对接群中提交工单查询原因。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /opensaas-s2b/opensaas-s2b-biz-trade/v2/purchaseOrders HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	PurchaseOrderCreateCmd	是	创建采购单

{
  "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"
    }
  ]
}

返回参数

名称	类型	描述	示例值
	PurchaseOrderCreateResult	采购单创建结果（返回采购单号）。警告请注意，因采购单创建为异步任务，如分销商调用本接口返回异常时（如 503 错误码），建议勿立即执行业务侧的 toC 退款；请分销商等待并消费 PurchaseOrderCreate 消息（采购单创建结果消息）后正常判断订单状态（如消费订单状态同步消息判断订单状态）后再处理业务逻辑，以免造成资损。

{
  "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 内部配置变更，不影响调用	查看变更详情