定义
卡信息查询是按ICCID、MSISDN、项目、客户、代理商等条件检索物联网卡详情的功能。与卡状态监控（看板告警）不同，本能力侧重「按需检索单卡或批量卡」。
查询维度
- 精确查询：按ICCID、MSISDN查询单卡，获取卡状态、套餐、用量、账单等详情。
- 条件筛选：按项目、客户、代理商、设备类型、激活时间、流量套餐类型组合筛选。
- 批量查询：上传ICCID列表或筛选条件，批量导出，支持Excel格式。
返回信息
查询结果通常包含：卡基本信息（ICCID、MSISDN、运营商）、卡生命周期状态、当前流量套餐、剩余流量、流量计费明细，以及归属项目、客户、代理商等。C端用户通过用户自助服务可查询名下卡；企业、代理商通过后台查询。与卡状态监控（实时看板、告警）不同，卡信息查询侧重按需检索。
查询性能与导出
卡信息查询可能涉及大量数据，需做好索引与查询优化。按ICCID、MSISDN精确查询应快速响应；按多条件组合筛选时，可支持分页、限制返回数量。批量导出时，可异步生成文件供下载，避免超时。查询结果可用于对账、报表、客户服务。平台需控制查询权限，确保用户仅能查询权限范围内的卡。卡信息来源于平台数据库及运营商API同步，需保障数据及时性。
卡信息查询与业务
C端用户通过用户自助服务可查询名下卡的状态、套餐、用量、账单；代理商通过代理商自助门户可查询采购的卡。客服按MSISDN或ICCID快速定位卡处理报障。卡信息查询与卡生命周期、流量计费、运营商对账数据关联，是物联网云平台的基础能力。
查询维度
卡信息查询支持按ICCID、MSISDN精确查询，按项目、客户、代理商、设备类型、激活时间、流量套餐类型组合筛选。查询结果包含卡基本信息、卡生命周期状态、当前套餐、剩余流量、流量计费明细。平台需控制查询权限，确保用户仅能查询权限范围内的卡。卡信息来源于平台数据库及运营商API同步。
库里的状态和现查运营商为什么会差一截
卡信息查询读的是平台为了检索而保存的副本，加上必要时向运营商补的一笔实时查询。副本有同步时间。用户刚缴费，复机指令尚未回执，查询仍显示停机，这不一定是查错卡。结果里应带上「状态更新时间」和「用量账期」，没有时间的状态不能拿来判断现在能不能上网。按集成电路卡识别码精确查询应走唯一索引；按号码查询要先确认这个号码当前绑定的是哪一张卡，换过号的旧号码应返回「已更换」而不是随便命中一条历史记录。批量查询导出的是提交任务那一刻的快照，生成文件期间又有卡被停机，文件和页面不一致是预期，要在文件头写生成时间。达希物联的卡信息查询把精确检索、条件筛选和异步导出分开，导出任务也必须套用查询人的归属权限。
条件叠在一起时怎样才算查到该查的卡
项目、客户、代理商、激活日期、套餐几个条件是「同时满足」，不是「满足任意一个」。接口若把未传的条件当成空字符串去等值匹配，会查出零行，页面却像是没有这张卡。未传应表示不限制。日期筛选要说明是激活日、入库日还是到期日，三个日期混用一个「时间」参数，客服会漏掉未激活卡。只给了后六位号码时不能当精确查询，至多做受控的模糊检索并限制条数，避免扫全表。返回字段按角色裁剪：使用者看到套餐和余量，客服再看到停机原因，财务再看到账单。不要因为内部账号方便，就把运营商密钥、实名证件号放进默认详情。查询失败要区分无权限、卡不存在、运营商接口超时，超时不应显示成「未找到卡」。
导出和实时告警不是同一件事
查询是人来要数据，告警是数据来找人。把查询接口轮询当作监控，既慢又会打满运营商限流。需要盯停机、盯余量，应走状态同步和阈值，而不是让客服每分钟按卡号查一次。查询结果可以带最近一次告警，但告警列表不必具备所有筛选项。导出文件里的用量是查询时已入库的累计，不是这一秒的网元计数。对账人员用导出和运营商话单比对前，先对齐账期和时区。同一识别码在回收后重新入库，查询默认只给当前生命周期；要看上一任项目，必须显式查历史，否则新旧项目的用量会粘在一张卡上。历史查询单独授权，一线排障账号默认改不了已报废档案。导出任务若跨过回收时点，文件里要标明该行属于哪一段生命周期，避免把两段用量加在同一行里交给对账。