API
出库订单状态变更事件
更新时间： 2024-05-07 22:13:41 访问次数：2798

事件名称：EVENT_ORDER_STATUS_UPDATE_V1
事件说明：出库订单、ISP订单状态变更，推送给当前应用 （本应用提交的订单才会被推送）

出库订单除了通知状态变更，还会告知是否缺量出库，出库费用，出库装箱容器等信息
ISP此事件仅通知订单状态变更

字段说明

请求

名称 类型 必填 字段 说明
uniqueId String(50) Y 唯一标识
orderType String(50) Y 订单类别 WI：入库订单
WO：出库订单
ISP：ISP订单
orderNo String(128) Y Winit订单号 示例：入库-WI28888888；出库-WO6149999999；
status String(50) Y 订单状态 见附录
statusTime Long Y 状态变更的时间 yyyy-MM-dd HH:mm:ss 格式
北京时间
warehouseCode String(128) Y 仓库编码 orderType为出库订单时，必传
US0001
outboundTime Long O 出库时间 orderType为出库订单时，才会展示数据
winitProductName String（64） O 下单PSC名称 orderType为出库订单时，才会展示数据
winitProductCode String（64） O 下单PSC编码 orderType为出库订单时，才会展示数据
carrierName String（64） O 派送公司名称 orderType为出库订单时，才会展示数据
transationIdList Array O transationId集合 orderType为出库订单时，才会展示数据
subOrderNo String(128) Y 子单号 orderType为出库订单时，必传
WO6202251117407A
subOrderStatus String(128) Y 子单状态 orderType为出库订单时，必传
trackingNoList Array Y 子单对应的跟踪号列表 orderType为出库订单时，必传
[“111111”,
“222222”,
“33333”]
isShortage String(1) Y 是否缺量 orderType为出库订单时，必传
Y
estimateItemQty int O 子单总的预计出库单品数 只有当isShortage为Y时，才会展示数据
actualItemQty int O 子单总的实际出库单品数 只有当isShortage为Y时，才会展示数据
merchandiseList Array O 子单对应的商品信息 只有当isShortage为Y时，才会展示merchandiseList列表
-|merchandiseCode String(128) O 商品编码 sku_005
-|specification String(128) O 规格
-|estimateQty int O 预计出库单品数 2
-|actualQty int O 实际出库单品数 1
-|shortageQty Int O 缺量出库单品数 1
isVoidedByWinit String(1) O 是否winit作废 子单状态subOrderStatus为VO时，才会展示数据
voidOperator String(128) O 作废人 子单状态subOrderStatus为VO时，才会展示数据
preOrderStatus String(50) O 作废前订单状态 子单状态subOrderStatus为VO时，才会展示数据
voidType String（1） O 终止/作废类型 子单状态subOrderStatus为VO时，才会展示数据
mark String（1） O 备注/原因 子单状态subOrderStatus为VO时，才会展示数据
sellerNo String(32) O 卖家订单号 子单状态subOrderStatus为VO时，才会展示数据
orderFeeList

订单对应的费用信息列表 orderType为出库订单时，才会展示数据
-|chargeCode String（64） O 费用项编码
-|chargeName String（64） O 费用项名称
-|priceCardType String(32) O 费用类型 PSCG：库内费用
PSC：尾程费用
SU：
STORAGE：
-|chargeNode String(32) O 计费节点 CF：出库确认
TSC：暂存完成
DLI：派送中
HPO：移交邮局
DLC：派送完成
DLF：派送失败
EIC：异常确认中
DSC：销毁完成
OBC：出库完成
VO：已作废
-|chargeDescription String（128） O 收费说明
-|settlementAmount BigDecimal(16,4) O 结算金额
-|settlementCurrency String（32） O 结算金额币种
-|rebateAmount BigDecimal(16,4) O 返利金额
-|rebateCurrency String（32） O 返利金额币种
-|discountAmount BigDecimal(16,4) O 折扣金额
-|discountCurrency String（32） O 折扣金额币种
orderContainerList Array
订单对应的装箱容器信息列表 当orderType为出库订单时，才展示数据
-|containerSerno String（128） O 容器条码
-|containerLength BigDecimal(16,6) O 容器的长
-|containerWidth BigDecimal(16,6) O 容器的宽
-|containerHeight BigDecimal(16,6) O 容器的高
-|containerWeigh BigDecimal(16,6) O 容器的重量
-|containerType String（32） O 容器类型 PACKAGE：包裹
PALLET：托盘
ASSEMBLE：组套
-|parentContainerSerno String（64） O 父级容器条码 容器有层级关系，该字段标识当前容器被放置在哪个外层容器中。
例：托盘出库出一个托，托盘容器号为PT01，在该托盘下有两个包裹（B01，B02），这两个包裹的父级容器条码为PT01
-|merchandiseList Array O 容器下对应的商品信息 出库单场景下，如果当前容器里面还有子容器，并且除子容器之外还装有零散SKU，则该列表中有值。
例：托盘出库一个托PT01，该托盘上放了两个包裹B01、B02（B01中装有SKU M03，B02中装有SKU M04），并且还有两个零散SKU（M01，M02）未放入包裹，则当前容器商品列表中会放入M01，M02。在B01容器下的商品列表中则会有M03，B02容器下的商品列表中会有M04。
-|-|merchandiseCode String（64） O 商品编码
-|-|specification String（64） O 商品规格
-|-|skuType String（32） O sku类型 SINGLE：单一产品
SUITE：套装产品
BOX：箱产品
-|-|outboundQuantity int O 出库数量 SKU类型为单一产品时，件数SI
SKU类型为箱套产品时，套数或箱数
-|-|skuStandardQuantity int O 库存单元标准件数 SKU类型为箱套产品时，单品件数=出库数量x库存单元标准件数
-|-|merchandiseGrade String (128) O 商品等级 GOOD：良品
DEFECTIVE：不良品
-|-|details Array N 出库商品详情
-|-|-|barcode String(128) N 条码
-|-|batchList Array N 出库商品批次信息
-|-|-|packingBatchNo String (128) N 批次号
-|-|-|batchDate String (32) N 批次日期

