# 更新限时抢购任务
接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。
接口英文名：updatelimiteddiscounttask
可通过该接口更新限时抢购任务
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/product/limiteddiscounttask/update?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用。
# 第三方调用
本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：129
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | - | 是 | ACCESS_TOKEN | 接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用） |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 限时抢购任务ID |
| status | number | 是 | 当前活动状态（乐观锁校验，传入时校验与实际状态是否一致。0=待开始, 1=进行中） |
| start_time | number | 是 | 限时抢购任务开始时间(秒级时间戳) |
| end_time | number | 是 | 限时抢购任务结束时间(秒级时间戳) |
| title | string | 是 | 活动名称(仅商家可见，最长50个字符) |
| limited_discount_skus | objarray | 是 | SKU抢购信息列表，修改SKU时必须传入product_id |
# Body.limited_discount_skus(Array) Object Payload
SKU抢购信息列表，修改SKU时必须传入product_id
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string | 是 | SKU所属商品ID（修改SKU时必传） |
| sku_id | string | 是 | SKU ID |
| sale_price | number | 是 | SKU的抢购价格 |
| sale_stock | number | 是 | 参与抢购的商品库存 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | number | 错误信息 |
| task_id | number | 限时抢购任务ID |
| title | string | 活动名称 |
# 4. 注意事项
- 只能更新待开始（status=0）或进行中（status=1）的活动，已结束的活动无法修改
- 不支持修改限购设置（is_limit_purchase 和 limit_purchase_num），限购需在创建活动时设置
- 活动持续时间不可超过7天
- start_time 不得超过当前时间90天以后
- end_time 必须大于当前时间
- 修改 SKU 时，每个 SKU 必须传入 product_id 标识所属商品
- 传入 status 时会校验与活动实际状态是否一致，不一致返回错误（用于防止并发更新）
# 5. 代码示例
请求示例
{
"task_id": "12345678",
"status": 0,
"title": "新活动名称",
"end_time": 1614873822,
"limited_discount_skus": [
{
"product_id": "1234567001",
"sku_id": "12345678901",
"sale_price": 2888,
"sale_stock": 5
}
]
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"task_id": "12345678",
"title": "新活动名称"
}
# 6. 错误码
以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 10020072 | 活动时长不能超过7天 |
| 10020074 | 设置抢购的SKU无效 |
| 10020076 | 抢购活动不存在 |
| 10020077 | 抢购活动状态不正确（已结束的活动无法修改） |
| 10020514 | 活动状态与入参不一致，请刷新后重试 |
| 10020516 | 活动名称超过最大长度限制 |
| 10020517 | 限时抢购入参错误（如传入了不支持修改的限购设置，或修改SKU时未传product_id） |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。
接口变更日志（1条）2026 年 05 月 12 日
新增 更新限时抢购任务 接口