国家税务总局全国增值税发票查验平台Python实现指南

一、背景与需求分析

国家税务总局全国增值税发票查验平台（https://inv-veri.chinatax.gov.cn）是官方提供的发票真伪验证渠道，支持增值税专用发票、普通发票等类型的在线查验。企业财务、审计人员及开发者常需通过编程实现批量查验，以提高工作效率并减少人为错误。Python因其简洁的语法和丰富的网络请求库（如`requests`），成为实现该功能的首选工具。

核心需求

1. 自动化查验：替代手动输入发票信息，支持批量处理。
2. 数据解析：从返回的JSON或HTML中提取关键信息（如发票状态、金额、购买方名称）。
3. 异常处理：应对网络超时、验证码错误、发票不存在等场景。
4. 合规性：严格遵循平台使用规则，避免高频请求触发封禁。

二、技术实现方案

1. 接口分析

平台提供两种查验方式：

• 网页表单提交：通过POST请求模拟浏览器行为。
• API接口（未公开）：需逆向分析网页请求，存在合规风险。

推荐方案：模拟网页表单提交，使用requests库发送POST请求，参数包括发票代码、号码、日期、金额等。

2. 代码实现步骤

（1）环境准备

pip install requests pandas

（2）核心函数实现

import requests
from urllib.parse import urlencode
import json
def check_invoice(fpdm, fphm, date, total):
    """
    增值税发票查验主函数
    :param fpdm: 发票代码（10或12位）
    :param fphm: 发票号码（8位）
    :param date: 开票日期（格式：YYYY-MM-DD）
    :param total: 金额（不含税，元）
    :return: 查验结果字典
    """
    url = "https://inv-veri.chinatax.gov.cn/invveri/servlet/invoiceveri"
    headers = {
        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
        "Content-Type": "application/x-www-form-urlencoded",
    }
    data = {
        "fpdm": fpdm,
        "fphm": fphm,
        "kprq": date,
        "je": total,
        "nsrsbh": "",  # 购买方税号（可选）
        "pdfpzm": "",  # 发票密码区（可选）
        "method": "invoiceQuery",
    }
    try:
        response = requests.post(url, headers=headers, data=data, timeout=10)
        result = response.json()  # 实际返回可能是HTML，需进一步解析
        if "error" in result:
            return {"status": "error", "message": result.get("error")}
        # 解析关键字段（示例）
        parsed_data = {
            "status": "valid" if result.get("code") == "0" else "invalid",
            "buyer_name": result.get("gfmc"),
            "seller_name": result.get("xfmc"),
            "amount": result.get("hjje"),
        }
        return parsed_data
    except requests.exceptions.RequestException as e:
        return {"status": "error", "message": str(e)}

（3）批量查验示例

import pandas as pd
def batch_check(input_file, output_file):
    df = pd.read_excel(input_file)  # 假设Excel包含fpdm, fphm, date, total列
    results = []
    for _, row in df.iterrows():
        res = check_invoice(
            row["fpdm"],
            row["fphm"],
            row["date"],
            row["total"]
        )
        results.append(res)
    pd.DataFrame(results).to_excel(output_file, index=False)
# 使用示例
batch_check("invoices.xlsx", "results.xlsx")

三、关键问题与解决方案

1. 验证码处理

平台可能要求输入验证码，可通过以下方式优化：

• 人工干预：在代码中暂停，提示用户输入验证码后继续。
• OCR识别：使用pytesseract库识别验证码图片（需训练模型，准确率有限）。
• 合规建议：优先处理无验证码的场景，或联系税务机关获取官方API。

2. 频率限制

平台可能限制单IP的查验频率（如每分钟5次）。解决方案：

• IP轮询：使用代理池切换IP（需确保代理合法性）。
• 延迟控制：在请求间添加随机延迟。
  ```python
  import time
  import random

def safe_request(func, args, **kwargs):
time.sleep(random.uniform(1, 3)) # 随机延迟1-3秒
return func(args, **kwargs)

### 3. 数据解析
平台返回的可能是HTML而非JSON，需使用`BeautifulSoup`解析：
```python
from bs4 import BeautifulSoup
def parse_html_result(html):
    soup = BeautifulSoup(html, "html.parser")
    # 示例：提取发票状态
    status_tag = soup.find("div", class_="status")
    return {"status": status_tag.text.strip() if status_tag else "unknown"}

四、合规与安全建议

1. 数据保密：查验的发票信息可能涉及企业机密，需在本地加密存储。
2. 日志记录：记录所有查验请求，便于审计。
3. 官方渠道：优先使用税务机关推荐的集成方案（如电子税务局API）。
4. 法律风险：避免将查验功能用于非法目的（如批量获取企业数据）。

五、扩展功能

1. 集成到财务系统：通过API将查验结果自动写入ERP或会计软件。
2. 异常报警：当查验到无效发票时，发送邮件或短信通知。
3. 数据可视化：生成发票查验统计报表（如按月份、供应商分类）。

六、总结

通过Python实现国家税务总局增值税发票查验平台的自动化，可显著提升财务工作效率。开发者需重点关注接口稳定性、异常处理和合规性，同时结合实际业务需求扩展功能。建议定期关注平台规则更新，确保代码长期可用。

完整代码与示例文件：可在GitHub搜索“china-tax-invoice-verifier”获取开源实现，或参考税务机关官方文档调整参数。