字段说明

请求

名称	类型	必填	字段	说明
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)	接收失败	消息接收失败

示例

解密后报文示例

订单仅状态变更场景

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

出库-非缺量场景

{
    "actualWinitProductCode": "OSF811006991",
    "actualWinitProductName": "UPS - Ground (Standard 1-5 Business Days)-US",
    "carrierName": "UPS",
    "isShortage": "N",
    "orderNo": "WO0000000731",
    "orderType": "WO",
    "orderWarehouseCode": "US0001",
    "sellerNo": "sss",
    "status": "CF",
    "statusTime": 1730806742300,
    "subOrderNo": "WO0000000731B",
    "subOrderStatus": "CF",
    "trackingNoList": [
        "989890933436031125"
    ],
    "transactionIdList": [
        null
    ],
    "uniqueId": "69e93439b15546359bbe64d7d4173f35",
    "warehouseCode": "USWC2",
    "winitProductCode": "OSF811006991",
    "winitProductName": "UPS - Ground (Standard 1-5 Business Days)-US"
}

出库-缺量场景

{
    "actualWinitProductCode": "OSF811006991",
    "actualWinitProductName": "UPS - Ground (Standard 1-5 Business Days)-US",
    "carrierName": "UPS",
    "orderNo": "WO0000000731",
    "orderType": "WO",
    "orderWarehouseCode": "US0001",
    "sellerNo": "sss",
    "status": "CF",
    "statusTime": 1730806742300,
    "subOrderNo": "WO0000000731B",
    "subOrderStatus": "CF",
    "trackingNoList": [
        "989890933436031125"
    ],
    "transactionIdList": [
        null
    ],
    "uniqueId": "69e93439b15546359bbe64d7d4173f35",
    "warehouseCode": "USWC2",
    "winitProductCode": "OSF811006991",
    "winitProductName": "UPS - Ground (Standard 1-5 Business Days)-US"
      "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订单状态

出库单状态变更，状态包含：

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：暂存后客户要求作废

关键词