Appearance
第十一章 数据字段定义
关盘口径(2026-04-21 生效):关盘来源统一为数据源推送(唯一来源);关盘 = 绝对终态,操盘页与结算详情页均不提供人工开盘入口。
派彩公式的完整定义(含数值示例和验算)见结算详情页第 13 章。串关结算规则(含子单系数、降级、复式串关)见结算详情页第 14 章。驳回与二次结算规则(含派彩回收、差额处理)见结算详情页第 15 章。
11.1 赛事结算状态(4 种)
| 状态 | 英文 | 含义 |
|---|---|---|
| 待结算 | pending | 赛事已进入即将开赛阶段(距开赛 ≤ 30 分钟)或已开赛,至少有盘口未结算或未确认结算 |
| 已结算 | settled | 所有盘口结算完成,赛事级确认 |
| 已取消 | cancelled | 赛事取消处理完成 |
| 异常 | exception | 腰斩暂缓 / 延期暂缓(数据错误不进入异常态)。数据错误的实际修正走各自独立入口(操盘页调赔率 / 赛果录入页 / 盘口卡片 void / 盘口二次结算);第 16.5 节赛事异常处理 → 数据错误弹窗仅做审计标记(不下架、不关盘、不改态、不动订单) |
11.1b 盘口状态(4 种,与 settlement-detail 18.1 一致)
完整的各端展示对照(操盘页 / 结算详情页 / C 端)见结算详情页 18.1为主定义。列表侧仅需了解盘口状态枚举以理解盘口进度(分子/分母)和注单联动。
| 状态 | 英文 | 含义 | 列表侧呈现 |
|---|---|---|---|
| 开盘 | open | 接受投注中 | 不计入盘口进度分母(不可结算) |
| 关盘 | closed | 停止投注,可结算 | 计入分母(已关盘未结算) |
| 已结算 | settled | 结算结果已确定,派彩已计算 | 计入分母 + 分子 |
| 已取消 | cancelled | 盘口取消,投注退款 | 不计入分母(从统计中剔除) |
关盘来源仅 1 种:数据源推送关盘(唯一来源)。操盘页与结算页面均不提供关盘入口;关盘 = 绝对终态,无人工开盘入口。如数据源误推送关盘,依赖数据源再次推送开盘信号自动响应。
盘口进度分母动态性:数据源推送开盘信号触发自动回滚(关盘 → 开盘)后,该盘口退出分母,赛事视图进度可能由 22/30 回退为 22/29(详见 11.5)。
11.2 注单结算状态(3 种,与 settlement-detail 18.4 一致)
| 状态 | 英文 | 含义 |
|---|---|---|
| 待结算 | pending | 未完成结算 |
| 已结算 | settled | 结算完成 |
| 已取消 | cancelled | 注单已取消退款 |
注意与 11.3 结算结果枚举中的「取消(void)」区分:
- 注单状态 = "已取消"(cancelled) — 注单生命周期结束
- 结算结果 = "取消"(void) — 7 种派彩结果之一,盘口/赛事取消导致的派彩结果
不存在"冻结"状态:赛事异常(延期暂缓 / 腰斩暂缓)期间注单状态仍为"待结算",仅在业务规则层屏蔽操作入口,不引入独立状态枚举。IM 数据源亦不推送任何注单级状态字段,注单状态管理完全由本地承担。详见结算详情页 18.4。
11.3 结算结果枚举(7 种)
| 枚举值 | 中文 | 派彩公式 | 适用范围 | 业务含义 |
|---|---|---|---|---|
| win | 赢 | 投注额 × Decimal | 全部 BT | 投注选项命中 |
| lose | 输 | 派彩 = 0 | 全部 BT | 投注选项未命中 |
| half_win | 赢半 | 投注额 + 投注额 × 0.5 × HK | 仅有盘口线的玩法 | 盘口线 x.25 部分命中 |
| half_lose | 输半 | 投注额 × 0.5 | 仅有盘口线的玩法 | 盘口线 x.25 部分未命中 |
| push | 走水 | 退还投注额 | 仅有盘口线的玩法 | 整数线恰好打平 |
| void | 取消 | 退还投注额 | 全部 BT | 赛事/盘口取消,结果无效 |
| refund | 退款 | 退还投注额 | 全部 BT | 延期/腰斩等异常,退还本金 |
派彩精度:2 位小数,向下取整(floor)(系统级写死,修改需发版)。合规说明见结算详情页 13.3.2 派彩舍入合规说明。
取消与退款的区别:
| 结果 | 触发场景 | 财务处理 | 报表标记 |
|---|---|---|---|
| 取消(void) | 赛事取消、盘口取消、数据错误导致盘口无效 | 退还投注额 | 标记为「取消」,不计入结算盈亏 |
| 退款(refund) | 腰斩未完成时段退款、延期超时退款、异常处理退款 | 退还投注额 | 标记为「退款」,计入异常处理统计 |
两者财务结果相同(均退还投注额),区别在于原因分类:取消表示盘口本身无效(从未产生有效结果);退款表示盘口有效但因异常原因退还(曾经有效但无法继续)。区分便于报表统计和审计追溯。
11.4 结算时间定义
| 时间字段 | 定义 | 记录时机 | 说明 |
|---|---|---|---|
| 赛事结算时间 | 结算人员点击「结算赛事」确认的时刻 | 赛事状态 待结算→已结算 时写入 | 赛事级时间戳,与盘口结算时间独立 |
| 盘口结算时间 | 单个盘口结算结果确定的时刻 | 盘口状态 关盘→已结算 时写入 | 每个盘口各自的时间戳 |
赛事驳回 / 盘口二次结算对结算时间的影响:
| 场景 | 结算时间变化 |
|---|---|
| 赛事驳回(已结算→待结算) | 结算时间清空,显示「—」 |
| 重新确认结算 | 结算时间更新为最新一次确认的时刻,作为下一轮 24h 驳回窗口的新起点(窗口随最新结算时间向后滚动) |
| 盘口二次结算 | 赛事结算时间不变(赛事驳回才会清空) |
| 盘口二次结算 | 该盘口结算时间更新,赛事结算时间不变 |
24h 驳回窗口时间基准(对齐结算详情 15.3):距赛事最新一次结算时间(UTC 时间戳)≤ 24h 内允许驳回;多次重新确认结算时窗口随之向后滚动;超窗后赛事终态永久化,驳回按钮灰显永久禁用。
11.5 盘口结算进度口径
| 术语 | 计算方式 |
|---|---|
| 分子(已结算) | 已完成结算的盘口数 |
| 分母(已关盘) | 已结算 + 待结算(已关盘但未结算) |
| 不含 | 仍在开盘中的盘口 |
| 动态变化 | 比赛进行中盘口陆续关盘,分母动态增加;若数据源推送开盘信号触发自动回滚(关盘→开盘),分母减少 |
11.6 结算层级标识
| 层级 | 在注单列表中的体现 |
|---|---|
| L1 | 注单状态为已结算,操作列显示「已结算」(盘口二次结算在结算详情页执行) |
| L2 | 注单状态为待结算,操作列显示「结算」(蓝色按钮,标记"系统预填") |
| L3/L4 | 注单状态为待结算,操作列显示「结算」 |
11.6.1 无赛果原因(字段定义)
对应工具栏 第 4.5 节 注单视图筛选项"无赛果原因",4 种取值:
| 枚举值 | 含义 | 判定规则 | 更新时机 |
|---|---|---|---|
| 本地模式 | 该注单所属盘口为可操盘盘口,比分需结算人员录入 | 盘口来源 = 可操盘 | 盘口创建时写入,生命周期不变 |
| 玩法不支持 | 该 BT 属于 IM 不覆盖的小众玩法(40 种 L4),本地规则无法自动推导结算结果 | 盘口 BetTypeId ∈ L4 玩法清单 | 盘口创建时写入,生命周期不变 |
| 数据源超时 | 盘口已关盘超过配置时长(默认 30 分钟)但 IM 未推送盘口终态,触发本地接管 | 盘口状态 = 已关盘 且 距关盘时刻 > 30 分钟 且 IM 未推送盘口终态 | 系统定时任务触发(每分钟扫描一次超时盘口) |
| 赛事异常 | 所属赛事被结算人员标记为异常态(腰斩暂缓 / 延期暂缓) | 赛事状态 = 异常 | 结算人员触发赛事异常处理时写入 |
字段归属:注单表读取派生字段(不记入注单,按查询时实时推导);筛选查询时按赛事状态 + 盘口来源 + 盘口超时时间组合判定。
11.7 串关术语
| 术语 | 含义 |
|---|---|
| 母单 | 包含多个投注选项的串关注单 |
| 子单 | 母单中每一个单独的投注选项 |
| 子单系数 | 每个子单结算后的系数,用于计算母单派彩 |
| 母单派彩 | 投注额 × 子单1系数 × 子单2系数 × ... × 子单N系数 |