保存通用物流配置

POST 
/openapi/2025-06/shipping-schemas/general

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

请求

application/json

请求体

请求体必填

shipping_schemas object
运费方案列表
idstring
物流方案 ID，存在更新，不存在创建
namestring必填
名称
shippings object[]
区域方案
Array [
idstring
ID，存在更新，不存在创建
namestring必填
名称
support_codint32
是否支持货到付款（COD）：
• 1: 支持
• 0: 不支持
plans object[]
套餐列表
Array [
idstring
区域方案 ID， 存在更新，不存在创建
namestring必填
运费方案名称
descstring
运费方案描述
rule_typestring
区间规则条件匹配类型：
• price: 整单订单价格条件
• quantity: 分组数量条件
• weight: 分组重量条件
• pass: 无匹配条件
rule_range_minstring
满足条件的最小值
rule_range_maxstring
满足条件的最大值
rule_range_infiniteint32
用于标记最大值的无限大
rule_range_unitstring
存储单位：如重量单位 "kg", 数量单位 "件", 价格单位 "币种"
rate_typestring
计费方式：
• normal: 固定运费
• weight: 首重续重
• percent: 百分比计费
• third: 第三方计费
rate_amountstring
计费方式数据，分别对应：固定运费值、首重运费值、百分比值、空
rate_first_rangestring
首重值
rate_first_unitstring
首重单位
rate_additional_amountstring
每份续重值
rate_additional_unitstring
续重值单位
rate_additional_rangestring
续重值
plan_typeint32
方案类型：
• 1: 自定义
• 2: 第三方
plan_type_valuestring
方案类型相关规则值
rule_type_scopeint32
区间规则适用范围:
• 1: 订单
• 2: 分组
• 3: 其他
]
areas object[]
地区列表
Array [
country_namestring必填
国家名称
country_codestring必填
国家码
province_codesstring[]
省份代码列表
]
]

示例

{
  "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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
shipping_schemas object
运费方案列表
idstring
物流方案 ID
namestring
名称
schema_typeint32
方案类型：
• 0: 通用
• 1: 自定义
variant_numint32
规格数量
shippings object[]
区域方案
Array [
idstring
配送 ID
namestring
名称
schema_idstring
Schema ID
support_codint32
是否支持货到付款（COD）
plans object[]
套餐列表
Array [
idstring
运费方案 ID
shipping_idstring
区域方案 ID
namestring
运费方案名称
descstring
运费方案描述
support_codint32
是否支持COD：
• 1: 支持
• 0: 不支持
rule_typestring
区间规则条件匹配类型：
• price: 整单订单价格条件
• quantity: 分组数量条件
• weight: 分组重量条件
• pass: 无匹配条件
rule_range_minstring
满足条件的最小值
rule_range_maxstring
满足条件的最大值
rule_range_infiniteint32
用于标记最大值的无限大
rule_range_unitstring
存储单位：如重量单位 "kg", 数量单位 "件", 价格单位 "币种"
rate_typestring
计费方式：
• normal: 固定运费
• weight: 首重续重
• percent: 百分比计费
• third: 第三方计费
rate_amountstring
计费方式数据分别对应：固定运费值、首重运费值、百分比值、空
rate_first_rangestring
首重值
rate_first_unitstring
首重单位
rate_additional_amountstring
每份续重值
rate_additional_unitstring
续重值单位
rate_additional_rangestring
续重值
store_idstring
店铺 ID
created_timestring
创建时间
updated_timestring
更新时间
plan_typeint32
方案类型：
• 1: 自定义
• 2: 第三方
plan_type_valuestring
方案类型相关规则值
rule_type_scopeint32
区间规则适用范围:
• 1: 订单
• 2: 分组
• 3: 其他
]
areas object[]
地区列表
Array [
shipping_idstring
区域方案 ID
country_namestring
国家名称
country_codestring
国家码
province_codesstring[]
省份代码列表
]
]

示例

{
  "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"
              ]
            }
          ]
        }
      ]
    }
  }
}