免审更新商品

查看 Markdown

最后一次编辑于 2026-10-22

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

接口英文名:updateproductauditfree

针对已上架的商品,通过本接口可以进行免审核更新,接口只更新线上版本的数据,不影响编辑中的草稿数据。更新成功后,将通过「商品更新」「商品上架」的回调通知商家。

1. 调用方式

HTTPS 调用

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

云调用

  • 本接口不支持云调用。

第三方调用

2. 请求参数

查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstring是ACCESS_TOKEN接口调用凭证,可使用 access_token(微信小店商家)、authorizer_access_token(服务商代调用)

请求体 Request Payload

参数名类型必填说明
product_idnumber是平台生成的 id
spu_codestring否商品编码
skusobjarray是需要进行更新的 sku
limited_infoobject否限购信息
express_infoobject否运费信息
extra_serviceobject否extra_service
deliver_methodnumber否发货方式,若为无需快递(仅对部分类目开放),则无需填写运费模版 id 。 0=快递发货(默认), 1=无需快递
hide_in_windownumber否是否在店铺首页隐藏。 0=不隐藏,1=隐藏
timing_onsale_infoobject否商品待开售信息
spu_deliver_infoobject否spu 维度配置全部 sku 预售规则
after_sale_infoobject否售后/退货地址
face_activationobject否当面激活服务设置。不传该字段时不影响商品原有当面激活状态;传 is_open=0 关闭当面激活。仅已开通当面激活服务的店铺可开启,赠品商品不支持开启,不满足条件返回 10020051

Body.skus(Array) Object Payload

需要进行更新的 sku

参数名类型必填说明
sku_idnumber是更新时必填 sku_id
sku_codestring否商品 sku 编码
stock_infoobject否库存信息,供货商铺货商品(supply_source == 1)不支持修改库存
sale_pricenumber否售卖价格,以分为单位,不超过 1000000000 ( 1000 万元)
sku_deliver_infoobject否sku_deliver_info
is_deletenumber否是否要删除当前 sku
statusnumber否更新 sku 状态。0=默认值,5=上架,11=下架

Body.limited_info Object Payload

限购信息

参数名类型必填说明
period_typenumber否限购周期类型, 0=无限购(默认), 1=按自然日限购, 2=按自然周限购, 3=按自然月限购, 4=按自然年限购
limited_buy_numnumber否限购数量

Body.express_info Object Payload

运费信息

参数名类型必填说明枚举
template_idnumber否运费模板 ID (先通过获取运费模板列表接口拿到),若 deliver_method=1 ,则不用填写-
weightnumber否商品重量,单位克,若当前运费模版计价方式为[按重量],则必填-
express_typenumber否是否开启“偏远地区中转集运”枚举值

Body.extra_service Object Payload

extra_service

参数名类型必填说明
seven_day_returnnumber否是否支持七天无理由退货, 0=不支持七天无理由, 1=支持七天无理由, 2=支持七天无理由(定制商品除外), 3=支持七天无理由(使用后不支持)。管理规则请参见七天无理由退货管理规则。类目是否必须支持七天无理由退货,可参考文档获取类目信息中的字段 attr.seven_day_return
freight_insurancenumber否是否支持运费险, 0=不支持运费险, 1=支持运费险。需要商户开通运费险服务,非必须开通运费险类目的商品依据该字段进行设置,必须开通运费险类目中的商品将默认开启运费险保障,不依据该字段。规则详情请参见 微信小店「运费险」管理规则
damage_guaranteenumber否是否支持坏损包退, 0=不支持坏损包退, 1=支持坏损包退。
fake_one_pay_threenumber否是否支持假一赔三, 0=不支持假一赔三, 1=支持假一赔三。
exchange_supportnumber否是否支持换货, 0=支持换货关, 1=支持换货开。。0=关闭支持换货,1=打开支持换货
onsite_installationnumber否是否支持上门安装,0=不支持,1=商家上门安装。

Body.timing_onsale_info Object Payload

商品待开售信息

参数名类型必填说明
statusnumber否状态枚举。0=没有待开售,1=待开售
onsale_timetimestamp否开售时间,秒级时间戳, 0 为未配置时间
is_hide_pricenumber否是否隐藏价格。0=不隐藏,1=隐藏

Body.spu_deliver_info Object Payload

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

参数名类型必填说明
sku_deliver_infoobject否sku 的预售配置
is_spu_rangenumber否是否生效。0=不生效,1=生效

Body.after_sale_info Object Payload

售后/退货地址

参数名类型必填说明
after_sale_address_idnumber否售后/退货地址 id ,使用地址管理相关接口进行添加或获取

Body.face_activation Object Payload

当面激活服务设置。不传该字段时不影响商品原有当面激活状态;传 is_open=0 关闭当面激活。仅已开通当面激活服务的店铺可开启,赠品商品不支持开启,不满足条件返回 10020051

