更新价格规则

PUT 
/openapi/2025-06/price_rules/:price_rule_id

通过指定价格规则 ID 和新参数修改现有价格规则。

请求

Path参数

price_rule_id string必填

价格规则 ID

application/json

请求体

请求体必填

price_rule object必填
价格规则
titlestring
标题
valuefloat
值
value_typestring
值类型
usage_limitint32
使用次数上限，-1 表示无限制
allocation_limitint32
分配上限
once_per_customerint32
是否每位顾客只能使用一次
prerequisiteint32
前提条件
target_selectionstring
目标选择
target_typestring
目标类型
starts_atstring
开始时间
ends_atstring
结束时间
entitled_product_idsstring[]
授权商品 ID 列表
entitled_variant_idsstring[]
授权规格 ID 列表
entitled_collection_idsstring[]
授权集合 ID 列表
prerequisite_subtotal_range object[]
小计前提条件范围
Array [
greater_than_or_equal_tostring
指定价格须大于或等于的值
valuestring
值
value_percentagestring
百分比值
value_event_typestring
值事件类型
value_conditionstring
值条件
target_typestring
目标类型
target_datastring[]
目标数据
]
prerequisite_quantity_range object[]
数量前提条件范围
Array [
greater_than_or_equal_tostring
指定价格须大于或等于的值
valuestring
值
value_percentagestring
百分比值
value_event_typestring
值事件类型
value_conditionstring
值条件
target_typestring
目标类型
target_datastring[]
目标数据
]

示例

{
  "price_rule": {
    "title": "string",
    "value": 0,
    "value_type": "string",
    "usage_limit": 0,
    "allocation_limit": 0,
    "once_per_customer": 0,
    "prerequisite": 0,
    "target_selection": "string",
    "target_type": "string",
    "starts_at": "string",
    "ends_at": "string",
    "entitled_product_ids": [
      "string"
    ],
    "entitled_variant_ids": [
      "string"
    ],
    "entitled_collection_ids": [
      "string"
    ],
    "prerequisite_subtotal_range": [
      {
        "greater_than_or_equal_to": "string",
        "value": "string",
        "value_percentage": "string",
        "value_event_type": "string",
        "value_condition": "string",
        "target_type": "string",
        "target_data": [
          "string"
        ]
      }
    ],
    "prerequisite_quantity_range": [
      {
        "greater_than_or_equal_to": "string",
        "value": "string",
        "value_percentage": "string",
        "value_event_type": "string",
        "value_condition": "string",
        "target_type": "string",
        "target_data": [
          "string"
        ]
      }
    ]
  }
}

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object
price_rule object
价格规则
idstring
价格规则 ID
titlestring
标题
valuefloat
值
value_typestring
值类型
usage_limitint32
使用次数上限，-1 表示无限制
times_usedint32
已使用次数
allocation_methodstring
分配方式
allocation_limitint32
分配上限
allocation_limit_amountfloat
分配上限金额
once_per_customerint32
是否每位顾客只能使用一次
prerequisiteint32
前提条件
customer_selectionstring
顾客筛选条件
target_selectionstring
目标选择
target_typestring
目标类型
target_price_typestring
目标价格类型
created_atstring
创建时间，ISO-8601 格式
updated_atstring
最后更新时间，ISO-8601 格式
starts_atstring
开始时间
ends_atstring
结束时间
prerequisite_customer_idsstring[]
前提条件顾客 ID 列表
prerequisite_customer_segment_idsstring[]
顾客分组前提条件 ID 列表
entitled_product_idsstring[]
授权商品 ID 列表
entitled_variant_idsstring[]
授权规格 ID 列表
entitled_filter_idsstring[]
授权过滤 ID 列表
entitled_filter_liststring[]
授权过滤列表
variant_product_idsstring[]
规格所属商品 ID 列表
entitled_collection_idsstring[]
授权集合 ID 列表
entitled_area_list object[]
授权地区列表
Array [
country_codestring
国家代码（如 CN）
province_codesstring[]
省份代码列表
]
prerequisite_subtotal_range object[]
小计前提条件范围
Array [
greater_than_or_equal_tostring
大于或等于的值
valuestring
值
value_percentagestring
百分比值
value_event_typestring
值事件类型
value_conditionstring
值条件
target_typestring
目标类型
target_datastring[]
目标数据
]
prerequisite_quantity_range object[]
数量前提条件范围
Array [
greater_than_or_equal_tostring
大于或等于的值
valuestring
值
value_percentagestring
百分比值
value_event_typestring
值事件类型
value_conditionstring
值条件
target_typestring
目标类型
target_datastring[]
目标数据
]

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "price_rule": {
      "id": "string",
      "title": "string",
      "value": 0,
      "value_type": "string",
      "usage_limit": 0,
      "times_used": 0,
      "allocation_method": "string",
      "allocation_limit": 0,
      "allocation_limit_amount": 0,
      "once_per_customer": 0,
      "prerequisite": 0,
      "customer_selection": "string",
      "target_selection": "string",
      "target_type": "string",
      "target_price_type": "string",
      "created_at": "string",
      "updated_at": "string",
      "starts_at": "string",
      "ends_at": "string",
      "prerequisite_customer_ids": [
        "string"
      ],
      "prerequisite_customer_segment_ids": [
        "string"
      ],
      "entitled_product_ids": [
        "string"
      ],
      "entitled_variant_ids": [
        "string"
      ],
      "entitled_filter_ids": [
        "string"
      ],
      "entitled_filter_list": [
        "string"
      ],
      "variant_product_ids": [
        "string"
      ],
      "entitled_collection_ids": [
        "string"
      ],
      "entitled_area_list": [
        {
          "country_code": "string",
          "province_codes": [
            "string"
          ]
        }
      ],
      "prerequisite_subtotal_range": [
        {
          "greater_than_or_equal_to": "string",
          "value": "string",
          "value_percentage": "string",
          "value_event_type": "string",
          "value_condition": "string",
          "target_type": "string",
          "target_data": [
            "string"
          ]
        }
      ],
      "prerequisite_quantity_range": [
        {
          "greater_than_or_equal_to": "string",
          "value": "string",
          "value_percentage": "string",
          "value_event_type": "string",
          "value_condition": "string",
          "target_type": "string",
          "target_data": [
            "string"
          ]
        }
      ]
    }
  }
}