# 免审更新商品

接口应在服务器端调用,不可在前端(小程序、网页、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_tokenstringACCESS_TOKEN接口调用凭证,可使用 access_tokenauthorizer_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:无需快递

# 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

# 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-支持七天无理由(使用后不支持)。管理规则请参见[七天无理由退货管理规则](https://store.weixin.qq.com/chengzhang/webdoc/wiki/1028/c603b590b41dc923/growth_center_rule_for_store?source=6&sourceType=4)。类目是否必须支持七天无理由退货,可参考文档获取类目信息中的字段attr.seven_day_return
freight_insurancenumber是否支持运费险,0-不支持运费险,1-支持运费险。需要商户开通运费险服务,非必须开通运费险类目的商品依据该字段进行设置,必须开通运费险类目中的商品将默认开启运费险保障,不依据该字段。规则详情请参见 [微信小店「运费险」管理规则](https://store.weixin.qq.com/chengzhang/webdoc/wiki/851/45b921bf634e1457/growth_center_rule_for_store?source=6&sourceType=4)
damage_guaranteenumber是否支持坏损包退,0-不支持坏损包退,1-支持坏损包退。
fake_one_pay_threenumber是否支持假一赔三,0-不支持假一赔三,1-支持假一赔三。

# 3. 返回参数

# 返回体 Response Payload

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

# 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. 适用范围

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