# 免审更新商品

调试诊断

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

接口英文名:updateproductauditfree

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

相关事件推送:

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 本接口不支持云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

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

# 请求体 Request Payload

参数名类型必填说明
productobject商品信息

# Body.product Object Payload

商品信息

参数名类型必填说明
product_idnumber平台生成的id
skusobjarray需要进行更新的sku
limited_infoobject限购信息
express_infoobject运费信息
extra_serviceobjectextra_service
deliver_methodnumber发货方式,若为无需快递(仅对部分类目开放),则无需填写运费模版id。0:快递发货(默认),1:无需快递
timing_onsale_infoobject商品待开售信息

# Body.product.skus(Array) Object Payload

需要进行更新的sku

参数名类型必填说明枚举
sku_idnumber更新时必填sku_id-
stock_infoobjectstock_info-
sale_pricenumber售卖价格,以分为单位,不超过1000000000(1000万元)-
sku_deliver_infoobjectsku_deliver_info-
is_deletenumber是否要删除当前sku-
statusnumber更新sku状态枚举值

# Body.product.skus(Array).stock_info Object Payload

stock_info

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

# Body.product.skus(Array).sku_deliver_info Object Payload

sku_deliver_info

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

# Body.product.limited_info Object Payload

限购信息

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

# Body.product.express_info Object Payload

运费信息

参数名类型必填说明
template_idnumber运费模板ID(先通过获取运费模板列表接口拿到),若deliver_method=1,则不用填写
weightnumber商品重量,单位克,若当前运费模版计价方式为[按重量],则必填

# Body.product.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-支持换货开。枚举值

# Body.product.timing_onsale_info Object Payload

商品待开售信息

参数名类型必填说明枚举
statusnumber状态枚举枚举值
onsale_timetimestamp开售时间,秒级时间戳,0为未配置时间-
is_hide_pricenumber是否隐藏价格枚举值

# 3. 返回参数

# 返回体 Response Payload

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

# 4. 枚举信息

# Body.product.skus(Array).status Enum

更新sku状态

枚举值描述
0默认值
5上架
11下架

# Body.product.extra_service.exchange_support Enum

是否支持换货,0-支持换货关,1-支持换货开。

枚举值描述
0关闭支持换货
1打开支持换货

# Body.product.timing_onsale_info.status Enum

状态枚举

枚举值描述
0没有待开售
1待开售

# Body.product.timing_onsale_info.is_hide_price Enum

是否隐藏价格

枚举值描述
0不隐藏
1隐藏

# 5. 注意事项

  • 审核中的商品不支持免审更新,需要先等待审核完成或者主动取消审核。
  • 接口对传入的字段进行覆盖更新,对缺省字段不做处理。如果需要删除某个字段的内容,需要显示指定字段名,并带上空的value。
  • 如果只需更新库存,请使用快速更新库存接口。

# 6. 代码示例

请求示例

{
    "product_id": "12345466",
    "skus":
    [
        {
            "sku_id": "1234565",
            "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参数错误
10020110商品信息检查不通过, 错误码:6600019 原因:你的物流体验分为3.99,低于4分暂不支持使用全款预售功能
10020290售后地址id不能为空,请填写after_sale_info.after_sale_address_id字段后重新提交
10020309商品处于待开售状态,不可编辑请立即开售或取消开售改变待开售状态,或等到开售时间后,再修改
10020310商品的待开售信息不支持编辑请先取消开售,再重新更新新的待开售信息
10020312商品待开售请求状态参数无效确认待开售中的状态参数是否正确
10020313商品待开售请求时间参数无效确认待开售中的时间参数是否正确
10020314商品待开售请求隐藏价格参数无效确认待开售中的隐藏价格参数是否正确
10020315商品支持换货参数无效

# 8. 适用范围

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

接口变更日志(2条)
2025 年 11 月 20 日
新增10020051,10020110等错误码
2025 年 10 月 30 日
新增 exchange_support 支持换货字段。