系统-基础税费-列表
基础税费 - 获取国家税率列表
接口信息
- 接口地址:
{your-site-url}/api/skill/tax/get-base-tax-list - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
GET - 说明: 此接口用于获取店铺已配置的所有国家基础税费（税率）列表（每个国家可设置不同的税率，部分国家可对省/州单独设置税率）
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数
无请求参数。
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/tax/get-base-list' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"list": [
{
"id": 12,
"shop_id": 15,
"country_code": "CN",
"country_state_count": 31,
"status": 1,
"min_tax": "4.00",
"max_tax": "8.00",
"created_at": "2023-05-02 11:24:35",
"updated_at": "2025-08-21 23:07:40"
},
{
"id": 8,
"shop_id": 15,
"country_code": "AF",
"country_state_count": 0,
"status": 2,
"min_tax": "3.00",
"max_tax": "3.00",
"created_at": "2023-05-02 09:25:31",
"updated_at": "2026-06-01 11:31:24"
}
]
},
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data.list |
Array[Object] | 国家税率列表 |
data.list[].id |
int | 记录 ID |
data.list[].shop_id |
int | 店铺 ID |
data.list[].country_code |
string | 国家简码 |
data.list[].country_state_count |
int | 该国家下设置了独立税率的省/州个数 |
data.list[].status |
int | 状态。1 = 开启，2 = 关闭 |
data.list[].min_tax |
string | 最小税率。当不同省/州设置了不同税率时，取最小值 |
data.list[].max_tax |
string | 最大税率。当不同省/州设置了不同税率时，取最大值 |
data.list[].created_at |
string | 创建时间 |
data.list[].updated_at |
string | 最后更新时间 |
注意事项
- 无请求参数，直接返回所有已配置的国家税率列表
- 当某国家未对不同省/州设置独立税率时，
min_tax和max_tax值相同，为全国统一税率 - 当
country_state_count > 0时，表示该国家下有省/州设置了不同的税率，可进一步查询省/州级别税率 status=2表示该国家的税费方案已关闭