# 发票验真 API POC 与采购决策

## Goal

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

## Scope

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

## Requirements

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

## Acceptance Criteria

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

## Out of Scope

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

## Test Plan

```bash
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`

## Completion Note

2026-05-27：本轮完成供应商调研、合规边界和最小 POC 方案设计；未采购、未充值、未上传真实发票、未接入生产 provider。真实 API POC 需另起实施任务并获得样票授权和预算确认。