酷特海外平台优惠券冻结金额列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-list-frozen-price。
技能介绍
要解决什么问题
在海外运营场景里,用户优惠券往往处于「已占用但未最终结算」的状态:下单锁券、售后处理、跨系统同步时,运营和客服需要知道当前登录用户在钱包里被冻结的金额明细,而不是只看可用余额。若把这类查询混进大而全的「钱包聚合」接口里,Agent 在编排时难以精确触发、也不利于按接口粒度做权限与审计。
本技能对应酷特海外平台的一个原子动作:list_frozen_price,专门拉取当前用户优惠券冻结金额列表。
技能如何工作
执行器固定请求正式环境 GET /coupon-member/listCouponFrozenPrice(base_url 来自技能 frontmatter,不可被用户输入覆盖)。这是登录态接口:在 params.accessToken 中传入 token,生成 Authorization: Bearer;若值已含 Bearer 前缀则不再重复拼接。
参数约定与其它 Kutesmart 原子 skill 一致:最外层仅 params;Path / Query / Body / 额外 Header 分别写入 params.path、params.query、params.body、params.headers。本接口以 GET 为主,通常无额外 body,可按上下文在 query 中补充网关要求的字段。
返回以接口真实响应为准,Agent 不应自行补造冻结金额、券种或订单关联信息。若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层继续处理。
适用边界
- 只完成「冻结金额列表」这一步;完整链路(查可用券、解冻、核销等)需由上层 Agent 引用
platform-coupon-wallet聚合 skill 或其它原子 skill 编排。 - 依赖有效登录态与当前租户/用户权限;无 token 或权限不足时,应如实透传接口错误,而非猜测列表内容。
使用场景
- 客服接到「券还在但用不了」的工单时,需拉取当前用户优惠券冻结金额列表核对锁券占用
- 售后改单或取消前,运营 Agent 先查询该账号冻结明细,再决定是否串联解冻或核销 skill
- 对账脚本编排中,作为 platform-coupon-wallet 链路的一步,获取登录用户冻结金额用于与订单锁券记录比对
- 跨境活动复盘时,按当前登录运营账号或代查用户上下文,导出冻结金额列表辅助排查异常占用
适合人员
- 处理酷特海外商城券余额争议的客服,需用接口事实说明哪些金额处于冻结而非丢失
- 负责 platform-coupon-wallet 多接口编排的后端或 Agent 集成工程师,需要独立的 list_frozen_price 原子步骤
- 海外运营在对账日核对用户侧「可用 vs 冻结」差异,要把冻结列表作为审计输入的运营专员
- 为商家或内部工具构建优惠券查询助手的产品经理,需在对话流里单独触发冻结金额查询