# 添加商品

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

接口英文名：addproduct

通过该接口可对商品添加微信小店

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/product/add?access_token=ACCESS_TOKEN

# 云调用

• 本接口不支持云调用。

# 第三方调用

• 本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍

• 该接口所属的权限集 id 为：129

• 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String Parameters

# 请求体 Request Payload

# Body.desc_info Object Payload

商品详情

# Body.cats(Array) Object Payload

商品类目，大小恒等于 3 （一二三级类目），商品上架后不可修改一级类目

# Body.cats_v2(Array) Object Payload

商品类目，新类目树结构，商品上架后不可修改一级类目

# Body.attrs(Array) Object Payload

商品参数，部分类目有必填的参数，具体参考获取类目信息中的字段 attr.product_attr_list[].is_required

# Body.product_qua_infos(Array) Object Payload

商品资质列表，取代 qualifications 字段。注意：不同类目下必填的资质要求不同，具体参考文档获取类目信息中的字段 product_qua_list[]

# Body.express_info Object Payload

运费信息

# Body.limited_info Object Payload

限购信息

# Body.extra_service Object Payload

额外服务 [ 为提升商家发品成功率，若入参信息不符合平台规则（详见各种服务的相关文档），平台会将其优化至符合规则的参数值。如，某类目要求发品时关闭运费险，但商家入参为空或开启运费险，则平台会将其调整为关闭运费险。 ]

# Body.skus(Array) Object Payload

商品 SKU ，长度最少为 1 ，最大为 500

# Body.after_sale_info Object Payload

售后/退货地址

# Body.size_chart Object Payload

尺码表

# Body.timing_onsale_info Object Payload

商品待开售信息

# Body.head_videos Object Payload

商品头图视频，最多上传 1 个。不传递该字段时不会删除商品原有视频，如果需要删除视频，请显式传入一个空的 video_url 字符串。

# Body.spu_deliver_info Object Payload

spu 维度配置全部 sku 预售规则

# Body.supply_source Object Payload

供货货品（商品来源）信息

# Body.skus(Array).sku_attrsObject Payload

规格

# Body.skus(Array).sku_deliver_info Object Payload

sku 库存信息

以下参数也使用此结构：

• Body.spu_deliver_info.sku_deliver_info ： sku 的预售配置

# Body.size_chart.specification_list(Array) Object Payload

尺码表，启用尺码表时必填

# Body.size_chart.specification_list(Array).value_listObject Payload

尺码值与尺码属性值的映射列表

# 3. 返回参数

# 返回体 Response Payload

# Res.data Object Payload

data

# 4. 注意事项

• 商品有 2 份数据，草稿和线上数据，调用接口新增和修改商品数据后，影响的只是草稿数据，要调上架接口，并审核通过，草稿数据才会覆盖线上数据正式生效;
• 商品 sku 数量超过 25 个的情况下，接口会异步更新商品信息;
• 在上传完成之前调用上架商品接口，会返回 10020067 ，因此如果有更新商品并提交审核的需求，建议直接在本接口将 listing 参数设置为 1 ，不需要再调用上架商品的接口；
• 图片相关参数（如 head_img 、 desc_info.imgs 、 qualifications 、 product_qua_infos[].qua_url[]、 skus[].thumb_img 等），请务必使用接口上传图片（参数 resp_type=1 ），并将返回的 img_url 填入此处，不接受其他任何格式的图片 url 。若 url 曾经做过转换（ url 前缀为 mmecimage.cn/p/），则可以直接提交。
• 启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。此接口新增 cats_v2 字段支持新类目树，详见参数。
  • 如果商户设置了 cats_v2 的信息，会优先读取 cats_v2 ，作为类目信息，说明商户请求使用新的类目结构（多级类目结构）。
  • 如果商户未设置 cats_v2 字段，使用 cats ，说明商户请求使用旧的类目结构（三级类目结构）。
  • cats_v2 字段填写类目信息（与 level1 / level2 / levle3 字段同级），顺序与一，二，三，...， N 级类目严格一致，即数组下标为 0 的是一级类目，数组下标为 1 的是二级类目，数组下标 length - 1 的是 N 级类目（即最后一级叶子类目）。
  • 上架过的商品不允许修改一级类目，即上架后 cats_v2[0]不可修改。
