API
查询商品
更新时间: 2023-07-26 17:25:59 访问次数:17511

接口说明

该接口提供商品信息查询功能,长宽高重量等

接口名称

winit.mms.item.list

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,1000有需要可申请加大。

请求入参

名称 类型 必填 说明 示例
pageNo Int Y 页码信息 1
pageSize Int Y 每页记录数 100
skuCode String(255) N 商品编码SKU
模糊搜索
auto_sku22
startTime String(20) N 商品注册开始时间
格式:YYYY-MM-DD HH:MM:SS
2019-08-01 00:00:00
endTime String(20) N 商品注册结束时间
格式:YYYY-MM-DD HH:MM:SS
2019-08-07 00:00:00

请求示例

1、全量查询

  1. {
  2. "action": "winit.mms.item.list",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "141884496E086A7732D04FD34C7FD8A7",
  6. "data": {
  7. "pageNo": "1",
  8. "pageSize": "100"
  9. },
  10. "format": "json",
  11. "language": "zh_CN",
  12. "sign": "2EE2A5E699CA2B9B729F4A2BDC2937FD",
  13. "sign_method": "md5",
  14. "platform": "OWNERERP",
  15. "timestamp": "2015-06-16 00:19:26",
  16. "version": "1.0"
  17. }

2、高效查询

  1. {
  2. "action": "winit.mms.item.list",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "F38A52FC5F4CA7B63119CC8D75901702",
  6. "data": {
  7. "pageNo": "1",
  8. "pageSize": "5",
  9. "skuCode": "auto_sku22",
  10. "startTime": "2019-08-01 00:00:00",
  11. "endTime": "2019-08-07 00:00:00"
  12. },
  13. "format": "json",
  14. "language": "zh_CN",
  15. "sign": "DCDF4D408A1427AAC8C000D779323590",
  16. "sign_method": "md5",
  17. "platform": "OWNERERP",
  18. "timestamp": "2015-06-16 00:19:26",
  19. "version": "1.0"
  20. }

返回出参

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

名称 类型 必传 说明 示例
pageParams Object Y 分页信息
–|pageNo Int Y 当前页
–|pageSize Int Y 分页大小
–|totalCount Int Y 总记录数
list Array Y 数据数组
–|isActive String() Y 是否有效 ,Y/N
Y:有效
N:无效
Y
–|code String Y 商品条码
–|skuCode String Y 商品编码
–|specification String Y 商品规格
–|cnName String Y 商品中文名称
–|name String Y 商品英文名称
–|registerLength Double Y 注册长度(厘米)
–|registerWidth Double Y 注册宽度(厘米)
–|registerHeight Double Y 注册高度(厘米)
–|registerWeight Double Y 注册重量(千克)
–|registerVolume Double Y 注册体积(CBM)
–|supervisorMode String() Y 商品管理模式
SI:单品管理模式
SKU:商品管理模式
–|brandName String() O 品牌名称
–|model String() O 型号
–|isPlus String() O 是否带插头 N
–|isBattery String() O 是否带电 Y
–|displayPageUrl String() O 商品链接,刊登网址 www.Amazon.com
–|customsDeclarationList Array Y 商品申报信息(依国家区分)
–|–|countryCode String() Y 国家
–|–|declareName String() Y 申报品名
–|–|exportPrice Number Y 出口申报价值(美元)
–|–|importPrice Number Y 进口申报价值(美元)
–|–|recommendDeclarePrice Number Y 海关建议申报价值(美元)
–|–|importRate Number Y 进口关税税率 3.7
–|–|rebateRate Number Y 退税率 20
–|–|vatRate Number Y 增值税率 15
–|–|length Number Y 核实长度(厘米)
–|–|width Number Y 核实宽度(厘米)
–|–|height Number Y 核实高度(厘米)
–|–|volume Number Y 核实体积(m3)
–|–|weight Number Y 核实重量(Kg)
–|–|registerLength Number Y 注册长度(厘米)
–|–|registerWidth Number Y 注册宽度(厘米)
–|–|registerHeight Number Y 注册高度(厘米)
–|–|registerVolume Number Y 注册体积(立方米)
–|–|registerWeight Number Y 注册重量(Kg)
–|–|isNew String() Y 是否新品
若商品完成验货或核实尺寸后为N,否则为Y