参数名类型必填说明枚举
is_opennumber否是否开启当面激活:0-关闭,1-开启0 1
collect_standard_idnumber否当面激活信息采集标准:0-未配置,1-外包装采集SN码、开机后采集SN码,2-外包装采集SN码、开机后采集IMEI码,3-外包装采集SN码、设备/机身SN码(不开机)。is_open=1 时必传且须为 1/2/3;is_open=0 时该字段会被清空0 1 2 3

Body.skus(Array).stock_info Object Payload

库存信息,供货商铺货商品(supply_source == 1)不支持修改库存

参数名类型必填说明
diff_typenumber否修改类型。 1=增加,2=减少,3=设置。 建议使用 1 或 2 ,不建议使用 3 ,因为使用 3 在高并发场景可能会出现预期外表现
numnumber否增加、减少或者设置的库存值

Body.skus(Array).sku_deliver_info Object Payload

sku_deliver_info

以下参数也使用此结构:

  • Body.spu_deliver_info.sku_deliver_info : sku 的预售配置
参数名类型必填说明
stock_typenumber否sku 库存情况。 0=现货(默认), 1=全款预售。部分类目支持全款预售,具体参考文档获取类目信息中的字段 attr.pre_sale
full_payment_presale_delivery_typenumber否sku 发货节点,该字段仅对 stock_type=1 有效。 0=付款后 n 天发货, 1=预售结束后 n 天发货
presale_begin_timenumber否sku 预售周期开始时间,秒级时间戳,该字段仅对 delivery_type=1 有效。
presale_end_timenumber否sku 预售周期结束时间,秒级时间戳,该字段仅对 delivery_type=1 有效。限制:预售结束时间距离现在<=30 天,即 presale_end_time - now <= 2592000 。预售时间区间<=15 天,即 presale_end_time - presale_begin_time <= 1296000
full_payment_presale_delivery_timenumber否sku 发货时效,即付款后/预售结束后{full_payment_presale_delivery_time}天内发货,该字段仅对 stock_type=1 时有效。当发货节点选择"0=付款后 n 天发货"时,范围是[4, 15]的整数;当发货节点选择"1=预售结束后 n 天发货"时,范围是[1, 3]的整数
spot_after_presale_endnumber否是否在预售结束后自动转为现货,该字段仅对 delivery_type=1 有效。 0=否,1=是

3. 返回参数

返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息

4. 枚举信息

Body.express_info.express_type Enum

是否开启“偏远地区中转集运”

枚举值描述
0默认,普通类型
1中转集运类型

5. 注意事项

  • 审核中的商品不支持免审更新,需要先等待审核完成或者主动取消审核。
  • 接口对传入的字段进行覆盖更新,对缺省字段不做处理。如果需要删除某个字段的内容,需要显示指定字段名,并带上空的 value 。
  • 如果只需更新库存,请使用快速更新库存接口。
  • 当面激活(face_activation):设置商品的当面激活服务(买家需当面核验后激活)。仅已开通当面激活服务的店铺可开启,赠品商品不支持开启,条件不满足或参数非法返回 10020051。不传该字段时不影响商品原有设置。

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 分暂不支持使用全款预售功能
100202460 元保证金试运营商品数超出限制,上架中与审核中商品总数不得超过 100 个,解除限制请结束试运营前往补缴保证金
10020290售后地址 id 不能为空,请填写 after_sale_info.after_sale_address_id 字段后重新提交
10020298相似商品经营受限,不允许取消隐藏
10020309商品处于待开售状态,不可编辑请立即开售或取消开售改变待开售状态,或等到开售时间后,再修改
10020310商品的待开售信息仅支持免审编辑请先取消开售,再重新更新新的待开售信息;或者免审编辑时间一次
10020311待开售时间过晚最多允许后延 90 天
10020312商品待开售请求状态参数无效确认待开售中的状态参数是否正确
10020313商品待开售请求时间参数无效确认待开售中的时间参数是否正确
10020314商品待开售请求隐藏价格参数无效确认待开售中的隐藏价格参数是否正确
10020315商品支持换货参数无效
10020322商品即将开售,不可编辑待开售信息
10020323最多修改待开售时间一次超过指定次数

8. 适用范围

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

接口变更日志(14条)
2026 年 10 月 22 日
新增 face_activation 字段设置当面激活服务( is_open 开关、 collect_standard_id 采集标准),并同步更新字段说明及注意事项。
2026 年 10 月 14 日
onsite_installation 字段新增,表示是否支持上门安装,取值 0 或 1。
2026 年 07 月 24 日
更新 express_type 字段描述
2026 年 07 月 17 日
新增 express_type 字段,新增「0」「1」等 2 个枚举选项
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 支持换货字段。