docs: sync reviewed public manuals
Sync manuals, navigation and screenshots from open-source c8fa783 while preserving public README, LICENSE and history.
This commit is contained in:
Dai0814
@@ -5,7 +5,7 @@
|
||||
左侧菜单 → **通讯管理 → 卡信息**。
|
||||
|
||||
该页面是日常查卡的主要入口，可查询卡的身份标识、运营商状态、套餐、流量、归属企业、通道和到期情况。
|
||||
|
||||
|
||||
|
||||
## 查询卡片
|
||||
|
||||
@@ -25,6 +25,12 @@
|
||||
|
||||
查询不到卡时，先确认使用的是完整卡号，再清空状态、时间和通道等附加条件重试。
|
||||
|
||||
### 批量查询
|
||||
|
||||
在列表上方点击“批量操作 → 批量查询”，每行填写 1 至 3 个号码值（ICCID、MSISDN、IMSI），多个号码以空格分隔，同一行应属于同一张卡；单次最多 1000 行。
|
||||
|
||||
点击“查询”后，结果保留当前筛选条件和公司范围，可使用原有“导出”按钮导出。若结果少于预期，先核对号码及附加条件。完成后点击“清除批量查询”恢复普通查询。
|
||||
|
||||
## 列表信息
|
||||
|
||||
| 字段 | 说明 |
|
||||
@@ -46,14 +52,12 @@
|
||||
|
||||
## 查看卡详情
|
||||
|
||||
点击目标卡右侧“查看”。详情上方展示：MSISDN、ICCID、IMSI、IMEI、卡状态、网络类型、流量同步时间、套餐总流量、到期时间、出库时间、当前套餐、已用流量、剩余流量、所属企业、所属通道、达量断网配置状态、限额、备注。
|
||||
|
||||
|
||||
点击列表中目标卡的 ICCID 打开详情。详情上方展示：MSISDN、ICCID、IMSI、IMEI、卡状态、网络类型、流量同步时间、套餐总流量、到期时间、出库时间、当前套餐、已用流量、剩余流量、所属企业、所属通道、达量断网配置状态、限额、备注。
|
||||
|
||||
详情下方包含以下页签：
|
||||
|
||||
- **会话信息：** APN、IPv4、IPv6、接入方式、在线状态、会话建立时间、实时 IMEI、开关机状态等。点击“刷新”重新查询；“未查询到会话”通常表示设备当前未建立数据会话，并不等同于卡已销户。
|
||||
- **归属信息：** 当前套餐编号、套餐名称、所属企业和所属通道（所属通道不予展示）。
|
||||
- **归属信息：** 当前套餐编号、套餐名称、所属企业；通道信息以当前账号实际可见字段为准。
|
||||
- **主套餐：** 订单编号、套餐名称、套餐类型、订购状态、生效时间和到期时间。
|
||||
- **叠加套餐：** 加油包名称、总流量、支付方式和交易时间。
|
||||
- **变更历史：** 变更前后套餐、订购状态和办理时间。
|
||||
@@ -64,15 +68,30 @@
|
||||
|
||||
页面上的操作按钮以账号权限为准。
|
||||
|
||||
|
||||
|
||||
- **备注：** 编辑本企业对卡片的业务备注，便于按项目、设备或使用场景检索。
|
||||
- **同步用量：** 向上游请求最新用量。同步成功后查看“流量同步时间”是否更新。
|
||||
- **同步状态：** 向上游请求最新运营商卡状态。
|
||||
- **导出：** 按当前筛选条件导出卡信息。
|
||||
- **导出：** 按当前筛选条件导出第一页最多 2000 张卡的信息。匹配数量超过 2000 时，应按卡号、时间或其他条件分段查询并分别导出，核对各文件的记录数。
|
||||
- **诊断：** 在卡详情点击“诊断”，系统会携带当前 ICCID 跳转到智能诊断并自动查询。
|
||||
|
||||
“批量操作”当前仍显示为待接入功能。
|
||||
列表行的“更多”菜单还可能显示**开通数据、停用数据、自主停机、自主复机、重启**。这些操作各有独立权限；选择后先核对确认框中的 ICCID 和操作名称，再点击“确认提交”。缺少 ICCID 的卡不能提交。
|
||||
|
||||
|
||||
单卡操作会创建业务任务；页面提示“任务已提交”或返回批次号不代表运营商侧已经完成。请在[执行日志](./api-and-logs)中按批次号核对最终状态，再刷新卡信息确认结果。
|
||||
|
||||
列表“备注”弹窗目前只保存备注；出库时间、套餐周期和到期时间在此页为展示字段，不能通过“备注”入口修改。需要变更卡片业务信息时，使用对应的出库或套餐业务流程，并在提交后复核卡详情。
|
||||
|
||||
## 单卡用量与历史月份
|
||||
|
||||
列表和卡详情只显示当前账期的总流量、已用流量和剩余流量。需要按时间跨度看用量时，用以下两种方式：
|
||||
|
||||
1. **趋势查看：** 在[智能诊断](./intelligent-diagnosis)执行一键诊断，结果中的流量趋势提供近 7 天、近 30 天和近 6 个月三档，适合判断设备是否持续上报、是否突增或长时间无流量。
|
||||
2. **逐月数值：** 需要某个月的确切用量时，通过 OpenAPI 的历史月用量接口按 ICCID 和月份（`yyyyMM`）查询，详见[旧版兼容接口 - 查询 SIM 历史月用量](/openapi/legacy/query)。该接口一次返回一个月份，查近 3 个月或近 6 个月需按月份分别调用。
|
||||
|
||||
“近 1 个月 / 近 3 个月 / 近 6 个月”这组下拉项在**库存卡信息的“协议到期”条件**里，用于筛选协议到期时间，不是用量区间，两者不要混用。
|
||||
|
||||
历史月份用量与当前账期的已用流量来自不同取数路径，口径和更新时间可能不同。跨月对比时先确认月份口径，不要直接把两个数值相减。
|
||||
|
||||
## 查看数据异常时
|
||||
|
||||
|
||||
Reference in New Issue
Block a user