- API
- 文档中心
- 平台公告
- 重要:沙箱环境维护通知
- 【2023-03-14】沙箱自动测试工具上线
- 【2022-07-18】Winit开通加拿大仓(CATO)通知
- 【2022-05-12】入库单状态变化通知
- 【2022-02-25】查询入库单详情接口变更通知
- 【2022-02-17】注册查询商品接口变更通知
- 关于openapi升级安全能力的通知
- 【2021-11-30】winit在2021年12月6日更改沙箱环境的网址
- 新增入库单作废接口【2021-11-18】
- 更换沙箱环境调用URL【2021-11-1】
- 入库出库退货接口变更和停用http的通知【2021-9-30】
- 开发平台请求升级为https[2021-8-6]
- 英国新增UKBM仓库及其服务[2021-7-12]
- 支持欧盟7月1日税改增加IOSS字段传输【6-28】
- ISP新增发件人VATNO和EORI【2021-3-4】
- 库存查询相关接口变更【2021-1-27】
- 脱欧政策相关API变更【2020-12-22】
- 开发者网站停机维护(无法访问官网)【2020-9-12】
- 门牌号截取服务升级
- 沙箱环境版本更新通知【2020-8-5】
- 海外仓出库单的增值服务费用金额范围变更
- 海外仓部分尾程产品服务商及追踪号上传规则变更通知【2020-6-15】
- 优化门牌号截取【2020-05-21】
- 尾程派送渠道4月13日针对收件人门牌号及其字段校验变更
- 库存查询接口说明
- 基础文档
- ERP授权操作指引
- 常见问题
- 平台公告
查询分销商品列表(不含描述and图片,提升拉取效率)
更新时间: 2025-03-10 20:36:46 访问次数:3979
接口说明
分销商或第三方平台通过该接口可查询可分销商品信息列表,此接口不含商品描述和图片,提升拉取效率,拉取后可使用wanyilian.supplier.spu.querySPUList接口,传入SPU,精确拉取描述和图片。
使用场景
分销商在售卖前刊登时,查询可分销商品信息;第三方平台在展示可分销商品时,查询可分销商品列表。
接口名称
wanyilian.supplier.spu.getProductBaseList
请求说明
| 请求内容 | 说明 |
|---|---|
| URL | https://openapi.wanyilian.com/cedpopenapi/service |
| 验证方法 | Token,md5 |
| 格式 | json |
| 字符编码 | UTF-8 |
| http请求方式 | http |
| 请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
| 名称 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| SPU | String() | N | SPU,分销系统生成分销商品维一标识码 | |
| SKU | String() | N | 商品编码,一般为客户商品唯一编码 | |
| userDefinedCode | String() | N | 客户自定义编码,添加分销商品时可自定义填写 | |
| cid | int | N | 商品分类ID(新增) | 1 |
| saleTypeIds | String() | N | 商品销售类型(新增,支持多类型搜索) | 1,2,3 |
| keywords | String() | N | 标签/关键字 | |
| warehouseName | String() | N | 仓库名称 | |
| warehouseCode | String() | N | 仓库代码 | |
| isHavingInventory | String() | Y | 是否有库存,默认”Y” | “Y/N” |
| updateStartDate | String() | Y | SPU更新时间,起始时间 | ”2018-08-19 10:10:10“ |
| updateEndDate | String() | Y | SPU更新时间,截止时间 | |
| pageParams | Array | Y | 分布参数 | |
| - pageSize | int | Y | 每页显示数量,默认和最大200 | |
| - pageNo | int | Y | 页码,第几页,默认1 |
请求示例
{"action": "wanyilian.supplier.spu.getProductBaseList","app_key": "huangqiuhai","data": {"SKU": "","SPU": "","cid": "","isHavingInventory": "Y","keywords": "","pageParams": {"pageNo": 1,"pageSize": 200,"totalCount": 0},"uDefinedCategoryID": "","updateEndDate": "","updateStartDate": "","userDefinedCode": "","warehouseCode": "UKGF","warehouseName": ""},"format": "json","language": "zh_CN","platform": "SELLERERP","sign_method": "md5","timestamp": "2019-07-15 16:14:06","version": "1.0","sign": "xxx"}
返回出参
返回参数说明:正确的返回编码0及结果,错误的返回错误码及错误信息。
| 名称 | 类型 | 必传 | 说明 | 示例 |
|---|---|---|---|---|
| pid | Number | Y | 产品ID | |
| SPU | String() | Y | SPU分销系统生成分销商品维一标识码 | S10016230 |
| supplierAccount | String() | Y | 供应商账号 | |
| supplierCompany | String() | Y | 供应商名称 | |
| userDefinedCode | String() | Y | 客户自定义编码 | |
| title | String() | Y | 商品标题 | |
| chineseName | String() | Y | 中文名称 | |
| englishName | String() | Y | 英文名称 | |
| totalInventory | Number | Y | 可用总库存 | |
| cid | int | Y | 商品分类id(新增) | |
| saleTypeIds | String() | Y | 商品销售类型(新增) | |
| publishType | String() | Y | unPublish:未发布 Draft:草稿 Publish:发布 Obtained:下架 | |
| thumbnail | String() | Y | 主图url | |
| keywords | String() | Y | 关键词,多个关键词依逗号分隔 | |
| SKUList | Array | Y | 商品列表 | |
| - SKU | String() | Y | 商品编码 | |
| - randomSKU | String() | Y | 系统编码 | |
| - supplyInventory | Number | Y | 供货库存 | |
| - freeShip | String() | Y | 包邮 Y-是,N-否 | |
| - rebate | Number | Y | 折扣(%) | 0-100 |
| - supplyPrice | Number | Y | 供货价格(RMB) | |
| - settlePrice | Number | Y | 结算价格(RMB), 结算价格=供货价格*折扣 | |
| - minRetailPrice | Number | Y | 最低零售价(本地币种) | |
| - retailPriceCode | String() | Y | 最低零售价币种 | CNY,USD,AUD |
| - weight | Number | Y | 重量(kg) | |
| - length | Number | Y | 长度(cm) | |
| - width | Number | Y | 宽度(cm) | |
| - height | Number | Y | 高度(cm) | |
| - privateInventory | Number | N | //专属/保留库存 | |
| - wholesalePrice | Number | N | 批发价 | |
| - warehouseCode | String() | Y | 仓库编码 | |
| - warehouseName | String() | Y | 仓库名称 | |
| - countryCode | String() | Y | 国家二字码 | |
| - tmppic | String() | Y | 明细图片链接 |
返回示例
{"code": "0","msg": "操作成功","data": {"pageParams": {"pageNo": 1,"pageSize": 200,"totalCount": 1},"SPUList": [{"title": "15M Trampoline Sprinkler Water Spray Park Kid Fun Summer Outdoor Water Games","englishName": null,"chineseName": "澳洲仓 蹦床喷水 15米","keywords": "","userDefinedCode": "AUJJ044","publishType": "Obtained","thumbnail": "http://121.196.206.69:81/productImg/2023/04/27/pro_202304271047455.jpg","categoryID": 181076,"updateDate": "2023-06-21 14:37:05","supplierAccount": "Queenie0320","supplierCompany": "0","totalInventory": 77,"cid": 1402,"saleTypeIds": "1","SPU": "S10092556","SKUList": [{"randomSKU": "w12537028","supplyInventory": 19,"rebate": 1.00,"supplyPrice": 444.00,"settlePrice": 444.00,"minRetailPrice": 0.00,"retailPriceCode": null,"privateInventory": 0,"wholesalePrice": 1.00,"warehouseName": "万邑通AU仓澳洲","warehouseCode": "EWD","freeShip": "N","weight": 0.170,"length": 22.00,"width": 14.00,"height": 3.50,"SKU": "AUJJ037"},{"randomSKU": "w12537032","supplyInventory": 24,"rebate": 1.00,"supplyPrice": 444.00,"settlePrice": 444.00,"minRetailPrice": 0.00,"retailPriceCode": null,"privateInventory": 0,"wholesalePrice": 1.00,"warehouseName": "万邑通AU仓澳洲","warehouseCode": "EWD","freeShip": "N","weight": 0.315,"length": 21.00,"width": 16.00,"height": 6.00,"SKU": "AUJJ044"}]}]}}
关键词
