express_type 字段,新增「0」「1」等 2 个枚举选项# 免审更新商品
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:updateproductauditfree
针对已上架的商品,通过本接口可以进行免审核更新,接口只更新线上版本的数据,不影响编辑中的草稿数据。更新成功后,将通过「商品更新」「商品上架」的回调通知商家。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/product/auditfree?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为:129
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代微信小店商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用) |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | number | 是 | 平台生成的 id |
| spu_code | string | 否 | 商品编码 |
| skus | objarray | 是 | 需要进行更新的 sku |
| limited_info | object | 否 | 限购信息 |
| express_info | object | 否 | 运费信息 |
| extra_service | object | 否 | extra_service |
| deliver_method | number | 否 | 发货方式,若为无需快递(仅对部分类目开放),则无需填写运费模版 id 。 0=快递发货(默认), 1=无需快递 |
| hide_in_window | number | 否 | 是否在店铺首页隐藏。 0=不隐藏,1=隐藏 |
| timing_onsale_info | object | 否 | 商品待开售信息 |
| spu_deliver_info | object | 否 | spu 维度配置全部 sku 预售规则 |
| after_sale_info | object | 否 | 售后/退货地址 |
# Body.skus(Array) Object Payload
需要进行更新的 sku
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sku_id | number | 是 | 更新时必填 sku_id |
| sku_code | string | 否 | 商品 sku 编码 |
| stock_info | object | 否 | 库存信息,供货商铺货商品(supply_source == 1)不支持修改库存 |
| sale_price | number | 否 | 售卖价格,以分为单位,不超过 1000000000 ( 1000 万元) |
| sku_deliver_info | object | 否 | sku_deliver_info |
| is_delete | number | 否 | 是否要删除当前 sku |
| status | number | 否 | 更新 sku 状态。0=默认值,5=上架,11=下架 |
# Body.limited_info Object Payload
限购信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| period_type | number | 否 | 限购周期类型, 0=无限购(默认), 1=按自然日限购, 2=按自然周限购, 3=按自然月限购, 4=按自然年限购 |
| limited_buy_num | number | 否 | 限购数量 |
# Body.express_info Object Payload
运费信息
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| template_id | number | 否 | 运费模板 ID (先通过获取运费模板列表接口拿到),若 deliver_method=1 ,则不用填写 | - |
| weight | number | 否 | 商品重量,单位克,若当前运费模版计价方式为[按重量],则必填 | - |
| express_type | number | 否 | 中转类型 | 枚举值 |
# Body.extra_service Object Payload
extra_service
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| seven_day_return | number | 否 | 是否支持七天无理由退货, 0=不支持七天无理由, 1=支持七天无理由, 2=支持七天无理由(定制商品除外), 3=支持七天无理由(使用后不支持)。管理规则请参见七天无理由退货管理规则。类目是否必须支持七天无理由退货,可参考文档获取类目信息中的字段 attr.seven_day_return |
| freight_insurance | number | 否 | 是否支持运费险, 0=不支持运费险, 1=支持运费险。需要商户开通运费险服务,非必须开通运费险类目的商品依据该字段进行设置,必须开通运费险类目中的商品将默认开启运费险保障,不依据该字段。规则详情请参见 微信小店「运费险」管理规则 |
| damage_guarantee | number | 否 | 是否支持坏损包退, 0=不支持坏损包退, 1=支持坏损包退。 |
| fake_one_pay_three | number | 否 | 是否支持假一赔三, 0=不支持假一赔三, 1=支持假一赔三。 |
| exchange_support | number | 否 | 是否支持换货, 0=支持换货关, 1=支持换货开。。0=关闭支持换货,1=打开支持换货 |
# Body.timing_onsale_info Object Payload
商品待开售信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | number | 否 | 状态枚举。0=没有待开售,1=待开售 |
| onsale_time | timestamp | 否 | 开售时间,秒级时间戳, 0 为未配置时间 |
| is_hide_price | number | 否 | 是否隐藏价格。0=不隐藏,1=隐藏 |
# Body.spu_deliver_info Object Payload
spu 维度配置全部 sku 预售规则
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sku_deliver_info | object | 否 | sku 的预售配置 |
| is_spu_range | number | 否 | 是否生效。0=不生效,1=生效 |
# Body.after_sale_info Object Payload
售后/退货地址
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| after_sale_address_id | number | 否 | 售后/退货地址 id ,使用地址管理相关接口进行添加或获取 |
# Body.skus(Array).stock_info Object Payload
库存信息,供货商铺货商品(supply_source == 1)不支持修改库存
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| diff_type | number | 否 | 修改类型。 1=增加,2=减少,3=设置。 建议使用 1 或 2 ,不建议使用 3 ,因为使用 3 在高并发场景可能会出现预期外表现 |
| num | number | 否 | 增加、减少或者设置的库存值 |
# Body.skus(Array).sku_deliver_info Object Payload
sku_deliver_info
以下参数也使用此结构:
- Body.spu_deliver_info.sku_deliver_info : sku 的预售配置
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| stock_type | number | 否 | sku 库存情况。 0=现货(默认), 1=全款预售。部分类目支持全款预售,具体参考文档获取类目信息中的字段 attr.pre_sale |
| full_payment_presale_delivery_type | number | 否 | sku 发货节点,该字段仅对 stock_type=1 有效。 0=付款后 n 天发货, 1=预售结束后 n 天发货 |
| presale_begin_time | number | 否 | sku 预售周期开始时间,秒级时间戳,该字段仅对 delivery_type=1 有效。 |
| presale_end_time | number | 否 | sku 预售周期结束时间,秒级时间戳,该字段仅对 delivery_type=1 有效。限制:预售结束时间距离现在<=30 天,即 presale_end_time - now <= 2592000 。预售时间区间<=15 天,即 presale_end_time - presale_begin_time <= 1296000 |
| full_payment_presale_delivery_time | number | 否 | sku 发货时效,即付款后/预售结束后{full_payment_presale_delivery_time}天内发货,该字段仅对 stock_type=1 时有效。当发货节点选择"0=付款后 n 天发货"时,范围是[4, 15]的整数;当发货节点选择"1=预售结束后 n 天发货"时,范围是[1, 3]的整数 |
| spot_after_presale_end | number | 否 | 是否在预售结束后自动转为现货,该字段仅对 delivery_type=1 有效。 0=否,1=是 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
# 4. 枚举信息
# Body.express_info.express_type Enum
中转类型
| 枚举值 | 描述 |
|---|---|
| 0 | 默认,普通类型 |
| 1 | 中转集运类型 |
# 5. 注意事项
- 审核中的商品不支持免审更新,需要先等待审核完成或者主动取消审核。
- 接口对传入的字段进行覆盖更新,对缺省字段不做处理。如果需要删除某个字段的内容,需要显示指定字段名,并带上空的 value 。
- 如果只需更新库存,请使用快速更新库存接口。
# 6. 代码示例
请求示例
{
"product_id":"10000000000001",
"skus":
[
{
"sku_id":"1000000001",
"sku_code": "SKU_1",
"sale_price": 1000,
"sku_deliver_info": {}
},
{
"sku_id": "1234557",
"is_delete": true // 删除sku
}
],
"spu_code": "SPU_123",
"limited_info": {}
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 7. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 10020051 | 参数错误 | |
| 10020065 | 商品未上架或不存在 | |
| 10020083 | 该商品所需类目保证金高于当前保证金余额,请前往商家网页端( https://store.weixin.qq.com/shop/deposit/home )添加一次该类目商品,即可完成保证金补缴 | |
| 10020110 | 商品信息检查不通过, 错误码:6600019 原因:你的物流体验分为 3.99 ,低于 4 分暂不支持使用全款预售功能 | |
| 10020246 | 0 元保证金试运营商品数超出限制,上架中与审核中商品总数不得超过 100 个,解除限制请结束试运营前往补缴保证金 | |
| 10020290 | 售后地址 id 不能为空,请填写 after_sale_info.after_sale_address_id 字段后重新提交 | |
| 10020298 | 相似商品经营受限,不允许取消隐藏 | |
| 10020309 | 商品处于待开售状态,不可编辑 | 请立即开售或取消开售改变待开售状态,或等到开售时间后,再修改 |
| 10020310 | 商品的待开售信息仅支持免审编辑 | 请先取消开售,再重新更新新的待开售信息;或者免审编辑时间一次 |
| 10020311 | 待开售时间过晚 | 最多允许后延 90 天 |
| 10020312 | 商品待开售请求状态参数无效 | 确认待开售中的状态参数是否正确 |
| 10020313 | 商品待开售请求时间参数无效 | 确认待开售中的时间参数是否正确 |
| 10020314 | 商品待开售请求隐藏价格参数无效 | 确认待开售中的隐藏价格参数是否正确 |
| 10020315 | 商品支持换货参数无效 | |
| 10020322 | 商品即将开售,不可编辑待开售信息 | |
| 10020323 | 最多修改待开售时间一次 | 超过指定次数 |
# 8. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。
2026 年 07 月 17 日
新增
2026 年 06 月 16 日
更新
stock_info 字段描述2026 年 06 月 05 日
stock_info 铺货商品不支持修改库存
2026 年 03 月 23 日
新增
hide_in_window 字段,用于表示是否在店铺首页隐藏2026 年 03 月 12 日
免审编辑增加售后地址参数
2026 年 01 月 30 日
新增预售配置 spot_after_presale_end 字段
2026 年 01 月 16 日
新增spu维度的sku预售配置
2026 年 01 月 07 日
枚举值变更:
错误码 字段新增「待开售时间过晚」「商品即将开售,不可编辑待开售信息」「最多修改待开售时间一次」等 3 个枚举值,更新 错误码 字段描述2025 年 12 月 16 日
修复请求参数
2025 年 11 月 20 日
新增10020051,10020110等错误码
2025 年 10 月 30 日
新增
exchange_support 支持换货字段。