{"id":"934ed89a-4e4e-48f4-9117-8e20b9a66310","entityType":"agent","slug":"clawhub-zxt-invoice-verify","name":"发票查验","canonicalUrl":"https://www.xpersona.co/agent/clawhub-zxt-invoice-verify","canonicalPath":"/agent/clawhub-zxt-invoice-verify","generatedAt":"2026-10-11T16:01:10.083Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T13:27:17.620Z","emptyReason":null},"description":"发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Skill: 发票查验 Owner: zxt Summary: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-06-17T07:31:29.525Z | user 主体迁移到@zxt v1.0.0 | 2026-05-25T08:02:23.897Z | user 正式版 v1.0.0-beta | 2026-05-22T01:08:49.129Z | user - 更新了发票查验平台网址为 https://skill.quandianfapiao.com/ - apiKey 申请与注册说明中的平台域名同步为 quandianfapiao.com - 其他文档内容未做变动，功能保持一致 v1.0.0-alpha | 2026-05-21T09:05:28.611Z | user i","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s176y1zx801xf9nrys54e3xztd88t1jf:invoice-verify","sourceUrl":"https://clawhub.ai/zxt/invoice-verify","homepage":"https://clawhub.ai/zxt/skills/invoice-verify","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/zxt/invoice-verify","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/zxt/skills/invoice-verify","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Skill: 发票查验 Owner: zxt Summary: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Tags: latest:1.0.1 Version histo"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T13:27:17.620Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T13:27:17.620Z","emptyReason":null},"stars":null,"forks":null,"downloads":1057,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T13:27:17.608Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T13:27:17.620Z","lastCrawledAt":"2026-10-11T13:27:17.608Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T13:27:17.608Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-06-17T07:31:29.525Z","changelog":"主体迁移到@zxt","fileCount":5,"zipByteSize":12872},{"version":"1.0.0","createdAt":"2026-05-25T08:02:23.897Z","changelog":"正式版","fileCount":5,"zipByteSize":12770},{"version":"1.0.0-beta","createdAt":"2026-05-22T01:08:49.129Z","changelog":"- 更新了发票查验平台网址为 https://skill.quandianfapiao.com/ - apiKey 申请与注册说明中的平台域名同步为 quandianfapiao.com - 其他文档内容未做变动，功能保持一致","fileCount":4,"zipByteSize":11402},{"version":"1.0.0-alpha","createdAt":"2026-05-21T09:05:28.611Z","changelog":"invoice-verify 1.0.0-alpha - 初始发布：支持按票面信息或上传发票文件查验发票真伪。 - 提供发票查验、批量查验、查验记录查询等功能。 - 严格的环境变量（ZXT_API_KEY）检查与配置指引，确保安全、合规使用。 - 执行流程透明，参数校验和错误处理明确。 - 支持多种发票类型，查询和查验功能覆盖广泛的应用场景。","fileCount":4,"zipByteSize":11399}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s176y1zx801xf9nrys54e3xztd88t1jf:invoice-verify","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T16:01:10.081Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-verify/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T13:27:17.620Z","emptyReason":null},"readme":"Skill: 发票查验\n\nOwner: zxt\n\nSummary: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-06-17T07:31:29.525Z | user\n\n主体迁移到@zxt\n\nv1.0.0 | 2026-05-25T08:02:23.897Z | user\n\n正式版\n\nv1.0.0-beta | 2026-05-22T01:08:49.129Z | user\n\n- 更新了发票查验平台网址为 https://skill.quandianfapiao.com/\n- apiKey 申请与注册说明中的平台域名同步为 quandianfapiao.com\n- 其他文档内容未做变动，功能保持一致\n\nv1.0.0-alpha | 2026-05-21T09:05:28.611Z | user\n\ninvoice-verify 1.0.0-alpha\n\n- 初始发布：支持按票面信息或上传发票文件查验发票真伪。\n- 提供发票查验、批量查验、查验记录查询等功能。\n- 严格的环境变量（ZXT_API_KEY）检查与配置指引，确保安全、合规使用。\n- 执行流程透明，参数校验和错误处理明确。\n- 支持多种发票类型，查询和查验功能覆盖广泛的应用场景。\n\nArchive index:\n\nArchive v1.0.1: 5 files, 12872 bytes\n\nFiles: common.py (4673b), invoice_verify.py (8429b), skill-card.md (2505b), SKILL.md (24643b), _meta.json (133b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: invoice-verify\ndescription: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n---\n\n# 发票查验技能\n\n使用此技能通过票面信息或上传发票文件查验发票真伪，获取完整票面明细。\n\n## 使用场景\n\n满足以下需求时使用：\n\n- 根据发票号码、开票日期、金额/校验码查验发票真伪。\n- 上传发票文件（pdf/ofd/xml/jpg/png）进行批量查验。\n- 查询查验记录，按日期范围、发票号码、发票类型等条件筛选。\n\n## 触发语句示例\n\n以下用户输入应触发此技能：\n\n- 帮我查验这张发票 / 发票查验 / 查验发票\n- 验证发票真伪 / 发票验真 / 验真\n- 查一下这张发票是不是真的\n- 上传发票文件查验 / 文件查验\n- 这个发票文件帮我验一下\n- 查验发票 26127000000211930033\n- 查看一下查验记录 / 查验记录 / 查验历史\n- 查一下5月份的查验记录\n- 有没有查验失败的发票\n- 查验状态不一致的发票有哪些\n\n## 输入参数\n\n执行前准备以下参数：\n\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\n\n### 按票面查验 (inspect)\n\n- 发票号码（必填）\n- 开票日期（必填，格式 YYYY-MM-DD）\n- 金额或校验码（必填，根据发票种类不同传入金额或校验码）\n- 发票代码（可选）\n\n### 按文件查验 (file)\n\n- 发票文件路径（必填，支持 pdf、ofd、xml、jpg、png）\n\n### 查询查验记录 (record)\n\n- 开票日期开始（选填，格式 YYYY-MM-DD）\n- 开票日期结束（选填，格式 YYYY-MM-DD）\n- 发票号码（选填）\n- 发票代码（选填）\n- 发票类型（选填，可多选，传入编码值，详见下方 fplx 枚举）\n- 页码（选填，默认 1）\n- 每页条数（选填，默认 10）\n- 查验时间开始（选填，格式 YYYY-MM-DD）\n- 查验时间结束（选填，格式 YYYY-MM-DD）\n\n#### fplx 发票类型枚举\n\n| 票据大类 | 票据小类 | 编码 |\n| ---------------------- | ---------------------------------- | ---- |\n| 增值税发票管理系统发票 | 增值税专用发票 | 01 |\n| | 货物运输业增值税专用发票 | 02 |\n| | 机动车销售统一发票 | 03 |\n| | 增值税普通发票 | 04 |\n| | 增值税电子专用发票 | 08 |\n| | 增值税电子普通发票 | 10 |\n| | 增值税普通发票（卷票） | 11 |\n| | 二手车销售统一发票 | 15 |\n| | 道路通行费电子普通发票 | 14 |\n| 电子发票服务平台 | 电子发票（增值税专用发票） | 81 |\n| | 电子发票（普通发票） | 82 |\n| | 电子发票（铁路电子客票） | 51 |\n| | 电子发票（航空运输电子客票行程单） | 61 |\n| | 机动车销售电子统一发票 | 73 |\n| | 电子发票（机动车销售统一发票） | 83 |\n| | 二手车销售电子统一发票 | 84 |\n| | 纸质发票（增值税专用发票） | 85 |\n| | 纸质发票（普通发票） | 86 |\n| | 纸质发票（机动车销售统一发票） | 87 |\n| | 纸质发票（二手车销售统一发票） | 88 |\n| | 数电票（通行费发票） | 59 |\n| 地方通用发票 | 浙江通用（电子）发票 | Z1 |\n| | 云南省通用电子发票 | Y1 |\n| | 广东通用机打发票（电子） | G1 |\n| | 北京电子普通发票 | B1 |\n| | 深圳电子普通发票 | S1 |\n| | 通用定额发票 | TY |\n| | 江苏省车辆通行费通用（电子）发票 | J1 |\n| 交通运输发票 | 出租车发票 | CZ |\n| | 汽车票 | QC |\n| | 轮船票 | LC |\n| | 过路过桥费发票 | GL |\n| | 火车票 | HC |\n| | 机票行程单 | JX |\n| 其他发票 | 其他发票 | QT |\n| 财政票据 | 财政票据 | CP |\n| 海关缴款书 | 海关缴款书 | 17 |\n\n## 执行流程\n\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\n\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\n\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\n\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\n\n> 您需要完成以下三步，即可自动配置并执行技能：\n>\n> 1. **注册账号**\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\n>\n> 2. **申请 apiKey**\n> 登录后进入\"技能中心\"，复制您的 apiKey。\n>\n> 3. **提供 apiKey**\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\n\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\n\n- 禁止读取文件（Excel、PDF、图片等）\n- 禁止调用任何 API\n- 禁止执行任何脚本或命令\n- 禁止进行参数解析或预处理\n\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\n\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\n\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\n\n环境变量就绪后，继续以下步骤：\n\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\n - 缺少发票号码、开票日期或金额/校验码：停止并提示用户提供对应参数。\n - 按文件查验时文件不存在或不支持该文件类型：停止并提示用户。\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\n3. 检查返回的 status 字段，非 200 时停止并将错误信息展示给用户，禁止重试或忽略。\n4. 解析返回结果并以可读格式输出。\n\n## 请求参数说明\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | ------ | ---- | ----------------------------------------------------------- |\n| apiKey | string | 是 | apiKey |\n| invoiceNumber | string | 是 | 发票号码 |\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\n| jejym | string | 是 | 金额或校验码，根据发票种类不同传入，详见下方 jejym 传入规则 |\n| invoiceCode | string | 否 | 发票代码 |\n\n### jejym 传入规则\n\n不同发票类型的 jejym 入参不同：\n\n| 发票类型 | jejym 入参 |\n| ------------------------------ | ------------------ |\n| 增值税专用发票 | 开具金额（不含税） |\n| 机动车销售统一发票 | 不含税价 |\n| 二手车销售统一发票 | 车价合计 |\n| 增值税电子专用发票 | 开具金额（不含税） |\n| 电子发票（增值税专用发票） | 价税合计 |\n| 电子发票（普通发票） | 价税合计 |\n| 增值税普通发票 | 校验码后六位 |\n| 增值税普通发票（卷票） | 校验码后六位 |\n| 增值税电子普通发票 | 校验码后六位 |\n| 道路通行费电子普通发票 | 校验码后六位 |\n| 铁路电子客票 | 价税合计 |\n| 航空运输电子客票行程单 | 价税合计 |\n| 电子发票（机动车销售统一发票） | 价税合计 |\n| 电子发票（通行费发票） | 价税合计 |\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求头：`Content-Type: multipart/form-data`\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------ | ------ | ---- | ------------------------------- |\n| apiKey | string | 是 | apiKey |\n| file | file | 是 | 发票文件（pdf/ofd/xml/jpg/png） |\n\n### 查询查验记录 — POST /api/jxplus/zxtSkill/inspection/queryInspectionRecord\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | -------- | ---- | ------------------------- |\n| apiKey | string | 是 | apiKey |\n| kprqStart | string | 否 | 开票日期开始 (YYYY-MM-DD) |\n| kprqEnd | string | 否 | 开票日期结束 (YYYY-MM-DD) |\n| invoiceNumber | string | 否 | 发票号码 |\n| invoiceCode | string | 否 | 发票代码 |\n| fplxList | string[] | 否 | 发票类型集合 |\n| pageNo | string | 否 | 页码，默认 1 |\n| pageSize | string | 否 | 每页条数，默认 10 |\n| cysjStart | string | 否 | 查验时间开始 (YYYY-MM-DD) |\n| cysjEnd | string | 否 | 查验时间结束 (YYYY-MM-DD) |\n\n## 返回说明\n\n按票面查验和按文件查验共享相同的返回数据结构。按文件查验返回集合，集合内每条记录结构与按票面查验一致。\n\n### 查验记录返回 (record)\n\n返回分页列表，每条记录包含：\n\n| 字段 | 说明 |\n| ------------- | -------------------------------------------------------------------------------------------------------- |\n| invoiceNumber | 发票号码 |\n| invoiceCode | 发票代码 |\n| fplx | 发票类型 |\n| fplxName | 发票类型名称 |\n| kprq | 开票日期 |\n| jshj | 价税合计 |\n| cyzt | 查验状态：0 未查验，1 查验中，2 查验真票，3 查无此票，4 查询不一致，5 查验失败，6 不支持查验，7 抬头不符 |\n| cyztName | 查验状态名称 |\n| cysj | 查验时间 |\n| xsfMc | 销售方名称 |\n\n### 外层返回字段\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | -------------------------------- |\n| status | string | 返回接口状态码 |\n| message | string | 返回接口状态描述信息 |\n| data | object | 业务数据体（按文件查验时为数组） |\n\n### data 业务数据体\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------- | ---------------------------------------------------- |\n| invoiceType | string | 发票种类，详见发票类型说明 |\n| invoiceCode | string | 发票代码 |\n| invoiceNumber | string | 发票号码 |\n| invoiceDate | string | 开票日期 |\n| hjje | decimal | 合计金额 |\n| hjse | decimal | 合计税额 |\n| jshj | decimal | 价税合计 |\n| fpStatus | string | 发票状态：0 正常，2 作废，3 红冲 |\n| xsfMc | string | 销售方名称 |\n| xsfNsrsbh | string | 销售方纳税人识别号 |\n| xsfAddressTel | string | 销售方地址、电话 |\n| xsfBankAccount | string | 销售方开户行及账号 |\n| gmfMc | string | 购买方名称 |\n| gmfNsrsbh | string | 购买方税号 |\n| gmfAddressTel | string | 购买方地址、电话 |\n| gmfBankAccount | string | 购买方开户行及账号 |\n| payee | string | 收款人 |\n| reviewer | string | 复核人 |\n| invoicer | string | 开票人 |\n| machineNo | string | 机器编号 |\n| checkCode | string | 校验码 |\n| passwordArea | string | 密码区 |\n| remark | string | 备注 |\n| xmlFileUrl | string | xml 文件地址 |\n| pdfFileUrl | string | pdf 文件地址 |\n| ofdFileUrl | string | ofd 文件地址 |\n| items | List | 发票明细 |\n| specialDetail | List | 特殊票种明细（铁路电子客票、航空运输电子客票行程单） |\n\n### items 明细数据体\n\n#### 商品详情列表（其他类型发票）\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------ | ------------------------ |\n| projectName | string | 货物或应税劳务、服务名称 |\n| ggxh | string | 规格型号 |\n| projectUnit | string | 单位 |\n| projectCount | string | 数量 |\n| projectPriceEt | string | 单价 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 二手车详情列表（15 二手车发票）\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | ---------------------------- |\n| cpzh | string | 车牌照号 |\n| djzh | string | 登记证号 |\n| cllx | string | 车辆类型 |\n| cjh | string | 车架号/车辆识别号 |\n| cpxh | string | 厂牌型号 |\n| glsMc | string | 转入地车辆管理所名称 |\n| jyDw | string | 经营、拍卖单位 |\n| jyDz | string | 经营、拍卖单位地址 |\n| jySh | string | 经营、拍卖单位税号 |\n| jyYh | string | 经营、拍卖单位开户银行、账号 |\n| jyDh | string | 经营、拍卖单位电话 |\n| escsc | string | 二手车市场 |\n| escscSh | string | 二手车市场税号 |\n| escscDz | string | 二手车市场地址 |\n| escscYh | string | 二手车市场开户银行、账号 |\n| escscDh | string | 二手车市场电话 |\n\n#### 通行费详情列表（14 道路通行费 & 59 电子发票通行费）\n\n| 字段 | 类型 | 说明 |\n| ----------- | ------ | -------- |\n| projectName | string | 项目名称 |\n| carNumber | string | 车牌号 |\n| type | string | 类型 |\n| beginDate | string | 通行日起 |\n| endDate | string | 通行日止 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 机动车详情列表（03 机动车发票 & 83 电子发票机动车）\n\n| 字段 | 类型 | 说明 |\n| -------- | ------ | --------------------- |\n| hgzh | string | 合格证号 |\n| jkzmsh | string | 进口证明书号 |\n| sjdh | string | 商检单号 |\n| fdjhm | string | 发动机号码 |\n| clsbh | string | 车辆识别代号/车架号码 |\n| zzssl | string | 增值税税率或征收率 |\n| zzsse | string | 增值税税额 |\n| zgswjg | string | 主管税务机关 |\n| zgswjgdm | string | 主管税务机关代码 |\n| bhsj | string | 不含税价 |\n| wspzhm | string | 完税凭证号码 |\n| dw | string | 吨位 |\n| xccr | string | 限乘人数 |\n| dz | string | 地址 |\n| dh | string | 电话 |\n| khyh | string | 开户银行 |\n| zh | string | 账号 |\n\n### specialDetail 特殊票种明细数据体\n\n#### 铁路电子客票详情列表（51 铁路电子客票）\n\n| 字段 | 类型 | 说明 |\n| --------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| departureTime | string | 出发时间 |\n| fare | string | 票价 |\n| promptInformationArea | string | 提示信息 |\n| seat | string | 座位 |\n| travelDate | string | 乘车日期 |\n| passengerIdNumber | string | 身份证号码 |\n| departureStation | string | 出发地 |\n| trainNumber | string | 车次 |\n| destinationStation | string | 目的地 |\n| eticketNumber | string | 电子客票号码 |\n| seatLevel | string | 座位等级 |\n\n#### 航空运输电子客票行程单详情列表（61 航空运输电子客票行程单）\n\n| 字段 | 类型 | 说明 |\n| -------------------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| issuingStatus | string | 填开状态 |\n| departureStation | string | 出发地 |\n| firstDestinationStation | string | 第一站 |\n| secondDestinationStation | string | 第二站 |\n| thirdDestinationStation | string | 第三站 |\n| fourthDestinationStation | string | 第四站 |\n| totalAmount | string | 合计 |\n| markingOfDomesticOrInternational | string | 国内国际标识 |\n| gpoddnumbers | string | GP 单号 |\n| eticketNumber | string | 电子客票号码 |\n| itineraryDetail | List | 行程明细 |\n\n#### itineraryDetail 行程明细数据体\n\n| 字段 | 类型 | 说明 |\n| ------------- | ------ | ----------------- |\n| departureTime | string | 出发时间 |\n| flight | string | 航班号 |\n| carrier | string | 承运人 |\n| level | string | 座位等级 |\n| carrierDate | string | 承运日期 |\n| fareBasis | string | 客票级别/客票类别 |\n\n## 异常状态码\n\n| 状态码 | 说明 |\n| ------ | ---------------------- |\n| 400 | 请求参数错误 |\n| 300 | 参数为空或格式错误 |\n| 305 | 无权访问该接口 |\n| 307 | 消费失败，授权余次不足 |\n| 308 | 超出接口调用次数 |\n| 500 | 系统异常 |\n\n## 接口请求示例\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n请求：\n\n```json\n{\n \"data\": {\n \"apiKey\": \"sk-sg-9EVbsJLJnlKVLaSO4FZtPUVFysbFL\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"jejym\": \"162.43\"\n }\n}\n```\n\n成功返回：\n\n```json\n{\n \"status\": \"200\",\n \"message\": \"成功\",\n \"data\": {\n \"invoiceType\": \"82\",\n \"invoiceCode\": \"\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"hjje\": \"146.33\",\n \"hjse\": \"16.10\",\n \"jshj\": \"162.43\",\n \"fpStatus\": \"0\",\n \"xsfMc\": \"天津象鲜科技有限公司\",\n \"xsfNsrsbh\": \"91120101MADQKPT067\",\n \"xsfAddressTel\": \"天津市和平区南市街道张自忠路与多伦道交口合生国际大厦1号楼1-L7-101 021-52559777\",\n \"xsfBankAccount\": \"招商银行股份有限公司天津滨海分行营业部 122917783510000\",\n \"gmfMc\": \"北京中兴通融资产管理股份有限公司\",\n \"gmfNsrsbh\": \"911101087582285868\",\n \"gmfAddressTel\": \"\",\n \"gmfBankAccount\": \"\",\n \"items\": [\n {\n \"projectName\": \"*水果*水果\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"4\",\n \"projectPriceEt\": \"18.4850000000\",\n \"projectJeEt\": \"73.94\",\n \"sl\": \"0.090\",\n \"se\": \"6.66\"\n },\n {\n \"projectName\": \"*纸制品*纸制品\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"1\",\n \"projectPriceEt\": \"16.7300000000\",\n \"projectJeEt\": \"16.73\",\n \"sl\": \"0.130\",\n \"se\": \"2.17\"\n }\n ]\n }\n}\n```\n\n异常返回：\n\n```json\n{\n \"status\": \"400\",\n \"message\": \"金额/校验码不能为空\",\n \"data\": \"\"\n}\n```\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求方式：`multipart/form-data`，包含 `apiKey` 字段和 `file` 文件字段。\n\n返回值：集合，集合内结构与按票面查验一致。\n\n## 命令示例\n\n按票面查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py inspect --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\" --jejym \"162.43\"\n```\n\n按文件查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py file --file \"E:\\\\invoices\\\\test.pdf\"\n```\n\n查询查验记录（按日期范围）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\"\n```\n\n查询查验记录（按发票号码）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --invoice-number \"26127000000211930033\"\n```\n\n查询查验记录（按发票类型筛选，可多选）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\" --fplx 82 81\n```\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-verify\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1781681489525\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\n发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[zxt](https://clawhub.ai/user/zxt)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and business operators use this skill to verify invoice authenticity from invoice fields or uploaded invoice files, retrieve complete invoice details, and query prior verification records.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Invoice files and invoice metadata may contain sensitive business, tax, or personal information and are sent to skill.quandianfapiao.com for verification.\n\nMitigation: Install and use the skill only after confirming that this external service is acceptable for the data being checked, and avoid submitting invoices that exceed the user's data-sharing policy.\n\nRisk: The skill asks users to provide an API key in chat and includes instructions that may persist the key in plaintext shell startup files.\n\nMitigation: Use a temporary environment variable, a secret manager, or a restricted throwaway key instead of pasting production credentials into chat or storing them permanently; rotate any key that may have been exposed.\n\nRisk: Invoice authenticity and record outputs depend on responses from the remote service and the user's account authorization.\n\nMitigation: Review non-200 status messages before acting on results, and confirm important tax or compliance decisions against authoritative records.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/zxt/skills/invoice-verify)\n- [中兴通简税Skill平台](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Human-readable invoice verification results, record summaries, status messages, and command examples.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include invoice metadata returned by the external service; file verification supports pdf, ofd, xml, jpg, and png files up to 10MB.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.0: 5 files, 12770 bytes\n\nFiles: common.py (4673b), invoice_verify.py (8429b), skill-card.md (2463b), SKILL.md (24643b), _meta.json (133b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: invoice-verify\ndescription: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n---\n\n# 发票查验技能\n\n使用此技能通过票面信息或上传发票文件查验发票真伪，获取完整票面明细。\n\n## 使用场景\n\n满足以下需求时使用：\n\n- 根据发票号码、开票日期、金额/校验码查验发票真伪。\n- 上传发票文件（pdf/ofd/xml/jpg/png）进行批量查验。\n- 查询查验记录，按日期范围、发票号码、发票类型等条件筛选。\n\n## 触发语句示例\n\n以下用户输入应触发此技能：\n\n- 帮我查验这张发票 / 发票查验 / 查验发票\n- 验证发票真伪 / 发票验真 / 验真\n- 查一下这张发票是不是真的\n- 上传发票文件查验 / 文件查验\n- 这个发票文件帮我验一下\n- 查验发票 26127000000211930033\n- 查看一下查验记录 / 查验记录 / 查验历史\n- 查一下5月份的查验记录\n- 有没有查验失败的发票\n- 查验状态不一致的发票有哪些\n\n## 输入参数\n\n执行前准备以下参数：\n\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\n\n### 按票面查验 (inspect)\n\n- 发票号码（必填）\n- 开票日期（必填，格式 YYYY-MM-DD）\n- 金额或校验码（必填，根据发票种类不同传入金额或校验码）\n- 发票代码（可选）\n\n### 按文件查验 (file)\n\n- 发票文件路径（必填，支持 pdf、ofd、xml、jpg、png）\n\n### 查询查验记录 (record)\n\n- 开票日期开始（选填，格式 YYYY-MM-DD）\n- 开票日期结束（选填，格式 YYYY-MM-DD）\n- 发票号码（选填）\n- 发票代码（选填）\n- 发票类型（选填，可多选，传入编码值，详见下方 fplx 枚举）\n- 页码（选填，默认 1）\n- 每页条数（选填，默认 10）\n- 查验时间开始（选填，格式 YYYY-MM-DD）\n- 查验时间结束（选填，格式 YYYY-MM-DD）\n\n#### fplx 发票类型枚举\n\n| 票据大类 | 票据小类 | 编码 |\n| ---------------------- | ---------------------------------- | ---- |\n| 增值税发票管理系统发票 | 增值税专用发票 | 01 |\n| | 货物运输业增值税专用发票 | 02 |\n| | 机动车销售统一发票 | 03 |\n| | 增值税普通发票 | 04 |\n| | 增值税电子专用发票 | 08 |\n| | 增值税电子普通发票 | 10 |\n| | 增值税普通发票（卷票） | 11 |\n| | 二手车销售统一发票 | 15 |\n| | 道路通行费电子普通发票 | 14 |\n| 电子发票服务平台 | 电子发票（增值税专用发票） | 81 |\n| | 电子发票（普通发票） | 82 |\n| | 电子发票（铁路电子客票） | 51 |\n| | 电子发票（航空运输电子客票行程单） | 61 |\n| | 机动车销售电子统一发票 | 73 |\n| | 电子发票（机动车销售统一发票） | 83 |\n| | 二手车销售电子统一发票 | 84 |\n| | 纸质发票（增值税专用发票） | 85 |\n| | 纸质发票（普通发票） | 86 |\n| | 纸质发票（机动车销售统一发票） | 87 |\n| | 纸质发票（二手车销售统一发票） | 88 |\n| | 数电票（通行费发票） | 59 |\n| 地方通用发票 | 浙江通用（电子）发票 | Z1 |\n| | 云南省通用电子发票 | Y1 |\n| | 广东通用机打发票（电子） | G1 |\n| | 北京电子普通发票 | B1 |\n| | 深圳电子普通发票 | S1 |\n| | 通用定额发票 | TY |\n| | 江苏省车辆通行费通用（电子）发票 | J1 |\n| 交通运输发票 | 出租车发票 | CZ |\n| | 汽车票 | QC |\n| | 轮船票 | LC |\n| | 过路过桥费发票 | GL |\n| | 火车票 | HC |\n| | 机票行程单 | JX |\n| 其他发票 | 其他发票 | QT |\n| 财政票据 | 财政票据 | CP |\n| 海关缴款书 | 海关缴款书 | 17 |\n\n## 执行流程\n\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\n\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\n\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\n\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\n\n> 您需要完成以下三步，即可自动配置并执行技能：\n>\n> 1. **注册账号**\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\n>\n> 2. **申请 apiKey**\n> 登录后进入\"技能中心\"，复制您的 apiKey。\n>\n> 3. **提供 apiKey**\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\n\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\n\n- 禁止读取文件（Excel、PDF、图片等）\n- 禁止调用任何 API\n- 禁止执行任何脚本或命令\n- 禁止进行参数解析或预处理\n\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\n\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\n\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\n\n环境变量就绪后，继续以下步骤：\n\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\n - 缺少发票号码、开票日期或金额/校验码：停止并提示用户提供对应参数。\n - 按文件查验时文件不存在或不支持该文件类型：停止并提示用户。\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\n3. 检查返回的 status 字段，非 200 时停止并将错误信息展示给用户，禁止重试或忽略。\n4. 解析返回结果并以可读格式输出。\n\n## 请求参数说明\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | ------ | ---- | ----------------------------------------------------------- |\n| apiKey | string | 是 | apiKey |\n| invoiceNumber | string | 是 | 发票号码 |\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\n| jejym | string | 是 | 金额或校验码，根据发票种类不同传入，详见下方 jejym 传入规则 |\n| invoiceCode | string | 否 | 发票代码 |\n\n### jejym 传入规则\n\n不同发票类型的 jejym 入参不同：\n\n| 发票类型 | jejym 入参 |\n| ------------------------------ | ------------------ |\n| 增值税专用发票 | 开具金额（不含税） |\n| 机动车销售统一发票 | 不含税价 |\n| 二手车销售统一发票 | 车价合计 |\n| 增值税电子专用发票 | 开具金额（不含税） |\n| 电子发票（增值税专用发票） | 价税合计 |\n| 电子发票（普通发票） | 价税合计 |\n| 增值税普通发票 | 校验码后六位 |\n| 增值税普通发票（卷票） | 校验码后六位 |\n| 增值税电子普通发票 | 校验码后六位 |\n| 道路通行费电子普通发票 | 校验码后六位 |\n| 铁路电子客票 | 价税合计 |\n| 航空运输电子客票行程单 | 价税合计 |\n| 电子发票（机动车销售统一发票） | 价税合计 |\n| 电子发票（通行费发票） | 价税合计 |\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求头：`Content-Type: multipart/form-data`\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------ | ------ | ---- | ------------------------------- |\n| apiKey | string | 是 | apiKey |\n| file | file | 是 | 发票文件（pdf/ofd/xml/jpg/png） |\n\n### 查询查验记录 — POST /api/jxplus/zxtSkill/inspection/queryInspectionRecord\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | -------- | ---- | ------------------------- |\n| apiKey | string | 是 | apiKey |\n| kprqStart | string | 否 | 开票日期开始 (YYYY-MM-DD) |\n| kprqEnd | string | 否 | 开票日期结束 (YYYY-MM-DD) |\n| invoiceNumber | string | 否 | 发票号码 |\n| invoiceCode | string | 否 | 发票代码 |\n| fplxList | string[] | 否 | 发票类型集合 |\n| pageNo | string | 否 | 页码，默认 1 |\n| pageSize | string | 否 | 每页条数，默认 10 |\n| cysjStart | string | 否 | 查验时间开始 (YYYY-MM-DD) |\n| cysjEnd | string | 否 | 查验时间结束 (YYYY-MM-DD) |\n\n## 返回说明\n\n按票面查验和按文件查验共享相同的返回数据结构。按文件查验返回集合，集合内每条记录结构与按票面查验一致。\n\n### 查验记录返回 (record)\n\n返回分页列表，每条记录包含：\n\n| 字段 | 说明 |\n| ------------- | -------------------------------------------------------------------------------------------------------- |\n| invoiceNumber | 发票号码 |\n| invoiceCode | 发票代码 |\n| fplx | 发票类型 |\n| fplxName | 发票类型名称 |\n| kprq | 开票日期 |\n| jshj | 价税合计 |\n| cyzt | 查验状态：0 未查验，1 查验中，2 查验真票，3 查无此票，4 查询不一致，5 查验失败，6 不支持查验，7 抬头不符 |\n| cyztName | 查验状态名称 |\n| cysj | 查验时间 |\n| xsfMc | 销售方名称 |\n\n### 外层返回字段\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | -------------------------------- |\n| status | string | 返回接口状态码 |\n| message | string | 返回接口状态描述信息 |\n| data | object | 业务数据体（按文件查验时为数组） |\n\n### data 业务数据体\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------- | ---------------------------------------------------- |\n| invoiceType | string | 发票种类，详见发票类型说明 |\n| invoiceCode | string | 发票代码 |\n| invoiceNumber | string | 发票号码 |\n| invoiceDate | string | 开票日期 |\n| hjje | decimal | 合计金额 |\n| hjse | decimal | 合计税额 |\n| jshj | decimal | 价税合计 |\n| fpStatus | string | 发票状态：0 正常，2 作废，3 红冲 |\n| xsfMc | string | 销售方名称 |\n| xsfNsrsbh | string | 销售方纳税人识别号 |\n| xsfAddressTel | string | 销售方地址、电话 |\n| xsfBankAccount | string | 销售方开户行及账号 |\n| gmfMc | string | 购买方名称 |\n| gmfNsrsbh | string | 购买方税号 |\n| gmfAddressTel | string | 购买方地址、电话 |\n| gmfBankAccount | string | 购买方开户行及账号 |\n| payee | string | 收款人 |\n| reviewer | string | 复核人 |\n| invoicer | string | 开票人 |\n| machineNo | string | 机器编号 |\n| checkCode | string | 校验码 |\n| passwordArea | string | 密码区 |\n| remark | string | 备注 |\n| xmlFileUrl | string | xml 文件地址 |\n| pdfFileUrl | string | pdf 文件地址 |\n| ofdFileUrl | string | ofd 文件地址 |\n| items | List | 发票明细 |\n| specialDetail | List | 特殊票种明细（铁路电子客票、航空运输电子客票行程单） |\n\n### items 明细数据体\n\n#### 商品详情列表（其他类型发票）\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------ | ------------------------ |\n| projectName | string | 货物或应税劳务、服务名称 |\n| ggxh | string | 规格型号 |\n| projectUnit | string | 单位 |\n| projectCount | string | 数量 |\n| projectPriceEt | string | 单价 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 二手车详情列表（15 二手车发票）\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | ---------------------------- |\n| cpzh | string | 车牌照号 |\n| djzh | string | 登记证号 |\n| cllx | string | 车辆类型 |\n| cjh | string | 车架号/车辆识别号 |\n| cpxh | string | 厂牌型号 |\n| glsMc | string | 转入地车辆管理所名称 |\n| jyDw | string | 经营、拍卖单位 |\n| jyDz | string | 经营、拍卖单位地址 |\n| jySh | string | 经营、拍卖单位税号 |\n| jyYh | string | 经营、拍卖单位开户银行、账号 |\n| jyDh | string | 经营、拍卖单位电话 |\n| escsc | string | 二手车市场 |\n| escscSh | string | 二手车市场税号 |\n| escscDz | string | 二手车市场地址 |\n| escscYh | string | 二手车市场开户银行、账号 |\n| escscDh | string | 二手车市场电话 |\n\n#### 通行费详情列表（14 道路通行费 & 59 电子发票通行费）\n\n| 字段 | 类型 | 说明 |\n| ----------- | ------ | -------- |\n| projectName | string | 项目名称 |\n| carNumber | string | 车牌号 |\n| type | string | 类型 |\n| beginDate | string | 通行日起 |\n| endDate | string | 通行日止 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 机动车详情列表（03 机动车发票 & 83 电子发票机动车）\n\n| 字段 | 类型 | 说明 |\n| -------- | ------ | --------------------- |\n| hgzh | string | 合格证号 |\n| jkzmsh | string | 进口证明书号 |\n| sjdh | string | 商检单号 |\n| fdjhm | string | 发动机号码 |\n| clsbh | string | 车辆识别代号/车架号码 |\n| zzssl | string | 增值税税率或征收率 |\n| zzsse | string | 增值税税额 |\n| zgswjg | string | 主管税务机关 |\n| zgswjgdm | string | 主管税务机关代码 |\n| bhsj | string | 不含税价 |\n| wspzhm | string | 完税凭证号码 |\n| dw | string | 吨位 |\n| xccr | string | 限乘人数 |\n| dz | string | 地址 |\n| dh | string | 电话 |\n| khyh | string | 开户银行 |\n| zh | string | 账号 |\n\n### specialDetail 特殊票种明细数据体\n\n#### 铁路电子客票详情列表（51 铁路电子客票）\n\n| 字段 | 类型 | 说明 |\n| --------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| departureTime | string | 出发时间 |\n| fare | string | 票价 |\n| promptInformationArea | string | 提示信息 |\n| seat | string | 座位 |\n| travelDate | string | 乘车日期 |\n| passengerIdNumber | string | 身份证号码 |\n| departureStation | string | 出发地 |\n| trainNumber | string | 车次 |\n| destinationStation | string | 目的地 |\n| eticketNumber | string | 电子客票号码 |\n| seatLevel | string | 座位等级 |\n\n#### 航空运输电子客票行程单详情列表（61 航空运输电子客票行程单）\n\n| 字段 | 类型 | 说明 |\n| -------------------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| issuingStatus | string | 填开状态 |\n| departureStation | string | 出发地 |\n| firstDestinationStation | string | 第一站 |\n| secondDestinationStation | string | 第二站 |\n| thirdDestinationStation | string | 第三站 |\n| fourthDestinationStation | string | 第四站 |\n| totalAmount | string | 合计 |\n| markingOfDomesticOrInternational | string | 国内国际标识 |\n| gpoddnumbers | string | GP 单号 |\n| eticketNumber | string | 电子客票号码 |\n| itineraryDetail | List | 行程明细 |\n\n#### itineraryDetail 行程明细数据体\n\n| 字段 | 类型 | 说明 |\n| ------------- | ------ | ----------------- |\n| departureTime | string | 出发时间 |\n| flight | string | 航班号 |\n| carrier | string | 承运人 |\n| level | string | 座位等级 |\n| carrierDate | string | 承运日期 |\n| fareBasis | string | 客票级别/客票类别 |\n\n## 异常状态码\n\n| 状态码 | 说明 |\n| ------ | ---------------------- |\n| 400 | 请求参数错误 |\n| 300 | 参数为空或格式错误 |\n| 305 | 无权访问该接口 |\n| 307 | 消费失败，授权余次不足 |\n| 308 | 超出接口调用次数 |\n| 500 | 系统异常 |\n\n## 接口请求示例\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n请求：\n\n```json\n{\n \"data\": {\n \"apiKey\": \"sk-sg-9EVbsJLJnlKVLaSO4FZtPUVFysbFL\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"jejym\": \"162.43\"\n }\n}\n```\n\n成功返回：\n\n```json\n{\n \"status\": \"200\",\n \"message\": \"成功\",\n \"data\": {\n \"invoiceType\": \"82\",\n \"invoiceCode\": \"\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"hjje\": \"146.33\",\n \"hjse\": \"16.10\",\n \"jshj\": \"162.43\",\n \"fpStatus\": \"0\",\n \"xsfMc\": \"天津象鲜科技有限公司\",\n \"xsfNsrsbh\": \"91120101MADQKPT067\",\n \"xsfAddressTel\": \"天津市和平区南市街道张自忠路与多伦道交口合生国际大厦1号楼1-L7-101 021-52559777\",\n \"xsfBankAccount\": \"招商银行股份有限公司天津滨海分行营业部 122917783510000\",\n \"gmfMc\": \"北京中兴通融资产管理股份有限公司\",\n \"gmfNsrsbh\": \"911101087582285868\",\n \"gmfAddressTel\": \"\",\n \"gmfBankAccount\": \"\",\n \"items\": [\n {\n \"projectName\": \"*水果*水果\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"4\",\n \"projectPriceEt\": \"18.4850000000\",\n \"projectJeEt\": \"73.94\",\n \"sl\": \"0.090\",\n \"se\": \"6.66\"\n },\n {\n \"projectName\": \"*纸制品*纸制品\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"1\",\n \"projectPriceEt\": \"16.7300000000\",\n \"projectJeEt\": \"16.73\",\n \"sl\": \"0.130\",\n \"se\": \"2.17\"\n }\n ]\n }\n}\n```\n\n异常返回：\n\n```json\n{\n \"status\": \"400\",\n \"message\": \"金额/校验码不能为空\",\n \"data\": \"\"\n}\n```\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求方式：`multipart/form-data`，包含 `apiKey` 字段和 `file` 文件字段。\n\n返回值：集合，集合内结构与按票面查验一致。\n\n## 命令示例\n\n按票面查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py inspect --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\" --jejym \"162.43\"\n```\n\n按文件查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py file --file \"E:\\\\invoices\\\\test.pdf\"\n```\n\n查询查验记录（按日期范围）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\"\n```\n\n查询查验记录（按发票号码）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --invoice-number \"26127000000211930033\"\n```\n\n查询查验记录（按发票类型筛选，可多选）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\" --fplx 82 81\n```\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-verify\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1779696143897\n}\n\nFile v1.0.0:skill-card.md\n\n## Description:
\n发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[sunriseorient](https://clawhub.ai/user/sunriseorient)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and finance operations teams use this skill to verify invoice authenticity from invoice fields or uploaded invoice files, and to query prior verification records. It supports supported invoice file types and returns readable invoice details, status, and record summaries.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill handles sensitive invoice documents, extracted financial metadata, and verification history through a remote verifier service.
\nMitigation: Install and run it only after confirming that the user is comfortable sending invoice documents and metadata to the verifier service.
\nRisk: The skill requires an API key and its instructions include persistent shell environment configuration.
\nMitigation: Use a least-privilege API key, avoid pasting secrets into chat, and avoid persisting the key in shell startup files unless persistent access is explicitly intended.
\nRisk: Record lookup can expose sensitive verification history.
\nMitigation: Treat record queries and returned records as sensitive business data and restrict use to authorized users.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/sunriseorient/invoice-verify)
\n- [Verifier service](https://skill.quandianfapiao.com/)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, shell commands, configuration, guidance]
\n**Output Format:** [Plain text or Markdown-style summaries with invoice fields, verification status, record lists, and error messages]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses ZXT_API_KEY credentials and may upload invoice files up to 10 MB to the verifier service.]
\n\n## Skill Version(s):
\n1.0.0 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nArchive v1.0.0-beta: 4 files, 11402 bytes\n\nFiles: common.py (4673b), invoice_verify.py (8429b), SKILL.md (24643b), _meta.json (138b)\n\nFile v1.0.0-beta:SKILL.md\n\n---\nname: invoice-verify\ndescription: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n---\n\n# 发票查验技能\n\n使用此技能通过票面信息或上传发票文件查验发票真伪，获取完整票面明细。\n\n## 使用场景\n\n满足以下需求时使用：\n\n- 根据发票号码、开票日期、金额/校验码查验发票真伪。\n- 上传发票文件（pdf/ofd/xml/jpg/png）进行批量查验。\n- 查询查验记录，按日期范围、发票号码、发票类型等条件筛选。\n\n## 触发语句示例\n\n以下用户输入应触发此技能：\n\n- 帮我查验这张发票 / 发票查验 / 查验发票\n- 验证发票真伪 / 发票验真 / 验真\n- 查一下这张发票是不是真的\n- 上传发票文件查验 / 文件查验\n- 这个发票文件帮我验一下\n- 查验发票 26127000000211930033\n- 查看一下查验记录 / 查验记录 / 查验历史\n- 查一下5月份的查验记录\n- 有没有查验失败的发票\n- 查验状态不一致的发票有哪些\n\n## 输入参数\n\n执行前准备以下参数：\n\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\n\n### 按票面查验 (inspect)\n\n- 发票号码（必填）\n- 开票日期（必填，格式 YYYY-MM-DD）\n- 金额或校验码（必填，根据发票种类不同传入金额或校验码）\n- 发票代码（可选）\n\n### 按文件查验 (file)\n\n- 发票文件路径（必填，支持 pdf、ofd、xml、jpg、png）\n\n### 查询查验记录 (record)\n\n- 开票日期开始（选填，格式 YYYY-MM-DD）\n- 开票日期结束（选填，格式 YYYY-MM-DD）\n- 发票号码（选填）\n- 发票代码（选填）\n- 发票类型（选填，可多选，传入编码值，详见下方 fplx 枚举）\n- 页码（选填，默认 1）\n- 每页条数（选填，默认 10）\n- 查验时间开始（选填，格式 YYYY-MM-DD）\n- 查验时间结束（选填，格式 YYYY-MM-DD）\n\n#### fplx 发票类型枚举\n\n| 票据大类 | 票据小类 | 编码 |\n| ---------------------- | ---------------------------------- | ---- |\n| 增值税发票管理系统发票 | 增值税专用发票 | 01 |\n| | 货物运输业增值税专用发票 | 02 |\n| | 机动车销售统一发票 | 03 |\n| | 增值税普通发票 | 04 |\n| | 增值税电子专用发票 | 08 |\n| | 增值税电子普通发票 | 10 |\n| | 增值税普通发票（卷票） | 11 |\n| | 二手车销售统一发票 | 15 |\n| | 道路通行费电子普通发票 | 14 |\n| 电子发票服务平台 | 电子发票（增值税专用发票） | 81 |\n| | 电子发票（普通发票） | 82 |\n| | 电子发票（铁路电子客票） | 51 |\n| | 电子发票（航空运输电子客票行程单） | 61 |\n| | 机动车销售电子统一发票 | 73 |\n| | 电子发票（机动车销售统一发票） | 83 |\n| | 二手车销售电子统一发票 | 84 |\n| | 纸质发票（增值税专用发票） | 85 |\n| | 纸质发票（普通发票） | 86 |\n| | 纸质发票（机动车销售统一发票） | 87 |\n| | 纸质发票（二手车销售统一发票） | 88 |\n| | 数电票（通行费发票） | 59 |\n| 地方通用发票 | 浙江通用（电子）发票 | Z1 |\n| | 云南省通用电子发票 | Y1 |\n| | 广东通用机打发票（电子） | G1 |\n| | 北京电子普通发票 | B1 |\n| | 深圳电子普通发票 | S1 |\n| | 通用定额发票 | TY |\n| | 江苏省车辆通行费通用（电子）发票 | J1 |\n| 交通运输发票 | 出租车发票 | CZ |\n| | 汽车票 | QC |\n| | 轮船票 | LC |\n| | 过路过桥费发票 | GL |\n| | 火车票 | HC |\n| | 机票行程单 | JX |\n| 其他发票 | 其他发票 | QT |\n| 财政票据 | 财政票据 | CP |\n| 海关缴款书 | 海关缴款书 | 17 |\n\n## 执行流程\n\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\n\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\n\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\n\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\n\n> 您需要完成以下三步，即可自动配置并执行技能：\n>\n> 1. **注册账号**\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\n>\n> 2. **申请 apiKey**\n> 登录后进入\"技能中心\"，复制您的 apiKey。\n>\n> 3. **提供 apiKey**\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\n\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\n\n- 禁止读取文件（Excel、PDF、图片等）\n- 禁止调用任何 API\n- 禁止执行任何脚本或命令\n- 禁止进行参数解析或预处理\n\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\n\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\n\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\n\n环境变量就绪后，继续以下步骤：\n\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\n - 缺少发票号码、开票日期或金额/校验码：停止并提示用户提供对应参数。\n - 按文件查验时文件不存在或不支持该文件类型：停止并提示用户。\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\n3. 检查返回的 status 字段，非 200 时停止并将错误信息展示给用户，禁止重试或忽略。\n4. 解析返回结果并以可读格式输出。\n\n## 请求参数说明\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | ------ | ---- | ----------------------------------------------------------- |\n| apiKey | string | 是 | apiKey |\n| invoiceNumber | string | 是 | 发票号码 |\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\n| jejym | string | 是 | 金额或校验码，根据发票种类不同传入，详见下方 jejym 传入规则 |\n| invoiceCode | string | 否 | 发票代码 |\n\n### jejym 传入规则\n\n不同发票类型的 jejym 入参不同：\n\n| 发票类型 | jejym 入参 |\n| ------------------------------ | ------------------ |\n| 增值税专用发票 | 开具金额（不含税） |\n| 机动车销售统一发票 | 不含税价 |\n| 二手车销售统一发票 | 车价合计 |\n| 增值税电子专用发票 | 开具金额（不含税） |\n| 电子发票（增值税专用发票） | 价税合计 |\n| 电子发票（普通发票） | 价税合计 |\n| 增值税普通发票 | 校验码后六位 |\n| 增值税普通发票（卷票） | 校验码后六位 |\n| 增值税电子普通发票 | 校验码后六位 |\n| 道路通行费电子普通发票 | 校验码后六位 |\n| 铁路电子客票 | 价税合计 |\n| 航空运输电子客票行程单 | 价税合计 |\n| 电子发票（机动车销售统一发票） | 价税合计 |\n| 电子发票（通行费发票） | 价税合计 |\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求头：`Content-Type: multipart/form-data`\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------ | ------ | ---- | ------------------------------- |\n| apiKey | string | 是 | apiKey |\n| file | file | 是 | 发票文件（pdf/ofd/xml/jpg/png） |\n\n### 查询查验记录 — POST /api/jxplus/zxtSkill/inspection/queryInspectionRecord\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | -------- | ---- | ------------------------- |\n| apiKey | string | 是 | apiKey |\n| kprqStart | string | 否 | 开票日期开始 (YYYY-MM-DD) |\n| kprqEnd | string | 否 | 开票日期结束 (YYYY-MM-DD) |\n| invoiceNumber | string | 否 | 发票号码 |\n| invoiceCode | string | 否 | 发票代码 |\n| fplxList | string[] | 否 | 发票类型集合 |\n| pageNo | string | 否 | 页码，默认 1 |\n| pageSize | string | 否 | 每页条数，默认 10 |\n| cysjStart | string | 否 | 查验时间开始 (YYYY-MM-DD) |\n| cysjEnd | string | 否 | 查验时间结束 (YYYY-MM-DD) |\n\n## 返回说明\n\n按票面查验和按文件查验共享相同的返回数据结构。按文件查验返回集合，集合内每条记录结构与按票面查验一致。\n\n### 查验记录返回 (record)\n\n返回分页列表，每条记录包含：\n\n| 字段 | 说明 |\n| ------------- | -------------------------------------------------------------------------------------------------------- |\n| invoiceNumber | 发票号码 |\n| invoiceCode | 发票代码 |\n| fplx | 发票类型 |\n| fplxName | 发票类型名称 |\n| kprq | 开票日期 |\n| jshj | 价税合计 |\n| cyzt | 查验状态：0 未查验，1 查验中，2 查验真票，3 查无此票，4 查询不一致，5 查验失败，6 不支持查验，7 抬头不符 |\n| cyztName | 查验状态名称 |\n| cysj | 查验时间 |\n| xsfMc | 销售方名称 |\n\n### 外层返回字段\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | -------------------------------- |\n| status | string | 返回接口状态码 |\n| message | string | 返回接口状态描述信息 |\n| data | object | 业务数据体（按文件查验时为数组） |\n\n### data 业务数据体\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------- | ---------------------------------------------------- |\n| invoiceType | string | 发票种类，详见发票类型说明 |\n| invoiceCode | string | 发票代码 |\n| invoiceNumber | string | 发票号码 |\n| invoiceDate | string | 开票日期 |\n| hjje | decimal | 合计金额 |\n| hjse | decimal | 合计税额 |\n| jshj | decimal | 价税合计 |\n| fpStatus | string | 发票状态：0 正常，2 作废，3 红冲 |\n| xsfMc | string | 销售方名称 |\n| xsfNsrsbh | string | 销售方纳税人识别号 |\n| xsfAddressTel | string | 销售方地址、电话 |\n| xsfBankAccount | string | 销售方开户行及账号 |\n| gmfMc | string | 购买方名称 |\n| gmfNsrsbh | string | 购买方税号 |\n| gmfAddressTel | string | 购买方地址、电话 |\n| gmfBankAccount | string | 购买方开户行及账号 |\n| payee | string | 收款人 |\n| reviewer | string | 复核人 |\n| invoicer | string | 开票人 |\n| machineNo | string | 机器编号 |\n| checkCode | string | 校验码 |\n| passwordArea | string | 密码区 |\n| remark | string | 备注 |\n| xmlFileUrl | string | xml 文件地址 |\n| pdfFileUrl | string | pdf 文件地址 |\n| ofdFileUrl | string | ofd 文件地址 |\n| items | List | 发票明细 |\n| specialDetail | List | 特殊票种明细（铁路电子客票、航空运输电子客票行程单） |\n\n### items 明细数据体\n\n#### 商品详情列表（其他类型发票）\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------ | ------------------------ |\n| projectName | string | 货物或应税劳务、服务名称 |\n| ggxh | string | 规格型号 |\n| projectUnit | string | 单位 |\n| projectCount | string | 数量 |\n| projectPriceEt | string | 单价 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 二手车详情列表（15 二手车发票）\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | ---------------------------- |\n| cpzh | string | 车牌照号 |\n| djzh | string | 登记证号 |\n| cllx | string | 车辆类型 |\n| cjh | string | 车架号/车辆识别号 |\n| cpxh | string | 厂牌型号 |\n| glsMc | string | 转入地车辆管理所名称 |\n| jyDw | string | 经营、拍卖单位 |\n| jyDz | string | 经营、拍卖单位地址 |\n| jySh | string | 经营、拍卖单位税号 |\n| jyYh | string | 经营、拍卖单位开户银行、账号 |\n| jyDh | string | 经营、拍卖单位电话 |\n| escsc | string | 二手车市场 |\n| escscSh | string | 二手车市场税号 |\n| escscDz | string | 二手车市场地址 |\n| escscYh | string | 二手车市场开户银行、账号 |\n| escscDh | string | 二手车市场电话 |\n\n#### 通行费详情列表（14 道路通行费 & 59 电子发票通行费）\n\n| 字段 | 类型 | 说明 |\n| ----------- | ------ | -------- |\n| projectName | string | 项目名称 |\n| carNumber | string | 车牌号 |\n| type | string | 类型 |\n| beginDate | string | 通行日起 |\n| endDate | string | 通行日止 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 机动车详情列表（03 机动车发票 & 83 电子发票机动车）\n\n| 字段 | 类型 | 说明 |\n| -------- | ------ | --------------------- |\n| hgzh | string | 合格证号 |\n| jkzmsh | string | 进口证明书号 |\n| sjdh | string | 商检单号 |\n| fdjhm | string | 发动机号码 |\n| clsbh | string | 车辆识别代号/车架号码 |\n| zzssl | string | 增值税税率或征收率 |\n| zzsse | string | 增值税税额 |\n| zgswjg | string | 主管税务机关 |\n| zgswjgdm | string | 主管税务机关代码 |\n| bhsj | string | 不含税价 |\n| wspzhm | string | 完税凭证号码 |\n| dw | string | 吨位 |\n| xccr | string | 限乘人数 |\n| dz | string | 地址 |\n| dh | string | 电话 |\n| khyh | string | 开户银行 |\n| zh | string | 账号 |\n\n### specialDetail 特殊票种明细数据体\n\n#### 铁路电子客票详情列表（51 铁路电子客票）\n\n| 字段 | 类型 | 说明 |\n| --------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| departureTime | string | 出发时间 |\n| fare | string | 票价 |\n| promptInformationArea | string | 提示信息 |\n| seat | string | 座位 |\n| travelDate | string | 乘车日期 |\n| passengerIdNumber | string | 身份证号码 |\n| departureStation | string | 出发地 |\n| trainNumber | string | 车次 |\n| destinationStation | string | 目的地 |\n| eticketNumber | string | 电子客票号码 |\n| seatLevel | string | 座位等级 |\n\n#### 航空运输电子客票行程单详情列表（61 航空运输电子客票行程单）\n\n| 字段 | 类型 | 说明 |\n| -------------------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| issuingStatus | string | 填开状态 |\n| departureStation | string | 出发地 |\n| firstDestinationStation | string | 第一站 |\n| secondDestinationStation | string | 第二站 |\n| thirdDestinationStation | string | 第三站 |\n| fourthDestinationStation | string | 第四站 |\n| totalAmount | string | 合计 |\n| markingOfDomesticOrInternational | string | 国内国际标识 |\n| gpoddnumbers | string | GP 单号 |\n| eticketNumber | string | 电子客票号码 |\n| itineraryDetail | List | 行程明细 |\n\n#### itineraryDetail 行程明细数据体\n\n| 字段 | 类型 | 说明 |\n| ------------- | ------ | ----------------- |\n| departureTime | string | 出发时间 |\n| flight | string | 航班号 |\n| carrier | string | 承运人 |\n| level | string | 座位等级 |\n| carrierDate | string | 承运日期 |\n| fareBasis | string | 客票级别/客票类别 |\n\n## 异常状态码\n\n| 状态码 | 说明 |\n| ------ | ---------------------- |\n| 400 | 请求参数错误 |\n| 300 | 参数为空或格式错误 |\n| 305 | 无权访问该接口 |\n| 307 | 消费失败，授权余次不足 |\n| 308 | 超出接口调用次数 |\n| 500 | 系统异常 |\n\n## 接口请求示例\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n请求：\n\n```json\n{\n \"data\": {\n \"apiKey\": \"sk-sg-9EVbsJLJnlKVLaSO4FZtPUVFysbFL\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"jejym\": \"162.43\"\n }\n}\n```\n\n成功返回：\n\n```json\n{\n \"status\": \"200\",\n \"message\": \"成功\",\n \"data\": {\n \"invoiceType\": \"82\",\n \"invoiceCode\": \"\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"hjje\": \"146.33\",\n \"hjse\": \"16.10\",\n \"jshj\": \"162.43\",\n \"fpStatus\": \"0\",\n \"xsfMc\": \"天津象鲜科技有限公司\",\n \"xsfNsrsbh\": \"91120101MADQKPT067\",\n \"xsfAddressTel\": \"天津市和平区南市街道张自忠路与多伦道交口合生国际大厦1号楼1-L7-101 021-52559777\",\n \"xsfBankAccount\": \"招商银行股份有限公司天津滨海分行营业部 122917783510000\",\n \"gmfMc\": \"北京中兴通融资产管理股份有限公司\",\n \"gmfNsrsbh\": \"911101087582285868\",\n \"gmfAddressTel\": \"\",\n \"gmfBankAccount\": \"\",\n \"items\": [\n {\n \"projectName\": \"*水果*水果\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"4\",\n \"projectPriceEt\": \"18.4850000000\",\n \"projectJeEt\": \"73.94\",\n \"sl\": \"0.090\",\n \"se\": \"6.66\"\n },\n {\n \"projectName\": \"*纸制品*纸制品\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"1\",\n \"projectPriceEt\": \"16.7300000000\",\n \"projectJeEt\": \"16.73\",\n \"sl\": \"0.130\",\n \"se\": \"2.17\"\n }\n ]\n }\n}\n```\n\n异常返回：\n\n```json\n{\n \"status\": \"400\",\n \"message\": \"金额/校验码不能为空\",\n \"data\": \"\"\n}\n```\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求方式：`multipart/form-data`，包含 `apiKey` 字段和 `file` 文件字段。\n\n返回值：集合，集合内结构与按票面查验一致。\n\n## 命令示例\n\n按票面查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py inspect --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\" --jejym \"162.43\"\n```\n\n按文件查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py file --file \"E:\\\\invoices\\\\test.pdf\"\n```\n\n查询查验记录（按日期范围）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\"\n```\n\n查询查验记录（按发票号码）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --invoice-number \"26127000000211930033\"\n```\n\n查询查验记录（按发票类型筛选，可多选）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\" --fplx 82 81\n```\n\nFile v1.0.0-beta:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-verify\",\n \"version\": \"1.0.0-beta\",\n \"publishedAt\": 1779412129129\n}\n\nArchive v1.0.0-alpha: 4 files, 11399 bytes\n\nFiles: common.py (4667b), invoice_verify.py (8435b), SKILL.md (24655b), _meta.json (139b)\n\nFile v1.0.0-alpha:SKILL.md\n\n---\nname: invoice-verify\ndescription: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n---\n\n# 发票查验技能\n\n使用此技能通过票面信息或上传发票文件查验发票真伪，获取完整票面明细。\n\n## 使用场景\n\n满足以下需求时使用：\n\n- 根据发票号码、开票日期、金额/校验码查验发票真伪。\n- 上传发票文件（pdf/ofd/xml/jpg/png）进行批量查验。\n- 查询查验记录，按日期范围、发票号码、发票类型等条件筛选。\n\n## 触发语句示例\n\n以下用户输入应触发此技能：\n\n- 帮我查验这张发票 / 发票查验 / 查验发票\n- 验证发票真伪 / 发票验真 / 验真\n- 查一下这张发票是不是真的\n- 上传发票文件查验 / 文件查验\n- 这个发票文件帮我验一下\n- 查验发票 26127000000211930033\n- 查看一下查验记录 / 查验记录 / 查验历史\n- 查一下5月份的查验记录\n- 有没有查验失败的发票\n- 查验状态不一致的发票有哪些\n\n## 输入参数\n\n执行前准备以下参数：\n\n- apiKey（必填）：通过 https://test-eqjs.es366.cn/jxplusSkill/ 申请。\n\n### 按票面查验 (inspect)\n\n- 发票号码（必填）\n- 开票日期（必填，格式 YYYY-MM-DD）\n- 金额或校验码（必填，根据发票种类不同传入金额或校验码）\n- 发票代码（可选）\n\n### 按文件查验 (file)\n\n- 发票文件路径（必填，支持 pdf、ofd、xml、jpg、png）\n\n### 查询查验记录 (record)\n\n- 开票日期开始（选填，格式 YYYY-MM-DD）\n- 开票日期结束（选填，格式 YYYY-MM-DD）\n- 发票号码（选填）\n- 发票代码（选填）\n- 发票类型（选填，可多选，传入编码值，详见下方 fplx 枚举）\n- 页码（选填，默认 1）\n- 每页条数（选填，默认 10）\n- 查验时间开始（选填，格式 YYYY-MM-DD）\n- 查验时间结束（选填，格式 YYYY-MM-DD）\n\n#### fplx 发票类型枚举\n\n| 票据大类 | 票据小类 | 编码 |\n| ---------------------- | ---------------------------------- | ---- |\n| 增值税发票管理系统发票 | 增值税专用发票 | 01 |\n| | 货物运输业增值税专用发票 | 02 |\n| | 机动车销售统一发票 | 03 |\n| | 增值税普通发票 | 04 |\n| | 增值税电子专用发票 | 08 |\n| | 增值税电子普通发票 | 10 |\n| | 增值税普通发票（卷票） | 11 |\n| | 二手车销售统一发票 | 15 |\n| | 道路通行费电子普通发票 | 14 |\n| 电子发票服务平台 | 电子发票（增值税专用发票） | 81 |\n| | 电子发票（普通发票） | 82 |\n| | 电子发票（铁路电子客票） | 51 |\n| | 电子发票（航空运输电子客票行程单） | 61 |\n| | 机动车销售电子统一发票 | 73 |\n| | 电子发票（机动车销售统一发票） | 83 |\n| | 二手车销售电子统一发票 | 84 |\n| | 纸质发票（增值税专用发票） | 85 |\n| | 纸质发票（普通发票） | 86 |\n| | 纸质发票（机动车销售统一发票） | 87 |\n| | 纸质发票（二手车销售统一发票） | 88 |\n| | 数电票（通行费发票） | 59 |\n| 地方通用发票 | 浙江通用（电子）发票 | Z1 |\n| | 云南省通用电子发票 | Y1 |\n| | 广东通用机打发票（电子） | G1 |\n| | 北京电子普通发票 | B1 |\n| | 深圳电子普通发票 | S1 |\n| | 通用定额发票 | TY |\n| | 江苏省车辆通行费通用（电子）发票 | J1 |\n| 交通运输发票 | 出租车发票 | CZ |\n| | 汽车票 | QC |\n| | 轮船票 | LC |\n| | 过路过桥费发票 | GL |\n| | 火车票 | HC |\n| | 机票行程单 | JX |\n| 其他发票 | 其他发票 | QT |\n| 财政票据 | 财政票据 | CP |\n| 海关缴款书 | 海关缴款书 | 17 |\n\n## 执行流程\n\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\n\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\n\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\n\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\n\n> 您需要完成以下三步，即可自动配置并执行技能：\n>\n> 1. **注册账号**\n> 访问中兴通简税Skill平台：https://test-eqjs.es366.cn/jxplusSkill/ 完成注册。\n>\n> 2. **申请 apiKey**\n> 登录后进入\"技能中心\"，复制您的 apiKey。\n>\n> 3. **提供 apiKey**\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\n\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\n\n- 禁止读取文件（Excel、PDF、图片等）\n- 禁止调用任何 API\n- 禁止执行任何脚本或命令\n- 禁止进行参数解析或预处理\n\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\n\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\n\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\n\n环境变量就绪后，继续以下步骤：\n\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\n - 缺少发票号码、开票日期或金额/校验码：停止并提示用户提供对应参数。\n - 按文件查验时文件不存在或不支持该文件类型：停止并提示用户。\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\n3. 检查返回的 status 字段，非 200 时停止并将错误信息展示给用户，禁止重试或忽略。\n4. 解析返回结果并以可读格式输出。\n\n## 请求参数说明\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | ------ | ---- | ----------------------------------------------------------- |\n| apiKey | string | 是 | apiKey |\n| invoiceNumber | string | 是 | 发票号码 |\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\n| jejym | string | 是 | 金额或校验码，根据发票种类不同传入，详见下方 jejym 传入规则 |\n| invoiceCode | string | 否 | 发票代码 |\n\n### jejym 传入规则\n\n不同发票类型的 jejym 入参不同：\n\n| 发票类型 | jejym 入参 |\n| ------------------------------ | ------------------ |\n| 增值税专用发票 | 开具金额（不含税） |\n| 机动车销售统一发票 | 不含税价 |\n| 二手车销售统一发票 | 车价合计 |\n| 增值税电子专用发票 | 开具金额（不含税） |\n| 电子发票（增值税专用发票） | 价税合计 |\n| 电子发票（普通发票） | 价税合计 |\n| 增值税普通发票 | 校验码后六位 |\n| 增值税普通发票（卷票） | 校验码后六位 |\n| 增值税电子普通发票 | 校验码后六位 |\n| 道路通行费电子普通发票 | 校验码后六位 |\n| 铁路电子客票 | 价税合计 |\n| 航空运输电子客票行程单 | 价税合计 |\n| 电子发票（机动车销售统一发票） | 价税合计 |\n| 电子发票（通行费发票） | 价税合计 |\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求头：`Content-Type: multipart/form-data`\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------ | ------ | ---- | ------------------------------- |\n| apiKey | string | 是 | apiKey |\n| file | file | 是 | 发票文件（pdf/ofd/xml/jpg/png） |\n\n### 查询查验记录 — POST /api/jxplus/zxtSkill/inspection/queryInspectionRecord\n\n| 参数 | 类型 | 必填 | 说明 |\n| ------------- | -------- | ---- | ------------------------- |\n| apiKey | string | 是 | apiKey |\n| kprqStart | string | 否 | 开票日期开始 (YYYY-MM-DD) |\n| kprqEnd | string | 否 | 开票日期结束 (YYYY-MM-DD) |\n| invoiceNumber | string | 否 | 发票号码 |\n| invoiceCode | string | 否 | 发票代码 |\n| fplxList | string[] | 否 | 发票类型集合 |\n| pageNo | string | 否 | 页码，默认 1 |\n| pageSize | string | 否 | 每页条数，默认 10 |\n| cysjStart | string | 否 | 查验时间开始 (YYYY-MM-DD) |\n| cysjEnd | string | 否 | 查验时间结束 (YYYY-MM-DD) |\n\n## 返回说明\n\n按票面查验和按文件查验共享相同的返回数据结构。按文件查验返回集合，集合内每条记录结构与按票面查验一致。\n\n### 查验记录返回 (record)\n\n返回分页列表，每条记录包含：\n\n| 字段 | 说明 |\n| ------------- | -------------------------------------------------------------------------------------------------------- |\n| invoiceNumber | 发票号码 |\n| invoiceCode | 发票代码 |\n| fplx | 发票类型 |\n| fplxName | 发票类型名称 |\n| kprq | 开票日期 |\n| jshj | 价税合计 |\n| cyzt | 查验状态：0 未查验，1 查验中，2 查验真票，3 查无此票，4 查询不一致，5 查验失败，6 不支持查验，7 抬头不符 |\n| cyztName | 查验状态名称 |\n| cysj | 查验时间 |\n| xsfMc | 销售方名称 |\n\n### 外层返回字段\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | -------------------------------- |\n| status | string | 返回接口状态码 |\n| message | string | 返回接口状态描述信息 |\n| data | object | 业务数据体（按文件查验时为数组） |\n\n### data 业务数据体\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------- | ---------------------------------------------------- |\n| invoiceType | string | 发票种类，详见发票类型说明 |\n| invoiceCode | string | 发票代码 |\n| invoiceNumber | string | 发票号码 |\n| invoiceDate | string | 开票日期 |\n| hjje | decimal | 合计金额 |\n| hjse | decimal | 合计税额 |\n| jshj | decimal | 价税合计 |\n| fpStatus | string | 发票状态：0 正常，2 作废，3 红冲 |\n| xsfMc | string | 销售方名称 |\n| xsfNsrsbh | string | 销售方纳税人识别号 |\n| xsfAddressTel | string | 销售方地址、电话 |\n| xsfBankAccount | string | 销售方开户行及账号 |\n| gmfMc | string | 购买方名称 |\n| gmfNsrsbh | string | 购买方税号 |\n| gmfAddressTel | string | 购买方地址、电话 |\n| gmfBankAccount | string | 购买方开户行及账号 |\n| payee | string | 收款人 |\n| reviewer | string | 复核人 |\n| invoicer | string | 开票人 |\n| machineNo | string | 机器编号 |\n| checkCode | string | 校验码 |\n| passwordArea | string | 密码区 |\n| remark | string | 备注 |\n| xmlFileUrl | string | xml 文件地址 |\n| pdfFileUrl | string | pdf 文件地址 |\n| ofdFileUrl | string | ofd 文件地址 |\n| items | List | 发票明细 |\n| specialDetail | List | 特殊票种明细（铁路电子客票、航空运输电子客票行程单） |\n\n### items 明细数据体\n\n#### 商品详情列表（其他类型发票）\n\n| 字段 | 类型 | 说明 |\n| -------------- | ------ | ------------------------ |\n| projectName | string | 货物或应税劳务、服务名称 |\n| ggxh | string | 规格型号 |\n| projectUnit | string | 单位 |\n| projectCount | string | 数量 |\n| projectPriceEt | string | 单价 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 二手车详情列表（15 二手车发票）\n\n| 字段 | 类型 | 说明 |\n| ------- | ------ | ---------------------------- |\n| cpzh | string | 车牌照号 |\n| djzh | string | 登记证号 |\n| cllx | string | 车辆类型 |\n| cjh | string | 车架号/车辆识别号 |\n| cpxh | string | 厂牌型号 |\n| glsMc | string | 转入地车辆管理所名称 |\n| jyDw | string | 经营、拍卖单位 |\n| jyDz | string | 经营、拍卖单位地址 |\n| jySh | string | 经营、拍卖单位税号 |\n| jyYh | string | 经营、拍卖单位开户银行、账号 |\n| jyDh | string | 经营、拍卖单位电话 |\n| escsc | string | 二手车市场 |\n| escscSh | string | 二手车市场税号 |\n| escscDz | string | 二手车市场地址 |\n| escscYh | string | 二手车市场开户银行、账号 |\n| escscDh | string | 二手车市场电话 |\n\n#### 通行费详情列表（14 道路通行费 & 59 电子发票通行费）\n\n| 字段 | 类型 | 说明 |\n| ----------- | ------ | -------- |\n| projectName | string | 项目名称 |\n| carNumber | string | 车牌号 |\n| type | string | 类型 |\n| beginDate | string | 通行日起 |\n| endDate | string | 通行日止 |\n| projectJeEt | string | 金额 |\n| sl | string | 税率 |\n| se | string | 税额 |\n\n#### 机动车详情列表（03 机动车发票 & 83 电子发票机动车）\n\n| 字段 | 类型 | 说明 |\n| -------- | ------ | --------------------- |\n| hgzh | string | 合格证号 |\n| jkzmsh | string | 进口证明书号 |\n| sjdh | string | 商检单号 |\n| fdjhm | string | 发动机号码 |\n| clsbh | string | 车辆识别代号/车架号码 |\n| zzssl | string | 增值税税率或征收率 |\n| zzsse | string | 增值税税额 |\n| zgswjg | string | 主管税务机关 |\n| zgswjgdm | string | 主管税务机关代码 |\n| bhsj | string | 不含税价 |\n| wspzhm | string | 完税凭证号码 |\n| dw | string | 吨位 |\n| xccr | string | 限乘人数 |\n| dz | string | 地址 |\n| dh | string | 电话 |\n| khyh | string | 开户银行 |\n| zh | string | 账号 |\n\n### specialDetail 特殊票种明细数据体\n\n#### 铁路电子客票详情列表（51 铁路电子客票）\n\n| 字段 | 类型 | 说明 |\n| --------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| departureTime | string | 出发时间 |\n| fare | string | 票价 |\n| promptInformationArea | string | 提示信息 |\n| seat | string | 座位 |\n| travelDate | string | 乘车日期 |\n| passengerIdNumber | string | 身份证号码 |\n| departureStation | string | 出发地 |\n| trainNumber | string | 车次 |\n| destinationStation | string | 目的地 |\n| eticketNumber | string | 电子客票号码 |\n| seatLevel | string | 座位等级 |\n\n#### 航空运输电子客票行程单详情列表（61 航空运输电子客票行程单）\n\n| 字段 | 类型 | 说明 |\n| -------------------------------- | ------ | ------------ |\n| nameOfPassenger | string | 旅客姓名 |\n| issuingStatus | string | 填开状态 |\n| departureStation | string | 出发地 |\n| firstDestinationStation | string | 第一站 |\n| secondDestinationStation | string | 第二站 |\n| thirdDestinationStation | string | 第三站 |\n| fourthDestinationStation | string | 第四站 |\n| totalAmount | string | 合计 |\n| markingOfDomesticOrInternational | string | 国内国际标识 |\n| gpoddnumbers | string | GP 单号 |\n| eticketNumber | string | 电子客票号码 |\n| itineraryDetail | List | 行程明细 |\n\n#### itineraryDetail 行程明细数据体\n\n| 字段 | 类型 | 说明 |\n| ------------- | ------ | ----------------- |\n| departureTime | string | 出发时间 |\n| flight | string | 航班号 |\n| carrier | string | 承运人 |\n| level | string | 座位等级 |\n| carrierDate | string | 承运日期 |\n| fareBasis | string | 客票级别/客票类别 |\n\n## 异常状态码\n\n| 状态码 | 说明 |\n| ------ | ---------------------- |\n| 400 | 请求参数错误 |\n| 300 | 参数为空或格式错误 |\n| 305 | 无权访问该接口 |\n| 307 | 消费失败，授权余次不足 |\n| 308 | 超出接口调用次数 |\n| 500 | 系统异常 |\n\n## 接口请求示例\n\n### 按票面查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionInvoice\n\n请求：\n\n```json\n{\n \"data\": {\n \"apiKey\": \"sk-sg-9EVbsJLJnlKVLaSO4FZtPUVFysbFL\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"jejym\": \"162.43\"\n }\n}\n```\n\n成功返回：\n\n```json\n{\n \"status\": \"200\",\n \"message\": \"成功\",\n \"data\": {\n \"invoiceType\": \"82\",\n \"invoiceCode\": \"\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"hjje\": \"146.33\",\n \"hjse\": \"16.10\",\n \"jshj\": \"162.43\",\n \"fpStatus\": \"0\",\n \"xsfMc\": \"天津象鲜科技有限公司\",\n \"xsfNsrsbh\": \"91120101MADQKPT067\",\n \"xsfAddressTel\": \"天津市和平区南市街道张自忠路与多伦道交口合生国际大厦1号楼1-L7-101 021-52559777\",\n \"xsfBankAccount\": \"招商银行股份有限公司天津滨海分行营业部 122917783510000\",\n \"gmfMc\": \"北京中兴通融资产管理股份有限公司\",\n \"gmfNsrsbh\": \"911101087582285868\",\n \"gmfAddressTel\": \"\",\n \"gmfBankAccount\": \"\",\n \"items\": [\n {\n \"projectName\": \"*水果*水果\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"4\",\n \"projectPriceEt\": \"18.4850000000\",\n \"projectJeEt\": \"73.94\",\n \"sl\": \"0.090\",\n \"se\": \"6.66\"\n },\n {\n \"projectName\": \"*纸制品*纸制品\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"1\",\n \"projectPriceEt\": \"16.7300000000\",\n \"projectJeEt\": \"16.73\",\n \"sl\": \"0.130\",\n \"se\": \"2.17\"\n }\n ]\n }\n}\n```\n\n异常返回：\n\n```json\n{\n \"status\": \"400\",\n \"message\": \"金额/校验码不能为空\",\n \"data\": \"\"\n}\n```\n\n### 按文件查验 — POST /api/jxplus/zxtSkill/inspection/queryInspectionFile\n\n请求方式：`multipart/form-data`，包含 `apiKey` 字段和 `file` 文件字段。\n\n返回值：集合，集合内结构与按票面查验一致。\n\n## 命令示例\n\n按票面查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py inspect --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\" --jejym \"162.43\"\n```\n\n按文件查验：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py file --file \"E:\\\\invoices\\\\test.pdf\"\n```\n\n查询查验记录（按日期范围）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\"\n```\n\n查询查验记录（按发票号码）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --invoice-number \"26127000000211930033\"\n```\n\n查询查验记录（按发票类型筛选，可多选）：\n\n```bash\npython .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\" --fplx 82 81\n```\n\nFile v1.0.0-alpha:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-verify\",\n \"version\": \"1.0.0-alpha\",\n \"publishedAt\": 1779354328611\n}","readmeExcerpt":"Skill: 发票查验 Owner: zxt Summary: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-06-17T07:31:29.525Z | user 主体迁移到@zxt v1.0.0 | 2026-05-25T08:02:23.897Z | user 正式版 v1.0.0-beta | 2026-05-22T01:08:49.129Z | user - 更新了发票查验平台网址为 https://skill.quandianfapiao.com/ - apiKey 申请与注册说明中的平台域名同步为 quandianfapiao.com - 其他文档内容未做变动，功能保持一致 v1.0.0-alpha | 2026-05-21T09:05:28.611Z | user i","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\n \"data\": {\n \"apiKey\": \"sk-sg-9EVbsJLJnlKVLaSO4FZtPUVFysbFL\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"jejym\": \"162.43\"\n }\n}"},{"language":"json","snippet":"{\n \"status\": \"200\",\n \"message\": \"成功\",\n \"data\": {\n \"invoiceType\": \"82\",\n \"invoiceCode\": \"\",\n \"invoiceNumber\": \"26127000000211930033\",\n \"invoiceDate\": \"2026-05-12\",\n \"hjje\": \"146.33\",\n \"hjse\": \"16.10\",\n \"jshj\": \"162.43\",\n \"fpStatus\": \"0\",\n \"xsfMc\": \"天津象鲜科技有限公司\",\n \"xsfNsrsbh\": \"91120101MADQKPT067\",\n \"xsfAddressTel\": \"天津市和平区南市街道张自忠路与多伦道交口合生国际大厦1号楼1-L7-101 021-52559777\",\n \"xsfBankAccount\": \"招商银行股份有限公司天津滨海分行营业部 122917783510000\",\n \"gmfMc\": \"北京中兴通融资产管理股份有限公司\",\n \"gmfNsrsbh\": \"911101087582285868\",\n \"gmfAddressTel\": \"\",\n \"gmfBankAccount\": \"\",\n \"items\": [\n {\n \"projectName\": \"*水果*水果\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"4\",\n \"projectPriceEt\": \"18.4850000000\",\n \"projectJeEt\": \"73.94\",\n \"sl\": \"0.090\",\n \"se\": \"6.66\"\n },\n {\n \"projectName\": \"*纸制品*纸制品\",\n \"ggxh\": \"/\",\n \"projectUnit\": \"件\",\n \"projectCount\": \"1\",\n \"projectPriceEt\": \"16.7300000000\",\n \"projectJeEt\": \"16.73\",\n \"sl\": \"0.130\",\n \"se\": \"2.17\"\n }\n ]\n }\n}"},{"language":"json","snippet":"{\n \"status\": \"400\",\n \"message\": \"金额/校验码不能为空\",\n \"data\": \"\"\n}"},{"language":"bash","snippet":"python .claude/skills/invoice-verify/invoice_verify.py inspect --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\" --jejym \"162.43\""},{"language":"bash","snippet":"python .claude/skills/invoice-verify/invoice_verify.py file --file \"E:\\\\invoices\\\\test.pdf\""},{"language":"bash","snippet":"python .claude/skills/invoice-verify/invoice_verify.py record --kprq-start \"2026-05-01\" --kprq-end \"2026-05-31\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: invoice-verify\ndescription: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n---\n\n# 发票查验技能\n\n使用此技能通过票面信息或上传发票文件查验发票真伪，获取完整票面明细。\n\n## 使用场景\n\n满足以下需求时使用：\n\n- 根据发票号码、开票日期、金额/校验码查验发票真伪。\n- 上传发票文件（pdf/ofd/xml/jpg/png）进行批量查验。\n- 查询查验记录，按日期范围、发票号码、发票类型等条件筛选。\n\n## 触发语句示例\n\n以下用户输入应触发此技能：\n\n- 帮我查验这张发票 / 发票查验 / 查验发票\n- 验证发票真伪 / 发票验真 / 验真\n- 查一下这张发票是不是真的\n- 上传发票文件查验 / 文件查验\n- 这个发票文件帮我验一下\n- 查验发票 26127000000211930033\n- 查看一下查验记录 / 查验记录 / 查验历史\n- 查一下5月份的查验记录\n- 有没有查验失败的发票\n- 查验状态不一致的发票有哪些\n\n## 输入参数\n\n执行前准备以下参数：\n\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\n\n### 按票面查验 (inspect)\n\n- 发票号码（必填）\n- 开票日期（必填，格式 YYYY-MM-DD）\n- 金额或校验码（必填，根据发票种类不同传入金额或校验码）\n- 发票代码（可选）\n\n### 按文件查验 (file)\n\n- 发票文件路径（必填，支持 pdf、ofd、xml、jpg、png）\n\n### 查询查验记录 (record)\n\n- 开票日期开始（选填，格式 YYYY-MM-DD）\n- 开票日期结束（选填，格式 YYYY-MM-DD）\n- 发票号码（选填）\n- 发票代码（选填）\n- 发票类型（选填，可多选，传入编码值，详见下方 fplx 枚举）\n- 页码（选填，默认 1）\n- 每页条数（选填，默认 10）\n- 查验时间开始（选填，格式 YYYY-MM-DD）\n- 查验时间结束（选填，格式 YYYY-MM-DD）\n\n#### fplx 发票类型枚举\n\n| 票据大类 | 票据小类 | 编码 |\n| ---------------------- | ---------------------------------- | ---- |\n| 增值税发票管理系统发票 | 增值税专用发票 | 01 |\n| | 货物运输业增值税专用发票 | 02 |\n| | 机动车销售统一发票 | 03 |\n| | 增值税普通发票 | 04 |\n| | 增值税电子专用发票 | 08 |\n| | 增值税电子普通发票 | 10 |\n| | 增值税普通发票（卷票） | 11 |\n| | 二手车销售统一发票 | 15 |\n| | 道路通行费电子普通发票 | 14 |\n| 电子发票服务平台 | 电子发票（增值税专用发票） | 81 |\n| | 电子发票（普通发票） | 82 |\n| | 电子发票（铁路电子客票） | 51 |\n| | 电子发票（航空运输电子客票行程单） | 61 |\n| | 机动车销售电子统一发票 | 73 |\n| | 电子发票（机动车销售统一发票） | 83 |\n| | 二手车销售电子统一发票 | 84 |\n| | 纸质发票（增值税专用发票） | 85 |\n| | 纸质发票（普通发票） | 86 |\n| | 纸质发票（机动车销售统一发票） | 87 |\n| | 纸质发票（二手车销售统一发票） | 88 |\n| | 数电票（通行费发票） | 59 |\n| 地方通用发票 | 浙江通用（电子）发票 | Z1 |\n| | 云南省通用电子发票 | Y1 |\n| | 广东通用机打发票（电子） | G1 |\n| | 北京电子普通发票 | B1 |\n| | 深圳电子普通发票 | S1 |\n| | 通用定额发票 | TY |\n| | 江苏省车辆通行费通用（电子）发票 | J1 |\n| 交通运输发票 | 出租车发票 | CZ |\n| | 汽车票 | QC |\n| | 轮船票 | LC |\n| | 过路过桥费发票 | GL |\n| "},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-verify\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1781681489525\n}"},{"path":"skill-card.md","content":"## Description:\n\n发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[zxt](https://clawhub.ai/user/zxt)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and business operators use this skill to verify invoice authenticity from invoice fields or uploaded invoice files, retrieve complete invoice details, and query prior verification records.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Invoice files and invoice metadata may contain sensitive business, tax, or personal information and are sent to skill.quandianfapiao.com for verification.\n\nMitigation: Install and use the skill only after confirming that this external service is acceptable for the data being checked, and avoid submitting invoices that exceed the user's data-sharing policy.\n\nRisk: The skill asks users to provide an API key in chat and includes instructions that may persist the key in plaintext shell startup files.\n\nMitigation: Use a temporary environment variable, a secret manager, or a restricted throwaway key instead of pasting production credentials into chat or storing them permanently; rotate any key that may have been exposed.\n\nRisk: Invoice authenticity and record outputs depend on responses from the remote service and the user's account authorization.\n\nMitigation: Review non-200 status messages before acting on results, and confirm important tax or compliance decisions against authoritative records.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/zxt/skills/invoice-verify)\n- [中兴通简税Skill平台](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Human-readable invoice verification results, record summaries, status messages, and command examples.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include invoice metadata returned by the external service; file verification supports pdf, ofd, xml, jpg, and png files up to 10MB.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Skill: 发票查验 Owner: zxt Summary: 发票查验技能。按票面信息或上传文件查验发票真伪，返回完整票面信息。适用于验证发票真实性的场景。 Tags: latest:1.0.1 Version history: v1.0.1 | 2026-06-17T07:31:29.525Z | user 主体迁移到@zxt v1.0.0 | 2026-05-25T08:02:23.897Z | user 正式版 v1.0.0-beta | 2026-05-22T01:08:49.129Z | user - 更新了发票查验平台网址为 https://skill.quandianfapiao.com/ - apiKey 申请与注册说明中的平台域名同步为 quandianfapiao.com - 其他文档内容未做变动，功能保持一致 v1.0.0-alpha | 2026-05-21T09:05:28.611Z | user i","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":730,"uniquenessScore":64,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T13:27:17.620Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T13:27:17.620Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T16:01:10.083Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}