# 在售商品转赠品
# 接口说明
可通过该接口将小店在售商品转为赠品
# 注意事项
目前仅支持将单sku商品设置为赠品。
设置为赠品后，将生成新的赠品ID和赠品skuID，并在接口的回包中返回。
设置赠品时会从原始商品划拨库存，之后每次进行库存更新都将从原始商品的库存中进行扣减/归还。
同一个商品只能被设置为赠品一次，删除后可以重新设置。
预售商品不可设置为赠品。
设置在售赠品后，如果原始商品的改动导致不满足赠品准入要求，将会下架对应赠品。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/product/gift/onsale/set?access_token=ACCESS_TOKEN
# 请求参数说明
| 参数 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| product_id | string(uint64) | 是 | 设置为赠品的原始商品ID |
| skus[].sku_id | string(uint64) | 否 | 设置为赠品的原始商品skuID，目前仅支持将单sku商品设置为赠品 |
| skus[].stock_num | number | 是 | 划拨给赠品的库存数量，将直接从原始商品的库存中扣除，且这部分库存不参与售卖 |
# 请求参数示例
{
"product_id": "10000186383709",
"skus": [
{
"sku_id": "2967856845",
"stock_num": 1
}
]
}
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| product_ids[] | string(uint64) array | 赠品id列表 |
| next_key | string | 本次翻页的上下文，用于请求下一页 |
| total_num | number | 赠品总数 |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"src_product_id": "10000186383709",
"gift_product_id": "17000001344346",
"sku_mappings": [
{
"src_sku_id": "2967856845",
"gift_sku_id": "3185803880"
}
]
}
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 10020050 | 无权限调用该api，请开发者获取权限后再试 |
| 10020051 | 参数有误，请开发者按照文档传参 |
| 10020280 | 当前类目不支持设置赠品 |
| 10020281 | 预售商品不支持设置赠品 |
| 10020282 | 商品已被设置为赠品 |
| 10020285 | 原始商品库存不足，请补充后再设置赠品 |