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

接口说明

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

接口名称

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. }