收银班次

收银班次定义门店一天里分几段营业时间。收银端上传的每一张小票都会被打上一个班次号，交班报表、收银员交接班、按班次看销售，全靠这个班次号分组。班次没配好，最直接的后果是销售都堆到同一个班次上，交接班对不上账。

一、功能概述

菜单位置：连锁管理 → 编码 → 收银班次（页面地址 /admin/PosRetail/posreceiverorder/）

用途	说明
定义班次	给每个班次编号、命名，设开始类型、结束类型、开始时间、结束时间
跨天	用「前一天 / 当天 / 第二天」表达凌晨班、晚班这种跨零点的班次
排序	班次编号决定交接班报表里的先后顺序

班次是全局定义，不挂在某家门店或某个收银员上；具体哪台收银机、哪个收银员在哪个班次，由收银端登录和交班动作决定。

二、界面布局说明

区域	内容
工具栏	+ 新增、导出、回收站、打印
查询条	关键字框，匹配班次编号、班次名称、助记码
列表	班次编号 / 班次名称 / 开始类型 / 结束类型 / 开始时间 / 结束时间 / 助记码

班次名称是链接，点进去编辑。这个页面没有筛选下拉，因为班次通常只有几条到十几条。

列的含义

列	含义
班次编号	唯一，10 位以内，交接班排序依据
班次名称	如「早班」「晚班」「凌晨班」，打印在交班表上
开始类型	前一天 / 当天 / 第二天，表示班次开始的日期相对业务日怎么算
结束类型	同上，表示班次结束的日期
开始时间 / 结束时间	只到时分，如 07:00；留空表示这个班次不参与匹配
助记码	搜索用，手工填，不会自动生成

三、新增与编辑

点 + 新增，表单分三组：

分组	字段	填写要点
班次基本信息	班次编号、班次名称、助记码	编号与名称建议成对编，如 001 早班
时间设置	开始类型、结束类型、开始时间、结束时间	类型选日期归属，时间按 HH:MM
编码状态 / 审计信息	折叠组	由系统写入，一般不展开

保存时只保留时分。 时间字段虽然按日期时间存储，但每次保存都会把日期部分改写成当天，所以班次的「日期」不携带业务含义，只看类型和时分。

三种类型的实际含义

类型	用在什么场景
当天	常规班次，比如早班 07:00–15:00、中班 15:00–22:00
前一天	班次的起点要往前推一天，用于「接班时间已经跨到凌晨」的晚班
第二天	班次的终点要往后推一天，用于「下班时间已经过了零点」的夜班

配凌晨班时最容易出错。稳妥的做法是：配完在收银端做一笔测试单，看这张单在交班报表里落到哪个班次，再决定类型怎么调。

四、班次是怎么被匹配上的

一张小票上传时，系统按下面的顺序找班次：

1. 先看有没有未交班的记录：这台收银机、这个收银员如果有还没交班的记录，直接用那条记录的班次号。
2. 再按时间窗匹配：遍历所有未删除的班次，看当前时间是否落在「开始时间–结束时间」这个区间内，取第一条命中的。
3. 都没命中：落到默认的早班（班次号 1）。

由此带来几个使用上的约束：

• 时间留空的班次永远匹配不上。配置里如果只有类型、没填时间，等于这个班次形同虚设。
• 时间重叠的班次，先查到哪条用哪条。所以班次之间不要留重叠区间。
• 默认早班要存在。如果班次号 1 被删了，又出现匹配不上的情况，小票会带一个不存在的班次号。

五、删除与恢复

删除是逻辑删除，记录进回收站，可从工具栏 回收站 还原。已经被小票引用的班次，删除后历史小票的班次号还在、班次名称查不到，交班报表里会显示为空。日常调整建议改时间而不是删班次。

六、常见问题

问：凌晨的班怎么配？ 答：开始时间填 23:00 这类跨零点前的时间，结束时间填 07:00；类型按「起点在哪天、终点在哪天」选。配完必须做一笔测试单验证，不要只看配置。

问：为什么交班报表里所有销售都在「早班」？ 答：大概率是班次时间留空或时间窗不连续，小票全部落到默认班次。检查每个班次的开始/结束时间是否填了、相邻班次之间有没有空档。

问：班次改了名字，历史单据会变吗？ 答：历史小票存的是班次号，报表按号关联当前名称，所以改名后历史报表会显示新名称。

问：可以按门店配不同班次吗？ 答：班次是全局档案，不区分门店。门店与班次的关系体现在收银端登录和交班动作上。

问：删除班次后会发生什么？ 答：列表里不再显示，回收站可还原；历史小票仍保留原班次号，但交班报表里的班次名称会变空。要用下班次，优先改时间窗让它不再命中。