跳转到主要内容
GET
/
v1
/
categories
VAT 类别端点
curl --request GET \
  --url https://vat.cleariflow.com/v1/categories/
[
    {
        "category": "some agricultural inputs",
        "country_code": "DE",
        "description": "Reduced VAT rate (some agricultural inputs)",
        "rate": "0.070"
    },
    {
        "category": "taxation of some gold coins and jewellery",
        "country_code": "DE",
        "description": "Reduced VAT rate (taxation of some gold coins and jewellery)",
        "rate": "0.070"
    },
    {
        "category": "cut flowers and plants for decorative use and food production",
        "country_code": "DE",
        "description": "Reduced VAT rate (cut flowers and plants for decorative use and food production)",
        "rate": "0.070"
    },
    {
        "category": "e-books",
        "country_code": "DE",
        "description": "Reduced VAT rate (e-books)",
        "rate": "0.070"
    },

    ..................

    {
        "category": "standard",
        "country_code": "DE",
        "description": "Standard VAT rate",
        "rate": "0.190"
    },
    {
        "category": "newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising)",
        "country_code": "DE",
        "description": "Reduced VAT rate (newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising))",
        "rate": "0.070"
    },
    {
        "category": "some timber for industrial use",
        "country_code": "DE",
        "description": "Reduced VAT rate (some timber for industrial use)",
        "rate": "0.070"
    }
]

​
快速开始

​
基础 URL

https://vat.cleariflow.com/v1/categories/

​
类别端点

categories 端点需要您的唯一 API 密钥和要检查的国家： 
https://vat.cleariflow.com/v1/categories/
? api_key = YOUR_UNIQUE_API_KEY
& country_code = DE
此成功请求返回全面的 VAT 税率信息，包括标准税率及其关联类别的优惠税率： 
[
    {
        "category": "some agricultural inputs",
        "country_code": "DE",
        "description": "Reduced VAT rate (some agricultural inputs)",
        "rate": "0.070"
    },
    {
        "category": "taxation of some gold coins and jewellery",
        "country_code": "DE",
        "description": "Reduced VAT rate (taxation of some gold coins and jewellery)",
        "rate": "0.070"
    },
    {
        "category": "cut flowers and plants for decorative use and food production",
        "country_code": "DE",
        "description": "Reduced VAT rate (cut flowers and plants for decorative use and food production)",
        "rate": "0.070"
    },
    {
        "category": "e-books",
        "country_code": "DE",
        "description": "Reduced VAT rate (e-books)",
        "rate": "0.070"
    },

    ..................

    {
        "category": "standard",
        "country_code": "DE",
        "description": "Standard VAT rate",
        "rate": "0.190"
    },
    {
        "category": "newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising)",
        "country_code": "DE",
        "description": "Reduced VAT rate (newspapers and periodicals (except those containing content harmful to minors and/or more than 50% advertising))",
        "rate": "0.070"
    },
    {
        "category": "some timber for industrial use",
        "country_code": "DE",
        "description": "Reduced VAT rate (some timber for industrial use)",
        "rate": "0.070"
    }
]

​
请求参数

​
api_key
String
必填
您的唯一 API 密钥。请注意，每个用户为每个 Cleariflow API 拥有独立的 API 密钥，因此您的 VAT 验证 API 密钥无法用于 IP 地理定位 API，例如。
​
country_code
String
必填
您要检索 VAT 类别的国家的两字母 ISO 3166-1 alpha-2 代码。

​
响应参数

API 响应以通用、轻量的 JSON 格式 返回。 响应是类别对象数组，每个对象包含：
​
country_code
String
返回类别所在国家的两字母 ISO 3166-1 alpha-2 代码。
​
rate
String
此类别的 VAT 税率，以小数字符串表示（例如 “0.190” 表示 19%）。
​
category
String
类别名称（例如 “standard”、“e-books”、“audiobooks”）。
​
description
String
关于类别及其适用性的描述。