API
自验货数据导入
更新时间: 2023-06-06 14:04:00 访问次数:5270

接口说明

客户自验货数据导入接口
确认验货完成前,一个订单支持多次提交验货数据

  • 不重复的包裹,累增验货数据
  • 重复的包裹,取最后一次提交的验货数据
  • 每批次导入支持最大包裹数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. }
关键词