# 添加限时抢购任务

# 接口说明

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

# 注意事项

  • 本接口已重新上线,抢购活动的规则有更新,请仔细阅读;
  • 每个商品同一时间只能有一个限时抢购任务。如果当前有限时抢购任务没有结束,无论是否开始,都不允许创建第二个限时抢购任务。可以提前修改限时抢购任务状态为结束后,再创建新的任务;
  • 抢购活动的规则要求:
    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元以上)