# 在售商品转赠品

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：setproductasgift

可通过该接口将小店在售商品转为赠品

# 1. 调用方式

# HTTPS 调用

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

# 云调用

• 本接口不支持云调用

# 第三方调用

• 本接口支持第三方平台代商家调用。

• 该接口所属的权限集 id 为：129

• 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

# 2. 请求参数

# 查询参数 Query String parameters

# 请求体 Request Payload

# Body.skus Object Payload

skus

# 3. 返回参数

# 返回体 Response Payload

# 4. 注意事项

• 目前仅支持将单sku商品设置为赠品。

• 设置为赠品后，将生成新的赠品ID和赠品skuID，并在接口的回包中返回。

• 设置赠品时会从原始商品划拨库存，之后每次进行库存更新都将从原始商品的库存中进行扣减/归还。

• 同一个商品只能被设置为赠品一次，删除后可以重新设置。

• 预售商品不可设置为赠品。

• 设置在售赠品后，如果原始商品的改动导致不满足赠品准入要求，将会下架对应赠品。

# 5. 代码示例

请求示例

{
    "product_id": "10000186383709",
    "skus": [
        {
            "sku_id": "2967856845",
            "stock_num": 1
        }
    ]
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "src_product_id": "10000186383709",
        "gift_product_id": "17000001344346",
        "sku_mappings": [
            {
                "src_sku_id": "2967856845",
                "gift_sku_id": "3185803880"
            }
        ]
    }
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 通用错误码

# 7. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。