–|–|cargoTypeSpec String() Y 货型规格 T25
–|–|qty Integer Y 数量,已停用
–|–|firstWayType String() Y 头程类型
商品支持的入库类型
NL:无限制
NS:卖家直发
–|–|isProhibitWarehousing String() Y 商品是否禁止入库
Y:禁止入库
N:不禁止入库
–|itemThirdVos Array N 商品第三方编码列表
–|–|skuCodeThird String() Y 第三方编码
–|–|description String() Y 说明
–|–|isActive String() Y 无用出参,不用处理
–|–|isDelete String() Y 无用出参,不用处理

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "pageParams": {
  6. "pageNo": 1,
  7. "pageSize": 5,
  8. "totalCount": 1
  9. },
  10. "list": [
  11. {
  12. "code": "M010000000001674549",
  13. "skuCode": "auto_sku22",
  14. "specification": "",
  15. "cnName": "cnName_auto_sku22",
  16. "name": "enName_auto_sku22",
  17. "length": 15,
  18. "width": 10,
  19. "height": 3,
  20. "volume": 4.5E-4,
  21. "weight": 0.025,
  22. "registerWeight": 0.025,
  23. "registerLength": 15,
  24. "registerWidth": 10,
  25. "registerHeight": 3,
  26. "registerVolume": 4.5E-4,
  27. "supervisorMode": "SI",
  28. "brandName": "",
  29. "model": "",
  30. "isPlus": "N",
  31. "isBattery": "N",
  32. "displayPageUrl": "www.Amazon.com",
  33. "isActive": "Y",
  34. "sourceType": "Normal",
  35. "customsDeclarationList": [
  36. {
  37. "countryCode": "AU",
  38. "declareName": "---Other",
  39. "importPrice": 5,
  40. "exportPrice": 0,
  41. "rebateRate": 0,
  42. "importRate": 0,
  43. "firstWayType": "NL",
  44. "vatRate": 10,
  45. "length": 15,
  46. "width": 10,
  47. "height": 3,
  48. "volume": 4.5E-4,
  49. "weight": 0.025,
  50. "registerWeight": 0.025,
  51. "registerLength": 15,
  52. "registerWidth": 10,
  53. "registerHeight": 3,
  54. "registerVolume": 4.5E-4,
  55. "recommendDeclarePrice": 20,
  56. "isNew": "N",
  57. "cargoTypeSpec": "T50",
  58. "qty": null
  59. },
  60. {
  61. "countryCode": "US",
  62. "declareName": "OTHER",
  63. "importPrice": 5,
  64. "exportPrice": 0,
  65. "rebateRate": null,
  66. "importRate": 3,
  67. "firstWayType": "NL",
  68. "vatRate": 0,
  69. "length": 15,
  70. "width": 10,
  71. "height": 3,
  72. "volume": 4.5E-4,
  73. "weight": 0.025,
  74. "registerWeight": 0.025,
  75. "registerLength": 15,
  76. "registerWidth": 10,
  77. "registerHeight": 3,
  78. "registerVolume": 4.5E-4,
  79. "recommendDeclarePrice": 20,
  80. "isNew": "N",
  81. "cargoTypeSpec": "T50",
  82. "qty": 2
  83. }
  84. ],
  85. "itemThirdVos": [
  86. {
  87. "skuCodeThird": "fba_auto_sku22",
  88. "description": null,
  89. "isActive": "Y",
  90. "isDelete": "N"
  91. },
  92. {
  93. "skuCodeThird": "SF190426000002",
  94. "description": null,
  95. "isActive": "Y",
  96. "isDelete": "N"
  97. }
  98. ]
  99. }
  100. ]
  101. }
  102. }