查询商品
更新时间: 2023-07-26 17:25:59 访问次数:17343
接口说明
该接口提供商品信息查询功能,长宽高重量等
接口名称
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、全量查询
{
"action": "winit.mms.item.list",
"app_key": "rebecca",
"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign": "141884496E086A7732D04FD34C7FD8A7",
"data": {
"pageNo": "1",
"pageSize": "100"
},
"format": "json",
"language": "zh_CN",
"sign": "2EE2A5E699CA2B9B729F4A2BDC2937FD",
"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"
}
返回出参
返回参数说明:正确的返回编码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 | 无用出参,不用处理 |
返回示例
{
"code": "0",
"msg": "操作成功",
"data": {
"pageParams": {
"pageNo": 1,
"pageSize": 5,
"totalCount": 1
},
"list": [
{
"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": "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"
}
]
}
]
}
}