添加限时抢购任务 | 微信开放文档

# 添加限时抢购任务

# 接口说明

可通过该接口添加限时抢购任务

# 注意事项

本接口已重新上线，抢购活动的规则有更新，请仔细阅读；
每个商品同一时间只能有一个限时抢购任务。如果当前有限时抢购任务没有结束，无论是否开始，都不允许创建第二个限时抢购任务。可以提前修改限时抢购任务状态为结束后，再创建新的任务；
抢购活动的规则要求：
1. 参与抢购的商品库存，必须小于等于现有库存；
2. 抢购开始/结束时间必须设置为一年内（365天）的时间，且活动持续时间不可超过24小时；
3. 参与抢购活动的商品原售卖价必须大于10元，折扣范围1-8.5折，且抢购价必须比原价优惠10元以上。

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
product_id	string(uint64)	是	参与抢购的商品ID
start_time	number	是	限时抢购任务开始时间(秒级时间戳)，只能取大于等于当前时间的值(允许有最多十分钟的误差)，且距离当前时间不得超过一年（365天）
end_time	number	是	限时抢购任务结束时间(秒级时间戳)，必须大于当前时间以及start_time，且距离当前时间不得超过一年（365天）
limited_discount_skus[].sku_id	string(uint64)	是	参与抢购的商品ID下，不同规格（SKU）的商品信息
limited_discount_skus[].sale_price	number	是	SKU的抢购价格，必须小于原价（原价为1分钱的商品无法创建抢购任务）
limited_discount_skus[].sale_stock	number	是	参与抢购的商品库存，必须小于等于现有库存

# 请求参数示例

{
    "product_id": "1234567001",
    "start_time": 1614863822,
    "end_time": 1614873822,
    "limited_discount_skus": [
        {
            "sku_id": "12345678901",
            "sale_price": 2888,
            "sale_stock": 3
        },
        {
            "sku_id": "12345678902",
            "sale_price": 2600,
            "sale_stock": 50
        }
    ]
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
task_id	string(uint64)	限时抢购任务ID，创建成功后返回

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "task_id": "12345678"
}

# 错误码

错误码	错误描述
公共错误码	-
10020050	无权限调用该api，请开发者获取权限后再试
10020051	参数有误，请检查请求参数是否正确
10020052	商品不存在
10020071	抢购商品未上架
10020072	抢购开始/结束时间无效，请设置一年内（365天）的时间，且活动持续时间不可超过24小时
10020073	抢购库存超出商品可用库存
10020074	设置抢购的SKU无效
10020075	商品已存在其他抢购活动
10020078	抢购价格不符合平台规则（折扣范围1-8.5折，并且抢购价必须比原价优惠10元以上）