1.1. 入库反馈推送接口

1.1.1. 反馈地址配置

img.png
img.png
img.png

1.1.2. SERVICE_TYPE

PUSH_ASN_ORDER

1.1.3. 推送消息内容

参数 是否必须 类型 示例 备注
asnNumber Y String “A230109129883” 入库单号
trackNumber N String 跟踪单号
skuList Y List<Sku> Sku收货数据
status Y String 入库单状态 FINISHED 已完成 CLOSED 已关闭 RECEIVING 收货中且收货数大于0
finishedTime Y Date 入库单完成时间条件必传，仅当status=FINISHED时传值
customNumber N String 参考号
snInfo N SNInfo SN信息
remark N String 备注

Sku

参数 是否必须 类型 示例 备注
quantity Y Number 100 收货数量
sku Y String Sku 商品sku
batchNo N String 批次号，仅对千易wms生效
mfgDate N String 2025-10-01 生产日期，仅对千易wms生效
expDate N String 2025-10-01 失效日期，仅对千易wms生效
originCountry N String CN 生产地国家，仅对千易wms生效

SNInfo(SN信息)

参数 是否必须 类型 示例 备注
snUrl N String sn excel附件URL

推送示例（默认form-data格式）：

JSON格式： {"appId":"TEST","bizParam":"{\"asnNumber\":\"A250619145545\",\"customNumber\":\"2025061900007\",\"status\":\"RECEIVING\",\"trackNumber\":\"CGDD0000787\",\"skuList\":[{\"sku\":\"LIP005\",\"quantity\":1},{\"quantity\":1,\"sku\":\"LIP005\"}]}","serviceType":"PUSH_ASN_ORDER","timestamp":"1754016113505","sign":"77fd745547a99d46cf5d2f17697a7c6e"}

FORM-DATA格式： {appId=1111-3, bizParam={"asnNumber":"A250731147584","customNumber":"1000832922","finishedTime":1753942939000,"skuList":[{"damageNum":0,"goodNum":9,"quantity":9,"sku":"PPB24700027"}],"status":"FINISHED","trackNumber":"4700041511"}, serviceType=PUSH_ASN_ORDER, timestamp=1753942939728, sign=8f40f3de6778c990bc7b762314b182ac}

1.2. 出库反馈推送接口

订单,出库单在erp发生状态流转,或接收到仓库的出库回调(即便没有发生状态变更)时,会调用该接口。需在三方应用配置反馈地址，并勾选「出库反馈推送」

推送外层字段与其它 Webhook 一致：appId、serviceType、timestamp、sign、bizParam。默认 form-data，空字段不返回。如需 JSON 请联系千易开白名单。反馈地址配置方式同「入库反馈推送接口」。

1.2.1. SERVICE_TYPE

PUSH_ODO_ORDER

1.2.2. 推送消息内容（bizParam）

参数 是否必须 类型 示例 备注
orderNumber Y String A20220905 出库单号，与 number 相同
customNumber N String C20220905 客户参考号
trackNumber N String T20220905 运单号，有则传
warehouseName Y String 马来仓库 出库仓库名称
type Y String MANUAL 库内出库单类型原值，不是查询接口的展示类型。常见值：ORDER（销售订单出库）、MANUAL（手工出库）、TRANSFER（调拨 / 头程计划，头程不会推 FIRST_LEG）、PURCHASE_RETURN（采购退货）、LABEL_REPLACEMENT（换标）、OTHER（OpenAPI 创建）、ASSEMBLY（加工单）、RESTORE（拆分单）、SHIP_ORDER（全托管）、MANUAL_TOB、DIR_STORE_TRANSFER（直营店调拨）
status Y String SHIPPED 仓库原始状态转大写，不是查询接口的 WAIT_OUTBOUND / FINISHED。常见值：SHIPPED（已发货）、PACKED（已打包）、DELIVERED（WMS 2.0 已发货）、WMS_PICK / WMS_PACKAGE / WMS_WEIGH（作业中）、VOIDED / CANCELED（取消）、ERROR / EXCEPTION（异常）
erpStatus Y String SUCCESS erp状态 SENDING待发货/SUCCESS已发货/CANCEL已取消/FAILED失败
shippingTime N Number 1662364800000 发运时间，毫秒时间戳；无则不返回
carrier N String J&T Express 承运商
skuList Y List<Sku> 见下方示例 出库 SKU
snInfo N SNInfo 见下方示例 有 SN 信息时返回

