发票查验 — 發票查驗

发票查验技能 使用此技能通过票面信息或上传发票文件查验发票真伪，获取完整票面明细。

使用场景 满足以下需求时使用： 根据发票号码、开票日期、金额/校验码查验发票真伪。 上传发票文件（pdf/ofd/xml/jpg/png）进行批量查验。 查询查验记录，按日期范围、发票号码、发票类型等条件筛选。

触发语句示例 以下用户输入应触发此技能： 帮我查验这张发票 / 发票查验 / 查验发票 验证发票真伪 / 发票验真 / 验真 查一下这张发票是不是真的 上传发票文件查验 / 文件查验 这个发票文件帮我验一下 查验发票 26127000000211930033 查看一下查验记录 / 查验记录 / 查验历史 查一下5月份的查验记录 有没有查验失败的发票 查验状态不一致的发票有哪些

输入参数 执行前准备以下参数： apiKey（必填）：通过 https://test-eqjs.es366.cn/jxplusSkill/ 申请。 按票面查验 (inspect) 发票号码（必填） 开票日期（必填，格式 YYYY-MM-DD） 金额或校验码（必填，根据发票种类不同传入金额或校验码） 发票代码（可选） 按文件查验 (file) 发票文件路径（必填，支持 pdf、ofd、xml、jpg、png） 查询查验记录 (record) 开票日期开始（选填，格式 YYYY-MM-DD） 开票日期结束（选填，格式 YYYY-MM-DD） 发票号码（选填） 发票代码（选填） 发票类型（选填，可多选，传入编码值，详见下方 fplx 枚举） 页码（选填，默认 1） 每页条数（选填，默认 10） 查验时间开始（选填，格式 YYYY-MM-DD） 查验时间结束（选填，格式 YYYY-MM-DD）

fplx 发票类型枚举 票据大类 票据小类 编码 增值税发票管理系统发票 增值税专用发票 01 货物运输业增值税专用发票 02 机动车销售统一发票 03 增值税普通发票 04 增值税电子专用发票 08 增值税电子普通发票 10 增值税普通发票（卷票） 11 二手车销售统一发票 15 道路通行费电子普通发票 14 电子发票服务平台 电子发票（增值税专用发票） 81 电子发票（普通发票） 82 电子发票（铁路电子客票） 51 电子发票（航空运输电子客票行程单） 61 机动车销售电子统一发票 73 电子发票（机动车销售统一发票） 83 二手车销售电子统一发票 84 纸质发票（增值税专用发票） 85 纸质发票（普通发票） 86 纸质发票（机动车销售统一发票） 87 纸质发票（二手车销售统一发票） 88 数电票（通行费发票） 59 地方通用发票 浙江通用（电子）发票 Z1 云南省通用电子发票 Y1 广东通用机打发票（电子） G1 北京电子普通发票 B1 深圳电子普通发票 S1 通用定额发票 TY 江苏省车辆通行费通用（电子）发票 J1 交通运输发票 出租车发票 CZ 汽车票 QC 轮船票 LC 过路过桥费发票 GL 火车票 HC 机票行程单 JX 其他发票 其他发票 QT 财政票据 财政票据 CP 海关缴款书 海关缴款书 17

执行流程 前置检查（最高优先级）：检查环境变量 ZXT_API_KEY 是否已设置。 注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 $ZXT_API_KEY： Windows：执行 powershell -Command "[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')" 获取用户级环境变量值，同时检查 $ZXT_API_KEY。 macOS/Linux：检查 $ZXT_API_KEY 即可。 如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止： 您需要完成以下三步，即可自动配置并执行技能： 注册账号 访问中兴通简税Skill平台：https://test-eqjs.es366.cn/jxplusSkill/ 完成注册。 申请 apiKey 登录后进入"技能中心"，复制您的 apiKey。 提供 apiKey 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。 严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于： 禁止读取文件（Excel、PDF、图片等） 禁止调用任何 API 禁止执行任何脚本或命令 禁止进行参数解析或预处理 只允许输出提示信息，然后停止，等待用户提供 apiKey。 用户提供 apiKey 后，写入系统环境变量并使当前会话生效： Windows：setx ZXT_API_KEY 写入用户级环境变量，然后执行 export ZXT_API_KEY= 使当前会话生效。 macOS/Linux：将 export ZXT_API_KEY= 追加到 ~/.bashrc 或 ~/.zshrc（根据用户使用的 shell），同时执行 export ZXT_API_KEY= 使当前会话生效。 环境变量就绪后，继续以下步骤： 校验必填参数存在且非空。任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。 缺少发票号码、开票日期或金额/校验码：停止并提示用户提供对应参数。 按文件查验时文件不存在或不支持该文件类型：停止并提示用户。 通过 python 执行脚本调用远程 API（Windows 下使用 python，macOS/Linux 使用 python3），脚本优先使用 --api-key 参数，未传则回退读取环境变量 ZXT_API_KEY。 检查返回的 status 字段，非 200 时停止并将错误信息展示给用户，禁止重试或忽略。 解析返回结果并以可读格式输出。

请求参数说明 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice 参数 类型 必填 说明 apiKey string 是 apiKey invoiceNumber string 是 发票号码 invoiceDate string 是 开票日期（YYYY-MM-DD） jejym string 是 金额或校验码，根据发票种类不同传入，详见下方 jejym 传入规则 invoiceCode string 否 发票代码 jejym 传入规则 不同发票类型的 jejym 入参不同： 发票类型 jejym 入参 增值税专用发票 开具金额（不含税） 机动车销售统一发票 不含税价 二手车销售统一发票 车价合计 增值税电子专用发票 开具金额（不含税） 电子发票（增值税专用发票） 价税合计 电子发票（普通发票） 价税合计 增值税普通发票 校验码后六位 增值税普通发票（卷票） 校验码后六位 增值税电子普通发票 校验码后六位 道路通行费电子普通发票 校验码后六位 铁路电子客票 价税合计 航空运输电子客票行程单 价税合计 电子发票（机动车销售统一发票） 价税合计 电子发票（通行费发票） 价税合计

按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile 请求头：Content-Type: multipart/form-data 参数 类型 必填 说明 apiKey string 是 apiKey file file 是 发票文件（pdf/ofd/xml/jpg/png）

查询查验记录 — POST /api/jxplus/zxtSkill/inspection/queryInspectionRecord 参数 类型 必填 说明 apiKey string 是 apiKey kprqStart string 否 开票日期开始 (YYYY-MM-DD) kprqEnd string 否 开票日期结束 (YYYY-MM-DD) invoiceNumber string 否 发票号码 invoiceCode string 否