**版本：202601**

# 创建运费区域

**POST** `/openapi/2026-01/shipping-schemas/shipping-zone`

创建新的运费区域。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `shipping` object

  配送信息

  - `schema_id` string (required)

    物流方案 ID
  - `name` string (required)

    名称
  - `support_cod` int32

    是否支持货到付款（COD）
  - `plans` object[]

    套餐列表

    *   Array \[

    - `name` string (required)

      运费方案名称
    - `desc` string

      运费方案描述
    - `rule_type` string

      区间规则条件匹配类型：

      *   `price`: 整单订单价格条件
      *   `quantity`: 分组数量条件
      *   `weight`: 分组重量条件
      *   `pass`: 无匹配条件
    - `rule_range_min` string

      满足条件的最小值
    - `rule_range_max` string

      满足条件的最大值
    - `rule_range_infinite` int32

      用于标记最大值的无限大
    - `rule_range_unit` string

      存储单位：如重量单位 "kg", 数量单位 "件", 价格单位 "币种"
    - `rate_type` string

      计费方式：

      *   `normal`: 固定运费
      *   `weight`: 首重续重
      *   `percent`: 百分比计费
      *   `third`: 第三方计费
    - `rate_amount` string

      计费方式数据
    - `rate_first_range` string

      首重值
    - `rate_first_unit` string

      首重单位
    - `rate_additional_amount` string

      每份续重值
    - `rate_additional_unit` string

      续重值单位
    - `rate_additional_range` string

      续重值
    - `plan_type` int32

      方案类型：

      *   `1`: 自定义
      *   `2`: 第三方
    - `plan_type_value` string

      方案类型相关规则值
    - `rule_type_scope` int32

      区间规则适用范围:

      *   `1`: 订单
      *   `2`: 分组
      *   `3`: 其他
    *   \]
  - `areas` object[]

    地区列表

    *   Array \[

    - `country_name` string (required)

      国家名称
    - `country_code` string (required)

      国家码
    - `province_codes` string[]

      省份代码列表
    *   \]

```json
{
  "shipping": {
    "schema_id": "string",
    "name": "string",
    "support_cod": 0,
    "plans": [
      {
        "name": "string",
        "desc": "string",
        "rule_type": "string",
        "rule_range_min": "string",
        "rule_range_max": "string",
        "rule_range_infinite": 0,
        "rule_range_unit": "string",
        "rate_type": "string",
        "rate_amount": "string",
        "rate_first_range": "string",
        "rate_first_unit": "string",
        "rate_additional_amount": "string",
        "rate_additional_unit": "string",
        "rate_additional_range": "string",
        "plan_type": 0,
        "plan_type_value": "string",
        "rule_type_scope": 0
      }
    ],
    "areas": [
      {
        "country_name": "string",
        "country_code": "string",
        "province_codes": [
          "string"
        ]
      }
    ]
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `shipping` object

    配送信息

    - `id` string

      配送 ID
    - `name` string

      名称
    - `schema_id` string

      Schema ID
    - `support_cod` int32

      是否支持货到付款（COD）
    - `plans` object[]

      套餐列表

      *   Array \[

      - `id` string

        运费方案 ID
      - `shipping_id` string

        区域方案 ID
      - `name` string

        运费方案名称
      - `desc` string

        运费方案描述
      - `support_cod` int32

        是否支持COD：

        *   `1`: 支持
        *   `0`: 不支持
      - `rule_type` string

        区间规则条件匹配类型：

        *   `price`: 整单订单价格条件
        *   `quantity`: 分组数量条件
        *   `weight`: 分组重量条件
        *   `pass`: 无匹配条件
      - `rule_range_min` string

        满足条件的最小值
      - `rule_range_max` string

        满足条件的最大值
      - `rule_range_infinite` int32

        用于标记最大值的无限大
      - `rule_range_unit` string

        存储单位：如重量单位 "kg", 数量单位 "件", 价格单位 "币种"
      - `rate_type` string

        计费方式：

        *   `normal`: 固定运费
        *   `weight`: 首重续重
        *   `percent`: 百分比计费
        *   `third`: 第三方计费
      - `rate_amount` string

        计费方式数据分别对应：固定运费值、首重运费值、百分比值、空
      - `rate_first_range` string

        首重值
      - `rate_first_unit` string

        首重单位
      - `rate_additional_amount` string

        每份续重值
      - `rate_additional_unit` string

        续重值单位
      - `rate_additional_range` string

        续重值
      - `store_id` string

        店铺 ID
      - `created_time` string

        创建时间
      - `updated_time` string

        更新时间
      - `plan_type` int32

        方案类型：

        *   `1`: 自定义
        *   `2`: 第三方
      - `plan_type_value` string

        方案类型相关规则值
      - `rule_type_scope` int32

        区间规则适用范围:

        *   `1`: 订单
        *   `2`: 分组
        *   `3`: 其他
      *   \]
    - `areas` object[]

      地区列表

      *   Array \[

      - `shipping_id` string

        区域方案 ID
      - `country_name` string

        国家名称
      - `country_code` string

        国家码
      - `province_codes` string[]

        省份代码列表
      *   \]

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "shipping": {
      "id": "string",
      "name": "string",
      "schema_id": "string",
      "support_cod": 0,
      "plans": [
        {
          "id": "string",
          "shipping_id": "string",
          "name": "string",
          "desc": "string",
          "support_cod": 0,
          "rule_type": "string",
          "rule_range_min": "string",
          "rule_range_max": "string",
          "rule_range_infinite": 0,
          "rule_range_unit": "string",
          "rate_type": "string",
          "rate_amount": "string",
          "rate_first_range": "string",
          "rate_first_unit": "string",
          "rate_additional_amount": "string",
          "rate_additional_unit": "string",
          "rate_additional_range": "string",
          "store_id": "string",
          "created_time": "string",
          "updated_time": "string",
          "plan_type": 0,
          "plan_type_value": "string",
          "rule_type_scope": 0
        }
      ],
      "areas": [
        {
          "shipping_id": "string",
          "country_name": "string",
          "country_code": "string",
          "province_codes": [
            "string"
          ]
        }
      ]
    }
  }
}
```