# 国税增值税发票查验平台

## 官方平台

**国家税务总局增值税发票查验平台**
https://inv-veri.chinatax.gov.cn

## API 接入方式

### 方式一：网页端查验（推荐 Skill 使用）

通过爬取官方网页模拟查验请求：

```
POST https://inv-veri.chinatax.gov.cn/web/query.do
```

请求参数：
| 参数 | 说明 |
|------|------|
| param0 | 发票代码（10位） |
| param1 | 发票号码（8位） |
| param2 | 开票日期（YYYYMMDD） |
| param3 | 金额（价税合计，元） |
| param4 | 验证码（需识别） |

返回：发票状态（正常/作废/红冲/失控）

### 方式二：电子发票 XML/OFD 直读

电子发票（数电票）的 XML/OFD 文件包含完整签名信息，
可通过本地验签确认发票真实性，无需调用外部 API：

```bash
# XML 电子发票验签
# 使用 OpenSSL 验证数字签名块
openssl smime -verify -in invoice.xml.sig -inform DER

# OFD 发票验签
# OFD 文件结构解析，提取签名域验证
```

### 方式三：企业 ERP 对接

企业可通过税局授权的第三方服务商（如用友、金蝶）API 批量查验。

## 接口配额

| 账号类型 | 每日查验量 | 说明 |
|---------|-----------|------|
| 税局官网（免费）| 100次/天/IP | 需验证码 |
| 企业开发者账号 | 不限（按量付费）| 0.1-0.3元/次 |
| 第三方服务商 | 不限 | API 封装 |

## 发票状态枚举

| 状态码 | 含义 | 报销建议 |
|--------|------|---------|
| 00 / 正常 | 发票有效 | ✅ 可报销 |
| 01 / 作废 | 企业自行作废 | ❌ 不可报销 |
| 02 / 红冲 | 开具红字发票冲销 | ❌ 不可报销 |
| 03 / 失控 | 已被税局列为失控 | ❌ 不可报销 |
| 04 / 异常 | 数据不一致 | ⚠️ 需核实 |

## Skill 内的验真策略

由于 Skill 运行在沙箱环境，**不存储企业敏感税务信息**。

验真流程设计：
1. 用户上传发票图片 → AI 识别关键字段
2. 调用查验接口（或 XML 直验）获取状态
3. 仅返回状态结果，不存储发票数据
4. 每次验真消耗 Token 计入账户

> ⚠️ 接口如有调整，以税局官方文档为准。Skill 不承担接口变更导致的损失。