API
查询商品
更新时间： 2024-10-16 11:17:34 访问次数：20132

接口说明

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

接口名称

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 型号
– displayPageUrl String() O 商品链接，刊登网址 www.Amazon.com
– isWithPowder String(1) Y 是否带粉，Y/N
– isWithLiquid String(1) Y 是否带液体，Y/N
– isWithMagnetism String(1) Y 是否带磁，Y/N
– isBattery String() Y 是否带电，Y/N Y
– batteryTypeId LONG O 电池种类
1：锂离子电池
2：锂金属电池
3：非锂电池
– batteryPackId LONG O 电池包装
4：纯电
5：内置
6：外置
– batteryGroupId LONG O 电池组/电池组
9：电池芯
10：电池组
– batteryPower BigDecimal O 电池能量
– batteryWeight BigDecimal O 电池重量
– unCode String(20) O UN编码
– isFood String(1) Y 是否食品，Y/N
– isHaveAllergen String(1) O 是否有过敏源，Y/N
– allergens String(128) O 过敏源，多个逗号分开
A1：含麸质的谷类食品
A2：甲壳类动物及其制品
A3：鸡蛋及其制品
A4：鱼类及其制品
A5：花生及其制品
A6：牛奶及其制品
A7：坚果
A8：芹菜及其制品
A9：芥末及其制品
A10：芝麻及其制品
A11：二氧化硫和亚硫酸盐
A12：羽扇豆及其制品
A13：软体动物及其制品
A14：大豆及其制品		 A1,A2
– isHighValue String Y 是否高货值，Y/N
– isBatchManager String Y 是否启用批次管理，Y/N
– batchManagerType String O 批次管理类型
SHELF_LIFE_MANAGEMENT：保质期管理
INBOUND_BATCH_MANAGEMENT：入库批次管理
PRODUCTION_BATCH_MANAGEMENT：生产批次管理
– batchAttributeType String O 批次属性
PD：生产日期
ID：入库日期
ED：失效日期
PDPB：生产日期+产品批号
EDPB：失效日期+产品批号
– batchPictureUrl String O 批次信息示意图
– shelfLifeValue Integer O 保质期
– shelfLifeUnit String O 保质期单位 DAY,MONTH,YEAR
– alertDays Integer O 预警天数
– prohibitSaleDays Integer O 禁售天数
– itemPackaging String Y 入库包装类别
LOGISTICS：物流包装
SALES：销售包装
NUDE_CARGO：裸货
不填写默认LOGISTICS物流包装
– itemShape String Y 入库商品形状
STRIP：规则长条形
SQUARE：规则方形
ROUND：规则圆形
IRREGULAR：不规则形状
– itemPackagingMaterial String Y 入库包装材质
CARTON：通用纸箱
COURIER：快递袋
BUBBLE：气泡袋
WOVEN：编织袋
METAL：金属容器
CORTICAL：皮质
FOAM：泡沫箱
PLASTIC：塑料袋
ELSE：其他
– itemExtAttributeList Array N 商品扩展属性集合
– – attributeName String N 属性名称
具体参见如下表格
– – attributeValue String N 属性值
– itemCountryExtAttributeList Array N 商品扩展属性集合（区分国家）
– – attributeName String N 属性名称
具体参见如下表格
– – attributeValue String N 属性值
– – countryCode String N 国家，二字码
– customsDeclarationList Array Y 商品申报信息（依国家区分）
– – countryCode String() Y 国家
– – type String() Y 国家类型
E：出口国
I：进口国
– – 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
– – outPackagingType String() N 出库包装类别（单一订单）
NO：不加包装
PACKAGING_WINIT：WINIT标准包装
CUSTOM_LOGISTICS：客制物流包装
CUSTOM_SALE：客制销售包装
– – packagingMethod String() N 出库包材类型（单一订单）
COURIER_SATCHEL：快递袋
PADDED_ENVELOPE：气泡袋
CARTON_BOX：纸箱
NO：不加包装
– – outPackagingSku String() N 出库指定包材SKU（单一订单）
– – outPackagingTypeMulti String() N 出库包装类别（复合订单）
NO：不加包装
PACKAGING_WINIT：WINIT标准包装
CUSTOM_LOGISTICS：客制物流包装
CUSTOM_SALE：客制销售包装
– – packagingMethodMulti String() N 出库包材类型（复合订单）
COURIER_SATCHEL：塑料袋
PADDED_ENVELOPE：气泡袋
CARTON_BOX：纸箱
NO：不加包装
– – outPackagingSkuMulti String() N 出库指定包材sku（复合订单）
– itemThirdVos Array N 商品第三方编码列表
– – skuCodeThird String() Y 第三方编码
– – countryCode String() N 国家，仅限开通国家三方编码管理
– – description String() Y 说明
– – isActive String() Y 无用出参，不用处理
– – isDelete String() Y 无用出参，不用处理

商品扩展属性集合

不区分国家