返回

注：返回success即可，无需加引号逗号等其他信息

名称 类型 字段 说明
success String(7) 接收成功 消息接收成功
fail String(4) 接收失败 消息接收失败

示例

解密后报文示例

订单仅状态变更场景

  1. {
  2.   "orderNo":"ID15290000000022ZZ",
  3.   "orderType":"ISP",
  4.   "status":"AO",
  5.   "statusTime":1658386504000
  6. }

出库-非缺量场景

  1. {
  2.     "orderNo":"WO6202251117407",
  3.     "orderType":"WO",
  4.     "status":"DLC",
  5.     "statusTime":1660118978433,
  6.     "uniqueId":"b4189525-f6a0-44d8-89be-336b2e399aca",
  7.     "subOrderNo":"WO6202251117407A",
  8.     "warehouseCode":"US0001",
  9.     "subOrderStatus":"DLI",
  10.     "trackingNoList":[
  11.         "111111",
  12.         "222222",
  13.         "33333"
  14.     ],
  15.     "isShortage":"N"
  16. }

出库-缺量场景

  1. {
  2.     "orderNo":"WO6202251117407",
  3.     "orderType":"WO",
  4.     "status":"DLC",
  5.     "statusTime":1660118978433,
  6.     "uniqueId":"b4189525-f6a0-44d8-89be-336b2e399aca",
  7.     "subOrderNo":"WO6202251117407A",
  8.     "warehouseCode":"US0001",
  9.     "subOrderStatus":"DLI",
  10.     "trackingNoList":[
  11.         "111111",
  12.         "222222",
  13.         "33333"
  14.     ],
  15.       "isShortage":"Y",
  16.     "estimateItemQty":2,
  17.     "actualItemQty":1,
  18.     "merchandiseList":[
  19.         {
  20.             "merchandiseCode":"sku_005",
  21.             "specification":"",
  22.             "estimateQty":2,
  23.             "actualQty":1,
  24.             "shortageQty":1
  25.         }
  26.     ]
  27. }

出库-作废场景

  1. {
  2.     "isVoidedByWinit":"Y",
  3.     "voidOperator":"Winit",
  4.     "mark":"库存缺失数量：20460698*1",
  5.     "orderNo":"WO6209722365",
  6.     "orderType":"WO",
  7.     "status":"VO",
  8.     "statusTime":1660629621925,
  9.     "uniqueId":"dbd5beb3-5f32-45b3-b690-20bcd794bebc",
  10.     "voidType":"EXV"
  11. }

开发者返回的示例

  1. success

附录

status订单状态

出库单状态变更，状态包含：
CF：出库确认
PKC：拣选完成
PAC：打包完成
TSC：暂存完成
DLI ：派送中
DLC ：派送完成
DLF ：派送失败
HPO：移交邮局
OBC：出库完成
DSC：销毁完成
EX：异常
VOI：作废处理中
VO：已作废
ISP订单状态变更，状态包含：
WFR：确认发货
CFS：已揽收
PC：已打包
AO：已出库
VO：作废
PUF：揽收失败
EX：订单异常

voidType订单异常原因

ISP单作废：
暂无类型及原因
出库单作废，原因如下：
CV：客户作废
OTV：处理超时作废
EXV：库存寻找中作废
WILV：仓库库存丢失作废
GLFV：抓面单失败作废
BBV：买家黑名单作废
SCFV：SU策略匹配失败作废
GLFOTV：抓面单失败超时作废
SCFOTV：SU策略匹配失败超时作废
OWIV：出库超重拦截作废
SOTV：缺量订单确认不同意出库作废
TSCV：暂存后客户要求作废

关键词