添加商品

注意:商品有2份数据,草稿和线上数据 调用接口新增和修改商品数据后,影响的只是草稿数据,要调上架接口,并审核通过,草稿数据才会覆盖线上数据正式生效

接口调用请求说明

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

请求参数示例

  1. {
  2. "out_product_id": "1234566",
  3. "title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
  4. "sub_title": "JD自营更放心】【国行Switch,更安心的保修服务,更快的国行服务器】一台主机三种模式,游戏掌机,随时随地,一起趣玩。",
  5. "head_img":
  6. [
  7. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  8. ],
  9. "desc_info":
  10. {
  11. "imgs":
  12. [
  13. "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg"
  14. ]
  15. },
  16. "brand_id": 2100000000,
  17. "cats":
  18. [
  19. {
  20. "cat_id": 6033,
  21. "level": 1
  22. },
  23. {
  24. "cat_id": 6057,
  25. "level": 2
  26. },
  27. {
  28. "cat_id": 6091,
  29. "level": 3
  30. }
  31. ],
  32. "attrs":
  33. [
  34. {
  35. "attr_key": "商品毛重",
  36. "attr_value": "380g"
  37. },
  38. {
  39. "attr_key": "商品产地",
  40. "attr_value": "中国大陆"
  41. }
  42. ],
  43. "model": "国行续航增强版",
  44. "express_info":
  45. {
  46. "template_id": 5189
  47. },
  48. "skus":
  49. [
  50. {
  51. "out_product_id": "1234566",
  52. "out_sku_id": "1024",
  53. "thumb_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/100778/17/13648/424215/5e590a40E2d68e774/e171d222a0c9b763.jpg",
  54. "sale_price": 1300,
  55. "market_price": 1500,
  56. "stock_num": 100,
  57. "sku_code": "A24525252",
  58. "barcode": "13251454",
  59. "sku_attrs":
  60. [
  61. {
  62. "attr_key": "选择颜色",
  63. "attr_value": "红蓝主机"
  64. },
  65. {
  66. "attr_key": "选择套装",
  67. "attr_value": "主机+保护套"
  68. }
  69. ]
  70. }
  71. ]
  72. }

回包示例

  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. }
  10. }

请求参数说明

参数类型是否必填说明
out_product_idstring商家自定义商品ID,与product_id二选一
titlestring标题
sub_titlestring副标题
head_imgstring array主图,多张,列表,最多9张,每张不超过2MB
desc_info.imgsstring array商品详情,图文(目前只支持图片,最多20张,每张不超过2MB)
brand_idnumber品牌ID,商家需要申请品牌并通过获取品牌接口brand/get获取,如果是无品牌请填2100000000
cats[].cat_idnumber类目ID,如果brand_id=2100000000,需要先通过获取类目接口category/get拿到可用的cat_id;如果brand_id!=2100000000,则这里的cat_id需要与获取品牌接口brand/get中的1,2,3级类目一一对应
cats[].levelnumber类目层级
attrs[].attr_keystring属性键key(属性自定义用)
attrs[].attr_valuestring属性值(属性自定义用)
modelstring商品型号
express_info.template_idnumber运费模板ID(先通过获取运费模板接口delivery/get_freight_template拿到)
skus[]array该 skus 列表非必填,可另行通过 BatchAddSKU 添加 SKU
skus[].out_product_idstringskus非空时必填商家自定义商品ID
skus[].out_sku_idstringskus非空时必填商家自定义skuID
skus[].thumb_imgstringskus非空时必填sku小图
skus[].sale_pricenumberskus非空时必填售卖价格,以分为单位
skus[].market_pricenumberskus非空时必填市场价格,以分为单位
skus[].stock_numnumberskus非空时必填库存
skus[].barcodestring条形码
skus[].sku_codestring商品编码
skus[].sku_attrs[].attr_keystringskus非空时必填属性键key(属性自定义用)
skus[].sku_attrs[].attr_valuestringskus非空时必填属性值(属性自定义用)

回包参数说明

参数类型说明
errcodenumber错误码
errmsgstring错误信息
data.product_idnumber小商店内部商品ID
data.out_product_idstring商家自定义商品ID
data.create_timestring创建时间

返回码

返回码错误类型
-1系统异常
-2token太长
9401020参数有误
9401021无权限调用该api
9401002SPU不存在
9401001SPU已经存在
9401023SPU不允许编辑