1.POST 物流下单

POST {请求地址}/apicenter/api/order/shippingPackages

2.请求参数

名称 位置 类型 必选 说明
wms_order_id body int 是 ERP订单id
order_number body string 否· wms单号
packages_qty body int 是 包裹数
packages_detail body array 是 包裹详情
-package_id body string 是 包裹id
-weight body string 是 包裹实际重量（cm）
-length body string 是 包裹实际长度（cm）
-width body string 是 包裹实际宽度（cm）
-height body string 是 包裹实际高度（cm）
-items body array 是 包裹内的商品信息
-‌-sku body string 是 sku
-‌-qty body int 是 数量
-‌-sn_list body Array(String) 否 sn 
  1. {
  2.     "wms_order_id": 4622372,
  3.     "order_number": "test-order-2026-shiptype4-0323002-1",
  4.     "packages_qty": 2,
  5.     "operator_code": "YH-WMS2026",
  6.     "packages_detail": [
  7.         {
  8.             "package_id": "type4-PKG001",
  9.             "weight": 15,
  10.             "length": 20,
  11.             "width": 15,
  12.             "height": 10,
  13.             "items": [
  14.                 {
  15.                     "sku": "0.02.3660",
  16.                     "qty": 1,
  17.                     "sn_list": [""]
  18.                 }
  19.             ]
  20.         },
  21.         {
  22.             "package_id": "type4-PKG002",
  23.             "weight": 15,
  24.             "length": 20,
  25.             "width": 15,
  26.             "height": 10,
  27.             "items": [
  28.                 {
  29.                     "sku": "0.02.3660",
  30.                     "qty":1,
  31.                     "sn_list": [""]
  32.                 }
  33.             ]
  34.         }
  35.     ]
  36. }

返回示例

200 Response

  1. {
  2.     "code": 200,
  3.     "data": [
  4.         {
  5.             "success": true,
  6.             "tracking_number": "1ZJ20R680303361169",
  7.             "service_code": "labelsday-UPS Ground",
  8.             "package_id": "type4-PKG001",
  9.             "shipping_label_url": "",
  10.             "carrier_code": "ups"
  11.         },
  12.         {
  13.             "success": true,
  14.             "tracking_number": "1ZJ20R680316052559",
  15.             "service_code": "labelsday-UPS Ground",
  16.             "package_id": "type4-PKG002",
  17.             "shipping_label_url": "",
  18.             "carrier_code": "ups"
  19.         }
  20.     ],
  21.     "message": "success"
  22. }

3.返回结果

状态码 状态码含义 说明 数据模型
200 OK 成功 Inline

4.返回数据结构

状态码 200

名称 类型 中文名 说明
» code integer true none
» data Array true none
-success string 状态
-tracking_number string 跟踪号
-service_code string 运输服务
-package_id string 包裹id
-shipping_label_url string 面单url
-carrier_code string 承运商代码
» message string true

3.异常情况示例

  1. {
  2.     "code": 500,
  3.     "message": "交运模式有误"
  4. }