# 免审更新团购优惠
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:updatelocalauditfree
针对已上线的本地团购优惠,通过本接口可以进行免审核更新。更新成功后,将通过「团购优惠更新回调」接口通知商家
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/product/locallife/auditfree?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:129
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | string(uint64) | 是 | 平台生成的id |
| skus | object | 是 | 售卖单元,更新时sku_id为必填项。本接口不支持直接设置库存数量,请调用修改团购优惠库存的接口设置库存数量 |
# Body.skus Object Payload
售卖单元,更新时sku_id为必填项。本接口不支持直接设置库存数量,请调用修改团购优惠库存的接口设置库存数量
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sku_id | string | 是 | 平台自动生成的sku_id,更新时必须填写本参数。 |
| sale_price | number | 是 | 实际售卖价格,单位分 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"product_id": "15000000392025",
"skus": [
{
"sku_id": "2022104954",
"sale_price": 90
}
]
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 |
|---|---|
| 10020013 | 商品sku数量不合理 |
| 10020034 | 该商品的sku_id/sku_out_id填写有误 |
| 10020042 | 商品标题过短 |
| 10020045 | 商品标题不得仅为数字、字母、字符,不得含非法字符,请修改后重新提交 |
| 10020049 | 商品正在审核中,无法编辑或删除,请先调用撤回商品审核接口 |
| 10020051 | 参数错误 |
| 10020052 | 商品不存在 |
| 10020135 | 可用时间范围use_date跨度超出限制,最长时间180天,最短时间1天。开始时间不能晚于当前时间+30天 |
| 10020147 | 可用时间范围use_date.use_end_date已过期 |
| 10020148 | 套餐分组数set_meals.size超出限制,兑换券类型上限10个子套餐分组,次卡类型限制传1个子套餐分组 |
| 10020163 | 套餐分组内的商品列表set_meals[].items为空,至少包含一项商品 |
| 10020176 | 团购优惠售价不能大于原价 |
# 7. 适用范围
本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明,均不可调用。