查询分销商品列表(不含描述and图片,提升拉取效率)
更新时间: 2019-07-26 11:07:38 访问次数:2898

接口说明

分销商或第三方平台通过该接口可查询可分销商品信息列表,此接口不含商品描述和图片,提升拉取效率,拉取后可使用wanyilian.supplier.spu.querySPUList接口,传入SPU,精确拉取描述和图片。

使用场景

分销商在售卖前刊登时,查询可分销商品信息;第三方平台在展示可分销商品时,查询可分销商品列表。

接口名称

wanyilian.supplier.spu.getProductBaseList

请求说明

请求内容 说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://openapi.uat1.winit.com.cn/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

请求示例

  1. {
  2. "action": "wanyilian.supplier.spu.getProductBaseList",
  3. "app_key": "huangqiuhai",
  4. "data": {
  5. "SKU": "",
  6. "SPU": "",
  7. "cid": "",
  8. "isHavingInventory": "Y",
  9. "keywords": "",
  10. "pageParams": {
  11. "pageNo": 1,
  12. "pageSize": 200,
  13. "totalCount": 0
  14. },
  15. "uDefinedCategoryID": "",
  16. "updateEndDate": "",
  17. "updateStartDate": "",
  18. "userDefinedCode": "",
  19. "warehouseCode": "UKGF",
  20. "warehouseName": ""
  21. },
  22. "format": "json",
  23. "language": "zh_CN",
  24. "platform": "SELLERERP",
  25. "sign_method": "md5",
  26. "timestamp": "2019-07-15 16:14:06",
  27. "version": "1.0",
  28. "sign": "xxx"
  29. }

返回出参

返回参数说明:正确的返回编码0及结果,错误的返回错误码及错误信息。

名称 类型 必传 说明 示例
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 关键词,多个关键词依逗号分隔
warehouseName String() Y 仓库名称
warehouseCode String() Y 仓库代码
SKUList Array Y 商品列表
-|SKU String() Y 商品编码
-|randomSKU String() Y 系统编码
-|supplyInventory Number Y 供货库存
-|sepcification String() 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)

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "pageParams": {
  6. "pageNo": 1,
  7. "pageSize": 200,
  8. "totalCount": 1
  9. },
  10. "SPUList": [
  11. {
  12. "title": "15M Trampoline Sprinkler Water Spray Park Kid Fun Summer Outdoor Water Games",
  13. "englishName": null,
  14. "chineseName": "澳洲仓 蹦床喷水 15米",
  15. "keywords": "",
  16. "userDefinedCode": "AUJJ044",
  17. "publishType": "Obtained",
  18. "thumbnail": "http://121.196.206.69:81/productImg/2023/04/27/pro_202304271047455.jpg",
  19. "categoryID": 181076,
  20. "updateDate": "2023-06-21 14:37:05",
  21. "supplierAccount": "Queenie0320",
  22. "supplierCompany": "0",
  23. "totalInventory": 77,
  24. "cid": 1402,
  25. "saleTypeIds": "1",
  26. "SPU": "S10092556",
  27. "SKUList": [
  28. {
  29. "randomSKU": "w12537028",
  30. "supplyInventory": 19,
  31. "rebate": 1.00,
  32. "supplyPrice": 444.00,
  33. "settlePrice": 444.00,
  34. "minRetailPrice": 0.00,
  35. "retailPriceCode": null,
  36. "privateInventory": 0,
  37. "wholesalePrice": 1.00,
  38. "warehouseName": "万邑通AU仓澳洲",
  39. "warehouseCode": "EWD",
  40. "freeShip": "N",
  41. "weight": 0.170,
  42. "length": 22.00,
  43. "width": 14.00,
  44. "height": 3.50,
  45. "SKU": "AUJJ037"
  46. },
  47. {
  48. "randomSKU": "w12537032",
  49. "supplyInventory": 24,
  50. "rebate": 1.00,
  51. "supplyPrice": 444.00,
  52. "settlePrice": 444.00,
  53. "minRetailPrice": 0.00,
  54. "retailPriceCode": null,
  55. "privateInventory": 0,
  56. "wholesalePrice": 1.00,
  57. "warehouseName": "万邑通AU仓澳洲",
  58. "warehouseCode": "EWD",
  59. "freeShip": "N",
  60. "weight": 0.315,
  61. "length": 21.00,
  62. "width": 16.00,
  63. "height": 6.00,
  64. "SKU": "AUJJ044"
  65. }
  66. ]
  67. }
  68. ]
  69. }
  70. }
关键词