# 卡信息

## 页面入口

左侧菜单 → **通讯管理 → 卡信息**。

该页面是日常查卡的主要入口，可查询卡的身份标识、运营商状态、套餐、流量、归属企业、通道和到期情况。
![日常查卡页面入口](/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、异常时间和已完成的操作。