接口说明
客户自验货数据导入接口
确认验货完成前,一个订单支持多次提交验货数据
- 不重复的包裹,累增验货数据
- 重复的包裹,取最后一次提交的验货数据
- 每批次导入支持最大包裹数1000,最大SKU数1000,最大单品数10000
- 每订单支持最大包裹数5000,最大SKU数2000,最大单品数10w
订单所有验货数据导入完成后,需再调用自验货确认完成接口,以确认订单验货完成。
使用场景
直发自验入库单使用:老自验货订单,快速自验
仅限开通快速自验管理权限后调用,详询客服
接口名称
winit.wh.inbound.selfinspection.importpackinglist
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
orderNo | String(50) | Y | 订单号 | |
packageList | Array | Y | 包裹集合list | |
–|thirdSerno | String(50) | O | 第三方包裹条码(自定义), thirdSerno与packageNo至少填一项 |
|
–|packageNo | String(50) | O | Winit包裹号 thirdSerno与packageNo至少填一项 |
|
–|length | Numberic(10,2) | Y | 包裹长(单位CM) | |
–|width | Numberic(10,2) | Y | 包裹宽(单位CM) | |
–|height | Numberic(10,2) | Y | 包裹高(单位CM) | |
–|weight | Numberic(10,4) | Y | 包裹重量(单位KG) | |
–|merchandiseList | Array | Y | 商品明细list(包裹装箱明细) | |
–|–|merchandiseCode | String(255) | Y | 商品编码 | |
–|–|specification | String(255) | N | 规格 若注册商品信息中规格存在,必填 |
|
–|–|qty | Int | Y | 数量 | |
–|–|skuType | String(50) | N | SKU类型 SINGLE -单一商品 SUITE-套装商品 BOX-箱商品 未填时,默认为单一商品 |
|
–|–|standardPartsQty | Integer | N | 库存单元标准件数 未填时,默认为1 |
|
–|–|productionBatch | String(128) | O | 生产批次号 注意:当SKU为批次管理商品,且批次属性为“生产日期+产品批次号”或“时效日期+产品批次号”时,必填。 |
|
–|–|productionDate | String(50) | O | 生产日期 格式:yyyy-MM-dd 注意:当SKU为批次管理商品,且批次属性为“生产日期”或“生产日期+产品批次号”时,必填。 |
|
–|–|expirationDate | String(50) | O | 失效日期 格式:yyyy-MM-dd 注意:当SKU为批次管理商品,且批次属性为“失效日期”或“失效日期+产品批次号”时,必填。 |
|
–|–|barcodeValue | String(128) | O | 条码值 注意:当SKU为条码值管理的商品时,必填 |
|
–|–|subPackgSerno | String(50) | N | 子包裹(当为子包裹时,必填;散装货物非必填) | |
–|–|itemList | Array | O | 单品明细 若为单品化管理的SKU,必填 |
|
–|–|–|itemSerno | String(50) | O | 单品条码 注意:同时满足如下条件时必填 1、当下单商品的管理方式为单品化管理(SI)时 2、当下单商品的SKU类型(skuType)为单一商品(SINGLE)、套装商品(SUITE) |
|
–|–|–|originItemSernoList | Array | N | 源单一商品的单品条码(即套装商品或箱商品内部的单品条码) 注意:当下单商品的SKU类型(skuType)为套装(SUITE)或者箱(BOX),且箱内或套内的源单一商品为单品化管理(SI)时,必填 |
|
merchandiseSizeList | Array | O | 商品尺寸信息 商品为新品或需要更新商品尺寸重量时,必填 |
|
–|merchandiseCode | String(255) | Y | 商品编码 | |
–|specification | String(255) | N | 规格 | |
–|skuType | String(50) | N | SKU类型 SINGLE -单一商品 SUITE-套装商品 BOX-箱商品 未填时,默认为单一商品。 |
|
–|standardPartsQty | Integer | N | 库存单元标准件数 未填时,默认为1 |
|
–|length | Numberic(10,2) | Y | 商品长(cm) | |
–|width | Numberic(10,2) | Y | 商品宽(cm) | |
–|height | Numberic(10,2) | Y | 商品高(cm) | |
–|weight | Numberic(10,4) | Y | 商品重(KG) |
请求示例
1、非子包裹验货
未开通箱套商品管理,仅单一商品
包裹:
第三方包裹条码(自定义)TS001,Winit包裹号B0400000000000001027,
包裹中分别装有SKU:auto_picking_001、auto_picking_002若干。
装箱明细如下:
auto_picking_001 2个
auto_picking_002 2个
其中auto_picking_001是新品或者需要重新测量尺寸重量,传入merchandiseSizeList信息
{
"action": "winit.wh.inbound.selfinspection.importpackinglist ",
"app_key": "rebecca",
"data": {
"orderNo": "WI9900000857",
"packageList": [{
"packageNo": "B0400000000000001027",
"thirdSerno": " TS001",
"merchandiseList": [{
"merchandiseCode": "auto_picking_001",
"specification": "",
"qty": "2",
"itemList": [{
"itemSerno": "S500083000389043494"
},
{
"itemSerno": "S500084000389043493"
}
]
}, {
"merchandiseCode": "auto_picking_002",
"specification": "",
"qty": "2",
"itemList": [{
"itemSerno": "S500083000389043495"
},
{
"itemSerno": "S500084000389043496"
}
]
}],
"height": "26",
"length": "26",
"weight": "3",
"width": "26"
}],
"merchandiseSizeList": [{
"specification": "",
"merchandiseCode": "auto_picking_001",
"height": "10.4",
"length": "15.5",
"weight": "1.5",
"width": "3.5"
}]
},
"format": "json",
"language": "zh_CN",
"platform": "sw",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2021-01-14 10:30:26",
"version": "1.0"
}
同时存在单一商品和套装商品
包裹:
第三方包裹条码(自定义)TS001
Winit包裹号B0400000000000001027,
包裹中分别装有SKU:auto_picking_001(单一商品,库存单元标准件数1)、auto_picking_002(套装商品,库存单元标准件数2)若干。
Winit包裹号B0400000000000001028,
包裹中分别装有SKU:auto_picking_003(箱商品,库存单元标准件数5)若干。
装箱明细如下:
B0400000000000001027:
auto_picking_001 2个
auto_picking_002 2个
B0400000000000001028:
auto_picking_003 1个
其中auto_picking_001是新品或者需要重新测量尺寸重量,传入merchandiseSizeList信息
{
"action": "winit.wh.inbound.selfinspection.importpackinglist ",
"app_key": "rebecca",
"data": {
"orderNo": "WI9900000857",
"packageList": [
{
"packageNo": "B0400000000000001027",
"thirdSerno": " TS001",
"merchandiseList": [
{
"merchandiseCode": "auto_picking_001",
"specification": "",
"skuType": "SINGLE",
"standardPartsQty": 1,
"qty": "2",
"itemList": [
{
"itemSerno": "S500083000389043494"
},
{
"itemSerno": "S500084000389043493"
}
]
},
{
"merchandiseCode": "auto_picking_002",
"specification": "",
"skuType": "SUITE",
"standardPartsQty": 2,
"qty": "2",
"itemList": [
{
"itemSerno": "S0000000001T",
"originItemSernoList": [
"S500083000389043495",
"S500083000389043496"
]
},
{
"itemSerno": "S0000000002T",
"originItemSernoList": [
"S500083000389043497",
"S500083000389043498"
]
}
]
}
],
"height": "26",
"length": "26",
"weight": "3",
"width": "26"
},
{
"packageNo": "B0400000000000001028",
"thirdSerno": " TS001",
"merchandiseList": [
{
"merchandiseCode": "auto_picking_003",
"specification": "",
"skuType": "BOX",
"standardPartsQty": 5,
"qty": "2",
"itemList": [
{
"itemSerno": "",
"originItemSernoList": [
"S500083000389043401",
"S500083000389043402",
"S500083000389043403",
"S500083000389043404",
"S500083000389043405"
]
}
]
}
],
"height": "26",
"length": "26",
"weight": "3",
"width": "26"
}
],
"merchandiseSizeList": [
{
"specification": "",
"merchandiseCode": "auto_picking_001",
"skuType": "SINGLE",
"standardPartsQty": 1,
"height": "10.4",
"length": "15.5",
"weight": "1.5",
"width": "3.5"
}
]
},
"format": "json",
"language": "zh_CN",
"platform": "sw",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2021-01-14 10:30:26",
"version": "1.0"
}
2、子包裹验货
未开通箱套商品管理,仅单一商品
包裹:
第三方包裹条码(自定义)TS001,Winit包裹号B0400000000000001027,
包裹中分别装有SKU:auto_picking_001、auto_picking_002若干。
装箱明细如下:
auto_picking_001 2个,置于子包裹BC001180810093528945中
auto_picking_002 2个,置于子包裹BC001180810093528946中
其中auto_picking_001是新品或者需要重新测量尺寸重量,传入merchandiseSizeList信息
{
"action": "winit.wh.inbound.selfinspection.importpackinglist ",
"app_key": "rebecca",
"data": {
"orderNo": "WI9900000857",
"packageList": [{
"packageNo": "B0400000000000001027",
"thirdSerno": " TS001",
"merchandiseList": [{
"subPackgSerno":"BC001180810093528945",
"merchandiseCode": "auto_picking_001",
"specification": "",
"qty": "2",
"itemList": [{
"itemSerno": "S500083000389043494"
},
{
"itemSerno": "S500084000389043493"
}
]
}, {
"subPackgSerno":"BC001180810093528946",
"merchandiseCode": "auto_picking_002",
"specification": "",
"qty": "2",
"itemList": [{
"itemSerno": "S500083000389043495"
},
{
"itemSerno": "S500084000389043496"
}
]
}],
"height": "26",
"length": "26",
"weight": "3",
"width": "26"
}],
"merchandiseSizeList": [{
"specification": "",
"merchandiseCode": "auto_picking_001",
"height": "10.4",
"length": "15.5",
"weight": "1.5",
"width": "3.5"
}]
},
"format": "json",
"language": "zh_CN",
"platform": "sw",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2021-01-14 10:30:26",
"version": "1.0"
}
同时存在单一商品和套装商品
包裹:
第三方包裹条码(自定义)TS001
Winit包裹号B0400000000000001027,
包裹中分别装有SKU:auto_picking_001(单一商品,库存单元标准件数1)、auto_picking_002(套装商品,库存单元标准件数2)若干。
装箱明细如下:
auto_picking_001 2个,置于子包裹BC001180810093528945中
auto_picking_002 2个,置于子包裹BC001180810093528946中
其中auto_picking_001是新品或者需要重新测量尺寸重量,传入merchandiseSizeList信息
{
"action": "winit.wh.inbound.selfinspection.importpackinglist ",
"app_key": "rebecca",
"data": {
"orderNo": "WI9900000857",
"packageList": [
{
"packageNo": "B0400000000000001027",
"thirdSerno": " TS001",
"merchandiseList": [
{
"subPackgSerno": "BC001180810093528945",
"merchandiseCode": "auto_picking_001",
"specification": "",
"skuType": "SINGLE",
"standardPartsQty": 1,
"qty": "2",
"itemList": [
{
"itemSerno": "S500083000389043494"
},
{
"itemSerno": "S500084000389043493"
}
]
},
{
"subPackgSerno": "BC001180810093528946",
"merchandiseCode": "auto_picking_002",
"specification": "",
"skuType": "SUITE",
"standardPartsQty": 2,
"qty": "2",
"itemList": [
{
"itemSerno": "S0000000001T",
"originItemSernoList": [
"S500083000389043495",
"S500083000389043496"
]
},
{
"itemSerno": "S0000000002T",
"originItemSernoList": [
"S500083000389043497",
"S500083000389043498"
]
}
]
}
],
"height": "26",
"length": "26",
"weight": "3",
"width": "26"
}
],
"merchandiseSizeList": [
{
"specification": "",
"merchandiseCode": "auto_picking_001",
"skuType": "SINGLE",
"standardPartsQty": 1,
"height": "10.4",
"length": "15.5",
"weight": "1.5",
"width": "3.5"
}
]
},
"format": "json",
"language": "zh_CN",
"platform": "sw",
"sign": "00000000000000000000000000000000",
"sign_method": "md5",
"timestamp": "2021-01-14 10:30:26",
"version": "1.0"
}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
返回示例
{
"code": "0",
"msg": "操作成功",
"data": {}
}