分店管理
分店管理是连锁体系的门店总档案：一家门店只要在这里出现，收银端登录、库存归属、业绩考核、配送线路、第三方平台对接才有落脚点。这个页面同时管三件事——门店的身份（编号、名称、地址）、门店的经营权限（能不能采购、能不能销售、允不允许负库存）、以及门店在平台侧的激活状态（有没有拿到授权、授权有没有过期）。
一、功能概述
菜单位置：连锁管理 → 编码 → 分店管理（页面地址 /admin/PosRetail/posfiliale/）
| 用途 | 说明 |
|---|---|
| 建门店 | 通过「从机构新增」从组织架构里选一个部门机构，系统自动建分店档案并配一个同名仓库 |
| 改档案 | 修改门店名称、地址、负责人、联系电话、营业参数、仓库绑定等 |
| 授权 | 行尾「授权管理」打开授权弹窗，激活、停用、解除激活、改管理员手机号、生成分店授权码 |
| 定位 | 顶部搜索框按编号/名称/手机号找店；三个筛选下拉按加盟店、云POS、SaaS分店过滤 |
分店编号不是自己编的，等于机构编号。 新建门店时系统把机构 ID 直接写成分店编号，所以「先建机构、再建分店」是固定顺序，也是这个页面没有普通「新增」按钮、只有「从机构新增」的原因。
二、界面布局说明
分店列表
| 区域 | 内容 |
|---|---|
| 工具栏 | 蓝色 + 从机构新增；导出；右侧三个图标依次是 搜索、刷新、全屏 |
| 查询条 | 关键字框（提示「搜索...」）、加盟店: 全部、云POS: 全部、SaaS分店: 全部、蓝色 🔍 |
| 列表 | 勾选 / 排序 / 编号 / 名称 / 营业状态 / 激活状态 / 加盟店 / 云POS / SaaS分店 / 城市 / 分店地址 / 手机号 / 负责人 / 操作 |
| 分页 | 「共 N 条」「共 N 页」+ 翻页按钮 + 每页条数下拉 |
名称是链接，点进去就是这家门店的编辑表单。操作列唯一的按钮是 授权管理，打开平台授权弹窗。
三个筛选下拉的选项都是「全部 / 是 / 否 / 未知」：选「未知」等于找这一项还没填过的门店，做数据体检时比逐个点开快。
列表字段口径
| 列 | 含义 | 备注 |
|---|---|---|
| 编号 | 分店编号 | 等于机构编号，建店后不建议再改，改了对不上收银端和权限里的门店范围 |
| 名称 | 分店名称 | 收银端、报表、单据上都显示这个名称 |
| 营业状态 | 营业中 / 停业 | 停业是业务状态，和授权停用不是一回事 |
| 激活状态 | 已激活 / 未激活 / 激活码过期 / 已停用 / - | 来自平台授权，- 表示还没取到授权信息 |
| 加盟店 | 开关 | 勾选后这家店按加盟店口径参与结算与调拨 |
| 云POS | 开关 | 该门店使用云端收银模式 |
| SaaS分店 | 开关 | 该门店是 SaaS 版本纳管的门店 |
| 城市 / 分店地址 / 手机号 | 联系信息 | 手机号在授权流程里会作为默认联系号码 |
| 负责人 | 关联系统用户 | 选择器「选择负责人」 |
| 操作 | 授权管理 | 见下文授权弹窗 |
三、新增门店：从机构新增
新增入口只有一个：工具栏 + 从机构新增。
- 点击后弹出机构选择框，只列部门类型的机构，总部机构本身、已删除机构、名称空的机构、以及已经有未删除分店的机构都不会出现——换句话说，一个机构只能对应一家分店。
- 选中机构后弹确认框：「确认从机构 [机构名] 新增分店？」下方提示「系统将自动创建分店记录并绑定仓库。」
- 确认后系统做两件事：先建一个仓库，再建分店档案，分店自动绑定这个仓库。
- 成功后直接打开这家分店的编辑表单，可以接着补地址、负责人、营业参数。
新店默认值：
| 项目 | 默认值 |
|---|---|
| 分店编号 | 机构编号 |
| 分店名称 | 机构名称 |
| 助记码 | / + 门店名称（按原文，不是拼音首字母） |
| 允许采购 / 允许销售 | 打开 |
| 仓库 | 新建的「门店名 + 仓库」 |
| 营业状态 | 营业中 |
如果这个机构以前建过分店又删掉了，系统会走还原：把原来那条分店恢复，并同时恢复它的仓库，提示「分店 [机构名] 已从回收站还原」，不会重复建第二条。
常见的失败提示：
| 提示 | 原因 |
|---|---|
| 请选择机构 | 没选就提交 |
| 机构不存在或不是部门机构 | 选的不是部门类型机构，或机构已被删除 |
| 机构 [X] 已存在分店，请勿重复添加 | 该机构已有未删除的分店 |
| 仓库创建失败，请重试 | 建仓库这一步出错，分店没有建出来，重试即可 |
四、编辑门店
点名称进入表单，常用分组如下（门店参数很多，这里只列日常会动的）：
| 分组 | 主要字段 | 说明 |
|---|---|---|
| 基本信息 | 编号、名称、分店类型、加盟店、加盟商户、负责人、联系方式、手机号、分店地址、完整地址、配送路线ID、允许采购、允许销售、不允许负库存销售、是否中央厨房、是否外工厂、云POS、助记码、使用面积、员工数、分货优先级别、所属生产部门、本币类型、单据锁超时 | 门店的身份与经营开关 |
| 业务属性 | 允许快递、允许分店自提、是否中心加工工厂、是否支持商家配送、是否微信商城门店、允许散装商品修改重量 | 决定这家店能做哪些业务 |
| 关联 | 仓库 | 门店库存的存放仓，建店时自动生成 |
| 财务与额度 | 信用额度、可用额度、累计结算金额、累计销售金额、本次销售金额 | 加盟与结算口径 |
| 第三方平台 | 美团、饿了么、达达、抖音、京东的门店号与有效期 | 只读，由平台对接写入 |
营业状态和营业时间在门店参数里属于「营业时间」设置：填营业开始/结束时间时要按 HH:MM 写，格式不对会提示「时间格式错误,应为HH:MM格式」。
保存后如果后台开启了平台同步，系统会在后台把门店信息同步到平台，同步失败只记日志，不影响本地保存。
五、分店标签
分店标签是给门店贴的运营标记，一家店可以同时挂多个，例如「社区店」「商场店」「新开门店」「试点店」「2026 中秋活动店」。标签挂在门店档案上，日常以批量归类为主、逐店调整为辅。它不改变门店的任何经营规则，只解决一个问题：同一批门店总在不同场景里反复出现，而每次都有人重新勾一遍。
1. 为什么要定义分店标签
门店档案上已经有分店类型、加盟关系、配送线路、业务线这些结构性字段，它们回答的是「这家店是什么店、货怎么送、账怎么分」。但运营上还有一类分组是跨这些结构的：
- 这批社区店要一起做会员拉新；
- 这几家试点店要限量配新品；
- 新开业的门店要单独看一段时间的经营数据；
- 同一个业态的门店要放在一起比较，不能和商场店混排。
如果没有标签，上面每个动作都要在几十家门店里逐个勾选：勾一遍容易漏，活动复制一次就要重勾一次，做报表时也没有统一口径。分店标签把这批门店固化成一个可以反复引用的集合，圈一次、多处用。
2. 定义标签之后用在哪里
| 用途 | 怎么用 | 解决什么问题 |
|---|---|---|
| 促销与活动圈店 | 按标签找出同类门店，再把活动落到具体门店 | 新店扶持、试点品类、节日活动不用逐店勾选，减少漏店 |
| 分货与配货圈店 | 按标签筛出本次参与的门店，再结合配送线路和订货组织分货 | 社区店加配、试点店限量这类「只给一类店」的配货有统一入口 |
| 报表分组对比 | 按业态标签分组，在同一组内比较 | 社区店、商场店、高端店的健康标准不同，混在一起排名结论会失真 |
| 订货与备货规则 | 按标签确定适用门店范围，再套用同类规则 | 同类门店用同一套备货标准，不用一家家配 |
| 日常检索与批量维护 | 按标签筛选、导出、通知 | 找「这批店」比按名称逐个搜快 |
3. 标签和结构性字段的分工
| 归属方式 | 性质 | 一家店能有几个 | 是否影响单据流转 |
|---|---|---|---|
| 分店类型、加盟关系 | 门店身份 | 一个 | 影响业务判断与结算口径 |
| 配送线路 | 物流归属 | 按线路排 | 影响分货、配送与收货 |
| 业务线 | 账务与仓储分区 | 按业务线拆 | 影响账务归集 |
| 分店标签 | 运营描述 | 多个，互不冲突 | 不影响，只用于筛选和分组 |
一句话：要改变单据去哪、谁能做什么，改结构性字段或参数；只是想把一批店圈出来，用标签。
4. 使用时的注意点
- 新店不会自动带标签。标签是人工归类的结果，新门店建档后需要有人按业态和管理口径补上，否则按标签圈店的活动会漏掉它；
- 标签不记录修改历史。谁在什么时候把一家店移出试点名单，系统里查不到，调整口径时要自己留变更台账；
- 活动标签带年份并定期清理。「2026 中秋活动店」活动结束后应移除或改名归档，否则明年还会被圈进来；
- 一个标签只表达一件事。「社区店且月销 30 万以上」把业态和业绩混在一起，以后想单看业态就拆不出来；
- 标签不等于权限。标签只决定筛选范围，不决定谁能看哪家店的数，也不决定单据下发到哪家店。
概念与更多用法见 门店标签是什么？，标签档案与批量归类的操作演示见 分店标签管理培训。
六、授权管理
点击行尾 授权管理，弹出这家门店的平台授权窗口。窗口按当前授权状态给不同按钮：
| 当前状态 | 窗口显示 | 可用按钮 |
|---|---|---|
| 未激活 | 分店尚未激活，客户端无法绑定。点击「激活」开始授权流程。 | 激活 |
| 已激活 | 分店已激活，客户端可通过分店号@客户码或授权码绑定。 | 停用授权、解除激活、修改管理员手机号、生成分店授权码 |
| 激活码过期 | 激活码已过期，请联系服务商续期。 | 同上 |
| 已停用 | 分店授权已停用，已绑定的客户端将无法使用。 | 解除激活 |
激活：填分店编号、分店名称、分店手机号（默认取门店档案的手机号）、注册码（加密狗 SN）、管理员手机号，点「发送验证码」，收到短信后填验证码，点「确认激活」。激活成功后管理员手机号会写回门店档案。
停用授权 / 解除激活：这两个按钮不是弹确认框，而是按钮变红、文字变成「确认停用?」「确认解除?」，3 秒内再点一次才执行。误点了不点第二次就没事。
修改管理员手机号：改完客户端需要重新绑定。手机号必须是 11 位、以 1 开头，否则提示「手机号格式不正确」。验证码发送后按钮进入 60 秒倒计时。
生成分店授权码：生成一串带有效期的授权码，界面同时给出二维码，可以「复制授权码」发给门店，门店在客户端用授权码完成绑定。
授权信息取不到时（例如当前环境没有配置平台对接），弹窗会回落显示「未激活」。遇到明明已授权却显示未激活，先确认这套环境有没有连平台，再判断是不是授权真丢了。
七、常见问题
问：为什么没有「新增」按钮？ 答：分店必须挂在机构下面。先到组织架构里建好部门机构，再回这里用「从机构新增」选它。
问：分店编号能改吗？ 答：能填，但不建议。编号等于机构编号，改了以后收银端、权限里的门店范围、历史单据都对不上，属于实施级操作。
问：删除门店会连机构、连仓库一起删吗？ 答：不会。删除只影响分店档案本身（记录进回收站，可恢复）；机构还在组织架构里，仓库也还在。想彻底重来，删完再用同一个机构「从机构新增」，系统会还原原来那条分店和它的仓库。
问：营业状态显示「停业」，但收银端还能登录？ 答：营业状态和授权是两套东西。营业状态是业务口径（比如装修暂停营业），授权停用才会让客户端无法使用。要让门店彻底进不去，得在授权弹窗里停用或解除激活。
问：为什么同一个机构加不进第二家分店？ 答：一个机构只对应一家分店。要开新店，先在组织架构里新建一个部门机构。
问：激活码过期了怎么办？ 答：联系服务商续期。续期前客户端绑定不受影响，但新设备无法用旧激活码注册。