更新非卖赠品 | 微信开放文档

# 更新非卖赠品

# 接口说明

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

# 注意事项

在售赠品会自动同步母品信息，不支持接口更新。
赠品有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.百岁山天然矿泉水1L15瓶。不合规赠品标题举例：* 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	当前类目不支持设置赠品