API
自验货数据导入
更新时间： 2025-05-20 11:33:55 访问次数：7145

接口说明

客户自验货数据导入接口

确认验货完成前，一个订单支持多次提交验货数据

  • 不重复的包裹，累增验货数据
  • 重复的包裹，取最后一次提交的验货数据
  • 每批次导入支持最大包裹数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信息

  1. {
  2.     "action": "winit.wh.inbound.selfinspection.importpackinglist ",
  3.     "app_key": "rebecca",
  4.     "data": {
  5.         "orderNo": "WI9900000857",
  6.         "packageList": [{
  7.         "packageNo": "B0400000000000001027",
  8.             "thirdSerno": " TS001",
  9.             "merchandiseList": [{
  10.                 "merchandiseCode": "auto_picking_001",
  11.                 "specification": "",
  12.                 "qty": "2",
  13.                 "itemList": [{
  14.                         "itemSerno": "S500083000389043494"
  15.                     },
  16.                     {
  17.                         "itemSerno": "S500084000389043493"
  18.                     }
  19.                 ]
  20.             }, {
  21.                 "merchandiseCode": "auto_picking_002",
  22.                 "specification": "",
  23.                 "qty": "2",
  24.                 "itemList": [{
  25.                         "itemSerno": "S500083000389043495"
  26.                     },
  27.                     {
  28.                         "itemSerno": "S500084000389043496"
  29.                     }
  30.                 ]
  31.             }],
  32.             "height": "26",
  33.             "length": "26",
  34.             "weight": "3",
  35.             "width": "26"
  36.         }],
  37.         "merchandiseSizeList": [{
  38.             "specification": "",
  39.             "merchandiseCode": "auto_picking_001",
  40.             "height": "10.4",
  41.             "length": "15.5",
  42.             "weight": "1.5",
  43.             "width": "3.5"
  44.         }]
  45.     },
  46.     "format": "json",
  47.     "language": "zh_CN",
  48.     "platform": "sw",
  49.     "sign": "00000000000000000000000000000000",
  50.     "sign_method": "md5",
  51.     "timestamp": "2021-01-14 10:30:26",
  52.     "version": "1.0"
  53. }

同时存在单一商品和套装商品

包裹：

第三方包裹条码（自定义）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信息

  1. {
  2.   "action": "winit.wh.inbound.selfinspection.importpackinglist ",
  3.   "app_key": "rebecca",
  4.   "data": {
  5.     "orderNo": "WI9900000857",
  6.     "packageList": [
  7.       {
  8.         "packageNo": "B0400000000000001027",
  9.         "thirdSerno": " TS001",
  10.         "merchandiseList": [
  11.           {
  12.             "merchandiseCode": "auto_picking_001",
  13.             "specification": "",
  14.             "skuType": "SINGLE",
  15.             "standardPartsQty": 1,
  16.             "qty": "2",
  17.             "itemList": [
  18.               {
  19.                 "itemSerno": "S500083000389043494"
  20.               },
  21.               {
  22.                 "itemSerno": "S500084000389043493"
  23.               }
  24.             ]
  25.           },
  26.           {
  27.             "merchandiseCode": "auto_picking_002",
  28.             "specification": "",
  29.             "skuType": "SUITE",
  30.             "standardPartsQty": 2,
  31.             "qty": "2",
  32.             "itemList": [
  33.               {
  34.                 "itemSerno": "S0000000001T",
  35.                 "originItemSernoList": [
  36.                   "S500083000389043495",
  37.                   "S500083000389043496"
  38.                 ]
  39.               },
  40.               {
  41.                 "itemSerno": "S0000000002T",
  42.                 "originItemSernoList": [
  43.                   "S500083000389043497",
  44.                   "S500083000389043498"
  45.                 ]
  46.               }
  47.             ]
  48.           }
  49.         ],
  50.         "height": "26",
  51.         "length": "26",
  52.         "weight": "3",
  53.         "width": "26"
  54.       },
  55.       {
  56.         "packageNo": "B0400000000000001028",
  57.         "thirdSerno": " TS001",
  58.         "merchandiseList": [
  59.           {
  60.             "merchandiseCode": "auto_picking_003",
  61.             "specification": "",
  62.             "skuType": "BOX",
  63.             "standardPartsQty": 5,
  64.             "qty": "2",
  65.             "itemList": [
  66.               {
  67.                 "itemSerno": "",
  68.                 "originItemSernoList": [
  69.                   "S500083000389043401",
  70.                   "S500083000389043402",
  71.                   "S500083000389043403",
  72.                   "S500083000389043404",
  73.                   "S500083000389043405"
  74.                 ]
  75.               }
  76.             ]
  77.           }
  78.         ],
  79.         "height": "26",
  80.         "length": "26",
  81.         "weight": "3",
  82.         "width": "26"
  83.       }
  84.     ],
  85.     "merchandiseSizeList": [
  86.       {
  87.         "specification": "",
  88.         "merchandiseCode": "auto_picking_001",
  89.         "skuType": "SINGLE",
  90.         "standardPartsQty": 1,
  91.         "height": "10.4",
  92.         "length": "15.5",
  93.         "weight": "1.5",
  94.         "width": "3.5"
  95.       }
  96.     ]
  97.   },
  98.   "format": "json",
  99.   "language": "zh_CN",
  100.   "platform": "sw",
  101.   "sign": "00000000000000000000000000000000",
  102.   "sign_method": "md5",
  103.   "timestamp": "2021-01-14 10:30:26",
  104.   "version": "1.0"
  105. }

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信息

  1. {
  2.     "action": "winit.wh.inbound.selfinspection.importpackinglist ",
  3.     "app_key": "rebecca",
  4.     "data": {
  5.         "orderNo": "WI9900000857",
  6.         "packageList": [{
  7.         "packageNo": "B0400000000000001027",
  8.             "thirdSerno": " TS001",
  9.             "merchandiseList": [{
  10.                 "subPackgSerno":"BC001180810093528945",
  11.                 "merchandiseCode": "auto_picking_001",
  12.                 "specification": "",
  13.                 "qty": "2",
  14.                 "itemList": [{
  15.                         "itemSerno": "S500083000389043494"
  16.                     },
  17.                     {
  18.                         "itemSerno": "S500084000389043493"
  19.                     }
  20.                 ]
  21.             }, {
  22.                 "subPackgSerno":"BC001180810093528946",
  23.                 "merchandiseCode": "auto_picking_002",
  24.                 "specification": "",
  25.                 "qty": "2",
  26.                 "itemList": [{
  27.                         "itemSerno": "S500083000389043495"
  28.                     },
  29.                     {
  30.                         "itemSerno": "S500084000389043496"
  31.                     }
  32.                 ]
  33.             }],
  34.             "height": "26",
  35.             "length": "26",
  36.             "weight": "3",
  37.             "width": "26"
  38.         }],
  39.         "merchandiseSizeList": [{
  40.             "specification": "",
  41.             "merchandiseCode": "auto_picking_001",
  42.             "height": "10.4",
  43.             "length": "15.5",
  44.             "weight": "1.5",
  45.             "width": "3.5"
  46.         }]
  47.     },
  48.     "format": "json",
  49.     "language": "zh_CN",
  50.     "platform": "sw",
  51.     "sign": "00000000000000000000000000000000",
  52.     "sign_method": "md5",
  53.     "timestamp": "2021-01-14 10:30:26",
  54.     "version": "1.0"
  55. }

