常见问题
更新时间：2026.01.30投放计划是摇一摇有优惠的活动创建工具，按照创建方式差异，投放计划分为「API创建」和「经营平台页面创建」两种，下文中有关接口的皆为服务商模式通过「API创建」投放计划的QA。
创建模式 | 创建说明 | 适用商家 |
模式 1：投放计划 API创建 | 商家可基于最新的投放计划接口文档，进行投放计划开发，开发完成后即可直接通过api接口创建出投放计划，无需经营平台做二次配置 | 目前暂不支持，后续将提供相关能力 |
模式 2：经营平台创建投放计划 | 可免开发，登录品牌经营平台创建投放计划，查询投放计划和管理投放计划， | 所有品牌 |
Q：创建投放计划前，必须先接入哪些产品能力？
A：
1、接入“商品券”功能，单券、多次优惠的都可以。
2、至少接入“商家名片”和“品牌门店”两个功能的其中一个
具体可参考：摇一摇有优惠-快速开始（品牌模式）/快速开始（服务商模式）
Q：什么情况下会有“投放计划状态变更通知”？
A：投放计划创建后，如果设置了回调地址，当【投放计划的状态】plan_state或者【审批状态】audit_state发生变更时，会发送回调。
注意：【投放计划的状态】plan_state变更为EXPIRED（已过期）时不会回调。
Q：投放计划的活动时间还未结束，但配置的批次已失效，投放计划是否会终止？
A：不会终止，投放计划会进入“已暂停”状态，客户端在推荐券时，会因为没有可投放的券而过滤掉该投放计划。
Q：商品券的同一个批次是否可以同时配置到不同的投放计划中？
A：可以
Q：通过投放计划领取券，限领的数量以投放计划的配置为准？还是批次的配置为准？
A：两种维度的限领同时存在，在即不超过投放计划的限领，又不超过批次的限领时，才能成功领券。
当同一批次被不同投放计划配置时，批次维度的限领数量是多个投放计划共用的。
Q：投放计划已在投放中，如果此时商品券的库存数量更改，投放计划的投放数量是否会有变动，是否会有超发的情况？
A：在投放计划推荐券时，会实时校验库存信息，如果商品券最新的库存数量大于投放计划的【投放总库存数量】total_count，则会以【投放总库存数量】为发放总上限，反之，若商品券最新的库存数量小于投放计划的【投放总库存数量】，则以商品券最新的库存为发放总上限，不会超发。
Q：投放计划复用商品券/批次信息，发完券库存后进入“暂停中”的状态，若扩充了商品券的库存，是否会继续推荐券？
A：会，有库存后会自动进入“投放中”状态继续发券。
Q：服务商模式通过API接口创建的投放计划，品牌方在品牌经营平台的投放计划页面点击“终止”按钮，以这种方式终止投放计划是否会有投放计划状态变更通知？
A：会有投放计划状态变更通知。
Q：调用“创建投放计划”接口报错：该商品券核销方式暂不支持，请检查核销方式
A：目前投放计划不支持配置【券使用方式列表】coupon_usage_method_list为“OFFLINE: 线下滴码核销”的商品券批次。
Q：调用“创建投放计划”接口报错：投放计划周期过短
A：投放计划的持续时间不得少于 5 天。
Q：投放计划状态在“审核中”时，是否支持操作终止？
A：支持
Q：更新了投放计划，重新进入审批流程后且审批失败的话，原投放活动的内容是保持投放中还是整个活动都先暂停投放？
A：保持投放中。
Q：调用“创建投放计划”接口报错：活动结束时间至批次券失效的核销预留时间小于批次相对可用时间(批次优惠领取后可用时间)
A：商品券会随批次结束时间到期而直接失效，因此投放活动的结束时间需早于批次结束时间至少1天，保证用户不会在活动期间领取到一张立即过期的券。
情况1: 若商品券配置了wait_days_after_receive（领券后需等待N天生效）和available_days（券生效后N天内可用），则活动结束时间最长可配置为【available_end_time（批次结束时间）- wait_days_after_receive（领券后需等待N天生效）- available_days（券生效后N天内可用） -1 】。
情况2: 若商品券没有配置了wait_days_after_receive（领券后需等待N天生效）和available_days（券生效后N天内可用），则活动结束时间最长可配置为【available_end_time（批次结束时间） -1】。
