来源: GitCode Issue #145 by 陈晶杰 (https://gitcode.com/developer-skill/vod-skill/issues/145)

描述问题 (Description)

scripts/bss/ 目录下没有直接查询代金券详情的脚本。list_customer_coupon_change_records.py 只能查收支流水，无法获取代金券的面值(face_value)、当前余额(balance)、到期时间(expiry_time)、适用产品范围等关键信息。list_stored_value_cards.py 只覆盖储值卡，不覆盖代金券。guide.md 中也没有对应条目。BSS API 的 ListCouponQuotas/ShowCustomerCouponDetail 等接口未被封装。

复现步骤 (To Reproduce)

用户询问34元代金券能购买哪些云资源，需要先确认代金券余额和到期时间，但无法直接查询

预期行为 (Expected behavior)

新增 list_coupon_quotas.py 脚本，封装 BSS ListCouponQuotas API，支持查询代金券列表，返回字段包括：coupon_id, face_value, balance, effective_time, expire_time, status, coupon_type, applicable_products。修改建议：1) 在 scripts/bss/ 下新增 list_coupon_quotas.py；2) 在 references/bss/guide.md 中添加使用说明；3) 考虑同时封装 ListCustomerCoupons（如BSS API支持）作为备选

实际行为 (Actual behavior)

只能通过 list_customer_coupon_change_records.py 查流水记录间接推算余额，且推算结果与用户声称的34元不一致，最终回答中不得不让用户自行去控制台确认

错误堆栈 (Stack Trace)

``` 【问题描述】 scripts/bss/ 目录下没有直接查询代金券详情的脚本。list_customer_coupon_change_records.py 只能查收支流水，无法获取代金券的面值(face_value)、当前余额(balance)、到期时间(expiry_time)、适用产品范围等关键信息。list_stored_value_cards.py 只覆盖储值卡，不覆盖代金券。guide.md 中也没有对应条目。BSS API 的 ListCouponQuotas/ShowCustomerCouponDetail 等接口未被封装。

【复现场景】 用户询问34元代金券能购买哪些云资源，需要先确认代金券余额和到期时间，但无法直接查询

【预期行为】 新增 list_coupon_quotas.py 脚本，封装 BSS ListCouponQuotas API，支持查询代金券列表，返回字段包括：coupon_id, face_value, balance, effective_time, expire_time, status, coupon_type, applicable_products。修改建议：1) 在 scripts/bss/ 下新增 list_coupon_quotas.py；2) 在 references/bss/guide.md 中添加使用说明；3) 考虑同时封装 ListCustomerCoupons（如BSS API支持）作为备选

【实际行为】 只能通过 list_customer_coupon_change_records.py 查流水记录间接推算余额，且推算结果与用户声称的34元不一致，最终回答中不得不让用户自行去控制台确认 ```