税率 - Curosa

概览

税率端点返回在 Curosa 平台上为您的账户配置的所有税率。在创建或更新产品时，需要引用税率 ID，以便将正确的税率与产品的站点定价相关联。

身份验证

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

列出所有税率

获取您账户可用的所有税率列表。

端点： GET https://curosa.com/api/v1/tax-rates

请求

curl --location 'https://curosa.com/api/v1/tax-rates' \
--header 'Authorization: Bearer YOUR_API_TOKEN'

响应

返回 200 OK 以及包含所有可用税率的 data 数组：

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

响应字段：

字段	类型	描述
`id`	integer	税率的唯一标识符。在其他 API 调用中引用税率时使用
`name`	string	税率名称（例如 `"Standard Rate"`）
`rate`	string	以十进制字符串表示的税率百分比（例如 `"20.00"` 代表 20%）
`country_code`	string	此税率适用的 ISO 3166-1 alpha-2 国家代码（例如 `"GB"`）
`state_code`	string\|null	州或省份代码（如果该税率特定于某个地区）。`null` 表示该税率适用于整个国家
`display_name`	string	结合了名称和百分比的格式化标签（例如 `"Standard Rate (20%)"`）

使用税率 ID

在设置产品的站点定价时，通过其 id 引用税率：

{
    "site_pricing": [
        {
            "site_code": "UK",
            "price": "50.00",
            "price_currency": "GBP",
            "tax_rate_id": 1
        }
    ]
}

速率限制

此端点的速率限制为每小时 3,600 次请求。当前限制和剩余请求数会在响应头中通过 x-ratelimit-limit 和 x-ratelimit-remaining 返回。