Sku

参数 是否必须 类型 示例 备注
sku Y String S90 商品 SKU
title Y String 商品标题 商品标题
quantity Y Long 100 实际出库的良品数量
unavailableQuantity N Long 50 实际出库的不良品数量
apiCustom N String 创建时透传字段，无则不返回

SNInfo(SN信息)

参数 是否必须 类型 示例 备注
snUrl N String https://oss.example.com/sn/A20220905.xlsx WMS 下发的 SN excel 附件 URL
orderType N String SN 单据类型，有则返回

bizParam 解析示例：

{
  "orderNumber": "A20220905",
  "number": "A20220905",
  "customNumber": "C20220905",
  "trackNumber": "T20220905",
  "warehouseName": "马来仓库",
  "type": "MANUAL",
  "status": "SHIPPED",
  "shippingTime": 1662364800000,
  "carrier": "J&T Express",
  "skuList": [
    {
      "sku": "S90",
      "title": "商品标题",
      "quantity": 100,
      "unavailableQuantity": 50
    }
  ],
  "snInfo": {
    "snUrl": "https://oss.example.com/sn/A20220905.xlsx"
  }
}

推送示例（默认form-data格式）：

JSON格式： {"appId":"TEST","bizParam":"{\"orderNumber\":\"A20220905\",\"number\":\"A20220905\",\"customNumber\":\"C20220905\",\"trackNumber\":\"T20220905\",\"warehouseName\":\"马来仓库\",\"type\":\"MANUAL\",\"status\":\"SHIPPED\",\"shippingTime\":1662364800000,\"carrier\":\"J&T Express\",\"skuList\":[{\"sku\":\"S90\",\"title\":\"商品标题\",\"quantity\":100,\"unavailableQuantity\":50}],\"snInfo\":{\"snUrl\":\"https://oss.example.com/sn/A20220905.xlsx\"}}","serviceType":"PUSH_ODO_ORDER","timestamp":"1662364800000","sign":"sample-sign"}

FORM-DATA格式： {appId=TEST, bizParam={"orderNumber":"A20220905","number":"A20220905","customNumber":"C20220905","trackNumber":"T20220905","warehouseName":"马来仓库","type":"MANUAL","status":"SHIPPED","shippingTime":1662364800000,"carrier":"J&T Express","skuList":[{"sku":"S90","title":"商品标题","quantity":100,"unavailableQuantity":50}],"snInfo":{"snUrl":"https://oss.example.com/sn/A20220905.xlsx"}}, serviceType=PUSH_ODO_ORDER, timestamp=1662364800000, sign=sample-sign}

1.3. 订单物流信息推送接口

1.3.1. SERVICE_TYPE

PUSH_SALES_ORDER_SHIPPING_INFO

1.3.2. 推送消息内容

参数 是否必须 类型 示例 备注
orderNumber Y String “S200222115613” 系统订单号
onlineOrderNumber Y String 订单创建时设置的线上单号
trackingNumber Y String 运单号
carrier Y String 承运商
shippingTime Y Datetime 发货时间，"yyyy-MM-dd hh:mm:ss SSS"
status Y String 订单状态

推送示例（默认form-data格式）：

JSON格式： {"appId":"TEST","bizParam":"{\"carrier\":\"SHIPDOC\",\"onlineOrderNumber\":\"2507311347270601016525823\",\"orderNumber\":\"S250731147586\",\"shippingTime\":1754014435000,\"status\":\"WAIT_SHIP\",\"trackingNumber\":\"223243444\"}","serviceType":"PUSH_SALES_ORDER_SHIPPING_INFO","timestamp":"1754272685482","sign":"7cbc7305af85fb2eed308866c4fbaf89"}

