**版本：202601**

# 保存通用物流配置

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

创建或修改通用运费模板配置。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `shipping_schemas` object

  运费方案列表

  - `id` string

    物流方案 ID，存在更新，不存在创建
  - `name` string (required)

    名称
  - `shippings` object[]

    区域方案

    *   Array \[

    - `id` string

      ID，存在更新，不存在创建
    - `name` string (required)

      名称
    - `support_cod` int32

      是否支持货到付款（COD）：

      *   `1`: 支持
      *   `0`: 不支持
    - `plans` object[]

      套餐列表

      *   Array \[

      - `id` string

        区域方案 ID， 存在更新，不存在创建
      - `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_schemas": {
    "id": "string",
    "name": "string",
    "shippings": [
      {
        "id": "string",
        "name": "string",
        "support_cod": 0,
        "plans": [
          {
            "id": "string",
            "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_schemas` object

    运费方案列表

    - `id` string

      物流方案 ID
    - `name` string

      名称
    - `schema_type` int32

      方案类型：

      *   `0`: 通用
      *   `1`: 自定义
    - `variant_num` int32

      规格数量
    - `shippings` object[]

      区域方案

      *   Array \[

      - `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_schemas": {
      "id": "string",
      "name": "string",
      "schema_type": 0,
      "variant_num": 0,
      "shippings": [
        {
          "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"
              ]
            }
          ]
        }
      ]
    }
  }
}
```