API
查询商品
更新时间: 2019-10-16 20:00:04 访问次数:4942
接口说明

该接口提供给第三方平台或是卖家自有系统集成查询商品信息功能。
为了提高接口响应效率,推荐使用2.指定时间查询

使用场景

卖家可以通过该接口实现查询商品信息的功能,支持:
1.全量查询:startTime开始时间和endTime结束时间不入参,查询的为全量的商品信息
2.高效查询:
(1)指定商品编码:增加skuCode商品编码具体入参,模糊查询指定SKU,
(2)指定时间区域:增加startTime开始时间和endTime结束时间具体入参,查询的是该时间区域内被编辑过的商品。

接口英文名称

winit.mms.item.list

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
pageNo Integer Y 页码信息 1
pageSize Integer Y 每页记录数/分页大小 10
skuCode String(255) N 商品编码SKU
模糊搜索,包含该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.全量查询:
{
	"action": "winit.mms.item.list",
	"app_key": "rebecca",
	"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
	"client_sign": "BFE657A42B1E03486A1576089FC7FB7C",
	"data": {
		"pageNo": "1",
		"pageSize": "5"
	},
	"format": "json",
	"language": "zh_CN",
	"sign": "4AA5B72AA172BC2D0F12F32638FA8076",
	"sign_method": "md5",
	"platform": "OWNERERP",
	"timestamp": "2015-06-16 00:19:26",
	"version": "1.0"
}

2.高效查询: { "action": "winit.mms.item.list", "app_key": "rebecca", "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2", "client_sign": "F38A52FC5F4CA7B63119CC8D75901702", "data": { "pageNo": "1", "pageSize": "5", "skuCode": "auto_sku22", "startTime": "2019-08-01 00:00:00", "endTime": "2019-08-07 00:00:00" }, "format": "json", "language": "zh_CN", "sign": "DCDF4D408A1427AAC8C000D779323590", "sign_method": "md5", "platform": "OWNERERP", "timestamp": "2015-06-16 00:19:26", "version": "1.0" }

                            
返回出参
每箱件数
名称 类型 必填 说明 示例
pageParams Object Y 分页信息
--|pageNo Integer Y 当前页
--|pageSize Integer Y 分页大小
--|totalCount Integer Y 总记录数
list Array Y 数据数组
--|isActive String() Y 是否有效
Y,有效
N,无效
Y
--|code String Y 商品条码
--|skuCode String Y 商品编码
--|specification String Y 商品规格
--|cnName String Y 商品中文名称
--|name String Y 商品英文名称
--|length Double Y 核实长度(厘米)
已失效,请使用国家级(customsDeclarationList)尺寸重量
--|width Double Y 核实宽(厘米)
已失效,请使用国家级(customsDeclarationList)尺寸重量

--|height Double Y 核实高(厘米)
已失效,请使用国家级(customsDeclarationList)尺寸重量

--|weight Double Y 核实重量(千克)
已失效,请使用国家级(customsDeclarationList)尺寸重量

--|volume Double Y 核实体积(立方米)
已失效,请使用国家级(customsDeclarationList)尺寸重量

--|registerLength Double Y 注册长度(厘米)
--|registerWidth Double Y 注册宽度(厘米)
--|registerHeight Double Y 注册高度(厘米)
--|registerWeight Double Y 注册重量(千克)
--|registerVolume Double Y 注册体积(立方米)
--|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 商品申报信息(依国家区分)
--|--|firstWayType String() Y
头程类型
商品支持的入库类型
NL-无限制
WC-只支持Winit承运
NS-只支持卖家直发

--|--|countryCode String() Y 国家
--|--|declareName String() Y 申报品名
--|--|importPrice Number Y 进口申报价值(美元)
--|--|exportPrice Number Y 出口申报价值(美元)
--|--|rebateRate Number Y 退税率 20
--|--|importRate Number Y 进口关税税率 3.7
--|--|vatRate Number Y 增值税率 15
--|--|length Number
Y
核实长度(厘米)

--|--|width Number
Y
核实宽度(厘米)

--|--|height Number
Y
核实高度(厘米)

--|--|volume Number
Y
核实体积(m3)

--|--|weight Number
Y
核实重量(Kg)

--|--|registerWeight Number
Y
注册重量(Kg)

--|--|registerLength
Number
Y
注册长度(厘米)

--|--|registerWidth
Number
Y
注册宽度(厘米)

--|--|registerHeight
Number
Y
注册高度(厘米)

--|--|registerVolume
Number
Y
注册体积(立方米)

--|--|recommendDeclarePrice
Number
Y
建议申报价值

--|--|isNew
String() Y
是否新品
--|--|cargoTypeSpec
String()
Y
货型规格