FORM-DATA格式： {appId=1111-3, bizParam={"carrier":"SHIPDOC","onlineOrderNumber":"2507311347270601016525823","orderNumber":S250731147586,"shippingTime":1754014435000,"status":"WAIT_SHIP","trackingNumber":"223243444"}, serviceType=PUSH_SALES_ORDER_SHIPPING_INFO, timestamp=1754272685482, sign=7cbc7305af85fb2eed308866c4fbaf89}

1.4. 退货单完成信息推送接口

1.4.1. SERVICE_TYPE

PUSH_RETURN_ORDER_INFO

1.4.2. 推送消息内容

参数 是否必须 类型 示例 备注
returnNumber Y String “B200308115691” 退货单号
orderNumber Y String “S200222115613” 销售订单号
onlineOrderNumber Y String “DA200221115559” 关联线上单号
status Y String “FINISH” 状态
returnSkuList Y List<ReturnSku> 详见退货SKU

ReturnSku(退货SKU)

参数 是否必须 类型 示例 备注
sku Y String “abc” 商品SKU
orderSkuId Y Number 销售订单商品ID
quantity Y Number 1 实际退货数量

推送示例（默认form-data格式）：

JSON格式： {"serviceType":"PUSH_RETURN_ORDER_INFO","appId":"15167732016","sign":"b55826f1b417bd398aacf61aaa8abe23","bizParam":"{\"orderNumber\":\"THTZD000859\",\"returnSkuList\":[{\"orderSkuId\":45,\"quantity\":1,\"sku\":\"JCDF692024YH002\"}],\"onlineOrderNumber\":\"THTZD000859\",\"returnNumber\":\"B250801537077\",\"status\":\"WAIT_STORAGE\"}","timestamp":"1754033260116"}

FORM-DATA格式： {serviceType=PUSH_RETURN_ORDER_INFO,appId=15167732016,sign=b55826f1b417bd398aacf61aaa8abe23,bizParam={\"orderNumber\":\"THTZD000859\",\"returnSkuList\":[{\"orderSkuId\":45,\"quantity\":1,\"sku\":\"JCDF692024YH002\"}],\"onlineOrderNumber\":\"THTZD000859\",\"returnNumber\":\"B250801537077\",\"status\":\"WAIT_STORAGE\"},timestamp=1754033260116}

1.5. 物流跟踪状态变更推送接口

1.5.1. SERVICE_TYPE

PUSH_TRACKING_PACKAGE

1.5.2. 推送消息内容

Base

参数 是否必须 类型 示例 备注
orderNumber Y String “S230109129883” 系统单号
onlineOrderId Y String xsasx 线上订单号
trackingNumber Y String 运单号 11111
carrier Y String 承运商 LEX TH
status Y String CREATED 状态枚举

推送示例（默认form-data格式）：

JSON格式： {"appId":"1751530655877-10658", "bizParam":"{\"carrier\":\"J&T Express\",\"onlineOrderId\":\"579877366324626911\",\"orderNumber\":\"S2508053858595\",\"status\":\"CREATED\",\"trackingNumber\":\"762388742732\"}", "serviceType":"PUSH_TRACKING_PACKAGE", "timestamp":1754373394777, "sign":"c0fe6c3ab1a92831dffa5796fbf08a27"}

FORM-DATA格式： {appId=1751530655877-10658, bizParam={"carrier":"J&T Express","onlineOrderId":"579877366324626911","orderNumber":"S2508053858595","status":"CREATED","trackingNumber":"762388742732"}, serviceType=PUSH_TRACKING_PACKAGE, timestamp=1754373394777, sign=c0fe6c3ab1a92831dffa5796fbf08a27}

1.6. 订阅订单状态

1.6.1. SERVICE_TYPE

SUBSCRIBE_ORDER

1.6.2. 请求参数

字段名 字段描述 类型 必填 备注
orderType 订单类型 String 是 入库单：ASN
orderList 订单列表 Array 是
└ orderNumber 单号 String 是

1.6.3. 返回参数

参数 是否必须 类型 示例 备注
orderList Y Array 失败列表
└ orderNumber Y String 入库单号
└ errorMessage Y String 失败原因
© Copyright QianYi Team 2025 All Rights Reserved            Updated 2026-11-06 08:56:45

results matching ""

    No results matching ""