# 更新非卖赠品

# 接口说明

该接口用于对微信小店内非卖赠品信息的更新

# 注意事项

  • 在售赠品会自动同步母品信息,不支持接口更新。

  • 赠品有2份数据,草稿和线上数据,调用接口新增和修改赠品数据后,影响的只是草稿数据,要调用上架商品接口(或本接口参数listing设置为1),并审核通过,草稿数据才会覆盖线上数据正式生效。

  • 赠品目前仅支持单sku。

  • 在上传完成之前调用上架商品接口,会返回10020067,因此如果有更新赠品并提交审核的需求,建议直接在本接口将listing参数设置为1,不需要再调用上架赠品的接口。

  • 该接口请求方式和添加非卖赠品接口基本一致,区别在于请求该接口时需要带上已存在的product_id。

  • 该接口是覆盖写操作,每次提交后,草稿数据会被整体替换为本次请求上传的数据:

    1. 若sku列表中带上已存在的sku_id,则会用新上传的内容更新对应的sku草稿;
    2. 若列表中某个的sku没有传入sku_id,则视为新增的sku,分配新的sku_id并插入到赠品草稿中;
    3. 若原本存在于赠品信息中的某个sku_id,在本次更新没有上传,则视为删除,赠品草稿将移除该sku,在赠品审核通过后,以上变动将作用于线上数据。
  • 图片相关参数(如head_img、desc_info.imgs、qualifications、product_qua_infos[].qua_url[]、skus[].thumb_img等),请务必使用接口上传图片(参数resp_type=1),并将返回的img_url填入此处,不接受其他任何格式的图片url。若url曾经做过转换( url前缀为mmecimage.cn/p/),则可以直接提交。

# 接口调用请求说明

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

# 请求参数说明

