查询入库单详情
更新时间: 2021-11-12 11:22:54 访问次数:16573
接口说明
通过入库单winit订单号,查询订单和包裹的详细信息。
请求说明
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
接口名 | winit.wh.inbound.getOrderDetail |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
orderNo | String(50) | Y | WINIT订单号 |
WI9900001290 |
isIncludePackage | String(10) | N | 返回结果是否包含包裹信息。Y-是,N-否,默认N。 | Y |
请求示例
{ "action": " winit.wh.inbound.getOrderDetail", "app_key": "rebecca", "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign":"3F66F76AE27E3B34991F24DA218CAF05", "data": { "orderNo": "WI9900001290", "isIncludePackage": "Y" }, "format": "json", "language": "zh_CN", "platform": "OWNERERP", "sign": "CBA010210F78629ECBEDB05BC1842BF5", "sign_method": "md5", "timestamp": "2017-09-09 10:17:52", "version": "1.0" }
返回出参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
orderNo | String(50) | Y | WINIT订单号 | |
orderType | String(20) | Y | 订单类型 SD-标准海外仓入库 DW-直发海外验入库 DI-直发国内验入库 |
|
status | String(20) | Y | 订单状态
DR-草稿:卖家创建草稿单 OD-已下单:卖家创建订单,但尚未发货。 RE-已收货: Winit承运,国内验货仓已收货。 IC-验货完成: ①标准海外仓入库和标准快递入库,国内验货仓验货完成。 ②自验,自验验货完成。 TS-运输中: ①Winit承运时,国内验货仓出库完成。 ②卖家直发时,卖家确认发货。 PEWC-部分到仓 :入库单内部分包裹在海外仓卸货。 EWC-已到仓 :入库单内所有无异常(丢失或终止)的包裹在海外仓卸货。 SHD-已上架:入库单内所有无异常(丢失或终止)的包裹在海外仓已上架。 VO-作废:已下单状态下作废的订单。 STOP-终止:运输中状态下终止的订单。 |
|
isCompleted | String(50) | Y | 订单是否完结 Y-是;N-否 Y-是的定义:包含以下两种场景:
(1)入库单内包裹状态全部[上架完成];
(2)入库单包裹存在[终止][丢失]状态,但不存在[上架异常区]状态,
并且最后一个包裹上架已经超过1个月。
背景:入库单状态切[已上架]后还可能发生上架,因为入库单完全完结,
需要有一个持续时间才能做到,尤其是以下(2)和(3)的场景。 (1)包裹[上架异常区]:异常待提增值处理,订单先切已上架,
后续异常处理完,继续原单上架。
(2)包裹[终止]:例如直发部分包裹未到仓,超过一定时间,
WINIT认为不会再到仓了执行终止包裹,订单先切已上架,
但是后续这部分包裹又到仓继续原单上架。
(3)包裹[丢失]:例如仓库先判定包裹丢失,并且已经赔付,
订单先切已上架,后续丢失找回,继续原单上架。
注意:即使是上架超过1个月被认定[订单完结],也无法确保100%后续
不会再有商品上架,因为上述(2)和(3)的场景也有可能
在上架超过1个月后仍然发生。 | |
inspectionWarehouseCode | String(50) | Y | 验货仓编码 | |
inspectionWarehouseName | String(50) | Y | 验货仓名称 | |
destinationWarehouseCode | String(50) | Y | 目的仓编码 | |
destinationWarehouseName | String(50) | Y | 目的仓名称 | |
createdDate | String(50) | Y | 创建时间 | 2016-09-09 09:50:54 |
sellerOrderNo | String(255) | Y | 客户订单号 | |
winitProductCode | String(50) | Y | WINIT产品编码 | |
winitProductName | String(60) | Y | WINIT产品名称 | |
planShelfCompletedDate | String(50) | Y | 目标上架时间 目标上架时间=实际到仓时间+SLA(北京时间) 假设实际到仓时间是2016-09-09 09:50:54,SLA是1,那么目标上架时间=2016-09-10 09:50:54 |
2016-09-09 09:50:54 |
shelveCompletedDate | String(50) | Y | 海外仓实际上架时间 北京时间 |
2019-06-03 17:44:4 |
totalPackageQty | Int | Y | 总包裹数 | |
totalMerchandiseQty | Int | Y | 总商品数 | |
totalItemQty | Int | Y | 总单品数 | |
logisticsPlanNo | String(50) | Y | 物流计划编码 | |
logisticsPlanName | String(50) | Y | 物流计划名称 | |
exporterCode | String(50) | Y | 出口商编码 | |
exporterName | String(50) | Y | 出口商名称 | |
importerCode | String(50) | Y | 进口商编码 | |
importerName | String(50) | Y | 进口商名称 | |
inspectionType | String(20) | Y | 验货类型
WI-验货仓验货 VI-上门验货 |
|
pickupType | String(20) | Y | 提货类型
P-Winit上门提货 S-自发物流 |
|
reservePickupDate | String(20) | Y | 预计提货日期 | 2016-09-11 |
reservePickupTime | String(20) | Y | 预计提货时间 | 12:00:00-15:00:00 |
pickupAddressCode | String(50) | Y | 提货/验货地址编码 | |
pickupAddress | String(255) | Y | 提货地址 | |
expressNo | String(100) | Y | 快递单号
提货类型为自发物流时会有快递单号 |
|
expressVendorCode | String(50) | Y | 发货承运编码
提货类型为自发物流时会有发货承运编码 |
|
expressVendorName | String(50) | Y | 发货承运人名称 提货类型为自发物流时会有发货承运人名称 |
|
importDeclarationRuleCode |
String(50) |
Y |
进口报关规则编码 |
|
importDeclarationRuleName |
String(50) |
Y |
进口报关规则编码名称 |
普通清关-第三方进口商 |
importDeclareValueType |
String(50) |
Y |
进口申报价值 IMPORTPRICE1-进口申报价值, IMPORTPRICE2-采购成本, CUSTOMS_IMPORTPRICE-海关建议申报价值 |
|
importDeclareWay |
String(50) |
Y |
报关方式
进口报关方式 Genenal——传统清关模式, Fiscal——电商清关模式, Bond——美国Bond模式 |
General |
importDeclarationType |
String(50) |
Y |
进口报关类型编码 |
|
importDeclarationName |
String(50) |
Y |
进口报关类型名称 |
|
customsDeclarationType |
String(50) |
Y |
出口报关类型编码 |
|
customsDeclarationName |
String(50) |
Y |
出口报关类型名称 |
|
packageList | 包裹列表 | |||
sellerCaseNo | String(50) | Y | 卖家箱号 | |
sellerHeight | Numberic(10,2) | 预估包裹高(CM) | ||
sellerLength | Numberic(10,2) | 预估包裹长(CM) | ||
sellerWeight | Numberic(10,4) | 预估包裹重量(KG) | ||
sellerWidth | Numberic(10,2) | 预估包裹宽(CM) | ||
packageNo | String(50) | 包裹条码 | ||
thirdPartyCaseNo | String(50) | 第三方包裹编号 | ||
status | String(50) | 包裹状态
DR:草稿 PI:已下单 RE:已收货 IS:已验货 VC:核验完成 TS:运输中 UD:已卸货 PS:部分上架 SCP:已上架 STOP:终止 Lost:已丢失 SAA:上架异常区 | ||
unloadingTime | String(50) | 包裹卸货时间 | ||
shelvesTime | String(50) | 包裹上架时间 | 2019-06-03 17:44:49 | |
height | Numberic(10,2) | 实际包裹高(CM) | ||
length | Numberic(10,2) | 实际包裹长(CM) | ||
weight | Numberic(10,4) | 实际包裹重量(KG) | ||
width | Numberic(10,2) | 实际包裹宽(CM) | ||
packageList.merchandiseList | 包裹中的商品信息 | |||
sku | String(50) | Winit商品条码(M码) | ||
merchandiseCode | String(255) | 卖家商品编码 | ||
specification | String(255) | 商品规格 | ||
quantity | Integer | 下单数量 | ||
inspectionQty | Number | 验货数量 | ||
actualQuantity | Number | 上架数量 |
||
merchandiseList |
以订单级依sku进行汇总的数量 | |||
productBarcode | String(255) |
商品条码
万邑通内商品条码与sku一对一对应 |
||
merchandiseCode | String(255) |
卖家商品编码 |
||
specification | String(255) | 商品规格 | ||
quantity | Number | 数量(下单数量) | ||
inspectionQty | Number | 验货数量 | ||
actualQuantity | Number | 实际上架数量 | ||
merchandiseList.skuCode3rdList | 第三方商品编码列表 | |||
thirdPartyCode | String() | 第三方商品编码 | ||
mark | String() | 说明 |
返回示例
{ "code": "0", "msg": "操作成功", "data": { "orderType": "SD", "sellerOrderNo": "AutoStandard air 222222", "destinationWarehouseCode": "US0001", "customsDeclarationName": "第三方出口商", "expressNo": "55555555", "winitProductName": "空运-普货", "totalItemQty": 4, "importDeclarationRuleName": "普通清关-第三方进口商", "totalMerchandiseQty": 2, "needReservationSendWh": "N", "expressVendorName": "龙邦", "inspectionWarehouseCode": "SZ0001", "importerName": "YIDA EXPRESS INC.", "importDeclarationType": "TIOR", "exporterCode": null, "orderNo": "WI9900001290", "importDeclareValueType": "IMPORTPRICE1", "totalPackageQty": 1, "inspectionWarehouseName": "ShenZhen Warehouse", "inspectionType": "WI", "planShelfCompletedDate": "2019-07-05 14:00:00", "logisticsPlanName": "SZX-US-27-May", "destinationWarehouseName": "USWC Warehouse", "expressVendorCode": "LB", "importDeclarationRuleCode": "TIOR", "importDeclareWay": "General", "pickupType": "S", "packageList": [ { "sellerCaseNo": "AutoPackAge0001", "merchandiseList": [ { "quantity": 2, "actualQuantity": 2, "specification": "", "sku": "M010000000001674549", "merchandiseCode": "auto_sku22" }, { "quantity": 2, "actualQuantity": 2, "specification": "", "sku": "M010000000001674550", "merchandiseCode": "auto_sku23" } ], "thirdPartyCaseNo": null, "sellerWeight": 10, "sellerLength": 50, "length": 50, "width": 40, "weight": 10, "sellerHeight": 30, "sellerWidth": 40, "packageNo": "B0400000000000001732", "height": 30 }], "merchandiseList": [ { "inspectionQty": 2, "quantity": 2, "productBarcode": "M010000000001674549", "actualQuantity": 2, "specification": "", "merchandiseCode": "auto_sku22", "skuCode3rdList": [] }, { "inspectionQty": 2, "quantity": 2, "productBarcode": "M010000000001674550", "actualQuantity": 2, "specification": "", "merchandiseCode": "auto_sku23", "skuCode3rdList": [] } ], "importDeclarationName": "第三方进口商", "pickupAddressCode": "", "createdDate": "2019-06-03 17:38:08", "logisticsPlanNo": 187483, "pickupAddress": "", "exporterName": "ENERGY CIRCLE LIMITED", "winitProductCode": "OW01010343", "shelveCompletedDate": "2019-06-03 17:44:49", "customsDeclarationType": "TEOR", "importerCode": null, "status": "SHD" } }
关键词