VIES VAT Validator

The reliable, developer-friendly bridge to the EU VIES system.

面向欧盟VIES系统（EU VIES system）的可靠且开发者友好的对接桥梁

原始信息汇总

VIES VAT Validator 数据集概述

数据集基本信息

• 数据集名称: VIES VAT Validator
• 所属类别: Finance
• 数据集提供者: wrAPI
• 数据集地址: https://rapidapi.com/apimagikteam/api/vies-vat-validator
• API 基础 URL: https://vies-vat-validator.p.rapidapi.com

数据集描述

VIES VAT Validator 提供了一个现代、高性能的 REST API 层，覆盖官方的欧盟 VIES（增值税信息交换系统）注册表，专为 B2B SaaS、电子商务和发票平台设计，用于验证欧洲增值税号。

核心优势

• 快速响应: 通过智能边缘缓存，响应时间 <50毫秒。
• JSON 原生: 提供干净、结构化的 JSON 数据，无需解析复杂的 XML。
• 高可用性: 当官方 VIES 服务器离线时，系统提供最新的缓存数据。
• 抗节流: 管理 IP 轮换和请求队列，避免被欧盟服务器阻止或限速。
• 边缘驱动: 基于 Cloudflare Workers 构建，实现全球低延迟性能。

主要功能

• 实时验证: 针对最新的欧盟成员国数据库进行即时检查。
• 公司详情: 检索官方公司名称和注册地址（如可用）。
• 智能缓存: 由 Upstash Redis 提供支持，确保最大速度和成本效益。
• 简化集成: RESTful 架构，适用于任何编程语言。

端点详情

1. 检查增值税（基本验证）

• 端点: GET /validate-vat
• 描述: 根据欧盟 VIES 数据库验证增值税号。此端点执行基本的增值税号验证，不包含交易者信息。
• 必需查询参数:
  • countryCode: 2字母 ISO 国家代码（例如 DE, IT, FR）。
  • vatNumber: 不带国家前缀的增值税号（例如 1234567890）。
• 响应字段:
  • countryCode: 请求中使用的 ISO 国家代码。
  • vatNumber: 已验证的增值税号。
  • requestDate: 查询 VIES 数据库的 ISO 8601 时间戳。
  • valid: 增值税号在 VIES 系统中是否注册且有效。
  • name: 注册公司名称（仅在有效且可用时提供）。
  • address: 注册营业地址（仅在有效且可用时提供）。

2. 检查增值税近似值（高级验证）

• 端点: GET /validate-vat-approx
• 描述: 使用交易者信息进行近似匹配，执行高级增值税验证。此端点允许您验证增值税号以及公司详细信息（如名称、地址、邮政编码和城市），以获得更准确的验证。
• 必需查询参数:
  • countryCode: 2字母 ISO 国家代码。
  • vatNumber: 不带国家前缀的增值税号。
• 可选查询参数:
  • traderName: 用于近似匹配的公司名称。
  • traderStreet: 用于近似匹配的街道地址。
  • traderPostalCode: 用于近似匹配的邮政编码。
  • traderCity: 用于近似匹配的城市。
  • requesterCountryCode: 请求者（您的公司）的国家代码。
  • requesterVatNumber: 请求者（您的公司）的增值税号。
• 响应字段:
  • countryCode: 请求中使用的 ISO 国家代码。
  • vatNumber: 已验证的增值税号。
  • requestDate: 查询 VIES 数据库的 ISO 8601 时间戳。
  • valid: 增值税号在 VIES 系统中是否注册且有效。
  • traderName: VIES 中的注册交易者/公司名称（如可用）。
  • traderStreet: VIES 中的注册街道地址（如可用）。
  • traderPostalCode: VIES 中的注册邮政编码（如可用）。
  • traderCity: VIES 中的注册城市（如可用）。

3. 健康检查端点

• 端点: GET /health
• 描述: 简单的健康检查端点，无需身份验证。
• 响应示例: { "status": "healthy" }

身份验证

所有端点都需要通过 X-RapidAPI-Key 请求头进行 RapidAPI 身份验证。

错误处理

所有错误响应均遵循以下格式： json { "error": "错误描述" }

订阅计划

• BASIC: $0.00 / 月
• PRO: $10.00 / 月
• ULTRA: $50.00 / 月
• MEGA: $200.00 / 月