预售券价量态-更新预售商品价库及属性
接口说明
商家在来客后台创建商品成功后,通过接口调整预售券的价格库存信息
基本信息
名称 | 描述 |
HTTP URL | |
HTTP Method | POST |
Scope | life.capacity.trip_travel_presale_ari_operate |
权限要求 | 需申请酒旅旅行社-预售券价量态操作 |
请求头
名称 | 类型 | 必填 | 描述 |
content-type | string | 是 | 固定值 "application/json" |
access-token | string | 是 | 调用 /oauth/client_token/生成的 token,此 token 不需要用户授权。示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1****** |
请求参数
Body
接口入参 | | |||
参数 | 名称 | 是否必填 | 参数类型 | 备注 |
product_id | 抖音平台商品ID | 是 | string | |
account_id | 商家ID | 是 | string | 商家在抖音平台的id |
origin_amount | 预售商品原价 | 否 | int | 划线价格 |
actual_amount | 预售商品实际支付价格 | 否 | int | 实际支付价格 |
marketing_amount | 预售商品营销最低价 | 否 | int | 营销时改价不可低于该价格 |
stock_qty_limit_type | 预售商品是否无限库存 | 否 | int | 1 限制库存,2不限库存 |
total_stock_qty | 预售商品库存数量 | 否 | int | 总库存(库存数量需大于等于下单已支付和下单未支付的库存总量) |
user_add_price_rule | 增加出行人加价 | 否 | struct(见于OnlineAddPriceStruct) | 1. 当前C端展示规则:各种加价规则有重叠的时候,会取最大值。如一个时间段加价规则内也有有节假日加价,取最大加价值 2.增加出行人加价必须区分不同人群的加价金额 |
date_add_price_rule | 热门日期加价 | 否 | struct(见于OnlineAddPriceStruct) | 当前C端展示规则:各种加价规则有重叠的时候,会取最大值。如一个时间段加价规则内也有有节假日加价,取最大加价值 |
room_add_price_rule | 单房差加价 | 否 | struct(见于OnlineAddPriceStruct) | 当前C端展示规则:各种加价规则加价有重叠的时候,会取最大值。如一个时间段加价规则内也有有节假日加价,取最大加价值 |
children_definition | 儿童定义 | 否 | struct 见于CrowdDefinitionStruct | 日历库存加价结构体中有儿童出行人加价,并且需要覆盖之前的儿童定义,则填。原商品内有增加出行人加价属性或本次新增增加出行人加价时才可更新儿童定义 |
结构体
结构体:CrowdDefinitionStruct | | |||
参数 | 名称 | 是否必填 | 参数类型 | 备注 |
-min_age | 年龄下限 | 是 | int | 周岁 |
-max_age | 年龄上限 | 否 | int | 周岁 |
-min_height | 身高下限 | 否 | int | cm |
-max_height | 身高上限 | 否 | int | cm |
结构体:OnlineAddPriceStruct | | |||
参数 | 名称 | 是否必填 | 参数类型 | 备注 |
add_price_rule_list | 加价规则列表 | 否 | list<struct> | 结构体见下:AddPriceStruct |
enable | 是否开启加价 | 否 | bool | true代表有 加价规则,false则无 |
结构体:AddPriceStruct | | |||
参数 | 名称 | 是否必填 | 参数类型 | 备注 |
-date_type | 按日期还是节假日加价 | 是 | int | 1日期、2节假日 |
-price | 加价金额(当不区分成人或儿童加价时) | 是 | int | 单位分。单房差加价、热门日期加价时使用 |
-child_price | 儿童加价 | 否 | int | 单位分。增加出行人加价时使用。有儿童加价时必须要有儿童定义 |
-adult_price | 成人加价 | 否 | int | 单位分。增加出行人加价时使用。 |
-start_date | 开始日期 | 是 | string | 格式:2023-12-11 |
-end_date | 结束日期 | 是 | string | 格式:2023-12-11 |
-days_of_week | 适用于周几 | 是 | list<int> | 当date_type为1时必填。 周一:1、 周二:2、周三:3、周四:4、周五:5、周六:6、周日:7 |
-holidays | 节假日 | 否 | list<int> | 当data_type为2时必填。 具体日期以抖音侧为准 1:元旦 、2 :春节 3 :清明、 4:劳动节 5: 端午节、6:中秋节 7:国庆节(生效的时间范围说明) |
响应参数
接口出参 | | |||
参数信息 | 名称 | 是否必填 | 参数类型 | 备注 |
data | | 是 | struct | |
- error_code | 错误编码 | 是 | int | 注意返回100需要重试 |
- description | 描述信息 | 否 | string | |
| | | | |
错误码
HTTP 状态码 | 错误码 | 描述 | 排查建议 |
| 3000001 | ... | 按文案排查 |
| 3000007 | 操作无权限 | |
| 4000002 | 参数不合法 | |
| 5000002 | 操作频繁,请稍后再试 | |
