订单 API

渠道方通过 S2S 提交采购订单并查询履约状态。创建成功后返回平台order_code，初始状态为 PENDING_REVIEW（待审核）。

概述

接口路径前缀：/open/v1/order

鉴权说明

继承开放平台 S2S 中间件（AppKey + 签名）。完整算法见鉴权说明。

创建订单

渠道方提交收货信息及商品明细，系统校验 goods_code 有效性后创建订单。logistics_type 未传时默认 EXPRESS_DELIVERY，postage_policy 未传时默认 FREE_SHIPPING。

请求体（application/json）：

items 单项：

请求示例：

POST /open/v1/order/create
X-App-Id: 100023
X-Timestamp: 1743494400
X-Signature: ...
Content-Type: application/json

{
  "third_order_id": "PARTNER-ORD-20260720-001",
  "contact_person": "张三",
  "contact_phone": "13800138000",
  "area_text": "上海市浦东新区",
  "address": "世纪大道 1 号",
  "logistics_type": "EXPRESS_DELIVERY",
  "postage_policy": "FREE_SHIPPING",
  "items": [
    {
      "goods_code": "GOODS-BP-001",
      "quantity": 2,
      "unit_price": 19900
    }
  ]
}

成功响应（201 Created）：

{
  "success": true,
  "code": 0,
  "message": "订单创建成功",
  "data": {
    "id": 10001,
    "order_code": "ORD-X20260720ABCDEF",
    "order_time": "2026-07-20 15:30:00"
  },
  "timestamp": "2026-07-20T15:30:00+08:00"
}

data 字段说明：

查询订单详情

通过平台订单编码 order_code 查询订单完整信息，含商品明细列表。

查询参数：

请求示例：

GET /open/v1/order/detail?order_code=ORD-X20260720ABCDEF
X-App-Id: 100023
X-Timestamp: 1743494400
X-Signature: ...

成功响应（200 OK）：

{
  "success": true,
  "code": 0,
  "message": "查询成功",
  "data": {
    "order_code": "ORD-X20260720ABCDEF",
    "order_time": "2026-07-20 15:30:00",
    "order_status": "PENDING_REVIEW",
    "order_source": "API_INTERFACE",
    "cooperation_type": "PURCHASE",
    "user_id": null,
    "third_order_id": "PARTNER-ORD-20260720-001",
    "contact_person": "张三",
    "contact_phone": "13800138000",
    "area_code": null,
    "area_text": "上海市浦东新区",
    "address": "世纪大道 1 号",
    "logistics_type": "EXPRESS_DELIVERY",
    "postage_policy": "FREE_SHIPPING",
    "postage_amount": 0,
    "items": [
      {
        "id": 1,
        "goods_id": 100,
        "goods_code": "GOODS-BP-001",
        "goods_name": "示例血压计",
        "quantity": 2,
        "unit_price": 19900,
        "total_price": 39800,
        "shipping_status": "PENDING_SHIPMENT"
      }
    ],
    "created_at": "2026-07-20 15:30:00",
    "updated_at": "2026-07-20 15:30:00"
  },
  "timestamp": "2026-07-20T15:31:00+08:00"
}

data 主要字段：

items 单项：

发货回调说明

平台发货确认后，会将物流及设备 SN 等信息异步推送到合作方已配置的 Webhook 端点。 生产环境由内部服务触发（非渠道方主动调用）。

错误码