POST AI agent ready /v1/validate/vat

增值税号验证 API - 免费欧盟增值税检查

提交增值税号并接收返回值是否符合所在国家/地区的预期格式。支持所有欧盟成员国。对于 B2B 发票、免税结帐流程和合规性检查很有用。增值税号在服务器端处理并且从不存储。

Endpoint

curl -X POST https://api.botoi.com/v1/validate/vat \
  -H "Content-Type: application/json" \
  -d '{"vat_number":"DE123456789"}'

When to use this API

在结帐时应用零税率增值税豁免之前，请验证买家的增值税 ID。这可以防止您开具不正确的发票以及在税务审计期间免受潜在的处罚。

从增值税 ID 中提取国家/地区代码，以自动为每个欧盟成员国应用正确的增值税税率、发票语言和报告要求。

定期通过端点运行您的客户数据库。标记具有无效或过期增值税 ID 的帐户，以便您的财务团队可以在下一个发票周期之前请求更新文档。

支持哪些国家？

所有 27 个欧盟成员国。每个国家/地区都有自己的增值税号格式（例如，德国为 DE + 9 位数字，法国为 FR + 11 个字符）。 API 根据检测到的国家/地区的正确模式进行验证。

此 API 是否根据 VIES 数据库检查增值税号？

该端点验证增值税号的格式和结构。如需实时 VIES（欧盟委员会）查询以确认注册状态，请将其与官方 VIES SOAP 服务配对。

验证后是否存储增值税号？

不会。该号码在内存中进行处理，并在响应后被丢弃。没有数据写入磁盘或任何外部系统。

我可以验证英国增值税号码吗？

英国增值税号（GB 前缀）遵循已知格式，并且可以在结构上进行验证。由于英国离开欧盟，它们不再是 VIES 的一部分，但格式检查仍然有效。

如果我发送不带国家/地区前缀的号码会怎样？

API 需要两个字母的国家/地区前缀（例如“DE”、“FR”、“NL”）。如果没有它，响应将返回 valid: false 并说明缺少国家/地区代码的原因。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.