--|--|qty
Integer Y
数量
--|itemThirdVos Array
商品第三方编码列表
--|--|skuCodeThird String() Y 第三方编码
--|--|description String() Y 说明
--|--|isActive String() Y 无用出参,不用处理 Y
--|--|isDelete String() Y 无用出参,不用处理 N
返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "pageParams":       {
         "pageNo": 1,
         "pageSize": 5,
         "totalCount": 1
      },
      "list": [      {
         "id": null,
         "code": "M010000000001674549",
         "skuCode": "auto_sku22",
         "specification": "",
         "cnName": "cnName_auto_sku22",
         "name": "enName_auto_sku22",
         "length": 15,
         "width": 10,
         "height": 3,
         "volume": 4.5E-4,
         "weight": 0.025,
         "registerWeight": 0.025,
         "registerLength": 15,
         "registerWidth": 10,
         "registerHeight": 3,
         "registerVolume": 4.5E-4,
         "supervisorMode": "SI",
         "brandName": "",
         "model": "",
         "isPlus": "N",
         "isBattery": "N",
         "displayPageUrl": "www.Amazon.com",
         "isActive": "Y",
         "sourceType": "Normal",
         "customsDeclarationList":          [
                        {
               "countryCode": "AU",
               "declareName": "---Other",
               "importPrice": 5,
               "exportPrice": 0,
               "rebateRate": 0,
               "importRate": 0,
               "firstWayType": "NL",
               "vatRate": 10,
               "length": 15,
               "width": 10,
               "height": 3,
               "volume": 4.5E-4,
               "weight": 0.025,
               "registerWeight": 0.025,
               "registerLength": 15,
               "registerWidth": 10,
               "registerHeight": 3,
               "registerVolume": 4.5E-4,
               "recommendDeclarePrice": 20,
               "isNew": "N",
               "cargoTypeSpec": "T50",
               "qty": null
            },
                        {
               "countryCode": "CN",
               "declareName": "其他钢笔",
               "importPrice": 0,
               "exportPrice": 5,
               "rebateRate": 13,
               "importRate": 12,
               "firstWayType": "NL",
               "vatRate": 16,
               "length": 15,
               "width": 10,
               "height": 3,
               "volume": 4.5E-4,
               "weight": 0.025,
               "registerWeight": 0.025,
               "registerLength": 15,
               "registerWidth": 10,
               "registerHeight": 3,
               "registerVolume": 4.5E-4,
               "recommendDeclarePrice": 20,
               "isNew": "N",
               "cargoTypeSpec": "T50",
               "qty": null
            },
                        {
               "countryCode": "DE",
               "declareName": "Pen",
               "importPrice": 5,
               "exportPrice": 0,
               "rebateRate": 0,
               "importRate": 3.7,
               "firstWayType": "NL",
               "vatRate": 19,
               "length": 15,
               "width": 10,
               "height": 3,
               "volume": 4.5E-4,
               "weight": 0.025,
               "registerWeight": 0.025,
               "registerLength": 15,
               "registerWidth": 10,
               "registerHeight": 3,
               "registerVolume": 4.5E-4,
               "recommendDeclarePrice": 20,
               "isNew": "N",
               "cargoTypeSpec": "T50",
               "qty": null
            },
                        {
               "countryCode": "NL",
               "declareName": "Pen",
               "importPrice": 5,
               "exportPrice": 0,
               "rebateRate": null,
               "importRate": 3.7,
               "firstWayType": "NL",
               "vatRate": 21,
               "length": 15,
               "width": 10,
               "height": 3,
               "volume": 4.5E-4,
               "weight": 0.025,
               "registerWeight": 0.025,
               "registerLength": 15,
               "registerWidth": 10,
               "registerHeight": 3,
               "registerVolume": 4.5E-4,
               "recommendDeclarePrice": 20,
               "isNew": "N",
               "cargoTypeSpec": "T50",
               "qty": null
            },
                        {
               "countryCode": "US",
               "declareName": "OTHER",
               "importPrice": 5,
               "exportPrice": 0,
               "rebateRate": null,
               "importRate": 3,
               "firstWayType": "NL",
               "vatRate": 0,
               "length": 15,
               "width": 10,
               "height": 3,
               "volume": 4.5E-4,
               "weight": 0.025,
               "registerWeight": 0.025,
               "registerLength": 15,
               "registerWidth": 10,
               "registerHeight": 3,
               "registerVolume": 4.5E-4,
               "recommendDeclarePrice": 20,
               "isNew": "N",
               "cargoTypeSpec": "T50",
               "qty": 2
            }
         ],
         "itemThirdVos":          [
                        {
               "skuCodeThird": "fba_auto_sku22",
               "description": null,
               "isActive": "Y",
               "isDelete": "N"
            },
                        {
               "skuCodeThird": "SF190426000002",
               "description": null,
               "isActive": "Y",
               "isDelete": "N"
            }
         ]
      }]
   }
}