API

订单状态变更事件

更新时间： 0000-00-00 00:00:00 访问次数：2076

事件名称：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	出库数量
-\|-\|skuStandardQuantity	int	O	库存单元标准件数
-\|-\|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)	接收失败	消息接收失败

示例

解密后报文示例

订单仅状态变更场景

{
  "orderNo":"ID15290000000022ZZ",
  "orderType":"ISP",
  "status":"AO",
  "statusTime":1658386504000
}

出库-非缺量场景

{
    "orderNo":"WO6202251117407",
    "orderType":"WO",
    "status":"DLC",
    "statusTime":1660118978433,
    "uniqueId":"b4189525-f6a0-44d8-89be-336b2e399aca",
    "subOrderNo":"WO6202251117407A",
    "warehouseCode":"US0001",
    "subOrderStatus":"DLI",
    "trackingNoList":[
        "111111",
        "222222",
        "33333"
    ],
    "isShortage":"N"
}

出库-缺量场景

{
    "orderNo":"WO6202251117407",
    "orderType":"WO",
    "status":"DLC",
    "statusTime":1660118978433,
    "uniqueId":"b4189525-f6a0-44d8-89be-336b2e399aca",
    "subOrderNo":"WO6202251117407A",
    "warehouseCode":"US0001",
    "subOrderStatus":"DLI",
    "trackingNoList":[
        "111111",
        "222222",
        "33333"
    ],
      "isShortage":"Y",
    "estimateItemQty":2,
    "actualItemQty":1,
    "merchandiseList":[
        {
            "merchandiseCode":"sku_005",
            "specification":"",
            "estimateQty":2,
            "actualQty":1,
            "shortageQty":1
        }
    ]
}

出库-作废场景

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

开发者返回的示例

success

附录

status订单状态

入库单状态变更，状态包含：
IC：验货完成
RE：已收货
TS：运输中
PEWC：部分到仓
EWC：已到仓
SHD：已上架
STOP：终止
出库单状态变更，状态包含：
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：暂存后客户要求作废

关键词