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

事件名称: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:暂存后客户要求作废

关键词