发票查验

要解决的问题

国家税务总局全国增值税发票查验平台（inv-veri.chinatax.gov.cn）是官方查验入口，但人工操作链条很长：打开网站、手动填写发票代码/号码/日期/价税合计、识别图形验证码、点击查验、等待结果弹窗、逐项核对、截图存档。批量场景下，这些重复动作会迅速消耗人力，而且每张发票每天只有 5 次查验机会，试错成本高。

核心能力与工作流程

该技能用浏览器自动化驱动官方平台，把「填表 → 输码 → 查验 → 截图 → 归档」整条链路串成一条流水线。

• 三种输入：单张 PDF（--invoice）、批量清单（--invoices）、批量目录（--dir），自动跳过已生成的组合 PDF。
• 导入通道自动回填：脚本打开平台后点击【导入】，选择 PDF 让平台自己解析四要素，避免人工判断「价税合计 vs 不含税」时出错。
• 人机协作输码：验证码由用户在浏览器内手动输入并点击【查 验】，脚本实时监听点击动作、在结果弹窗出现瞬间截图。验证码颜色随机（红/蓝/黑）、固定 3 个字符，必须按当次提示读取。
• 兜底自动回填：平台解析服务偶发卡在 0% 时，脚本只尝试 1 次导入，随即改用 pdfplumber 从 PDF 文本层提取发票号码、开票日期、价税合计并手动回填表单；日期控件需真实鼠标点击日历面板才能写入。
• 合并交付：截图包含「开票人 / 特别提示」，通过 merge_result.py --no-crop 与原发票合并为组合 PDF，单张或批量统一落盘。

验证码是官方平台对自动化的主要瓶颈，因此默认保留人工输码环节。

适用边界

• 平台限制：当日开具的发票最快次日可查，仅支持近 5 年发票，每张每日最多查验 5 次。
• 导入解析服务可能抽风，脚本已改为「只试 1 次即转兜底」，重启浏览器会话通常可恢复。
• 扫描件无文本层时字段识别不全，建议改用导入通道或手动模式。
• 平台选择器可能因改版失效，可用 platform_diagnose.py dump 真实 DOM 核对输入框顺序。
• 大批量无人值守场景建议接入第三方查验 API；请勿高频刷验同一张发票以免触发风控。