税率 - Curosa

概览

税率 (Tax Rates) 接口允许您检索 Curosa 平台中配置的所有可用税率列表。税率用于根据客户的位置（国家以及可选的州/省）计算产品和订单的相应税额。每个税率都与特定的地理区域相关联，并包含要应用的百分比率。

身份验证

此接口需要身份验证。请在 Authorization 请求头中包含您的 API 密钥。有关获取 API 密钥的更多信息，请参阅身份验证指南。

获取所有税率

检索所有可用税率的列表。

请求

curl -X GET "https://api.curosa.com/v1/tax-rates" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应

所有响应均以 JSON 格式返回：

{
    "data": [
        {
            "id": 1,
            "name": "Standard Rates",
            "rate": "20.00",
            "country_code": "GB",
            "state_code": null,
            "display_name": "Standard Rates (20%)"
        }
    ]
}

响应字段：

id (integer): 税率的唯一标识符
name (string): 税率名称（例如，“Standard Rates”、“Reduced Rate”）
rate (string): 以字符串形式表示的小数税率百分比（例如，“20.00”代表 20%）
country_code (string): 该税率适用的 ISO 国家代码（例如，“GB”代表英国，“US”代表美国）
state_code (string|null): 该税率适用的州或省代码（如果适用）。null 表示该税率适用于整个国家
display_name (string): 结合了税率名称和百分比的格式化显示名称（例如，“Standard Rates (20%)”）

使用税率

系统会根据客户的收货地址自动将税率应用于产品和订单。在创建或更新产品时，如果您需要指定特定的税率，可以通过其 id 进行引用。系统在处理订单时将根据客户的位置使用相应的税率。

税率可以是针对国家级的（当 state_code 为 null 时），也可以是针对州/省级的（当提供了 state_code 时）。在适用时，特定州的税率优先于全国范围的税率。