Appearance
手牌设置
维护手牌分类、手牌编号和手牌内码，支持单个新增、编辑、删除以及 Excel 批量导入。
适用场景
当门店遇到以下情况时，可以查看或调整本页配置：
- 新增、调整或批量导入手牌。
- 维护手牌分类。
- 排查收银台找不到手牌的问题。
按问题查字段
| 遇到的问题 | 优先检查字段 | 处理方向 |
|---|---|---|
| 收银台找不到手牌 | 手牌编号、手牌内码、手牌类型 | 检查编号是否拼写正确、类型是否选对，可在手牌列表搜索确认。 |
| 手牌编号或内码重复 | 手牌编号、手牌内码 | 全门店唯一，导入前先在列表搜索同号是否已存在。 |
| 手牌占用后状态不释放 | 手牌列表无状态字段 | 状态由开单、结账、交接流程控制，不在本页设置。 |
| 批量导入失败 | Excel 模板、类型、文件 | 按模板填写编号和内码，必填项不能空，重复行会被拒绝。 |
| 分类删除失败 | 手牌分类 | 确认该分类下没有在用的手牌，删除手牌后再删分类。 |
字段说明
快速定位：
列表操作按钮
| 字段 | 推荐设置 | 如何设置 | 影响范围 | 风险 |
|---|---|---|---|---|
| 添加手牌 | 单个新增手牌时使用，按编号录入。 | 点击"添加手牌"，填写手牌编号、手牌内码、选择类型后保存。 | 新增一条手牌记录，可在收银台开单时被选中。 | 低 |
| 批量上传 | 新店开业或大量录入时使用，建议先下载模板。 | 点击"批量上传"，下载模板填好"手牌编号""手牌内码"两列，选择类型后上传 xls/xlsx 文件。 | 按文件批量新增手牌，编号或内码重复会整体失败。 | 中 |
| 编辑 | 仅在编号或内码录错时调整。 | 在列表行点击"编辑"，修改编号、内码或类型后保存。 | 影响收银台对该手牌的识别，已开单的手牌不建议修改编号。 | 中 |
| 删除 | 确认该手牌不再使用时再删除。 | 在列表行点击"删除"，确认后从列表中移除（历史订单仍能看到）。 | 删除后收银台无法再选择，历史订单不受影响。 | 中 |
| 搜索 | 导入或排查问题前先搜索是否已存在。 | 顶部输入框可按编号或内码模糊搜索，类型下拉可过滤。 | 只影响列表展示，不修改数据。 | 低 |
⭐ 标记为必填字段。
手牌分类字段（分类管理 Tab）
| 字段 | 推荐设置 | 如何设置 | 影响范围 | 风险 |
|---|---|---|---|---|
| 分类名称 ⭐ | 建议简短易识别，长度 1-20 字。 | 在"分类管理"Tab 点击"添加分类"，填写分类名称后保存。 | 用于在手牌列表按类型筛选和录入时归类。 | 低 |
| 添加时间 | 系统自动记录，无需手填。 | 新增分类时由系统自动写入，列表只读展示。 | 仅供查询追溯。 | 低 |
⭐ 标记为必填字段。
手牌基础字段（添加/编辑表单）
| 字段 | 推荐设置 | 如何设置 | 影响范围 | 风险 |
|---|---|---|---|---|
| 手牌编号 ⭐ | 建议与手牌实物一致，门店内唯一，1-20 字。 | 在添加或编辑表单填写"手牌编号"，可纯数字或字母数字组合。 | 收银台按编号识别手牌，错填会导致开单找不到。 | 中 |
| 手牌内码 ⭐ | 与手牌芯片或条码一致，门店内唯一，1-20 字。 | 在添加或编辑表单填写"手牌内码"，用于扫码或读卡识别。 | 扫码开单按内码匹配，错填会导致刷牌无响应。 | 中 |
| 类型 ⭐ | 需先在分类管理里维护好分类。 | 在添加或编辑表单选择已有手牌分类。 | 用于列表筛选和统计，不直接影响开单规则。 | 低 |
⭐ 标记为必填字段。
批量导入字段（批量上传弹窗）
| 字段 | 推荐设置 | 如何设置 | 影响范围 | 风险 |
|---|---|---|---|---|
| 模板下载 | 首次导入务必下载最新模板再填写。 | 点击弹窗内的"手牌批量上传格式模版"直接下载。 | 字段名不一致会导致解析失败。 | 低 |
| 类型 ⭐ | 本次导入的手牌全部归入该分类。 | 在弹窗内下拉选择手牌分类。 | 导入后所有手牌的类型一致，需要不同类型请分批导入。 | 低 |
| 手牌批量上传（文件） ⭐ | 支持 xls/xlsx，单文件不超过 10MB。 | 上传按模板填写的 Excel，必须包含"手牌编号""手牌内码"两列，单元格不能为空，文件内不能重复，且系统中也不能存在同号。 | 校验通过则整批新增；任意一行不合规则全部失败，需修正后重新上传。 | 中 |
⭐ 标记为必填字段。
修改前确认
修改前建议先确认：
- 确认该手牌未在使用或已下钟。
- 批量导入前先备份当前手牌列表。
- 确认编号、内码门店内唯一。
修改后验证
保存后建议至少验证以下场景：
| 验证场景 | 验证重点 |
|---|---|
| 收银台开单选择手牌 | 新增的手牌能按编号搜出并成功开单。 |
| 扫码或读卡开单 | 按内码刷牌能正确匹配到对应手牌。 |
| 手牌列表筛选 | 按分类筛选能看到本次新增或导入的全部手牌。 |
谁适合修改这些字段
| 字段类型 | 建议修改人 |
|---|---|
| 手牌分类 | 店长或具备"手牌分类"权限的管理员 |
| 手牌资料（增删改、批量导入） | 店长或具备"手牌"管理权限的管理员 |
规则说明
- 手牌编号和内码在门店内必须唯一。
- 手牌状态由业务流程控制，不在本页设置。
注意事项
- 批量导入前先在列表搜索同号是否存在。
- 删除前确认无在开订单使用该手牌。
常见问题
收银台开单找不到新增的手牌怎么办？
请检查手牌编号是否拼写正确、类型是否选择正确，可在手牌列表用搜索框确认数据已存在。
批量导入提示编号或内码重复？
请先在 Excel 内检查是否有同号，再在手牌列表搜索该号是否已存在；删除重复行或修改编号后重新上传。
手牌打开后状态没变怎么办？
手牌状态由开单、结账、下钟等业务动作驱动，本页只维护资料，请到收银台工作台核对订单与手牌的关联状态。
如页面展示与本说明不一致，请以门店当前设置和页面提示为准。