观影券核销详情（待核销 / 已核销）
页面信息
| 项目 |
内容 |
| 页面名称 |
核销确认（观影券） |
| 路由 |
/pages/ticket-package-detail/ticket-package-detail?claimId={领取记录ID} |
| 源码 |
pages/ticket-package-detail/ticket-package-detail.uvue |
| 入口 |
商家端「订单管理 → 团购」列表中观影券那一条 |
| 负责人/更新时间 |
待指定 / 2026-10-09 |
页面目标
观影券没有金额、也不是 benefit_order，商户在团购列表里只能看到「观影券1张」。
本页补上这条记录的完整信息：券是否已核销、什么时候领取、什么时候核销、是谁的券、当前权益是什么。
功能点
| 功能 |
说明 |
状态 |
| 状态展示 |
顶部大字显示「待核销 / 已核销」，来自领取记录 status（ISSUED / USED）。 |
已接入 |
| 券信息 |
固定展示「观影券1张」（票包一次核销一张）。 |
已接入 |
| 订单信息 |
领取时间 = ticket_package_claim.created_at；核销时间 = used_at，未核销显示「—」。 |
已接入 |
| 权益信息 |
卡等级用户 + 脱敏姓名/手机号 + 「当前权益」文案。 |
已接入 |
| 当前权益口径 |
先取商家人才权益里该等级的配置描述，没配再回落到该商户到店消费权益文案，与到店消费保持一致。 |
已接入 |
状态差异
| 状态 |
表现 |
待核销（ISSUED） |
状态红色系大字；核销时间显示「—」；权益信息正常展示。 |
已核销（USED） |
状态灰色大字；核销时间展示真实时间。 |
本页只做展示。核销动作仍走「用户出示二维码 → 店员扫码」：扫码后进入
/pages/ticket-package-confirm/ticket-package-confirm，确认核销后本页状态变为「已核销」。
接口与数据
| 数据项/动作 |
接口标识 |
参数 |
返回字段 |
状态 |
| 观影券领取记录详情 |
GET /api/merchant/ticket-package-claims/{claimId} |
领取记录 ID；商户来自会话 |
claimId、claimNo、title、packageName、merchantName、customerName、customerMobile、cardLevel、status、statusText、createdAt、usedAt、benefitText |
已接入 |
异常处理
| 场景 |
表现 |
| 领取记录不存在或不属于当前商户 |
服务端返回「观影券领取记录不存在或不属于当前商户」，页面显示错误态并可重试。 |
缺少 claimId |
页面提示「观影券参数缺失」。 |
后台可见性
管理后台「电影票管理 → 核销记录」可按票包、持卡人、卡片等级、领取时间、核销时间和核销商家查询到同一条记录。
