Files
iotlcm/docs/manual/web/card-info.md
T
Dai0814 19455e1cbc docs: sync reviewed public manuals
Sync manuals, navigation and screenshots from open-source c8fa783 while preserving public README, LICENSE and history.
2026-10-26 16:10:40 +08:00

104 lines
6.4 KiB
Markdown

# 卡信息
## 页面入口
左侧菜单 → **通讯管理 → 卡信息**。
该页面是日常查卡的主要入口,可查询卡的身份标识、运营商状态、套餐、流量、归属企业、通道和到期情况。
![日常查卡页面入口](/images/manual/web/card-info-main-entry.png)
## 查询卡片
常用查询条件如下:
| 条件 | 用法 |
| --- | --- |
| 卡号 | 输入 MSISDN、ICCID 或 IMSI 任一标识 |
| 卡状态 | 按运营商卡状态筛选 |
| IMEI | 按终端设备号查询 |
| 所属通道 | 按运营商或接入通道筛选,支持搜索 |
| 时间类型、时间范围 | 按所选业务时间区间筛选 |
| 查询条件、起始号段、结束号段 | 选择号段类型,并按起止号段范围筛选卡片 |
| 备注信息 | 按备注内容筛选 |
| 维度、维度状态、维度值 | 按指定业务维度进行组合筛选 |
| 排序值、排序类型 | 指定排序字段及升降序 |
查询不到卡时,先确认使用的是完整卡号,再清空状态、时间和通道等附加条件重试。
### 批量查询
在列表上方点击“批量操作 → 批量查询”,每行填写 1 至 3 个号码值(ICCID、MSISDN、IMSI),多个号码以空格分隔,同一行应属于同一张卡;单次最多 1000 行。
点击“查询”后,结果保留当前筛选条件和公司范围,可使用原有“导出”按钮导出。若结果少于预期,先核对号码及附加条件。完成后点击“清除批量查询”恢复普通查询。
## 列表信息
| 字段 | 说明 |
| --- | --- |
| ICCID | SIM 卡芯片的唯一识别码,业务办理和故障定位最常用 |
| MSISDN | 运营商分配的移动号码,也常称卡号 |
| IMSI | SIM 卡在移动网络中的用户识别码 |
| 卡状态 | 运营商侧当前生命周期状态 |
| 类型 | “单卡”表示独立计量,“池卡”表示参与流量池共享 |
| 通道 | 卡接入的运营商或上游通道 |
| 所属公司 | 当前卡归属的企业 |
| 套餐 | 当前主套餐名称 |
| 总流量、已用流量、剩余流量 | 当前套餐流量,单位为 MB |
| 到期时间 | 当前套餐预计到期日期 |
| 出库时间 | 卡片分配出库日期 |
| 备注信息 | 企业维护的业务备注 |
列表中的流量不是实时会话流量。需要最新结果时,执行“同步用量”后再刷新。
## 查看卡详情
点击列表中目标卡的 ICCID 打开详情。详情上方展示:MSISDN、ICCID、IMSI、IMEI、卡状态、网络类型、流量同步时间、套餐总流量、到期时间、出库时间、当前套餐、已用流量、剩余流量、所属企业、所属通道、达量断网配置状态、限额、备注。
详情下方包含以下页签:
- **会话信息:** APN、IPv4、IPv6、接入方式、在线状态、会话建立时间、实时 IMEI、开关机状态等。点击“刷新”重新查询;“未查询到会话”通常表示设备当前未建立数据会话,并不等同于卡已销户。
- **归属信息:** 当前套餐编号、套餐名称、所属企业;通道信息以当前账号实际可见字段为准。
- **主套餐:** 订单编号、套餐名称、套餐类型、订购状态、生效时间和到期时间。
- **叠加套餐:** 加油包名称、总流量、支付方式和交易时间。
- **变更历史:** 变更前后套餐、订购状态和办理时间。
![卡详情页签](/images/manual/card-detail-tabs.png)
## 常用操作
页面上的操作按钮以账号权限为准。
![卡信息列表更多菜单中的常用操作](/images/manual/card-info-common-actions.png)
- **备注:** 编辑本企业对卡片的业务备注,便于按项目、设备或使用场景检索。
- **同步用量:** 向上游请求最新用量。同步成功后查看“流量同步时间”是否更新。
- **同步状态:** 向上游请求最新运营商卡状态。
- **导出:** 按当前筛选条件导出第一页最多 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 个月”这组下拉项在**库存卡信息的“协议到期”条件**里,用于筛选协议到期时间,不是用量区间,两者不要混用。
历史月份用量与当前账期的已用流量来自不同取数路径,口径和更新时间可能不同。跨月对比时先确认月份口径,不要直接把两个数值相减。
## 查看数据异常时
1. 先核对卡号和所属企业。
2. 查看卡状态、套餐到期时间及流量同步时间。
3. 分别执行“同步状态”和“同步用量”。
4. 打开详情刷新会话信息。
5. 进入[智能诊断](./intelligent-diagnosis)做完整排查。
6. 仍有异常时创建工单,并提供 ICCID、异常时间和已完成的操作。