# 免审更新商品
接口应在服务器端调用,不可在前端(小程序、网页、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:无需快递 |
# 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 |
# 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-支持七天无理由(使用后不支持)。管理规则请参见[七天无理由退货管理规则](https://store.weixin.qq.com/chengzhang/webdoc/wiki/1028/c603b590b41dc923/growth_center_rule_for_store?source=6&sourceType=4)。类目是否必须支持七天无理由退货,可参考文档获取类目信息中的字段attr.seven_day_return |
freight_insurance | number | 否 | 是否支持运费险,0-不支持运费险,1-支持运费险。需要商户开通运费险服务,非必须开通运费险类目的商品依据该字段进行设置,必须开通运费险类目中的商品将默认开启运费险保障,不依据该字段。规则详情请参见 [微信小店「运费险」管理规则](https://store.weixin.qq.com/chengzhang/webdoc/wiki/851/45b921bf634e1457/growth_center_rule_for_store?source=6&sourceType=4) |
damage_guarantee | number | 否 | 是否支持坏损包退,0-不支持坏损包退,1-支持坏损包退。 |
fake_one_pay_three | number | 否 | 是否支持假一赔三,0-不支持假一赔三,1-支持假一赔三。 |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
# 4. 注意事项
- 审核中的商品不支持免审更新,需要先等待审核完成或者主动取消审核。
- 接口对传入的字段进行覆盖更新,对缺省字段不做处理。如果需要删除某个字段的内容,需要显示指定字段名,并带上空的value。
- 如果只需更新库存,请使用快速更新库存接口。
# 5. 代码示例
请求示例
{
"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"
}
# 6. 错误码
此接口没有特殊错误码,可参考 通用错误码
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。