hyb-oa/.trellis/tasks/05-27-invoice-verification-api-poc/prd.md

发票验真 API POC 与采购决策

Goal

评估并验证适合 hyb-oa 的发票验真 API，形成成本、能力、集成复杂度、合规边界和采购建议。先做 POC 与决策，不直接接入生产主链路。

Scope

• 候选：腾讯云、华为云、百度智能云、百望/诺诺类财税平台。
• 对比维度：单次价格、免费额度、发票类型、验真字段、失败原因、限流、签名鉴权、SDK/HTTP 接入、账期和采购便利性。
• 与当前 PDF OCR、发票查重、财务人工复核流程衔接。

Requirements

• 研究国家税务总局官方查验边界，确认不得依赖爬官方查验平台作为生产能力。
• 建立候选 API 对比表。
• 选 1-2 个候选做最小 POC 方案设计，优先考虑现有 OCR provider 复用和采购成本。
• 给出是否接入、何时接入、如何降级、如何记录审计和如何收费控制的建议。

Acceptance Criteria

• 输出发票验真 API 对比矩阵。
• 输出推荐供应商和备选供应商。
• 输出 POC 流程、样票授权边界、测试命令和验收标准。
• 明确发票验真失败、超限、欠费、API 不可用时的业务降级策略。

Out of Scope

• 不直接采购、充值或开通付费生产能力。
• 不上传未经授权的真实发票样票。
• 不保存真实票面、税号、银行账号、二维码或完整发票敏感字段。
• 不替代财务人工复核；首批仍以 OCR、查重和人工复核为主。

Test Plan

python3 ./.trellis/scripts/task.py validate 05-27-invoice-verification-api-poc
node scripts/qa/check-trellis-governance.mjs
git diff --check

Technical Notes

• Reimbursement rules: docs/报销发票附件规则.md
• Invoice/OCR spec: .trellis/spec/hyb-oa/reimbursement-invoice-ocr.md
• Security/privacy spec: .trellis/spec/hyb-oa/security-privacy.md