同时存在单一商品和套装商品

包裹：

第三方包裹条码（自定义）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信息

  1. {
  2.   "action": "winit.wh.inbound.selfinspection.importpackinglist ",
  3.   "app_key": "rebecca",
  4.   "data": {
  5.     "orderNo": "WI9900000857",
  6.     "packageList": [
  7.       {
  8.         "packageNo": "B0400000000000001027",
  9.         "thirdSerno": " TS001",
  10.         "merchandiseList": [
  11.           {
  12.             "subPackgSerno": "BC001180810093528945",
  13.             "merchandiseCode": "auto_picking_001",
  14.             "specification": "",
  15.             "skuType": "SINGLE",
  16.             "standardPartsQty": 1,
  17.             "qty": "2",
  18.             "itemList": [
  19.               {
  20.                 "itemSerno": "S500083000389043494"
  21.               },
  22.               {
  23.                 "itemSerno": "S500084000389043493"
  24.               }
  25.             ]
  26.           },
  27.           {
  28.             "subPackgSerno": "BC001180810093528946",
  29.             "merchandiseCode": "auto_picking_002",
  30.             "specification": "",
  31.             "skuType": "SUITE",
  32.             "standardPartsQty": 2,
  33.             "qty": "2",
  34.             "itemList": [
  35.               {
  36.                 "itemSerno": "S0000000001T",
  37.                 "originItemSernoList": [
  38.                   "S500083000389043495",
  39.                   "S500083000389043496"
  40.                 ]
  41.               },
  42.               {
  43.                 "itemSerno": "S0000000002T",
  44.                 "originItemSernoList": [
  45.                   "S500083000389043497",
  46.                   "S500083000389043498"
  47.                 ]
  48.               }
  49.             ]
  50.           }
  51.         ],
  52.         "height": "26",
  53.         "length": "26",
  54.         "weight": "3",
  55.         "width": "26"
  56.       }
  57.     ],
  58.     "merchandiseSizeList": [
  59.       {
  60.         "specification": "",
  61.         "merchandiseCode": "auto_picking_001",
  62.         "skuType": "SINGLE",
  63.         "standardPartsQty": 1,
  64.         "height": "10.4",
  65.         "length": "15.5",
  66.         "weight": "1.5",
  67.         "width": "3.5"
  68.       }
  69.     ]
  70.   },
  71.   "format": "json",
  72.   "language": "zh_CN",
  73.   "platform": "sw",
  74.   "sign": "00000000000000000000000000000000",
  75.   "sign_method": "md5",
  76.   "timestamp": "2021-01-14 10:30:26",
  77.   "version": "1.0"
  78. }

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

返回示例

  1. {
  2.     "code": "0",
  3.     "msg": "操作成功",
  4.     "data": {}
  5. }
关键词