系统-基础税费-详细
基础税费 - 获取国家的税率详情
接口信息
- 接口地址:
{your-site-url}/api/skill/tax/get-base-tax-info - 基础 URL:
{your-site-url}需替换为你自己的独立站 URL 地址，如https://your-domain.com/apimanager666 - 请求方式:
GET - 说明: 此接口用于获取某个国家税费配置的详细信息，包括该国家的默认税率以及各个省/州的独立税率。每个国家可能对不同的省/州设置不同的税率
认证
请求头中需要携带 skill-access-token：
| Header | 值 |
|---|---|
skill-access-token |
{your-skill-access-token} （请替换为你自己的 token） |
请求参数 (Query String)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
tax_base_id |
int | ✅ 必填 | 基础税费记录 ID，从 系统-基础税费-列表 返回值中的 id 获取 |
请求示例
cURL
curl --location --request GET '{your-site-url}/api/skill/tax/get-base-info?tax_base_id=13' \
--header 'skill-access-token: {your-skill-access-token}'
返回结果
code 为 200 表示调用成功；code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"list": [
{
"id": 49,
"shop_id": 15,
"tax_base_id": 13,
"type": 1,
"country_code": "US",
"state_code": "",
"tax": "8.00",
"created_at": "2024-01-26 03:35:31",
"updated_at": "2026-06-01 13:29:04"
},
{
"id": 326,
"shop_id": 15,
"tax_base_id": 13,
"type": 2,
"country_code": "US",
"state_code": "AL",
"tax": "6.34",
"created_at": "2026-06-01 13:22:35",
"updated_at": "2026-06-01 13:29:04"
},
{
"id": 327,
"shop_id": 15,
"tax_base_id": 13,
"type": 2,
"country_code": "US",
"state_code": "AK",
"tax": "5.34",
"created_at": "2026-06-01 13:22:35",
"updated_at": "2026-06-01 13:29:04"
}
]
},
"message": "success"
}
返回字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code |
Number | 状态码，200 表示成功 |
message |
String | 执行结果的文字描述 |
data.list |
Array[Object] | 该国税率详情列表。第一行为全国默认税率，后续行为各州的税率 |
data.list[].id |
int | 记录 ID |
data.list[].shop_id |
int | 店铺 ID |
data.list[].tax_base_id |
int | 所属基础税费记录 ID |
data.list[].type |
int | 类型。1 = 国家默认税率，2 = 州税率 |
data.list[].country_code |
string | 国家简码 |
data.list[].state_code |
string | 省/州简码。type=1 时为空字符串 |
data.list[].tax |
string | 税率值 |
data.list[].created_at |
string | 创建时间 |
data.list[].updated_at |
string | 最后更新时间 |
注意事项
tax_base_id必填，从 系统-基础税费-列表 返回值中的id获取- 返回的
list中，type=1表示该国家的默认税率（state_code为空）；type=2表示某个州的独立税率 - 未单独设置税率的州将使用
type=1的国家默认税率