# 免审更新商品
接口应在服务器端调用,不可在前端(小程序、网页、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 | object | 是 | 商品信息 |
# Body.product Object Payload
商品信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | number | 是 | 平台生成的id |
| skus | objarray | 是 | 需要进行更新的sku |
| limited_info | object | 否 | 限购信息 |
| express_info | object | 否 | 运费信息 |
| extra_service | object | 否 | extra_service |
| deliver_method | number | 否 | 发货方式,若为无需快递(仅对部分类目开放),则无需填写运费模版id。0:快递发货(默认),1:无需快递 |
| timing_onsale_info | object | 否 | 商品待开售信息 |
# Body.product.skus(Array) Object Payload
需要进行更新的sku
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| sku_id | number | 是 | 更新时必填sku_id | - |
| stock_info | object | 否 | stock_info | - |
| sale_price | number | 否 | 售卖价格,以分为单位,不超过1000000000(1000万元) | - |
| sku_deliver_info | object | 否 | sku_deliver_info | - |
| is_delete | number | 否 | 是否要删除当前sku | - |
| status | number | 否 | 更新sku状态 | 枚举值 |
# Body.product.skus(Array).stock_info Object Payload
stock_info
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| diff_type | number | 否 | 修改类型。1: 增加;2:减少;3:设置。 建议使用1或2,不建议使用3,因为使用3在高并发场景可能会出现预期外表现 |
| num | number | 否 | 增加、减少或者设置的库存值 |
# Body.product.skus(Array).sku_deliver_info Object Payload
sku_deliver_info
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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]的整数 |
# Body.product.limited_info Object Payload
限购信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| period_type | number | 否 | 限购周期类型,0:无限购(默认),1:按自然日限购,2:按自然周限购,3:按自然月限购,4:按自然年限购 |
| limited_buy_num | number | 否 | 限购数量 |
# Body.product.express_info Object Payload
运费信息
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| template_id | number | 否 | 运费模板ID(先通过获取运费模板列表接口拿到),若deliver_method=1,则不用填写 |
| weight | number | 否 | 商品重量,单位克,若当前运费模版计价方式为[按重量],则必填 |
# Body.product.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-支持换货开。 | 枚举值 |
# Body.product.timing_onsale_info Object Payload
商品待开售信息
| 参数名 | 类型 | 必填 | 说明 | 枚举 |
|---|---|---|---|---|
| status | number | 否 | 状态枚举 | 枚举值 |
| onsale_time | timestamp | 否 | 开售时间,秒级时间戳,0为未配置时间 | - |
| is_hide_price | number | 否 | 是否隐藏价格 | 枚举值 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
# 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. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。
2025 年 11 月 20 日
新增10020051,10020110等错误码
2025 年 10 月 30 日
新增
exchange_support 支持换货字段。