attributeName名称 attributeValue属性值 说明
packingMaterials Y/N 是否包材商品
fragileLabel Y/N 易碎品标
frontUpLabel Y/N 正面朝上标
caoLabel Y/N 只上货机标
exportLimit Y/N 限制出口标
surfaceMailOnly Y/N 只限陆运标
fireSafetyLabel Y/N None：无记录 锂电池UN标签
dangerousLabel Y/N None：无记录 9类危险品标

区分国家

attributeName名称 attributeValue属性值 说明
actualGoodsDateFormat 示例：MMDDYYYY 批次日期格式

返回示例

  1. {
  2.     "code": "0",
  3.     "msg": "操作成功",
  4.     "data": {
  5.         "pageParams": {
  6.             "pageNo": 1,
  7.             "pageSize": 100,
  8.             "totalCount": 1
  9.         },
  10.         "list": [
  11.             {
  12.                 "id": null,
  13.                 "code": "M010000000001695047",
  14.                 "skuCode": "A1231011",
  15.                 "specification": "",
  16.                 "cnName": "A1231011",
  17.                 "name": "A1231011",
  18.                 "length": 10,
  19.                 "width": 7,
  20.                 "height": 5,
  21.                 "volume": 0.00035,
  22.                 "weight": 0.23,
  23.                 "registerWeight": 0.23,
  24.                 "registerLength": 10,
  25.                 "registerWidth": 7,
  26.                 "registerHeight": 5,
  27.                 "registerVolume": 0.00035,
  28.                 "supervisorMode": "SKU",
  29.                 "brandName": "",
  30.                 "model": "",
  31.                 "isPlus": "N",
  32.                 "isBattery": "N",
  33.                 "displayPageUrl": "http://winit.com.cn/MerchandiseInfo/batchAdd",
  34.                 "isActive": "Y",
  35.                 "sourceType": "Normal",
  36.                 "isHighValue": "N",
  37.                 "batteryTypeId": null,
  38.                 "batteryPackId": null,
  39.                 "batteryPower": null,
  40.                 "customsDeclarationList": [
  41.                     {
  42.                         "countryCode": "UK",
  43.                         "declareName": "Pen",
  44.                         "importPrice": 1,
  45.                         "exportPrice": 1,
  46.                         "rebateRate": 0,
  47.                         "importRate": 3.7,
  48.                         "firstWayType": "NL",
  49.                         "vatRate": 20,
  50.                         "length": 10,
  51.                         "width": 7,
  52.                         "height": 5,
  53.                         "volume": 0.00035,
  54.                         "weight": 0.23,
  55.                         "registerWeight": 0.23,
  56.                         "registerLength": 10,
  57.                         "registerWidth": 7,
  58.                         "registerHeight": 5,
  59.                         "registerVolume": 0.00035,
  60.                         "recommendDeclarePrice": null,
  61.                         "isNew": "N",
  62.                         "cargoTypeSpec": "T50",
  63.                         "qty": null,
  64.                         "isProhibitWarehousing": "N",
  65.                         "needEar": "N",
  66.                         "needInstructions": "N",
  67.                         "needInstructionsUrl": "N"
  68.                     },
  69.                     {
  70.                         "countryCode": "US",
  71.                         "declareName": "OTHER",
  72.                         "importPrice": 1,
  73.                         "exportPrice": 0,
  74.                         "rebateRate": null,
  75.                         "importRate": 3,
  76.                         "firstWayType": "NL",
  77.                         "vatRate": 0,
  78.                         "length": 10,
  79.                         "width": 7,
  80.                         "height": 5,
  81.                         "volume": 0.00035,
  82.                         "weight": 0.23,
  83.                         "registerWeight": 0.23,
  84.                         "registerLength": 10,
  85.                         "registerWidth": 7,
  86.                         "registerHeight": 5,
  87.                         "registerVolume": 0.00035,
  88.                         "recommendDeclarePrice": null,
  89.                         "isNew": "N",
  90.                         "cargoTypeSpec": "T50",
  91.                         "qty": null,
  92.                         "isProhibitWarehousing": "N",
  93.                         "needEar": "N",
  94.                         "needInstructions": "N",
  95.                         "needInstructionsUrl": "N"
  96.                     }
  97.                 ],
  98.                 "itemThirdVos": [
  99.                     {
  100.                         "skuCodeThird": "A1231011",
  101.                         "description": null,
  102.                         "isActive": "Y",
  103.                         "isDelete": "N"
  104.                     }
  105.                 ],
  106.                 "isBatchManager": "Y",
  107.                 "batchManagerType": "INBOUND_BATCH_MANAGEMENT",
  108.                 "shelfLifeValue": null,
  109.                 "shelfLifeUnit": "",
  110.                 "prohibitSaleDays": null,
  111.                 "alertDays": null,
  112.                 "batchPictureUrl": "",
  113.                 "batchAttributeType": "ID",
  114.                 "unCode": null,
  115.                 "batteryWeight": null,
  116.                 "batteryGroupId": null,
  117.                 "isWithLiquid": "N",
  118.                 "isFood": "N",
  119.                 "isHaveAllergen": null,
  120.                 "allergens": null
  121.             }
  122.         ]
  123.     }
  124. }