抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • 接入前准备
  • API接口
  • 能力
  • 历史版本文档(不推荐)
  • 景区团购(在线预约)
  • 设置分佣比例
  • 代运营佣金
  • 建立代运营合作关系
  • 代运营合作
  • 景区日历票
  • 景区行业团购|在线预约解决方案
  • 餐饮团购
  • 线索经营
  • 更新预售券的预约库存日历
  • 酒店日历房接口
  • 三方码
  • 酒店新预售券接口
  • 酒旅
  • 预售券确认接单
  • 预售券查询订单poi
  • 预售券价量态-更新预售商品价库及属性
  • 预售券价量态-获取预售券商品价量态
  • 酒旅日历房解决方案
  • 通用能力
  • 接入前准备
  • 预售券价量态-更新预售商品价库及属性

    收藏
    我的收藏

    接口说明

    商家在来客后台创建商品成功后,通过接口调整预售券的价格库存信息

    基本信息

    名称
    描述
    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
    ​
    out_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
    操作频繁,请稍后再试
    ​