# 免审更新商品

针对已上架的商品,通过本接口可以进行免审核更新,对线上内容的更新会同步到草稿数据。更新成功后,将通过「更新回调」通知商家。

# 注意事项

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

# 接口调用请求说明

http请求方式:POST
https://api.weixin.qq.com/channels/ec/product/auditfree?access_token=ACCESS_TOKEN

# 请求参数示例

{
    "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"
}

# 请求参数说明

参数名 类型 是否必填 参数描述
product_id string(uint64) 平台生成的id
skus[] array 需要进行更新的sku
skus[].sku_id string(uint64) 更新时必填sku_id
skus[].sale_price number 售卖价格,以分为单位,不超过1000000000(1000万元)
skus[].stock_info.diff_type number 修改类型。1: 增加;2:减少;3:设置。
建议使用1或2,不建议使用3,因为使用3在高并发场景可能会出现预期外表现
skus[].stock_info.num number 增加、减少或者设置的库存值
skus[].sku_deliver_info.stock_type number sku库存情况。0:现货(默认),1:全款预售。部分类目支持全款预售,具体参考文档获取类目信息中的字段attr.pre_sale
skus[].sku_deliver_info.full_payment_presale_delivery_type number sku发货节点,该字段仅对stock_type=1有效。0:付款后n天发货,1:预售结束后n天发货
skus[].sku_deliver_info.presale_begin_time number sku预售周期开始时间,秒级时间戳,该字段仅对delivery_type=1有效。
skus[].sku_deliver_info.presale_end_time number sku预售周期结束时间,秒级时间戳,该字段仅对delivery_type=1有效。限制:预售结束时间距离现在<=30天,即presale_end_time - now <= 2592000。预售时间区间<=15天,即presale_end_time - presale_begin_time <= 1296000
skus[].sku_deliver_info.full_payment_presale_delivery_time number sku发货时效,即付款后/预售结束后{full_payment_presale_delivery_time}天内发货,该字段仅对stock_type=1时有效。当发货节点选择“0:付款后n天发货”时,范围是[4, 15]的整数;当发货节点选择“1:预售结束后n天发货”时,范围是[1, 3]的整数
skus[].is_delete number 是否要删除当前sku
limited_info.period_type number 限购周期类型,0:无限购(默认),1:按自然日限购,2:按自然周限购,3:按自然月限购,4:按自然年限购
limited_info.limited_buy_num number 限购数量
express_info.template_id string(uint64) 运费模板ID(先通过获取运费模板列表接口拿到),若deliver_method=1,则不用填写
express_info.weight number 商品重量,单位克,若当前运费模版计价方式为[按重量],则必填
extra_service.seven_day_return number 是否支持七天无理由退货,0-不支持七天无理由,1-支持七天无理由,2-支持七天无理由(定制商品除外),3-支持七天无理由(使用后不支持)。管理规则请参见七天无理由退货管理规则。类目是否必须支持七天无理由退货,可参考文档获取类目信息中的字段attr.seven_day_return
extra_service.freight_insurance number 是否支持运费险,0-不支持运费险,1-支持运费险。需要商户开通运费险服务,非必须开通运费险类目的商品依据该字段进行设置,必须开通运费险类目中的商品将默认开启运费险保障,不依据该字段。规则详情请参见 视频号小店「运费险」管理规则
extra_service.fake_one_pay_three number 是否支持假一赔三,0-不支持假一赔三,1-支持假一赔三。
extra_service.damage_guarantee number 是否支持坏损包退,0-不支持坏损包退,1-支持坏损包退。
deliver_method number 发货方式,若为无需快递(仅对部分类目开放),则无需填写运费模版id。0:快递发货(默认),1:无需快递

# 回包参数说明

参数 类型 说明
errcode number 错误码
errmsg string 错误信息