> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 简介

> Cleariflow VAT 验证 API 通过简洁、现代化的 RESTful JSON 接口提供全面的税务合规解决方案——支持国内外业务的无缝验证与计算。

## 快速开始

<Card title="VAT 验证端点" icon="tag" href="vat/validate">
  验证 VAT 号码真实性，并获取包括国家、企业名称、地址和注册详情在内的全面公司信息。
</Card>

<Card title="VAT 计算端点" icon="tags" href="vat/calculate">
  根据各国特定法规、购买类型和交易金额计算符合 VAT 要求的定价，实现精确的财务计算。
</Card>

<Card title="VAT 类别端点" icon="globe" href="vat/categories">
  获取特定国家的当前 VAT 税率和税类，确保符合当地税务法规。
</Card>

### REST 架构

VAT 验证 API 遵循 REST 原则，采用可预测的资源导向 URL 和标准 HTTP 状态码，实现无缝集成和错误处理。所有 API 端点必须以斜杠 (/) 结尾，且仅支持 GET 请求。

### HTTPS 安全

所有 API 通信均使用 TLS 1.2 或更高版本的加密协议进行保护，确保数据完整性和隐私。

### API 版本控制

VAT 验证 API 通过版本控制保持向后兼容，当前运行在第 1 版，并计划未来增强。

### 身份验证

API 密钥是访问 VAT 验证 API 的唯一凭证。每个 Cleariflow 服务需要唯一的密钥，确保不同 API 之间的安全隔离访问。API 实施速率限制，确保所有用户的公平使用。

## 响应和错误代码

请求失败时，API 返回结构化的 JSON 错误响应，包含特定代码和描述，便于有效排查问题。

| Code | Type                  | Details                             |
| ---- | --------------------- | ----------------------------------- |
| 200  | OK                    | 一切按预期运行。                            |
| 400  | Bad request           | 错误请求。                               |
| 401  | Unauthorized          | 请求不可接受。通常由于 API 密钥缺失或不正确。           |
| 422  | Quota reached         | 由于 API 积分不足，请求被中止。（免费计划）            |
| 429  | Too many requests     | 由于达到每秒允许请求数，请求被中止。免费计划的请求限制为每秒 1 次。 |
| 500  | Internal server error | 由于服务器端错误，无法完成请求。                    |
| 503  | Service unavailable   | 服务器不可用。                             |

## 国家代码

以下是 VAT 端点支持的国家列表

| Country code | Country name |
| ------------ | ------------ |
| AT           | 奥地利          |
| BE           | 比利时          |
| BG           | 保加利亚         |
| CY           | 塞浦路斯         |
| CZ           | 捷克           |
| DE           | 德国           |
| DK           | 丹麦           |
| EE           | 爱沙尼亚         |
| FI           | 芬兰           |
| FR           | 法国           |
| GB           | 英国           |
| GR           | 希腊           |
| HR           | 克罗地亚         |
| HU           | 匈牙利          |
| IE           | 爱尔兰          |
| IT           | 意大利          |
| LT           | 立陶宛          |
| LU           | 卢森堡          |
| LV           | 拉脱维亚         |
| MT           | 马耳他          |
| NL           | 荷兰           |
| PL           | 波兰           |
| PT           | 葡萄牙          |
| RO           | 罗马尼亚         |
| SE           | 瑞典           |
| SI           | 斯洛文尼亚        |
| SK           | 斯洛伐克         |