# 赠品接口调用流程
# 1、添加非卖商品调用流程
# 1.1、接口调用流程
# 1.2、相关接口说明
| 接口名称 | 需求参数 | 功能说明 |
|---|---|---|
| 上传图片 img_upload | img_url（图片url）upload_type=1时必填； media（图片文件buffer）upload_type=0时必填 | 上传后获取 media_id 支持其他接口使用 |
| 获取所有类目 getallcategory | access_token | 调用此接口用来获取非卖商品可用类目，用于“添加非卖商品”中的 cats_v2。超出非卖商品可用类目的商品不支持添加为非卖商品 |
| 获取类目信息 getcategorydetail | cat_id（类目ID） | 获取非卖商品必填参数，用于“添加非卖商品”中的attrs参数 |
| 添加非卖商品 addgiftproduct | 商品的各级、各字段商品信息，具体参照接口文档参数 | 1、添加非卖商品进入上架审核；2、获得非卖商品创建完成时间。目的：完成非卖商品上架 |
| 上架商品 listingproduct | product_id（商品ID） | 1、调用该接口可将商品（包括非卖商品）上架到微信小店；2、在审核中的商品无需重复提交； |
# 2、更新与管理非卖商品调用流程
# 2.1、接口调用流程
# 2.2、相关接口说明
| 接口名称 | 需求参数 | 功能说明 |
|---|---|---|
| 获取非卖商品列表 getgiftproductlist | page_size（每页数量）； status（商品状态） | 获取微信小店的非卖商品列表“product_ids”，可以用于在获取非卖商品、更新非卖商品时填写 product_id 参数 |
| 获取赠品 getgiftproduct | product_id（商品ID）； data_type（商品数据类型） | 获取指定非卖商品ID的具体信息，用于在更新非卖商品前掌握非卖商品明细现状 |
| 更新非卖商品 updategiftproduct | product_id（商品ID）； title（标题）； head_imgs（主图）； skus（非卖商品sku信息）； cats_v2（非卖商品类目） | 对微信小店内非卖商品信息的更新 *该接口请求方式和添加非卖商品（addgiftproduct）接口基本一致，区别在于请求该接口时需要带上已存在的product_id |
| 更新赠品库存 updategiftstock | product_id（商品ID）； sku_id（小店内非卖商品sku ID）； diff_type（修改类型：增加/减少）； num（增加、减少或者设置的库存值） | 可通过该接口更新非卖商品库存 |
| 在售商品转赠品 setproductasgift | product_id（设置为原始商品ID）； skus（非卖商品sku信息） | 1、可通过该接口将小店内在售商品转为非卖商品，并获取到非卖商品ID列表。 2、同一个商品只能被设置为一次非卖商品 |
# 3、设置买赠活动
# 3.1、接口调用流程
# 3.2、相关接口说明
| 接口名称 | 需求参数 | 功能说明 |
|---|---|---|
| 创建赠品活动 addgiftactivity | title（活动标题）； start_time（活动开始时间）； end_time（活动结束时间）； detail（活动详情） | 1、通过该接口添加买赠活动； 2、创建买赠活动成功后，返回买赠活动ID，可以用于后续删除或停止买赠活动时填写“activity_id”参数； 3、此前通过添加非卖商品接口创建成功的非卖商品ID（product_id），可用于填写至本接口“gift_set”参数中的“gift_id”； *创建买赠活动中的「gift_id」对应的是添加非卖商品接口中的「product_id」 |
| 停止赠品活动 stopgiftactivity | activity_id（买赠活动ID） | 通过该接口停止已创建的买赠活动 |
| 删除赠品活动 deleteGiftActivity | activity_id（买赠活动ID） | 通过该接口删除已创建的买赠活动 |
文档变更日志（1条）2025 年 12 月 12 日
新增 赠品接口调用流程