API
出库订单状态变更事件
更新时间： 2024-10-30 11:42:58 访问次数：3117

事件名称：EVENT_ORDER_STATUS_UPDATE_V1

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

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

字段说明

请求

名称 类型 必填 字段 说明
uniqueId String(50) Y 唯一标识
orderType String(50) Y 订单类别 WO：出库订单
orderNo String(128) Y Winit订单号 示例：出库-WO6149999999
status String(50) Y 订单状态 见附录
statusTime Long Y 状态变更的时间 yyyy-MM-dd HH:mm:ss 格式
时间戳
orderWarehouseCode String(128) Y 下单仓库
warehouseCode String(128) Y 实际发货仓库编码 orderType为出库订单时，必传
US0001
outboundTime Long O 出库时间 orderType为出库订单时，才会回传
winitProductName String（64） O 下单WINIT产品名称 orderType为出库订单时，才会回传
winitProductCode String（64） O 下单WINIT产品编码 orderType为出库订单时，才会回传
actualWinitProductCode String（64） Y 实际发货WINIT产品编码 orderType为出库订单时，才会回传
actualWinitProductName String（64） Y 实际发货WINIT产品名称 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 Array O 订单对应的费用信息列表 orderType为出库订单时，才会展示数据
- chargeCode String（64） O 费用项编码
- chargeName String（64） O 费用项名称
- priceCardType String(32) O 费用类型 PSCG：库内费用
PSC：尾程费用
VAS：增值服务费用
- chargeNode String(32) O 计费节点 CF：出库确认
TSC：暂存完成
DLI：派送中
HPO：移交邮局
DLC：派送完成
DLF：派送失败
EIC：异常确认中
DSC：销毁完成
OBC：出库完成
VO：已作废
- serviceCode String（32） O 服务编码 当费用类型(priceCardType)为VAS时，有值
如：OSF8V1500
- serviceName String（128） O 服务名称 当费用类型(priceCardType)为VAS时，有值
如：优先当天出库
- 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 O 订单对应的装箱容器信息列表 当orderType为出库订单时，才展示数据
- trackingNo String（64） O 跟踪号
- 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 条码 当入库是单件商品（箱产品或单一产品）的包裹（入库包裹等级为A+），且贴有第三方箱号，出库时可能会扫描第三方箱号，返回：三方箱号
未扫描到第三方箱号有Winit箱号，返回：Winit箱号
未扫描到第三方箱号且无Winit箱号时，返回：NO_BARCODE
- - 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.     "actualWinitProductCode": "OSF811006991",
  3.     "actualWinitProductName": "UPS - Ground (Standard 1-5 Business Days)-US",
  4.     "carrierName": "UPS",
  5.     "isShortage": "N",
  6.     "orderNo": "WO0000000731",
  7.     "orderType": "WO",
  8.     "orderWarehouseCode": "US0001",
  9.     "sellerNo": "sss",
  10.     "status": "CF",
  11.     "statusTime": 1730806742300,
  12.     "subOrderNo": "WO0000000731B",
  13.     "subOrderStatus": "CF",
  14.     "trackingNoList": [
  15.         "989890933436031125"
  16.     ],
  17.     "transactionIdList": [
  18.         null
  19.     ],
  20.     "uniqueId": "69e93439b15546359bbe64d7d4173f35",
  21.     "warehouseCode": "USWC2",
  22.     "winitProductCode": "OSF811006991",
  23.     "winitProductName": "UPS - Ground (Standard 1-5 Business Days)-US"
  24. }

出库-缺量场景

  1. {
  2.     "actualWinitProductCode": "OSF811006991",
  3.     "actualWinitProductName": "UPS - Ground (Standard 1-5 Business Days)-US",
  4.     "carrierName": "UPS",
  5.     "orderNo": "WO0000000731",
  6.     "orderType": "WO",
  7.     "orderWarehouseCode": "US0001",
  8.     "sellerNo": "sss",
  9.     "status": "CF",
  10.     "statusTime": 1730806742300,
  11.     "subOrderNo": "WO0000000731B",
  12.     "subOrderStatus": "CF",
  13.     "trackingNoList": [
  14.         "989890933436031125"
  15.     ],
  16.     "transactionIdList": [
  17.         null
  18.     ],
  19.     "uniqueId": "69e93439b15546359bbe64d7d4173f35",
  20.     "warehouseCode": "USWC2",
  21.     "winitProductCode": "OSF811006991",
  22.     "winitProductName": "UPS - Ground (Standard 1-5 Business Days)-US"
  23.       "isShortage":"Y",
  24.     "estimateItemQty":2,
  25.     "actualItemQty":1,
  26.     "merchandiseList":[
  27.         {
  28.             "merchandiseCode":"sku_005",
  29.             "specification":"",
  30.             "estimateQty":2,
  31.             "actualQty":1,
  32.             "shortageQty":1
  33.         }
  34.     ]
  35. }

出库-作废场景

  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：已作废

voidType订单异常原因

出库单作废，原因如下：

CV：客户作废

OTV：处理超时作废

EXV：库存寻找中作废

WILV：仓库库存丢失作废

GLFV：抓面单失败作废

BBV：买家黑名单作废

SCFV：SU策略匹配失败作废

GLFOTV：抓面单失败超时作废

SCFOTV：SU策略匹配失败超时作废

OWIV：出库超重拦截作废

SOTV：缺量订单确认不同意出库作废

TSCV：暂存后客户要求作废

关键词