> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 门店

> 商户后台「支付 > 终端 > 门店」页，管理放置 POS 设备的实体门店：查看门店列表、按状态搜索/筛选，并新增、编辑、删除门店与查看门店详情（已分配设备、活动记录）。

## 这是什么

这是商户后台「**支付**」下「**终端**」里的「**门店**」页面（导航路径：支付 → 终端 → 门店）。门店指你放置 POS 收款设备的实体地点（如某个门市、办公室、网点）。你在这里查看名下所有门店、按状态和关键词筛选，并新增、编辑、删除门店，也能点开单个门店看它的地址、时区、已分配的收款设备和活动记录。要给新店建档、维护门店地址、或查看某门店挂了哪些设备时，都从这里操作。

## 操作步骤

查看门店列表：

1. 进入「**支付**」→「**终端**」→「**门店**」标签。
2. 列表默认展示名下所有门店；用顶部「**状态**」筛选或「**搜索**」（按名称、地址、ID）缩小范围。

新增门店：

1. 点页面右上角「**添加门店**」。
2. 在弹窗中填「**名称**」「**地址第 1 行**」「**城市**」「**国家**」（均必填），「**地址第 2 行**」可选。
3. 选「**时区**」（必填，下拉选择）。
4. 点「**添加门店**」提交。缺必填项会提示「请填写所有必填字段」，成功后提示「门店已添加」。

编辑门店：

1. 在某行末尾「**⋯**」菜单点「**编辑**」，或先点开门店详情再点右上角「**编辑**」。
2. 修改名称、地址第 1 行、城市、国家、时区，其中名称、地址第 1 行、时区为必填。
3. 点「**保存更改**」，成功后提示「门店已更新」。

删除门店：

1. 在某行「**⋯**」菜单点「**删除**」。
2. 弹窗二次确认（「您确定要删除此门店吗？此操作无法撤销。」），点「**删除**」确认。

查看门店详情：点击某一行（或「⋯」→「**查看详情**」），右侧滑出详情面板，展示门店 ID、状态、地址、时区、创建时间，以及「已分配设备」和「活动」两块。

批量操作：勾选多行后顶部出现操作条，可「**导出选中项**」或「**删除选中项**」；点「**清除**」取消选择。

导出：点工具栏「**导出**」把当前列表导出为 CSV 文件。

## 字段与状态含义

**列表列：**

| 列    | 含义（商户视角）                |
| ---- | ----------------------- |
| 门店名称 | 门店的名称                   |
| 地址   | 门店完整地址（地址行 + 城市 + 国家拼合） |
| 设备   | 该门店当前挂载的收款设备数量          |
| 状态   | 门店当前状态，见下               |

**门店状态：**

| 状态  | 含义     |
| --- | ------ |
| 活跃  | 门店正常启用 |
| 未激活 | 门店未启用  |

**统计条**（列表上方）：总计（门店总数）、活跃、未激活、设备总数（所有门店的设备合计）。

**新增 / 编辑门店字段：**

| 字段      | 含义               | 备注    |
| ------- | ---------------- | ----- |
| 名称      | 门店名称             | 必填    |
| 地址第 1 行 | 街道地址             | 必填    |
| 地址第 2 行 | 公寓、套房、单元、建筑等补充地址 | 可选    |
| 城市      | 门店所在城市           | 新增时必填 |
| 国家      | 门店所在国家           | 新增时必填 |
| 时区      | 门店所在时区，从下拉选择     | 必填    |

**门店详情面板：**

* **门店详情**：门店 ID（可复制）、状态、地址、时区、创建时间。
* **已分配设备**：该门店挂载的收款设备清单，每台显示编号、名称与在线/离线状态；没有设备时显示「未为此门店分配任何设备」。
* **活动**：门店的时间线记录，如「门店已创建」「已分配读卡器」，活跃门店会显示「当前活跃」。

## 边界与常见处理

* **列表显示「暂无门店」**：账户下还没有任何门店，提示「一旦开始活动，门店将显示在此处。」，点右上角「添加门店」新建。
* **筛选后「没有门店符合您的筛选条件」**：当前状态/搜索没有匹配项，提示「请尝试调整筛选条件。」，点「清除筛选」或「全部清除」清空条件再看。
* **添加/编辑时点提交没反应**：多为必填项没填全，会提示「请填写所有必填字段」；补齐名称、地址第 1 行、时区（新增还需城市、国家）后再提交。
* **删除是不可逆的**：删除门店会提示「此操作无法撤销」，确认前请核对门店名称与地址；批量删除会二次确认「您确定要删除 N 个门店吗？」。
* **门店详情里没有设备**：说明还没有设备分配到该门店，显示「未为此门店分配任何设备」。
* **导出失败**：偶发「导出失败」提示时，稍后重试导出。

## 常见问法（Q→A）

* **Q：门店在哪里管理 / 怎么进门店列表？** A：支付 → 终端 → 门店，列表即名下全部门店。
* **Q：怎么新增一个门店？** A：门店页右上角「添加门店」，填名称、地址第 1 行、城市、国家、时区（必填），可选填地址第 2 行，点「添加门店」。
* **Q：门店必须填哪些信息？** A：名称、地址第 1 行、城市、国家、时区为必填；地址第 2 行可选。
* **Q：怎么改门店地址 / 名称？** A：在该门店「⋯」菜单点「编辑」（或详情面板右上角「编辑」），改完点「保存更改」。
* **Q：怎么删除门店？删了能恢复吗？** A：在该门店「⋯」菜单点「删除」并确认；删除不可撤销，请先核对门店。
* **Q：门店状态「活跃」和「未激活」是什么意思？** A：活跃=门店正常启用；未激活=门店未启用。
* **Q：门店列表里「设备」那一列是什么？** A：该门店当前挂载的收款设备数量；统计条的「设备总数」是所有门店设备的合计。
* **Q：怎么看一个门店挂了哪些设备？** A：点开该门店详情，「已分配设备」区列出挂在这个门店的设备及其在线/离线状态。
* **Q：能一次删多个门店吗？** A：可以，勾选多行后点「删除选中项」并二次确认。
* **Q：怎么把门店数据导出来？** A：工具栏「导出」导出当前列表为 CSV；勾选行后可用「导出选中项」只导出选中的门店。
* **Q：怎么按名字或地址找门店？** A：用搜索框，支持按名称、地址、ID 搜索。