发票查验

要解决什么问题

财务、报销或风控场景里，你手头有一张增值税专票、普票或电子发票，需要确认是否作废、红冲，以及票面上的销售方、购方、价税合计是否与纸质或 PDF 一致。手工去税务局或第三方页面逐张核对成本高，也容易漏字段。本技能把「单张发票真伪查验」收敛成一次结构化查询，让助手根据你提供的票面要素拉取官方数据源侧的查验结果。

技能如何工作

核心能力是调用发票查验接口：在具备有效 API Key 的前提下，按发票代码、号码、开票日期、不含税合计金额、校验码后六位及类型（可用 auto 自动识别）发起请求，成功时返回 status、seller、buyer、totalfee、extaltax 及 state（未作废 / 作废 / 红冲）等字段。

典型流程是：从对话里提取票面参数 → 在技能目录执行 query_invoice_verify.py（或通过环境变量 CHINAZ_INVOICE_VERIFY_API_KEY 注入密钥）→ 只依据脚本输出的 JSON 向用户解读，不编造字段。未配置 Key 时会得到 missing_api_key，应按技能说明引导用户到购买页获取 Key 后直接发给助手；Key 无效或额度不足则提示回购买页核对。

适用边界与注意点

• 本技能仅覆盖「发票查验」，不用于其它企业或工商类查询。
• 一次只查一条；所谓「批量」只能循环逐条调用，不能假定有批量接口。
• 返回数据仅供参考，存在同步延迟时以税务机关或开票方官方渠道为准。
• 助手不应保存、回显完整 API Key。