系统-自定义税费-国家税费-列表

税费 - 获取自定义税费方案的国家税率列表

接口信息

• 接口地址: {your-site-url}/api/skill/tax/get-custom-tax-country-taxs
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: GET
• 说明: 此接口用于获取指定自定义税费方案已配置的国家/省税率列表

认证

请求头中需要携带 skill-access-token：

请求参数 (Query String)

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/tax/get-custom-country-tax-list?tax_custom_id=20' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "tax_list": [
            {
                "id": 80,
                "shop_id": 15,
                "tax_custom_id": 20,
                "type": 1,
                "country_code": "GB",
                "state_code": "",
                "tax": "2.60",
                "created_at": "2026-06-01 15:54:55",
                "updated_at": "2026-06-01 15:59:19"
            },
            {
                "id": 81,
                "shop_id": 15,
                "tax_custom_id": 20,
                "type": 1,
                "country_code": "US",
                "state_code": "",
                "tax": "2.90",
                "created_at": "2026-06-01 15:54:55",
                "updated_at": "2026-06-01 15:59:19"
            },
            {
                "id": 82,
                "shop_id": 15,
                "tax_custom_id": 20,
                "type": 2,
                "country_code": "US",
                "state_code": "AS",
                "tax": "2.34",
                "created_at": "2026-06-01 15:54:55",
                "updated_at": "2026-06-01 15:59:19"
            }
        ]
    },
    "message": "success"
}

返回字段说明

注意事项

1. tax_custom_id 必填，pageNum 和 pageSize 选填（分页用）
2. type=1 表示国家默认税率（state_code 为空），type=2 表示省/州级别税率