• 关于类目属性更名的填写说明：请按照平台最新的类目属性结构进行传参。若您同时传递了新旧两个同义属性，系统将仅保留最新属性名及其属性值，旧版属性将被自动过滤。
  • 举例： 若同时传入“产地”和“商品产地”，因“产地”为最新属性名，系统将仅同步“产地”的值，“商品产地”的值将被忽略。

# 5. 代码示例

请求示例

{
	"title": "任天堂 Nintendo Switch 国行续航增强版 NS家用体感游戏机掌机 便携掌上游戏机 红蓝主机",
	"short_title": "任天堂 Nintendo Switch 国行续航增强版",
	"head_imgs": [
		"https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
	],
	"desc_info": {
		"imgs": [
			"https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
		],
		"desc": "物美价廉"
	},
	"cats": [],
	"cats_v2": [
		{
			"cat_id":6000
		},
		{
			"cat_id": "10000113"
		},
		{
			"cat_id": "6091"
		}
	],
	"attrs": [
		{
			 "attr_key": "产地",
			 "attr_value": "四川成都"
		},
		{
			 "attr_key": "材质",
			 "attr_value": "玻璃"
		},
		{
			"attr_key": "适用人群",
			"attr_value": "青年;中年"
		},
		{
			"attr_key": "数量",
			"attr_value": "33"
		},
		{
			"attr_key": "精度",
			"attr_value": "3.001"
		},
		{
			"attr_key": "重量",
			"attr_value": "38 mg"
		},
		{
		   "attr_key": "毛重",
		   "attr_value": "380 kg"
		}       
	],
	"express_info": {
		"template_id":1
	},
	"skus": [
		{
			"thumb_img": "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
			"sale_price": 1300,
			"stock_num": 100,
			"sku_code": "A24525252",
			"sku_attrs": [
				{
					"attr_key": "产地",
					"attr_value": "四川成都"
				},
				{
					"attr_key": "材质",
					"attr_value": "玻璃"
				},
				{
					"attr_key": "适用人群",
					"attr_value": "青年;中年"
				},
				{
					"attr_key": "数量",
					"attr_value": "33"
				},
				{
					"attr_key": "精度",
					"attr_value": "3.001"
				},
				{
					"attr_key": "重量",
					"attr_value": "38 mg"
				},
				{
					"attr_key": "毛重",
					"attr_value": "380 kg"
				}      
			],
			"sku_deliver_info": {
				"stock_type":0
			}
		}
	],
	"product_qua_infos": [
	  {
		"qua_id": "1111488",
		"qua_url": [
		  "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
		  "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn71nCC"
		]
	  },
	  {
		"qua_id": "1111489",
		"qua_url": [
		  "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ",
		  "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn71nCC"
		]
	  }
	]
}

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"data": {
		"product_id":"10000000000001",
		"create_time": "2026-06-09 21:00:29"
	}
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

# 7. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。

接口变更日志（17条）

2026 年 07 月 07 日

title 字段 至少1个有效字符

2026 年 06 月 16 日

关于类目属性更名的填写说明

2026 年 05 月 20 日

更新 supply_source 字段描述

2026 年 05 月 18 日

video_url 字段类型从 array 更新为 string

2026 年 05 月 07 日

更新 详情图 字段描述为最多50张

2026 年 04 月 22 日

新增 supply_source 字段

2026 年 04 月 14 日

新增 商品头图视频

2026 年 04 月 09 日

新增 head_videos 字段

2026 年 03 月 23 日

新增 hide_in_window 字段

2026 年 03 月 09 日

更新接口错误描述与参数说明，“销售属性”改为“规格”

2026 年 01 月 30 日

新增预售配置 spot_after_presale_end 字段

2026 年 01 月 16 日

新增spu维度的sku预售配置

2025 年 12 月 03 日

补充商品待开售字段

2025 年 11 月 17 日

更新 extra_service 处理逻辑。为提升商家发品成功率，若入参信息不符合平台规则（详见各种服务的相关文档），平台会将其优化至符合规则的参数值。如，某类目要求发品时关闭运费险，但商家入参为空或开启运费险，则平台会将其调整为关闭运费险。

2025 年 11 月 14 日

错误码 新增「10020246」「10020250」等 4 个枚举值

2025 年 11 月 12 日

sub_title字段标记为废弃

2025 年 10 月 30 日

新增 exchange_support 支持换货字段。