{"id":"253da334-a3f5-450a-b00c-58e40d5fcfa4","entityType":"agent","slug":"clawhub-zxt-invoice-cert","name":"发票认证","canonicalUrl":"https://www.xpersona.co/agent/clawhub-zxt-invoice-cert","canonicalPath":"/agent/clawhub-zxt-invoice-cert","generatedAt":"2026-10-11T07:37:46.331Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T04:37:33.320Z","emptyReason":null},"description":"发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。 Skill: 发票认证 Owner: zxt Summary: 发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-09-24T01:09:24.040Z | user - 支持税局扫码登录替换原账号密码/验证码登录，提升安全性，并优化交互流程。 - 新增“查询当前登录企业”功能，可显示当前操作企业名称及税号；所有业务操作成功后自动标注企业信息。 - 登录失效（status=309）时自动引导微信扫码，并将二维码图片优先直观展示给用户。 - 精简参数输入，删除原短信验证码/地区选择等流程，降低用户操作复杂度。 - 移除 skill-card.md 文档，无功能影响。 v1.0.1 | 2026-06-17T07:37:21.393Z | user 主体迁移 v1.0.0","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s176y1zx801xf9nrys54e3xztd88t1jf:invoice-cert","sourceUrl":"https://clawhub.ai/zxt/invoice-cert","homepage":"https://clawhub.ai/zxt/skills/invoice-cert","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/zxt/invoice-cert","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/zxt/skills/invoice-cert","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。 Skill: 发票认证 Owner: zxt Summary: 发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。 Tags: latest:1"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:37:33.320Z","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-11T04:37:33.320Z","emptyReason":null},"stars":null,"forks":null,"downloads":1157,"packageName":null,"latestVersion":"1.0.2","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T04:37:33.255Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T04:37:33.320Z","lastCrawledAt":"2026-10-11T04:37:33.255Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T04:37:33.255Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.2","createdAt":"2026-09-24T01:09:24.040Z","changelog":"- 支持税局扫码登录替换原账号密码/验证码登录，提升安全性，并优化交互流程。 - 新增“查询当前登录企业”功能，可显示当前操作企业名称及税号；所有业务操作成功后自动标注企业信息。 - 登录失效（status=309）时自动引导微信扫码，并将二维码图片优先直观展示给用户。 - 精简参数输入，删除原短信验证码/地区选择等流程，降低用户操作复杂度。 - 移除 skill-card.md 文档，无功能影响。","fileCount":5,"zipByteSize":15016},{"version":"1.0.1","createdAt":"2026-06-17T07:37:21.393Z","changelog":"主体迁移","fileCount":5,"zipByteSize":11846},{"version":"1.0.0","createdAt":"2026-05-25T08:04:22.480Z","changelog":"正式版","fileCount":5,"zipByteSize":11807},{"version":"1.0.0-beta","createdAt":"2026-05-22T01:07:52.523Z","changelog":"- 更新 apiKey 申请与平台说明，apiKey 申请地址由 https://test-eqjs.es366.cn/jxplusSkill/ 更换为 https://skill.quandianfapiao.com/ - 相关文档、提示和操作流程中的平台域名规范至新的 skill.quandianfapiao.com 域名 - 其他内容和参数、流程未发生变动","fileCount":4,"zipByteSize":10563},{"version":"1.0.0-alpha","createdAt":"2026-05-21T09:12:11.924Z","changelog":"- 初始发布：支持按票面信息或上传发票文件查验发票真伪。 - 提供发票查验、批量查验、查验记录查询等功能。 - 严格的环境变量（ZXT_API_KEY）检查与配置指引，确保安全、合规使用。 - 执行流程透明，参数校验和错误处理明确。 - 支持多种发票类型，查询和查验功能覆盖广泛的应用场景。","fileCount":4,"zipByteSize":10566}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s176y1zx801xf9nrys54e3xztd88t1jf:invoice-cert","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-cert/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/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-11T07:37:46.330Z"}},"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-cert/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-zxt-invoice-cert/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-11T04:37:33.320Z","emptyReason":null},"readme":"Skill: 发票认证\n\nOwner: zxt\n\nSummary: 发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\n\nTags: latest:1.0.2\n\nVersion history:\n\nv1.0.2 | 2026-09-24T01:09:24.040Z | user\n\n- 支持税局扫码登录替换原账号密码/验证码登录，提升安全性，并优化交互流程。\n- 新增“查询当前登录企业”功能，可显示当前操作企业名称及税号；所有业务操作成功后自动标注企业信息。\n- 登录失效（status=309）时自动引导微信扫码，并将二维码图片优先直观展示给用户。\n- 精简参数输入，删除原短信验证码/地区选择等流程，降低用户操作复杂度。\n- 移除 skill-card.md 文档，无功能影响。\n\nv1.0.1 | 2026-06-17T07:37:21.393Z | user\n\n主体迁移\n\nv1.0.0 | 2026-05-25T08:04:22.480Z | user\n\n正式版\n\nv1.0.0-beta | 2026-05-22T01:07:52.523Z | user\n\n- 更新 apiKey 申请与平台说明，apiKey 申请地址由 https://test-eqjs.es366.cn/jxplusSkill/ 更换为 https://skill.quandianfapiao.com/\n- 相关文档、提示和操作流程中的平台域名规范至新的 skill.quandianfapiao.com 域名\n- 其他内容和参数、流程未发生变动\n\nv1.0.0-alpha | 2026-05-21T09:12:11.924Z | user\n\n- 初始发布：支持按票面信息或上传发票文件查验发票真伪。\n- 提供发票查验、批量查验、查验记录查询等功能。\n- 严格的环境变量（ZXT_API_KEY）检查与配置指引，确保安全、合规使用。\n- 执行流程透明，参数校验和错误处理明确。\n- 支持多种发票类型，查询和查验功能覆盖广泛的应用场景。\n\nArchive index:\n\nArchive v1.0.2: 5 files, 15016 bytes\n\nFiles: common.py (4807b), invoice_cert.py (18837b), skill-card.md (2265b), SKILL.md (16716b), _meta.json (131b)\n\nFile v1.0.2:SKILL.md\n\n---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局扫码登录、登录企业查询、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 扫码登录税局系统（电子税务局）。\r\n- 查询当前登录的企业信息（企业名称、纳税人识别号）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 扫码登录 / 登录电子税务局\r\n- 现在登录的是哪个企业 / 查询企业信息 / 当前企业\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\r\n\r\n### 扫码登录 (login-qr)\r\n\r\n无额外参数。获取税局登录二维码并在终端展示，用户使用微信扫码（或在浏览器中打开链接）完成登录。\r\n\r\n### 查询当前登录企业 (org-info)\r\n\r\n无额外参数。返回当前 apiKey 对应的企业名称与纳税人识别号。\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\r\n\r\n> 您需要完成以下三步，即可自动配置并执行技能：\r\n>\r\n> 1. **注册账号**\r\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\r\n>\r\n> 2. **申请 apiKey**\r\n> 登录后进入\"技能中心\"，复制您的 apiKey。\r\n>\r\n> 3. **提供 apiKey**\r\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\r\n\r\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\r\n\r\n- 禁止读取文件（Excel、PDF、图片等）\r\n- 禁止调用任何 API\r\n- 禁止执行任何脚本或命令\r\n- 禁止进行参数解析或预处理\r\n\r\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\r\n\r\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\r\n\r\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n\r\n环境变量就绪后，继续以下步骤：\r\n\r\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\r\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\r\n3. 检查返回的 status 字段：\r\n - 非 200 且非 309 时，停止并将错误信息展示给用户。\r\n - **status 为 309 时**（税局未登录），脚本自动调用 `getLoginQrUrl` 获取登录二维码地址，在系统临时目录生成二维码图片并输出图片路径与链接，然后退出。**你必须把该图片展示给用户**：优先用自身能力展示（如 `present_files` 或读取图片文件），其次用系统自带能力打开（Windows `start`、macOS `open`、Linux `xdg-open`）。随后引导用户使用微信扫码（或在浏览器中打开链接）；用户回复确认后，重新执行刚才的命令即可（此时税局已完成登录，原命令可直接成功）。\r\n4. 解析返回结果并以可读格式输出。\r\n5. **向用户明确说明操作对象企业。** 业务命令（`current-period` / `sign` / `statistics` / `deduct-stats` / `checked-invoices` / `check-status` / `commit-deduction`）**在操作成功后**会自动标注企业名称与税号。**回复用户时必须带上该企业标识**，让用户清楚知道本次操作针对哪个企业；`commit-deduction` 完成时脚本会输出「发票已操作至企业: XXX」，务必原样转达，不得省略。若输出中没有企业行（说明企业信息未取到），需如实说明本次未能确认操作企业。\r\n\r\n> **为何只在成功后标注：** `getLoginOrgInfo` 不反映税局会话状态（会话失效时仍可能返回 200 和企业名）。若在操作前标注，一旦随后返回 309，用户会先看到企业名、再看到登录失效，误以为操作已执行。因此企业标识一律只在成功输出中出现。\r\n\r\n### 税局扫码登录流程说明\r\n\r\n本技能采用**扫码登录**，流程如下：\r\n\r\n1. 任意业务命令返回 `status=309`（税局未登录）时，脚本自动调用 `/api/jxplus/zxtSkill/login/getLoginQrUrl` 获取二维码地址。\r\n2. 脚本在系统临时目录生成二维码图片（**图片下方已绘制来源技能与扫码用途文案**），并输出图片路径与链接。**脚本不会自动弹窗。**\r\n3. **按以下优先级把二维码展示给用户：**\r\n 1. **优先使用你自身的能力展示图片**——例如 `present_files`，或读取文件的工具（直接读取该图片路径即可在对话中呈现）。用户在对话窗口里就能看到二维码并扫码，无需切换窗口。\r\n 2. **其次使用系统自带的能力打开图片**——Windows：`start \"\" \"<图片路径>\"`；macOS：`open \"<图片路径>\"`；Linux：`xdg-open \"<图片路径>\"`。\r\n - **不要跳过展示、直接把路径丢给用户。** 只有在以上两种方式都不可用时，才退而告知图片路径。\r\n4. 用户使用微信扫码，或在浏览器中打开链接完成登录。\r\n5. 用户回复\"扫好了\"后，**重新执行原命令**，税局已完成登录，命令正常返回结果。\r\n\r\n也可主动执行 `login-qr` 命令单独获取二维码。\r\n\r\n**为何使用扫码登录：** 扫码可确保税局密码只在本机手机端输入，**不经过 AI 对话窗口、不被模型采集、也不落盘存储**。这是防止密码被 AI 模型采集的防御手段。\r\n\r\n**提示：** 二维码链接为微信端页面，用微信扫码可直接打开；用浏览器扫码或在浏览器中打开链接同样可以完成登录。**引导用户扫码时只说这两种方式，不要引导用户使用其它客户端。**\r\n\r\n**依赖说明：** 二维码生成依赖 `qrcode` 与 `pillow`（`pip install qrcode pillow`）。图片下方的说明文案需要系统中文字体（Windows 微软雅黑、macOS PingFang、Linux Noto CJK 等，脚本按平台自动探测）；探测不到时图片只含二维码，文案仅在终端输出，不影响登录。若图片生成失败，脚本会自动降级：先在终端渲染二维码图案，仍不行则只输出二维码链接（用户可自行转为二维码后扫描）。\r\n\r\n## 请求参数说明\r\n\r\n### 1. 获取税局登录二维码 — POST /api/jxplus/zxtSkill/login/getLoginQrUrl\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 `data.qrUrl` 为税局登录二维码地址。\r\n\r\n### 2. 查询当前登录企业 — POST /api/jxplus/zxtSkill/dzsj/getLoginOrgInfo\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 `data.orgName` 为企业名称，`data.nsrsbh` 为纳税人识别号。\r\n\r\n> **重要限制：** 该接口返回的是 apiKey 在平台上绑定的企业，**不反映税局会话是否有效**。实测税局会话失效（其它接口返回 309）时，本接口仍会返回 200 和企业名称。因此它**只能用于标注操作对象，不能用于判断登录状态**——登录状态一律以业务接口的 309 为准。\r\n\r\n### 3. 确认签名 — POST /api/jxplus/zxtSkill/check/doSignature\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n### 4. 查询当前税款所属期 — POST /api/jxplus/zxtSkill/check/getCurrSkssq\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 data 为税款所属期字符串，如 `\"2026-05\"`。\r\n\r\n### 5. 申请或撤销统计 — POST /api/jxplus/zxtSkill/check/commitStatistics\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 申请统计，2 撤销统计 |\r\n| bz | string | 是 | N 忽略未勾选发票直接统计，Y 取消未完成的统计状态 |\r\n\r\n### 6. 查询抵扣统计数据 — POST /api/jxplus/zxtSkill/check/getDeductStatistList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ---------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 7. 查询当前属期认证发票集合 — POST /api/jxplus/zxtSkill/check/getCheckedInvoiceList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | -------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 8. 查询发票认证状态 — POST /api/jxplus/zxtSkill/check/getInvoiceCheckStatus\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------------- | ------ | ---- | ---------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| invoiceNumber | string | 是 | 发票号码 |\r\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\r\n| invoiceCode | string | 否 | 发票代码 |\r\n\r\n### 9. 提交或取消认证 — POST /api/jxplus/zxtSkill/check/commitDeduction\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 勾选认证，2 取消勾选认证 |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n| list | array | 是 | 发票列表，每条含 invoiceCode、kprq、invoiceNumber |\r\n\r\n## 返回说明\r\n\r\n### 登录企业返回 (org-info)\r\n\r\n| 字段 | 说明 |\r\n| ------- | -------------- |\r\n| orgName | 企业名称 |\r\n| nsrsbh | 纳税人识别号 |\r\n\r\n### 认证发票返回 (checked-invoices)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ------------ |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| qdfphm | 全电发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| jshj | 价税合计 |\r\n| fplx | 发票类型 |\r\n| fplxName | 发票类型名称 |\r\n| xsfNsrsbh | 销售方税号 |\r\n| xsfMc | 销售方名称 |\r\n\r\n### 认证状态返回 (check-status)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ---------------------------- |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| gxzt | 勾选状态：0 未勾选，1 已勾选 |\r\n| skssq | 认证属期 |\r\n\r\n### 提交认证返回 (commit-deduction)\r\n\r\n| 字段 | 说明 |\r\n| ------------ | -------------- |\r\n| successCount | 成功数量 |\r\n| failCount | 失败数量 |\r\n| successList | 成功集合 |\r\n| failLIst | 失败集合 |\r\n| skssq | 当前税款所属期 |\r\n\r\n## 异常状态码\r\n\r\n| 状态码 | 说明 |\r\n| ------ | ----------------------------------- |\r\n| 400 | 请求参数错误 |\r\n| 300 | 参数为空或格式错误 |\r\n| 305 | 无权访问该接口 |\r\n| 307 | 消费失败，授权余次不足 |\r\n| 308 | 超出接口调用次数 |\r\n| 309 | 税局未登录，脚本自动展示扫码登录二维码 |\r\n| 500 | 系统异常 |\r\n\r\n## 命令示例\r\n\r\n获取税局扫码登录二维码：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login-qr\r\n```\r\n\r\n查询当前登录企业：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py org-info\r\n```\r\n\r\n确认签名：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py sign\r\n```\r\n\r\n查询当前税款所属期：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py current-period\r\n```\r\n\r\n查询发票认证状态：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py check-status --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\"\r\n```\r\n\r\n查询当前属期认证发票：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices\r\n```\r\n\r\n查询指定属期认证发票（历史记录）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices --skssq \"202604\"\r\n```\r\n\r\n提交勾选认证（单张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-12,26127000000211930033\"\r\n```\r\n\r\n提交勾选认证（多张，自动按开票日期排序，每批最多 50 张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-10,26127000000211930033\" \"011002000311,2026-05-12,26127000000211930034\" \"011002000311,2026-05-08,26127000000211930035\"\r\n```\r\n\r\n申请统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py statistics --commit-type \"1\" --bz \"N\"\r\n```\r\n\r\n查询抵扣统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py deduct-stats\r\n```\n\nFile v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1790212164040\n}\n\nFile v1.0.2: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 tax and finance users use this skill to log in to the electronic tax bureau, inspect enterprise and invoice certification status, submit or cancel invoice certification, and manage deduction statistics.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks for a tax API key and may persist it in shell settings.\n\nMitigation: Configure the API key outside chat when possible and confirm who can read any persistent shell-profile storage.\n\nRisk: The skill can perform sensitive tax actions such as certification changes and deduction statistics operations.\n\nMitigation: Confirm the target enterprise, tax period, invoice list, and requested action before running state-changing commands.\n\nRisk: The security verdict recommends review before installation because the provider receives enterprise tax data and API-key authority.\n\nMitigation: Install only when the provider is trusted with the relevant enterprise tax data and API access.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/zxt/skills/invoice-cert)\n- [中兴通简税 Skill platform](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, API Calls, Markdown, Configuration, Guidance]\n\n**Output Format:** [Human-readable text and JSON-formatted command output, with QR-code image paths or links when login is required]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May perform state-changing tax actions after API-key configuration; successful business operations should identify the target enterprise.]\n\n## Skill Version(s):\n\n1.0.2 (source: server release metadata)\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.1: 5 files, 11846 bytes\n\nFiles: common.py (4673b), invoice_cert.py (15927b), skill-card.md (2095b), SKILL.md (14299b), _meta.json (131b)\n\nFile v1.0.1:SKILL.md\n\n---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局登录、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局登录、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 登录税局系统（电子税务局）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 登录电子税务局\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\r\n\r\n### 税局登录 (login)\r\n\r\n- 税号（必填）\r\n- 账号（选填，登录时可能需要）\r\n- 密码（选填，登录时可能需要）\r\n- 地区码（选填，如 BJ、TJ）\r\n\r\n### 验证码登录 (login-sms)\r\n\r\n- 验证码（必填）\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 发送验证码 (send-sms)\r\n\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\r\n\r\n> 您需要完成以下三步，即可自动配置并执行技能：\r\n>\r\n> 1. **注册账号**\r\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\r\n>\r\n> 2. **申请 apiKey**\r\n> 登录后进入\"技能中心\"，复制您的 apiKey。\r\n>\r\n> 3. **提供 apiKey**\r\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\r\n\r\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\r\n\r\n- 禁止读取文件（Excel、PDF、图片等）\r\n- 禁止调用任何 API\r\n- 禁止执行任何脚本或命令\r\n- 禁止进行参数解析或预处理\r\n\r\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\r\n\r\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\r\n\r\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n\r\n环境变量就绪后，继续以下步骤：\r\n\r\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\r\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\r\n3. 检查返回的 status 字段：\r\n - 非 200 且非 309 时，停止并将错误信息展示给用户。\r\n - **status 为 309 时**，脚本自动使用会话缓存中的登录凭证（creditCode、account、password）重新登录税局，登录成功后自动重试原请求。若缓存不存在或自动重登失败，则提示用户手动登录。\r\n4. 解析返回结果并以可读格式输出。\r\n\r\n### 税局登录流程说明\r\n\r\n调用登录接口后，根据 `returnType` 分支处理：\r\n\r\n- **returnType=4000**：直接登录成功，可继续调用其他接口。\r\n- **returnType=4001**：需要验证码登录，会返回带星手机号。引导用户发送验证码（`send-sms`）→ 输入验证码完成登录（`login-sms`）。\r\n- **returnType=4002**：需要设置地区，会返回可选地区列表。引导用户选择地区码后使用 `--area-code` 参数重新登录。\r\n\r\n## 请求参数说明\r\n\r\n### 1. 税局登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLogin\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | -------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 税号（纳税人识别号） |\r\n| account | string | 否 | 税局账号 |\r\n| password | string | 否 | 税局密码 |\r\n| areaCode | string | 否 | 地区码（如 BJ、TJ） |\r\n\r\n### 2. 验证码登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLoginBySmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n| smsCode | string | 是 | 短信验证码 |\r\n\r\n### 3. 发送验证码 — POST /api/jxplus/zxtSkill/dzsj/dzsjSendSmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n\r\n### 4. 确认签名 — POST /api/jxplus/zxtSkill/check/doSignature\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n### 5. 查询当前税款所属期 — POST /api/jxplus/zxtSkill/check/getCurrSkssq\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 data 为税款所属期字符串，如 `\"2026-05\"`。\r\n\r\n### 6. 申请或撤销统计 — POST /api/jxplus/zxtSkill/check/commitStatistics\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 申请统计，2 撤销统计 |\r\n| bz | string | 是 | N 忽略未勾选发票直接统计，Y 取消未完成的统计状态 |\r\n\r\n### 7. 查询抵扣统计数据 — POST /api/jxplus/zxtSkill/check/getDeductStatistList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ---------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 8. 查询当前属期认证发票集合 — POST /api/jxplus/zxtSkill/check/getCheckedInvoiceList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | -------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 9. 查询发票认证状态 — POST /api/jxplus/zxtSkill/check/getInvoiceCheckStatus\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------------- | ------ | ---- | ---------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| invoiceNumber | string | 是 | 发票号码 |\r\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\r\n| invoiceCode | string | 否 | 发票代码 |\r\n\r\n### 10. 提交或取消认证 — POST /api/jxplus/zxtSkill/check/commitDeduction\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 勾选认证，2 取消勾选认证 |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n| list | array | 是 | 发票列表，每条含 invoiceCode、kprq、invoiceNumber |\r\n\r\n## 返回说明\r\n\r\n### 登录返回 (login)\r\n\r\n| 字段 | 类型 | 说明 |\r\n| ----------- | ------ | --------------------------------------------------------- |\r\n| returnType | string | 4000 直接登录成功，4001 需验证码，4002 需设置地区 |\r\n| loginMobile | string | 带\\*手机号（returnType=4001 时返回） |\r\n| areaList | array | 地区列表（returnType=4002 时返回），含 areaCode、areaName |\r\n\r\n### 认证发票返回 (checked-invoices)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ------------ |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| qdfphm | 全电发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| jshj | 价税合计 |\r\n| fplx | 发票类型 |\r\n| fplxName | 发票类型名称 |\r\n| xsfNsrsbh | 销售方税号 |\r\n| xsfMc | 销售方名称 |\r\n\r\n### 认证状态返回 (check-status)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ---------------------------- |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| gxzt | 勾选状态：0 未勾选，1 已勾选 |\r\n| skssq | 认证属期 |\r\n\r\n### 提交认证返回 (commit-deduction)\r\n\r\n| 字段 | 说明 |\r\n| ------------ | -------------- |\r\n| successCount | 成功数量 |\r\n| failCount | 失败数量 |\r\n| successList | 成功集合 |\r\n| failLIst | 失败集合 |\r\n| skssq | 当前税款所属期 |\r\n\r\n## 异常状态码\r\n\r\n| 状态码 | 说明 |\r\n| ------ | ------------------------ |\r\n| 400 | 请求参数错误 |\r\n| 300 | 参数为空或格式错误 |\r\n| 305 | 无权访问该接口 |\r\n| 307 | 消费失败，授权余次不足 |\r\n| 308 | 超出接口调用次数 |\r\n| 309 | 税局未登录，需先登录税局 |\r\n| 500 | 系统异常 |\r\n\r\n## 命令示例\r\n\r\n税局登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login --credit-code \"911101087582285868\" --account \"account\" --password \"password\"\r\n```\r\n\r\n发送验证码：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py send-sms --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n验证码登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login-sms --sms-code \"123456\" --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n确认签名：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py sign\r\n```\r\n\r\n查询当前税款所属期：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py current-period\r\n```\r\n\r\n查询发票认证状态：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py check-status --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\"\r\n```\r\n\r\n查询当前属期认证发票：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices\r\n```\r\n\r\n查询指定属期认证发票（历史记录）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices --skssq \"202604\"\r\n```\r\n\r\n提交勾选认证（单张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-12,26127000000211930033\"\r\n```\r\n\r\n提交勾选认证（多张，自动按开票日期排序，每批最多 50 张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-10,26127000000211930033\" \"011002000311,2026-05-12,26127000000211930034\" \"011002000311,2026-05-08,26127000000211930035\"\r\n```\r\n\r\n申请统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py statistics --commit-type \"1\" --bz \"N\"\r\n```\r\n\r\n查询抵扣统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py deduct-stats\r\n```\n\nFile v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1781681841393\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\nTax and finance operators use this skill to log in to the electronic tax bureau, check invoice certification status, submit or cancel input-invoice certification, request or revoke deduction statistics, and review certified invoice records.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive tax credentials and API keys may be stored or reused locally in plaintext.\n\nMitigation: Set secrets locally instead of sharing them through chat, delete any .session file after use, and avoid production tax accounts until credential storage is improved.\n\nRisk: The skill can perform high-impact tax actions such as invoice certification, cancellation, statistics submission, revocation, and signature confirmation.\n\nMitigation: Require explicit user confirmation for each tax action and review target invoices, tax periods, and requested operation before execution.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/zxt/skills/invoice-cert)\n- [中兴通简税Skill平台](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and terminal text with command examples and JSON-formatted API results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May execute remote tax-service API calls and print invoice, certification, login, signature, and deduction-statistics results.]\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, 11807 bytes\n\nFiles: common.py (4673b), invoice_cert.py (15927b), skill-card.md (2278b), SKILL.md (14299b), _meta.json (131b)\n\nFile v1.0.0:SKILL.md\n\n---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局登录、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局登录、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 登录税局系统（电子税务局）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 登录电子税务局\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\r\n\r\n### 税局登录 (login)\r\n\r\n- 税号（必填）\r\n- 账号（选填，登录时可能需要）\r\n- 密码（选填，登录时可能需要）\r\n- 地区码（选填，如 BJ、TJ）\r\n\r\n### 验证码登录 (login-sms)\r\n\r\n- 验证码（必填）\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 发送验证码 (send-sms)\r\n\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\r\n\r\n> 您需要完成以下三步，即可自动配置并执行技能：\r\n>\r\n> 1. **注册账号**\r\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\r\n>\r\n> 2. **申请 apiKey**\r\n> 登录后进入\"技能中心\"，复制您的 apiKey。\r\n>\r\n> 3. **提供 apiKey**\r\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\r\n\r\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\r\n\r\n- 禁止读取文件（Excel、PDF、图片等）\r\n- 禁止调用任何 API\r\n- 禁止执行任何脚本或命令\r\n- 禁止进行参数解析或预处理\r\n\r\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\r\n\r\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\r\n\r\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n\r\n环境变量就绪后，继续以下步骤：\r\n\r\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\r\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\r\n3. 检查返回的 status 字段：\r\n - 非 200 且非 309 时，停止并将错误信息展示给用户。\r\n - **status 为 309 时**，脚本自动使用会话缓存中的登录凭证（creditCode、account、password）重新登录税局，登录成功后自动重试原请求。若缓存不存在或自动重登失败，则提示用户手动登录。\r\n4. 解析返回结果并以可读格式输出。\r\n\r\n### 税局登录流程说明\r\n\r\n调用登录接口后，根据 `returnType` 分支处理：\r\n\r\n- **returnType=4000**：直接登录成功，可继续调用其他接口。\r\n- **returnType=4001**：需要验证码登录，会返回带星手机号。引导用户发送验证码（`send-sms`）→ 输入验证码完成登录（`login-sms`）。\r\n- **returnType=4002**：需要设置地区，会返回可选地区列表。引导用户选择地区码后使用 `--area-code` 参数重新登录。\r\n\r\n## 请求参数说明\r\n\r\n### 1. 税局登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLogin\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | -------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 税号（纳税人识别号） |\r\n| account | string | 否 | 税局账号 |\r\n| password | string | 否 | 税局密码 |\r\n| areaCode | string | 否 | 地区码（如 BJ、TJ） |\r\n\r\n### 2. 验证码登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLoginBySmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n| smsCode | string | 是 | 短信验证码 |\r\n\r\n### 3. 发送验证码 — POST /api/jxplus/zxtSkill/dzsj/dzsjSendSmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n\r\n### 4. 确认签名 — POST /api/jxplus/zxtSkill/check/doSignature\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n### 5. 查询当前税款所属期 — POST /api/jxplus/zxtSkill/check/getCurrSkssq\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 data 为税款所属期字符串，如 `\"2026-05\"`。\r\n\r\n### 6. 申请或撤销统计 — POST /api/jxplus/zxtSkill/check/commitStatistics\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 申请统计，2 撤销统计 |\r\n| bz | string | 是 | N 忽略未勾选发票直接统计，Y 取消未完成的统计状态 |\r\n\r\n### 7. 查询抵扣统计数据 — POST /api/jxplus/zxtSkill/check/getDeductStatistList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ---------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 8. 查询当前属期认证发票集合 — POST /api/jxplus/zxtSkill/check/getCheckedInvoiceList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | -------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 9. 查询发票认证状态 — POST /api/jxplus/zxtSkill/check/getInvoiceCheckStatus\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------------- | ------ | ---- | ---------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| invoiceNumber | string | 是 | 发票号码 |\r\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\r\n| invoiceCode | string | 否 | 发票代码 |\r\n\r\n### 10. 提交或取消认证 — POST /api/jxplus/zxtSkill/check/commitDeduction\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 勾选认证，2 取消勾选认证 |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n| list | array | 是 | 发票列表，每条含 invoiceCode、kprq、invoiceNumber |\r\n\r\n## 返回说明\r\n\r\n### 登录返回 (login)\r\n\r\n| 字段 | 类型 | 说明 |\r\n| ----------- | ------ | --------------------------------------------------------- |\r\n| returnType | string | 4000 直接登录成功，4001 需验证码，4002 需设置地区 |\r\n| loginMobile | string | 带\\*手机号（returnType=4001 时返回） |\r\n| areaList | array | 地区列表（returnType=4002 时返回），含 areaCode、areaName |\r\n\r\n### 认证发票返回 (checked-invoices)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ------------ |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| qdfphm | 全电发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| jshj | 价税合计 |\r\n| fplx | 发票类型 |\r\n| fplxName | 发票类型名称 |\r\n| xsfNsrsbh | 销售方税号 |\r\n| xsfMc | 销售方名称 |\r\n\r\n### 认证状态返回 (check-status)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ---------------------------- |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| gxzt | 勾选状态：0 未勾选，1 已勾选 |\r\n| skssq | 认证属期 |\r\n\r\n### 提交认证返回 (commit-deduction)\r\n\r\n| 字段 | 说明 |\r\n| ------------ | -------------- |\r\n| successCount | 成功数量 |\r\n| failCount | 失败数量 |\r\n| successList | 成功集合 |\r\n| failLIst | 失败集合 |\r\n| skssq | 当前税款所属期 |\r\n\r\n## 异常状态码\r\n\r\n| 状态码 | 说明 |\r\n| ------ | ------------------------ |\r\n| 400 | 请求参数错误 |\r\n| 300 | 参数为空或格式错误 |\r\n| 305 | 无权访问该接口 |\r\n| 307 | 消费失败，授权余次不足 |\r\n| 308 | 超出接口调用次数 |\r\n| 309 | 税局未登录，需先登录税局 |\r\n| 500 | 系统异常 |\r\n\r\n## 命令示例\r\n\r\n税局登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login --credit-code \"911101087582285868\" --account \"account\" --password \"password\"\r\n```\r\n\r\n发送验证码：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py send-sms --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n验证码登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login-sms --sms-code \"123456\" --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n确认签名：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py sign\r\n```\r\n\r\n查询当前税款所属期：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py current-period\r\n```\r\n\r\n查询发票认证状态：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py check-status --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\"\r\n```\r\n\r\n查询当前属期认证发票：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices\r\n```\r\n\r\n查询指定属期认证发票（历史记录）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices --skssq \"202604\"\r\n```\r\n\r\n提交勾选认证（单张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-12,26127000000211930033\"\r\n```\r\n\r\n提交勾选认证（多张，自动按开票日期排序，每批最多 50 张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-10,26127000000211930033\" \"011002000311,2026-05-12,26127000000211930034\" \"011002000311,2026-05-08,26127000000211930035\"\r\n```\r\n\r\n申请统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py statistics --commit-type \"1\" --bz \"N\"\r\n```\r\n\r\n查询抵扣统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py deduct-stats\r\n```\n\nFile v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1779696262480\n}\n\nFile v1.0.0:skill-card.md\n\n## Description:
\n发票认证 helps users log in to the electronic tax bureau, certify input invoices, query certification status, and manage deduction statistics.
\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:
\nTax and accounting users use this skill to manage input-invoice certification workflows, including tax-bureau login, invoice status checks, certification or cancellation, signature confirmation, and deduction-statistics operations.
\n\n### Deployment Geography for Use:
\nChina
\n\n## Known Risks and Mitigations:
\nRisk: API keys and tax-login credentials are sensitive and may be exposed through chat, shell profiles, or persistent session storage.
\nMitigation: Use a dedicated revocable apiKey, avoid pasting secrets into chat, avoid storing tax passwords or API keys in shell profiles or the skill directory, and delete the .session file after use.
\nRisk: Real taxpayer and invoice data may be sent to the remote tax-service provider.
\nMitigation: Use the skill only after confirming that the provider is trusted and approved for the relevant taxpayer and invoice data.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/sunriseorient/invoice-cert)
\n- [ZXT Skill platform](https://skill.quandianfapiao.com/)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Shell commands, Configuration guidance]
\n**Output Format:** [Markdown and command-line text, with JSON-formatted API responses where returned by the tax-service APIs]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a ZXT_API_KEY and may prompt for taxpayer identifiers, tax-account credentials, invoice identifiers, dates, tax periods, and SMS verification codes depending on the command.]
\n\n## Skill Version(s):
\n1.0.0 (source: server release metadata)
\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, 10563 bytes\n\nFiles: common.py (4673b), invoice_cert.py (15927b), SKILL.md (14299b), _meta.json (136b)\n\nFile v1.0.0-beta:SKILL.md\n\n---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局登录、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局登录、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 登录税局系统（电子税务局）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 登录电子税务局\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\r\n\r\n### 税局登录 (login)\r\n\r\n- 税号（必填）\r\n- 账号（选填，登录时可能需要）\r\n- 密码（选填，登录时可能需要）\r\n- 地区码（选填，如 BJ、TJ）\r\n\r\n### 验证码登录 (login-sms)\r\n\r\n- 验证码（必填）\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 发送验证码 (send-sms)\r\n\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\r\n\r\n> 您需要完成以下三步，即可自动配置并执行技能：\r\n>\r\n> 1. **注册账号**\r\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\r\n>\r\n> 2. **申请 apiKey**\r\n> 登录后进入\"技能中心\"，复制您的 apiKey。\r\n>\r\n> 3. **提供 apiKey**\r\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\r\n\r\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\r\n\r\n- 禁止读取文件（Excel、PDF、图片等）\r\n- 禁止调用任何 API\r\n- 禁止执行任何脚本或命令\r\n- 禁止进行参数解析或预处理\r\n\r\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\r\n\r\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\r\n\r\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n\r\n环境变量就绪后，继续以下步骤：\r\n\r\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\r\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\r\n3. 检查返回的 status 字段：\r\n - 非 200 且非 309 时，停止并将错误信息展示给用户。\r\n - **status 为 309 时**，脚本自动使用会话缓存中的登录凭证（creditCode、account、password）重新登录税局，登录成功后自动重试原请求。若缓存不存在或自动重登失败，则提示用户手动登录。\r\n4. 解析返回结果并以可读格式输出。\r\n\r\n### 税局登录流程说明\r\n\r\n调用登录接口后，根据 `returnType` 分支处理：\r\n\r\n- **returnType=4000**：直接登录成功，可继续调用其他接口。\r\n- **returnType=4001**：需要验证码登录，会返回带星手机号。引导用户发送验证码（`send-sms`）→ 输入验证码完成登录（`login-sms`）。\r\n- **returnType=4002**：需要设置地区，会返回可选地区列表。引导用户选择地区码后使用 `--area-code` 参数重新登录。\r\n\r\n## 请求参数说明\r\n\r\n### 1. 税局登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLogin\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | -------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 税号（纳税人识别号） |\r\n| account | string | 否 | 税局账号 |\r\n| password | string | 否 | 税局密码 |\r\n| areaCode | string | 否 | 地区码（如 BJ、TJ） |\r\n\r\n### 2. 验证码登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLoginBySmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n| smsCode | string | 是 | 短信验证码 |\r\n\r\n### 3. 发送验证码 — POST /api/jxplus/zxtSkill/dzsj/dzsjSendSmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n\r\n### 4. 确认签名 — POST /api/jxplus/zxtSkill/check/doSignature\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n### 5. 查询当前税款所属期 — POST /api/jxplus/zxtSkill/check/getCurrSkssq\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 data 为税款所属期字符串，如 `\"2026-05\"`。\r\n\r\n### 6. 申请或撤销统计 — POST /api/jxplus/zxtSkill/check/commitStatistics\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 申请统计，2 撤销统计 |\r\n| bz | string | 是 | N 忽略未勾选发票直接统计，Y 取消未完成的统计状态 |\r\n\r\n### 7. 查询抵扣统计数据 — POST /api/jxplus/zxtSkill/check/getDeductStatistList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ---------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 8. 查询当前属期认证发票集合 — POST /api/jxplus/zxtSkill/check/getCheckedInvoiceList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | -------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 9. 查询发票认证状态 — POST /api/jxplus/zxtSkill/check/getInvoiceCheckStatus\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------------- | ------ | ---- | ---------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| invoiceNumber | string | 是 | 发票号码 |\r\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\r\n| invoiceCode | string | 否 | 发票代码 |\r\n\r\n### 10. 提交或取消认证 — POST /api/jxplus/zxtSkill/check/commitDeduction\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 勾选认证，2 取消勾选认证 |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n| list | array | 是 | 发票列表，每条含 invoiceCode、kprq、invoiceNumber |\r\n\r\n## 返回说明\r\n\r\n### 登录返回 (login)\r\n\r\n| 字段 | 类型 | 说明 |\r\n| ----------- | ------ | --------------------------------------------------------- |\r\n| returnType | string | 4000 直接登录成功，4001 需验证码，4002 需设置地区 |\r\n| loginMobile | string | 带\\*手机号（returnType=4001 时返回） |\r\n| areaList | array | 地区列表（returnType=4002 时返回），含 areaCode、areaName |\r\n\r\n### 认证发票返回 (checked-invoices)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ------------ |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| qdfphm | 全电发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| jshj | 价税合计 |\r\n| fplx | 发票类型 |\r\n| fplxName | 发票类型名称 |\r\n| xsfNsrsbh | 销售方税号 |\r\n| xsfMc | 销售方名称 |\r\n\r\n### 认证状态返回 (check-status)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ---------------------------- |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| gxzt | 勾选状态：0 未勾选，1 已勾选 |\r\n| skssq | 认证属期 |\r\n\r\n### 提交认证返回 (commit-deduction)\r\n\r\n| 字段 | 说明 |\r\n| ------------ | -------------- |\r\n| successCount | 成功数量 |\r\n| failCount | 失败数量 |\r\n| successList | 成功集合 |\r\n| failLIst | 失败集合 |\r\n| skssq | 当前税款所属期 |\r\n\r\n## 异常状态码\r\n\r\n| 状态码 | 说明 |\r\n| ------ | ------------------------ |\r\n| 400 | 请求参数错误 |\r\n| 300 | 参数为空或格式错误 |\r\n| 305 | 无权访问该接口 |\r\n| 307 | 消费失败，授权余次不足 |\r\n| 308 | 超出接口调用次数 |\r\n| 309 | 税局未登录，需先登录税局 |\r\n| 500 | 系统异常 |\r\n\r\n## 命令示例\r\n\r\n税局登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login --credit-code \"911101087582285868\" --account \"account\" --password \"password\"\r\n```\r\n\r\n发送验证码：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py send-sms --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n验证码登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login-sms --sms-code \"123456\" --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n确认签名：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py sign\r\n```\r\n\r\n查询当前税款所属期：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py current-period\r\n```\r\n\r\n查询发票认证状态：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py check-status --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\"\r\n```\r\n\r\n查询当前属期认证发票：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices\r\n```\r\n\r\n查询指定属期认证发票（历史记录）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices --skssq \"202604\"\r\n```\r\n\r\n提交勾选认证（单张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-12,26127000000211930033\"\r\n```\r\n\r\n提交勾选认证（多张，自动按开票日期排序，每批最多 50 张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-10,26127000000211930033\" \"011002000311,2026-05-12,26127000000211930034\" \"011002000311,2026-05-08,26127000000211930035\"\r\n```\r\n\r\n申请统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py statistics --commit-type \"1\" --bz \"N\"\r\n```\r\n\r\n查询抵扣统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py deduct-stats\r\n```\n\nFile v1.0.0-beta:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.0-beta\",\n \"publishedAt\": 1779412072523\n}\n\nArchive v1.0.0-alpha: 4 files, 10566 bytes\n\nFiles: common.py (4667b), invoice_cert.py (15933b), SKILL.md (14311b), _meta.json (137b)\n\nFile v1.0.0-alpha:SKILL.md\n\n---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局登录、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局登录、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 登录税局系统（电子税务局）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 登录电子税务局\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://test-eqjs.es366.cn/jxplusSkill/ 申请。\r\n\r\n### 税局登录 (login)\r\n\r\n- 税号（必填）\r\n- 账号（选填，登录时可能需要）\r\n- 密码（选填，登录时可能需要）\r\n- 地区码（选填，如 BJ、TJ）\r\n\r\n### 验证码登录 (login-sms)\r\n\r\n- 验证码（必填）\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 发送验证码 (send-sms)\r\n\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\r\n\r\n> 您需要完成以下三步，即可自动配置并执行技能：\r\n>\r\n> 1. **注册账号**\r\n> 访问中兴通简税Skill平台：https://test-eqjs.es366.cn/jxplusSkill/ 完成注册。\r\n>\r\n> 2. **申请 apiKey**\r\n> 登录后进入\"技能中心\"，复制您的 apiKey。\r\n>\r\n> 3. **提供 apiKey**\r\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\r\n\r\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\r\n\r\n- 禁止读取文件（Excel、PDF、图片等）\r\n- 禁止调用任何 API\r\n- 禁止执行任何脚本或命令\r\n- 禁止进行参数解析或预处理\r\n\r\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\r\n\r\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\r\n\r\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n\r\n环境变量就绪后，继续以下步骤：\r\n\r\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\r\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\r\n3. 检查返回的 status 字段：\r\n - 非 200 且非 309 时，停止并将错误信息展示给用户。\r\n - **status 为 309 时**，脚本自动使用会话缓存中的登录凭证（creditCode、account、password）重新登录税局，登录成功后自动重试原请求。若缓存不存在或自动重登失败，则提示用户手动登录。\r\n4. 解析返回结果并以可读格式输出。\r\n\r\n### 税局登录流程说明\r\n\r\n调用登录接口后，根据 `returnType` 分支处理：\r\n\r\n- **returnType=4000**：直接登录成功，可继续调用其他接口。\r\n- **returnType=4001**：需要验证码登录，会返回带星手机号。引导用户发送验证码（`send-sms`）→ 输入验证码完成登录（`login-sms`）。\r\n- **returnType=4002**：需要设置地区，会返回可选地区列表。引导用户选择地区码后使用 `--area-code` 参数重新登录。\r\n\r\n## 请求参数说明\r\n\r\n### 1. 税局登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLogin\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | -------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 税号（纳税人识别号） |\r\n| account | string | 否 | 税局账号 |\r\n| password | string | 否 | 税局密码 |\r\n| areaCode | string | 否 | 地区码（如 BJ、TJ） |\r\n\r\n### 2. 验证码登录 — POST /api/jxplus/zxtSkill/dzsj/dzsjLoginBySmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n| smsCode | string | 是 | 短信验证码 |\r\n\r\n### 3. 发送验证码 — POST /api/jxplus/zxtSkill/dzsj/dzsjSendSmsCode\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| creditCode | string | 是 | 纳税人识别号 |\r\n| account | string | 是 | 税局账号 |\r\n\r\n### 4. 确认签名 — POST /api/jxplus/zxtSkill/check/doSignature\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n### 5. 查询当前税款所属期 — POST /api/jxplus/zxtSkill/check/getCurrSkssq\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ------ |\r\n| apiKey | string | 是 | apiKey |\r\n\r\n返回 data 为税款所属期字符串，如 `\"2026-05\"`。\r\n\r\n### 6. 申请或撤销统计 — POST /api/jxplus/zxtSkill/check/commitStatistics\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------ |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 申请统计，2 撤销统计 |\r\n| bz | string | 是 | N 忽略未勾选发票直接统计，Y 取消未完成的统计状态 |\r\n\r\n### 7. 查询抵扣统计数据 — POST /api/jxplus/zxtSkill/check/getDeductStatistList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | ---------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 8. 查询当前属期认证发票集合 — POST /api/jxplus/zxtSkill/check/getCheckedInvoiceList\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------ | ------ | ---- | -------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n\r\n### 9. 查询发票认证状态 — POST /api/jxplus/zxtSkill/check/getInvoiceCheckStatus\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ------------- | ------ | ---- | ---------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| invoiceNumber | string | 是 | 发票号码 |\r\n| invoiceDate | string | 是 | 开票日期（YYYY-MM-DD） |\r\n| invoiceCode | string | 否 | 发票代码 |\r\n\r\n### 10. 提交或取消认证 — POST /api/jxplus/zxtSkill/check/commitDeduction\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n| ---------- | ------ | ---- | ------------------------------------------------- |\r\n| apiKey | string | 是 | apiKey |\r\n| commitType | string | 是 | 1 勾选认证，2 取消勾选认证 |\r\n| skssq | string | 否 | 税款所属期，不填默认当前属期 |\r\n| list | array | 是 | 发票列表，每条含 invoiceCode、kprq、invoiceNumber |\r\n\r\n## 返回说明\r\n\r\n### 登录返回 (login)\r\n\r\n| 字段 | 类型 | 说明 |\r\n| ----------- | ------ | --------------------------------------------------------- |\r\n| returnType | string | 4000 直接登录成功，4001 需验证码，4002 需设置地区 |\r\n| loginMobile | string | 带\\*手机号（returnType=4001 时返回） |\r\n| areaList | array | 地区列表（returnType=4002 时返回），含 areaCode、areaName |\r\n\r\n### 认证发票返回 (checked-invoices)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ------------ |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| qdfphm | 全电发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| jshj | 价税合计 |\r\n| fplx | 发票类型 |\r\n| fplxName | 发票类型名称 |\r\n| xsfNsrsbh | 销售方税号 |\r\n| xsfMc | 销售方名称 |\r\n\r\n### 认证状态返回 (check-status)\r\n\r\n| 字段 | 说明 |\r\n| ------------- | ---------------------------- |\r\n| invoiceCode | 发票代码 |\r\n| invoiceNumber | 发票号码 |\r\n| kprq | 开票日期 |\r\n| hjje | 合计金额 |\r\n| hjse | 合计税额 |\r\n| gxzt | 勾选状态：0 未勾选，1 已勾选 |\r\n| skssq | 认证属期 |\r\n\r\n### 提交认证返回 (commit-deduction)\r\n\r\n| 字段 | 说明 |\r\n| ------------ | -------------- |\r\n| successCount | 成功数量 |\r\n| failCount | 失败数量 |\r\n| successList | 成功集合 |\r\n| failLIst | 失败集合 |\r\n| skssq | 当前税款所属期 |\r\n\r\n## 异常状态码\r\n\r\n| 状态码 | 说明 |\r\n| ------ | ------------------------ |\r\n| 400 | 请求参数错误 |\r\n| 300 | 参数为空或格式错误 |\r\n| 305 | 无权访问该接口 |\r\n| 307 | 消费失败，授权余次不足 |\r\n| 308 | 超出接口调用次数 |\r\n| 309 | 税局未登录，需先登录税局 |\r\n| 500 | 系统异常 |\r\n\r\n## 命令示例\r\n\r\n税局登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login --credit-code \"911101087582285868\" --account \"account\" --password \"password\"\r\n```\r\n\r\n发送验证码：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py send-sms --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n验证码登录：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py login-sms --sms-code \"123456\" --credit-code \"911101087582285868\" --account \"account\"\r\n```\r\n\r\n确认签名：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py sign\r\n```\r\n\r\n查询当前税款所属期：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py current-period\r\n```\r\n\r\n查询发票认证状态：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py check-status --invoice-number \"26127000000211930033\" --invoice-date \"2026-05-12\"\r\n```\r\n\r\n查询当前属期认证发票：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices\r\n```\r\n\r\n查询指定属期认证发票（历史记录）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py checked-invoices --skssq \"202604\"\r\n```\r\n\r\n提交勾选认证（单张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-12,26127000000211930033\"\r\n```\r\n\r\n提交勾选认证（多张，自动按开票日期排序，每批最多 50 张）：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py commit-deduction --commit-type \"1\" --invoices \"011002000311,2026-05-10,26127000000211930033\" \"011002000311,2026-05-12,26127000000211930034\" \"011002000311,2026-05-08,26127000000211930035\"\r\n```\r\n\r\n申请统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py statistics --commit-type \"1\" --bz \"N\"\r\n```\r\n\r\n查询抵扣统计：\r\n\r\n```bash\r\npython .claude/skills/invoice-cert/invoice_cert.py deduct-stats\r\n```\n\nFile v1.0.0-alpha:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.0-alpha\",\n \"publishedAt\": 1779354731924\n}","readmeExcerpt":"Skill: 发票认证 Owner: zxt Summary: 发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。 Tags: latest:1.0.2 Version history: v1.0.2 | 2026-09-24T01:09:24.040Z | user - 支持税局扫码登录替换原账号密码/验证码登录，提升安全性，并优化交互流程。 - 新增“查询当前登录企业”功能，可显示当前操作企业名称及税号；所有业务操作成功后自动标注企业信息。 - 登录失效（status=309）时自动引导微信扫码，并将二维码图片优先直观展示给用户。 - 精简参数输入，删除原短信验证码/地区选择等流程，降低用户操作复杂度。 - 移除 skill-card.md 文档，无功能影响。 v1.0.1 | 2026-06-17T07:37:21.393Z | user 主体迁移 v1.0.0","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"File v1.0.2:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1790212164040\n}\n\nFile v1.0.2: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 tax and finance users use this skill to log in to the electronic tax bureau, inspect enterprise and invoice certification status, submit or cancel invoice certification, and manage deduction statistics.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks for a tax API key and may persist it in shell settings.\n\nMitigation: Configure the API key outside chat when possible and confirm who can read any persistent shell-profile storage.\n\nRisk: The skill can perform sensitive tax actions such as certification changes and deduction statistics operations.\n\nMitigation: Confirm the target enterprise, tax period, invoice list, and requested action before running state-changing commands.\n\nRisk: The security verdict recommends review before installation because the provider receives enterprise tax data and API-key authority.\n\nMitigation: Install only when the provider is trusted with the relevant enterprise tax data and API access.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/zxt/skills/invoice-cert)\n- [中兴通简税 Skill platform](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, API Calls, Markdown, Configuration, Guidance]\n\n**Output Format:** [Human-readable text and JSON-formatted command output, with QR-code image paths or links when login is required]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May perform state-changing tax actions after API-key configuration; successful business operations should identify the target enterprise.]\n\n##"},{"language":"text","snippet":"File v1.0.1:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.1\",\n \"publishedAt\": 1781681841393\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\nTax and finance operators use this skill to log in to the electronic tax bureau, check invoice certification status, submit or cancel input-invoice certification, request or revoke deduction statistics, and review certified invoice records.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Sensitive tax credentials and API keys may be stored or reused locally in plaintext.\n\nMitigation: Set secrets locally instead of sharing them through chat, delete any .session file after use, and avoid production tax accounts until credential storage is improved.\n\nRisk: The skill can perform high-impact tax actions such as invoice certification, cancellation, statistics submission, revocation, and signature confirmation.\n\nMitigation: Require explicit user confirmation for each tax action and review target invoices, tax periods, and requested operation before execution.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/zxt/skills/invoice-cert)\n- [中兴通简税Skill平台](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown and terminal text with command examples and JSON-formatted API results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May execute remote tax-service API calls and print invoice, certification, login, signature, and deduction-statistics results.]\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 e"},{"language":"text","snippet":"File v1.0.0:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.0\",\n \"publishedAt\": 1779696262480\n}\n\nFile v1.0.0:skill-card.md\n\n## Description:
\n发票认证 helps users log in to the electronic tax bureau, certify input invoices, query certification status, and manage deduction statistics.
\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:
\nTax and accounting users use this skill to manage input-invoice certification workflows, including tax-bureau login, invoice status checks, certification or cancellation, signature confirmation, and deduction-statistics operations.
\n\n### Deployment Geography for Use:
\nChina
\n\n## Known Risks and Mitigations:
\nRisk: API keys and tax-login credentials are sensitive and may be exposed through chat, shell profiles, or persistent session storage.
\nMitigation: Use a dedicated revocable apiKey, avoid pasting secrets into chat, avoid storing tax passwords or API keys in shell profiles or the skill directory, and delete the .session file after use.
\nRisk: Real taxpayer and invoice data may be sent to the remote tax-service provider.
\nMitigation: Use the skill only after confirming that the provider is trusted and approved for the relevant taxpayer and invoice data.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/sunriseorient/invoice-cert)
\n- [ZXT Skill platform](https://skill.quandianfapiao.com/)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Shell commands, Configuration guidance]
\n**Output Format:** [Markdown and command-line text, with JSON-formatted API responses where returned by the tax-service APIs]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires a ZXT_API_KEY and may prompt for taxpayer identifiers, tax-account credent"},{"language":"text","snippet":"File v1.0.0-beta:_meta.json\n\n{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.0-beta\",\n \"publishedAt\": 1779412072523\n}\n\nArchive v1.0.0-alpha: 4 files, 10566 bytes\n\nFiles: common.py (4667b), invoice_cert.py (15933b), SKILL.md (14311b), _meta.json (137b)\n\nFile v1.0.0-alpha:SKILL.md\n\n---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局登录、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局登录、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 登录税局系统（电子税务局）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 登录电子税务局\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://test-eqjs.es366.cn/jxplusSkill/ 申请。\r\n\r\n### 税局登录 (login)\r\n\r\n- 税号（必填）\r\n- 账号（选填，登录时可能需要）\r\n- 密码（选填，登录时可能需要）\r\n- 地区码（选填，如 BJ、TJ）\r\n\r\n### 验证码登录 (login-sms)\r\n\r\n- 验证码（必填）\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 发送验证码 (send-sms)\r\n\r\n- 税号（必填）\r\n- 账号（必填）\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: invoice-cert\r\ndescription: 发票认证技能。税局扫码登录、登录企业查询、发票勾选认证、抵扣统计。适用于进项发票勾选、认证、统计等税务操作场景。\r\n---\r\n\r\n# 发票认证技能\r\n\r\n使用此技能进行税局扫码登录、登录企业查询、发票勾选认证、查询认证状态、申请抵扣统计等操作。\r\n\r\n## 使用场景\r\n\r\n满足以下需求时使用：\r\n\r\n- 扫码登录税局系统（电子税务局）。\r\n- 查询当前登录的企业信息（企业名称、纳税人识别号）。\r\n- 查询发票的勾选认证状态。\r\n- 提交或取消发票勾选认证。\r\n- 申请或撤销抵扣统计。\r\n- 查询抵扣统计数据。\r\n- 查询当前属期已认证的发票集合。\r\n- 查询当前税款所属期。\r\n- 确认签名。\r\n\r\n## 触发语句示例\r\n\r\n以下用户输入应触发此技能：\r\n\r\n- 帮我登录税局 / 税局登录 / 扫码登录 / 登录电子税务局\r\n- 现在登录的是哪个企业 / 查询企业信息 / 当前企业\r\n- 查一下这张发票的认证状态 / 发票认证状态\r\n- 提交认证 / 勾选认证 / 取消认证\r\n- 申请统计 / 撤销统计 / 抵扣统计\r\n- 查看已认证发票 / 当前属期发票\r\n- 确认签名\r\n- 税款所属期 / 当前属期 / 查询税款所属期\r\n- 发票勾选 / 认证发票\r\n\r\n## 输入参数\r\n\r\n执行前准备以下参数：\r\n\r\n- apiKey（必填）：通过 https://skill.quandianfapiao.com/ 申请。\r\n\r\n### 扫码登录 (login-qr)\r\n\r\n无额外参数。获取税局登录二维码并在终端展示，用户使用微信扫码（或在浏览器中打开链接）完成登录。\r\n\r\n### 查询当前登录企业 (org-info)\r\n\r\n无额外参数。返回当前 apiKey 对应的企业名称与纳税人识别号。\r\n\r\n### 确认签名 (sign)\r\n\r\n无额外参数。\r\n\r\n### 查询当前税款所属期 (current-period)\r\n\r\n无额外参数。\r\n\r\n### 申请或撤销统计 (statistics)\r\n\r\n- 提交类型（必填）：1 申请统计，2 撤销统计\r\n- bz（必填）：N 忽略未勾选发票直接统计，Y 取消未完成的统计状态\r\n\r\n### 查询抵扣统计数据 (deduct-stats)\r\n\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n### 查询当前属期认证发票集合 (checked-invoices)\r\n\r\n- 税款所属期（选填，不填默认当前属期，传入可查询历史认证记录）\r\n\r\n### 查询发票认证状态 (check-status)\r\n\r\n- 发票号码（必填）\r\n- 开票日期（必填，格式 YYYY-MM-DD）\r\n- 发票代码（选填）\r\n\r\n### 提交或取消认证 (commit-deduction)\r\n\r\n- 提交类型（必填）：1 勾选认证，2 取消勾选认证\r\n- 发票列表（必填）：每条包含发票代码、开票日期、发票号码\r\n- 税款所属期（选填，不填默认当前属期）\r\n\r\n**批量处理规则：**\r\n\r\n- 提交前无需先查验认证状态，可直接提交或取消认证。\r\n- 多张发票时自动按开票日期（kprq）升序排序后提交。\r\n- 每批最多 50 张，超出自动分批。\r\n\r\n## 执行流程\r\n\r\n**前置检查（最高优先级）：检查环境变量 `ZXT_API_KEY` 是否已设置。**\r\n\r\n注意：当前 shell 会话可能未继承 Windows 用户级环境变量，必须按以下方式检查，不能仅依赖 `$ZXT_API_KEY`：\r\n\r\n- Windows：执行 `powershell -Command \"[System.Environment]::GetEnvironmentVariable('ZXT_API_KEY', 'User')\"` 获取用户级环境变量值，同时检查 `$ZXT_API_KEY`。\r\n- macOS/Linux：检查 `$ZXT_API_KEY` 即可。\r\n\r\n如果以上检查结果均为空，禁止执行任何后续操作，立即向用户输出以下提示并停止：\r\n\r\n> 您需要完成以下三步，即可自动配置并执行技能：\r\n>\r\n> 1. **注册账号**\r\n> 访问中兴通简税Skill平台：https://skill.quandianfapiao.com/ 完成注册。\r\n>\r\n> 2. **申请 apiKey**\r\n> 登录后进入\"技能中心\"，复制您的 apiKey。\r\n>\r\n> 3. **提供 apiKey**\r\n> 将复制的 apiKey 发送给我，我将为您完成配置并立即执行技能。\r\n\r\n**严格限制：前置检查未通过时，禁止执行任何其他动作，包括但不限于：**\r\n\r\n- 禁止读取文件（Excel、PDF、图片等）\r\n- 禁止调用任何 API\r\n- 禁止执行任何脚本或命令\r\n- 禁止进行参数解析或预处理\r\n\r\n**只允许输出提示信息，然后停止，等待用户提供 apiKey。**\r\n\r\n用户提供 apiKey 后，写入系统环境变量并使当前会话生效：\r\n\r\n- Windows：`setx ZXT_API_KEY ` 写入用户级环境变量，然后执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n- macOS/Linux：将 `export ZXT_API_KEY=` 追加到 `~/.bashrc` 或 `~/.zshrc`（根据用户使用的 shell），同时执行 `export ZXT_API_KEY=` 使当前会话生效。\r\n\r\n环境变量就绪后，继续以下步骤：\r\n\r\n1. 校验必填参数存在且非空。**任何必填参数缺失时必须立即停止，禁止跳过或使用空值继续执行。**\r\n2. 通过 python 执行脚本调用远程 API（Windows 下使用 `python`，macOS/Linux 使用 `python3`），脚本优先使用 `--api-key` 参数，未传则回退读取环境变量 `ZXT_API_KEY`。\r\n3. 检查返回的 status 字段：\r\n - 非 200 且非 309 时，停止并将错误信息展示给用户。\r\n - **status 为 309 时**（税局未登录），脚本自动调用 `getLoginQrUrl` 获取登录二维码地址，在系统临时目录生成二维码图片并输出图片路径与链接，然后退出。**你必须把该图片展示给用户**：优先用自身能力展示（如 `present_files` 或读取图片文件），其次用系统自带能力打开（Windows `start`、macOS `open`、Linux `xdg-open`）。随后引导用户使用微信扫码（或在浏览器中打开链接）；用户回复确认后，重新执行刚才的命令即可（此时税局已完成登录，原命令可直接成功）。\r\n4. 解析返回结果并以可读格式输出。\r\n5. **向用户明确说明操作对象企业。** 业务命令（`current-period` / `sign` / `statistics` / `deduct-stats"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn78wqnm3g9mqn7q7x83dh3jvn874tn3\",\n \"slug\": \"invoice-cert\",\n \"version\": \"1.0.2\",\n \"publishedAt\": 1790212164040\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 tax and finance users use this skill to log in to the electronic tax bureau, inspect enterprise and invoice certification status, submit or cancel invoice certification, and manage deduction statistics.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill asks for a tax API key and may persist it in shell settings.\n\nMitigation: Configure the API key outside chat when possible and confirm who can read any persistent shell-profile storage.\n\nRisk: The skill can perform sensitive tax actions such as certification changes and deduction statistics operations.\n\nMitigation: Confirm the target enterprise, tax period, invoice list, and requested action before running state-changing commands.\n\nRisk: The security verdict recommends review before installation because the provider receives enterprise tax data and API-key authority.\n\nMitigation: Install only when the provider is trusted with the relevant enterprise tax data and API access.\n\n## Reference(s):\n\n- [ClawHub skill listing](https://clawhub.ai/zxt/skills/invoice-cert)\n- [中兴通简税 Skill platform](https://skill.quandianfapiao.com/)\n\n## Skill Output:\n\n**Output Type(s):** [Shell commands, API Calls, Markdown, Configuration, Guidance]\n\n**Output Format:** [Human-readable text and JSON-formatted command output, with QR-code image paths or links when login is required]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May perform state-changing tax actions after API-key configuration; successful business operations should identify the target enterprise.]\n\n## Skill Version(s):\n\n1.0.2 (source: server release metadata)\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.2 Version history: v1.0.2 | 2026-09-24T01:09:24.040Z | user - 支持税局扫码登录替换原账号密码/验证码登录，提升安全性，并优化交互流程。 - 新增“查询当前登录企业”功能，可显示当前操作企业名称及税号；所有业务操作成功后自动标注企业信息。 - 登录失效（status=309）时自动引导微信扫码，并将二维码图片优先直观展示给用户。 - 精简参数输入，删除原短信验证码/地区选择等流程，降低用户操作复杂度。 - 移除 skill-card.md 文档，无功能影响。 v1.0.1 | 2026-06-17T07:37:21.393Z | user 主体迁移 v1.0.0","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":742,"uniquenessScore":60,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T04:37:33.320Z","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-11T04:37:33.320Z","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-11T07:37:46.331Z","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"}]}}}