参数 类型 是否必填 描述
product_id string(uint64) 商品ID
out_product_id string 外部平台自定义赠品ID,小店后台不作任何唯一性约束,开发者自行保证,一旦添加成功后该字段无法修改,最多128字符
title string 标题,应至少含5个有效字符数(中文文字/英文字母/数字,都各算1个有效字符数,且不得仅为数字或英文,不得含非法字符,允许的特殊字符集为:`·~~!@#$%^&()!@#¥%……&*()-_——=+[]\【】、{} \||;';’:": ‘“”,./,。、<>?《》?\u00A0\u0020\u3000),最多60字符。

合规赠品标题举例:
1.糖醋排骨【预订价10元】;
2.CheddarCheese切达干酪;
3.百岁山天然矿泉水1L*15瓶。
不合规赠品标题举例:
1.正宗五指毛桃根√;
2.Classic Whole Wheat;
3.便携式折叠扇第Ⅲ代;
4.iPhone 13;
5.Mac999;
6.[五元]扇子
head_imgs array[string] 主图,多张,列表,最少3张(食品饮料和生鲜类目赠品最少4张),最多9张。不得有重复图片。无形状尺寸要求,最终在商详页会显示为正方形
desc_info.imgs array[string] 赠品详情图片(最少1张,最多20张。其中食品饮料和生鲜类目赠品最少3张)。不得有重复图片
desc_info.desc string 赠品详情文本
cats_v2[] array 赠品类目,新类目树结构|
cats_v2[].cat_id string(uint64) 类目ID,需要先通过获取类目接口拿到可用的cat_id;这里的cat_id顺序与一,二,三,...,N 级类目严格一致,即数组下标为 0 的是一级类目,数组下标为 1 的是二级类目,数组下标 length - 1 的是 N 级类目(即最后一级叶子类目)|
attrs[] array 赠品参数,部分类目有必填的参数,具体参考文档获取类目信息中的字段attr.product_attr_list[].is_required
attrs[].attr_key string 属性键key(属性自定义用)
attrs[].attr_value string 属性值(属性自定义用)。如果添加时没录入,回包可能不包含该字段,参数规则如下:
● 当获取类目信息接口中返回的type:为 select_many,
attr_value的格式:多个选项用分号;隔开
示例:某赠品的适用人群属性,选择了:青年、中年,则 attr_value的值为:青年;中年
● 当获取类目信息接口中返回的type:为 integer_unit/decimal4_unit
attr_value格式:数值 单位,用单个空格隔开
示例:某赠品的重量属性,要求integer_unit属性类型,数值部分为 18,单位选择为kg,则 attr_value的值为:18 kg
● 当获取类目信息接口中返回的type:为 integer/decimal4
attr_value 的格式:字符串形式的数字
spu_code string 商家自定义的赠品编码
brand_id string(uint64) 品牌id,无品牌为“2100000000”
skus[] array 仅支持单sku,长度固定为1
skus[].sku_id string(uint64) 若填了已存在sku_id,则进行更新sku操作,否则新增sku
skus[].out_sku_id string 外部平台自定义sku_id,小店后台不作任何唯一性约束,开发者自行保证,一旦添加成功后该字段无法修改,最多128字符
skus[].sale_price number 售卖价格,以分为单位,不超过1000000000(1000万元)
skus[].stock_num number 直接设置赠品库存,在高并发场景可能会出现预期外表现,更新时建议使用stock_diff
skus[].stock_diff.diff_type number 库存修改类型。1: 增加;2:减少。
skus[].stock_diff.num number 增加、减少或者设置的库存值。
skus[].sku_code string 商家自定义的sku编码,最多100字符
listing number 添加完成后是否立即上架。1:是;0:否;默认0

# 请求参数示例

{
    "product_id": "1700000000000",
    "title": "宠物玩具5",
    "head_imgs": [
        "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
    ],
    "desc_info": {
        "imgs": [
            "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ"
        ],
        "desc": "物美价廉"
    },
    "cats_v2": [
        {
            "cat_id": "10000026"
        },
        {
            "cat_id": "10000032"
        },
        {
            "cat_id": "1246"
        }
    ],
    "attrs": [
        {
            "attr_key": "产品净重(kg)",
            "attr_value": "1"
        }
    ],
    "skus": [
        {
            "sku_id": "462966903",
            "sale_price": 100,
            "stock_diff": {
                "diff_type": 1,
                "num": 1,
            }
        }
    ],
    "spu_code": "SPU_CODE_XXX",
    "brand_id": "2100000000"
}

# 返回参数说明

参数 类型 描述
errcode number 错误码
errmsg string 错误信息
data.product_id number(uint64) 小店内部赠品ID
data.update_time string 更新时间

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "product_id": "1700000000000",
        "update_time": "2020-06-20 10:00:00"
    }
}

# 错误码

错误码 错误描述
公共错误码 -
10020008 当前商品不允许编辑
10020011 商品的类目长度不对(预期是有三级类目)
10020012 销售属性不合法,不属于商品所属的三级类目
10020013 商品sku数量不合理(sku数量必须在1-500之间)
10020014 该spu处于抢购状态,不能修改sku
10020016 批量添加sku失败
10020017 类目非法
10020018 商家不具备当前类目资质
10020019 运费模版非法
10020020 商品标题为空
10020021 商品标题过长
10020022 商品头图为空
10020023 商品头图过多
10020024 商品描述过长
10020025 商品详情图片过多
10020026 商品详情描述过长
10020027 资质图片过多
10020028 sku价格过高
10020029 sku商品编码过长
10020031 sku销售属性相同key下不能超过100个不同value
10020032 sku销售属性key过长
10020033 sku销售属性value过长
10020034 该商品的sku_id/sku_out_id填写有误
10020035 图片/视频url非法, url前缀应为mmecimage.cn/p/
10020036 out_product_id过长
10020037 out_sku_id过长
10020038 上架的商品缺少sku
10020039 SKU价格为0
10020040 sku售卖价格大于市场价格
10020041 账号注销中
10020042 商品标题过短
10020043 类目不可用,请更换类目
10020045 商品标题不得仅为数字、字母、字符,不得含非法字符,请修改后重新提交
10020046 商品信息设置有误,请重新输入
10020048 由于类目保证金不足,已禁止新增商品
10020049 商品正在审核中,无法编辑或删除,请先调用撤回商品审核接口
10020050 没有商品权限
10020051 参数错误
10020052 商品不存在
10020053 商品因违规已被封禁
10020066 本店铺近1小时内提审次数超过限制,请1小时后再试
10020067 该商品上一次提交正在上传中,请稍后再试
10020068 当前运费模版计价方式为[按重量],且提交商品重量为0
10020069 当前类目不允许选择无需快递的发货方式
10020070 由于类目保证金不足,已下架所有商品
10020083 该商品所需类目保证金高于当前保证金余额,请前往商家网页端添加一次该类目商品,即可完成保证金补缴。
10020088 当前类目不支持当前品牌,或商品品牌id非法,或商品品牌id未申请通过
10020089 未开张商店发布商品
10020091 不支持该类型的商品
10020095 售后说明超过长度限制(200 UTF字符)
10020096 商品参数名称attrs[].attr_key不能重复
10020097 当前类目的商品参数attrs缺少必填项,具体参考文档获取类目信息中的字段attr.product_attr_list[]
10020098 当前类目的商品参数attrs[].attr_value内容有误,具体参考文档获取类目信息中的字段attr.product_attr_list[]
10020099 预售时间为0
10020100 预售开始时间大于等于结束时间
10020101 预售时间区间超出类目限制范围
10020102 预售结束时间距离现在大于30天
10020125 预售开始时间距离现在大于3天
10020103 预售发货预计时间超出类目限制范围
10020104 当前类目不支持预售,具体参考文档获取类目信息中的字段attr.pre_sale
10020106 请上传至少3张商品头图
10020107 请上传至少1张商品详情图
10020108 当前类目必须支持七天无理由退货,extra_service.seven_day_return必须为1或者2
10020109 商品所属类目与主营类目不符,不支持上架
10020110 商品信息检查不通过
10020111 本店铺近1天内提审次数超过限制,请1天后再试
10020113 商品参数属性值为空,请检查后重新提交
10020208 本店铺的上架功能被封禁,请登录微信小店后台管理页查看详情
10020209 传入的skuid不属于当前商品
10020210 限购库存不能为0
10020211 当前店铺因为有未缴纳欠费,无法上架商品,请登录微信小店后台管理页查看详情
10020212 商品副标题不得仅为数字、字母、字符,不得含非法字符,请修改后重新提交
10020213 商品详情描述不得仅为数字、字母、字符,不得含非法字符,请修改后重新提交
10020214 商品售后说明不得仅为数字、字母、字符,不得含非法字符,请修改后重新提交
10020215 当前类目不支持该品牌
10020216 商品sku销售参数skus[].sku_attrs缺少必填项,具体参考文档获取类目信息中的字段attr.sale_attr_list[]
10020221 根据《微信小店「运费险」管理规则》旗舰店类型小店需开通运费险服务方可上架商品,请使用网页端登录并开通
10020222 根据《微信小店「运费险」管理规则》近7天退货率高于10%或商责纠纷率大于0.08%店铺需完成运费险开通签约方可上架商品,请使用网页端登录并开通
10020225 商品头图重复
10020226 商品详情图重复
10020228 商品头图与其他商品重复
10020229 请上传至少4张商品头图
10020230 请上传至少3张商品详情图
10020231 根据《微信小店「运费险」管理规则》,预售功能需开通运费险功能后才可打开,当前暂未开通,请至网页端开通运费险功能后重新尝试
10020234 根据《微信小店「运费险」管理规则》,旗舰店/服务违规小店/退货退款率较高小店需开通运费险服务方可上架商品,请使用网页端登录并开通运费险
10020235 当前店铺包含需要质检服务的类目资质,无法经营和上架其他非质检类目商品。具体可参考相关条款
10020252 未申请当前类目,请通过类目接口提交申请,并在审核成功后上架商品
10020280 当前类目不支持设置赠品