添加商品

新增成功后会直接提交审核,可通过商品审核回调,或者通过get接口的edit_status查看是否通过审核。

商品有2份数据,草稿和线上数据。

调用接口新增或修改商品数据后,影响的只是草稿数据,审核通过后草稿数据才会覆盖线上数据,正式生效。

注意:

  1. third_cat_id请根据获取类目接口拿到,并确定其qualification_type类目资质是否为必填,若为必填,那么要先调类目资质审核接口进行该third_cat_id的资质审核;
  2. qualification_pics请根据获取类目接口中对应third_cat_idproduct_qualification_type为依据,若为必填,那么该字段需要加上该商品的资质图片;
  3. 若需要上传某品牌商品,需要按照微信小商店开通规则开通对应品牌使用权限。微信小商店品牌开通规则:点击跳转,若无品牌可指定无品牌(无品牌brand_id: 2100000000)。
  4. 库存字段stock_num注意如果是0则无法在视频号直播上架该商品,库存和价格字段可以通过免审更新接口更新
  5. 部分特殊品类商品标题需要按照规范上传,请仔细阅读,避免审核不通过。商品标题规则:点击跳转
  6. 商品详情字段desc_info.desc desc_info.imgs 虽然非必填,但一些特殊品类仍然需要上传商品详情,请仔细阅读,避免审核不通过。商品详情规则:点击跳转

接口调用请求说明

  1. http请求方式:POST
  2. https://api.weixin.qq.com/shop/spu/add?access_token=xxxxxxxxx

请求参数示例

  1. {
  2. "out_product_id": "1234566",
  3. "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
  4. "path": "pages/productDetail/productDetail?productId=2176180",
  5. "head_img":
  6. [
  7. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  8. ],
  9. "qualification_pics": [
  10. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  11. ],
  12. "desc_info":
  13. {
  14. "desc": "xxxxx",
  15. "imgs":
  16. [
  17. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  18. ]
  19. },
  20. "third_cat_id": 6666,
  21. "brand_id": 2100000000,
  22. "skus":
  23. [
  24. {
  25. "out_product_id": "1234566",
  26. "out_sku_id": "1024",
  27. "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
  28. "sale_price": 1300,
  29. "market_price": 1500,
  30. "stock_num": 100,
  31. "sku_code": "A24525252",
  32. "barcode": "13251454",
  33. "sku_attrs":
  34. [
  35. {
  36. "attr_key": "选择颜色",
  37. "attr_value": "红蓝主机"
  38. },
  39. {
  40. "attr_key": "选择套装",
  41. "attr_value": "主机+保护套"
  42. }
  43. ]
  44. }
  45. ]
  46. }

回包示例

  1. {
  2. "errcode": 0,
  3. "errmsg":"ok",
  4. "data":
  5. {
  6. "product_id": 23423523452345235,
  7. "out_product_id": "1234566",
  8. "create_time": "2020-03-25 12:05:25",
  9. "skus":
  10. [
  11. {
  12. "sku_id": 123,
  13. "out_sku_id": "1024"
  14. },
  15. ...
  16. ]
  17. }
  18. }

请求参数说明

参数类型是否必填说明
out_product_idstring商家自定义商品ID
titlestring标题
pathstring绑定的小程序商品路径
head_imgstring array主图,多张,列表
qualification_picsstring array商品资质图片
desc_info.descstring商品详情图文
desc_info.imgsstring array商品详情图片
third_cat_idnumber第三级类目ID
brand_idnumber品牌id
skus[]object arraysku数组
skus[].out_product_idstring商家自定义商品ID
skus[].out_sku_idstring商家自定义skuID
skus[].thumb_imgstringsku小图
skus[].sale_pricenumber售卖价格,以分为单位
skus[].market_pricenumber市场价格,以分为单位
skus[].stock_numnumber库存
skus[].barcodestring条形码
skus[].sku_codestring商品编码
skus[].sku_attrs[].attr_keystring销售属性key(自定义)
skus[].sku_attrs[].attr_valuestring销售属性value(自定义)

回包参数说明

参数类型说明
errcodenumber错误码
errmsgstring错误信息
data.product_idnumber交易组件平台内部商品ID
data.out_product_idstring商家自定义商品ID
data.create_timestring创建时间
data.skusobject arraysku数组
data.skus[].sku_idstring交易组件平台自定义skuID
data.skus[].out_sku_idstring商家自定义skuID