EU VAT Validator Pro
收藏EU VAT Validator Pro 数据集概述
数据集名称
EU VAT Validator Pro
数据集提供者
arrijr
数据集类别
Business Software
数据集描述
EU VAT Validator Pro 是一个快速、可靠的 API，用于验证所有 27 个欧盟成员国以及北爱尔兰的增值税号，直接对接官方的 VIES 注册系统（欧盟委员会）。它不仅提供简单的“有效/无效”检查，还返回结构化的公司数据（名称、街道、邮政编码、城市）以及一个符合审计要求的验证 ID，可用于税务合规性记录保存。
主要功能
- 实时欧盟增值税验证：通过 VIES 进行实时验证。
- 返回解析后的公司信息：包括公司名称、街道、邮政编码和城市。
- 审计合规的验证 ID：每次成功验证都会返回一个 UUID
verification_id，可存储 90 天，用于税务审计追踪。 - 批量验证：包含批量验证端点，每个请求最多可验证 100 个增值税号。
- 智能缓存：已验证结果缓存 24 小时，重复查询响应时间低于 10 毫秒，并在 VIES 响应缓慢时保持服务可用。
- 透明的错误代码：提供具体的 VIES 故障代码（如
MS_MAX_CONCURRENT_REQ、MS_UNAVAILABLE等），以便构建智能重试逻辑。 - 支持所有 28 个管辖区：覆盖 27 个欧盟成员国及北爱尔兰 (XI)。
适用场景
- 发票与会计软件：在结账时根据增值税号自动填写 B2B 客户详细信息。将
verification_id与每张发票一起存储，用于税务审计追踪。 - 电子商务 B2B 结账：根据已验证的增值税号应用正确的增值税处理（欧盟内部 B2B 交易使用反向征收，否则使用国内税率）。
- CRM 数据丰富：输入增值税号，获取法定公司名称和注册地址。自动清理潜在客户列表。
- 合规性监控：批量重新验证现有客户群。批量端点每个请求最多接受 100 个增值税号。
支持的国家/地区代码
AT, BE, BG, CY, CZ, DE, DK, EE, EL (Greece), ES, FI, FR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK, XI (Northern Ireland)
API 端点
- 验证：
POST https://eu-vat-validator-pro.p.rapidapi.com/api/validate - 批量验证：
POST https://eu-vat-validator-pro.p.rapidapi.com/api/validate/batch
错误代码
| 代码 | HTTP 状态码 | 含义 |
|---|---|---|
UNSUPPORTED_COUNTRY |
422 | 国家代码不在欧盟范围内 |
INVALID_VAT_FORMAT |
422 | 增值税号格式不符合预期 |
MS_MAX_CONCURRENT_REQ |
503 | 成员国注册系统正在限制速率（约 10 秒后重试） |
GLOBAL_MAX_CONCURRENT_REQ |
503 | VIES 过载（稍后重试） |
MS_UNAVAILABLE |
503 | 成员国注册系统暂时离线 |
SERVICE_UNAVAILABLE |
503 | VIES 本身已关闭 |
TIMEOUT |
503 | 上游请求超时 |
RATE_LIMITED |
429 | 请求过多 — 请遵守 Retry-After 响应头 |
快速开始示例
Javascript javascript const response = await fetch(https://eu-vat-validator-pro.p.rapidapi.com/api/v1/validate, { method: POST, headers: { Content-Type: application/json, X-RapidAPI-Key: YOUR_RAPIDAPI_KEY, X-RapidAPI-Host: eu-vat-validator-pro.p.rapidapi.com }, body: JSON.stringify({ vat_number: LU26375245 }) }); const data = await response.json(); console.log(data.company_name); // "AMAZON EUROPE CORE S.A R.L." console.log(data.verification_id); // 将此 UUID 与您的发票一起存储以备审计追踪
Python python import requests data = requests.post( https://eu-vat-validator-pro.p.rapidapi.com/api/v1/validate, headers={ X-RapidAPI-Key: YOUR_RAPIDAPI_KEY, X-RapidAPI-Host: eu-vat-validator-pro.p.rapidapi.com, }, json={vat_number: LU26375245} ).json() print(data)
Shell shell curl -X POST https://eu-vat-validator-pro.p.rapidapi.com/api/v1/validate -H "Content-Type: application/json" -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" -H "X-RapidAPI-Host: eu-vat-validator-pro.p.rapidapi.com" -d {"vat_number": "LU26375245"}
