系统物流-配送方案-更新

接口信息

• 接口地址: {your-site-url}/api/skill/shipping/shipping-update-zone
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• Content-Type: application/json
• 说明: 此接口用于更新指定物流方案下的配送区域（Zone），属于全量更新。建议先通过 系统物流-配送方案-详情 获取当前配送区域数据，修改后提交

认证

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

请求参数 (JSON Body)

请求示例

type=1 按重量计费

curl --location --request POST '{your-site-url}/api/skill/shipping/shipping-update-zone' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
 "id": 100,
 "shipping_id": 51,
 "name": "亚洲",
 "type": 1,
 "countries": [
 {"country": "AU", "province": ["ACT", "NSW", "NT", "QLD", "SA", "TAS", "VIC", "WA"]}
 ],
 "price_based_shipping_rates": [],
 "weight_based_shipping_rates": [
 {"start": 0, "end": 1000, "amount": "3.96"},
 {"start": 1000, "end": 5000, "amount": "{weight} * 455 / 1000 + 24"}
 ],
 "qty_based_shipping_rates": {
 "is_free_shipping": 2,
 "fist_item": 0,
 "each_additional_item": 0,
 "is_over_qty_free_shipping": 2,
 "over_qty": 0
 }
}'

type=2 按价格区间计费

curl --location --request POST '{your-site-url}/api/skill/shipping/shipping-update-zone' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
 "id": 100,
 "shipping_id": 51,
 "name": "亚洲",
 "type": 2,
 "countries": [
 {"country": "AT", "province": []}
 ],
 "price_based_shipping_rates": [
 {"start": 0, "end": 100, "amount": "3.96"},
 {"start": 100, "end": 300, "amount": "{price} * 455 / 100 + 14"}
 ],
 "weight_based_shipping_rates": [],
 "qty_based_shipping_rates": {
 "is_free_shipping": 2,
 "fist_item": 0,
 "each_additional_item": 0,
 "is_over_qty_free_shipping": 2,
 "over_qty": 0
 }
}'

type=3 按数量计费（免运费）

curl --location --request POST '{your-site-url}/api/skill/shipping/shipping-update-zone' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
 "id": 100,
 "shipping_id": 51,
 "name": "亚洲",
 "type": 3,
 "countries": [
 {"country": "AT", "province": []}
 ],
 "price_based_shipping_rates": [],
 "weight_based_shipping_rates": [],
 "qty_based_shipping_rates": {
 "is_free_shipping": 1,
 "fist_item": 0,
 "each_additional_item": 0,
 "is_over_qty_free_shipping": 2,
 "over_qty": 0
 }
}'

type=3 按数量计费（不免运费）

curl --location --request POST '{your-site-url}/api/skill/shipping/shipping-update-zone' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
 "id": 100,
 "shipping_id": 51,
 "name": "亚洲",
 "type": 3,
 "countries": [
 {"country": "AT", "province": []}
 ],
 "price_based_shipping_rates": [],
 "weight_based_shipping_rates": [],
 "qty_based_shipping_rates": {
 "is_free_shipping": 2,
 "fist_item": 22,
 "each_additional_item": 11,
 "is_over_qty_free_shipping": 1,
 "over_qty": 4
 }
}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "id": 100,
        "shop_id": 15,
        "shipping_id": 51,
        "name": "亚洲",
        "type": 1,
        "countries": [ ... ],
        "weight_based_shipping_rates": [ ... ],
        "price_based_shipping_rates": [],
        "qty_based_shipping_rates": { ... },
        "created_at": "2026-06-01 09:12:38",
        "updated_at": "2026-06-01 10:27:59"
    },
    "message": "success"
}

返回字段说明

注意事项

1. id、shipping_id、name、type、countries 为必填
2. 全量更新：所有字段会覆盖原有数据，建议先通过 系统物流-配送方案-详情 获取当前配送区域数据，修改后提交
3. "country": "*" 兜底规则：country 填 "*" 表示"其他国家"，用于配置一个兜底配送区域。匹配优先级：系统先按具体国家简码（如 CN、US）匹配，匹配到则使用该 zone；若所有具体国家都不匹配，最终匹配 country: "*" 的配送区域。使用 "*" 时 province 传空数组 []。一个国家能被遍历全世界所有国家都配置一遍过于繁琐，用 * 作为兜底省时省力。
4. 一个国家和省份只能出现在一个配送区域中。更新前需调用 系统物流-配送方案-已配置的国家列表 获取已被占用的国家列表（传入 shipping_zone_id 可排除自身），已占用的国家和省份不可勾选。如果更新的国家/省份已被其他 zone 占用，将返回 code: 100501006
5. 计费类型与字段对应关系：
   • type=1：使用 weight_based_shipping_rates，price_based_shipping_rates 传空数组 []
   • type=2：使用 price_based_shipping_rates，weight_based_shipping_rates 传空数组 []
   • type=3：使用 qty_based_shipping_rates，weight_based_shipping_rates 和 price_based_shipping_rates 均传空数组 []
6. type=3 免运费时：is_free_shipping=1，fist_item 和 each_additional_item 传 0
7. type=3 不免运费时：is_free_shipping=2，fist_item 为首件运费，each_additional_item 为第 2 件起每件增加的费用
8. 国家简码和省份代码从 得到国家和省列表 获取
9. 重量区间和价格区间匹配规则均为 左闭右开：start <= 值 < end（即 >= start 且 < end）
10. type=3 满件免运费规则：当 is_over_qty_free_shipping=1 且商品总数量 >= over_qty 时免运费