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

    收藏
    我的收藏

    接口说明

      • 商家在来客后台创建商品成功后,可以通过接口查询到商品基础信息、商品状态以及预售商品及可预约商品的价格库存信息
      •不可频繁查询, 分布式锁: 大概3s内才可查询一次

    基本信息

    名称
    描述
    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
    booking_stock_start_date
    预约日历库存开始时间
    否
    string
    商家期望查询的日历范围。起止时间跨度不可超过90天。与end_date必须同时设置或同时不设置(若不设置则查询当天开始的90天内)
    booking_stock_end_date
    预约日历库存结束时间
    否
    string
    ​

    响应参数

    接口出参
    ​
    参数
    名称
    是否必填
    参数类型
    备注
    product_id
    商品ID
    是
    string
    注意:除了商品状态外,均只返回在线商品的属性规则
    out_id
    第三方商品ID
    是
    string
    ​
    product_name
    预售商品名称
    是
    string
    ​
    category_id
    旅行社商品类目ID
    是
    int
    ​
    category_name
    商品类目全称
    是
    string
    度假旅游服务·境内目的地玩乐·境内多日游, 【旅行社】全量经营&商品类目&poi映射
    create_time
    商品创建时间
    是
    int
    秒时间戳
    update_time
    商品更新时间
    是
    int
    秒时间戳
    product_status
    商品状态
    是
    int
    生效中/审核中/审核未通过/商品下架;修改时审核未通过回退至修改前状态
    original_amount
    预售商品原价
    是
    int
    划线价格
    actual_amount
    预售商品实际支付价格
    是
    int
    实际支付价格
    marketing_amount
    预售商品营销最低价
    是
    int
    营销时改价不可低于该价格
    stock_qty_limit_type
    预售商品是否无限库存
    是
    int
    1限制库存,2不限制库存
    total_stock_qty
    预售商品库存数量
    否
    int
    当预售商品非无限库存时必传,总库存,包含已售
    sold_count
    预售商品已售数量
    是
    int
    预售商品出售累计数量
    children_definition
    儿童加价限制
    否
    struct 见于CrowdDefinitionStruct
    如果日历库存加价结构体中有儿童出行人加价,则必填。儿童年龄上下限[0-18]周岁(闭区间)
    user_add_price_rule
    增加出行人加价
    ​
    struct(见下OnlineAddPriceStruct)
    1. 加价规则可以有多条。若C端用户下单日期命中多条规则时,会取最大值。 2.增加出行人加价必须区分不同人群的加价金额 3.仅“度假旅游服务”“住宿-酒景套餐”“交通出行-境外机票”商品类目下可用无加价规则为空
    date_add_price_rule
    热门日期加价
    ​
    structstruct(见下OnlineAddPriceStruct)
    加价规则可以有多条。若C端用户下单日期命中多条规则时,会取最大值。
    room_add_price_rule
    单房差加价
    ​
    struct(见下OnlineAddPriceStruct)
    1. 加价规则可以有多条。若C端用户下单日期命中多条规则时,会取最大值。 2.仅“度假旅游服务”商品类目下可用,无加价规则为空
    booking_calendar_stock
    预约商品的日历库存
    ​
    struct
    日历库存最大支持90天范围
    -stock_list
    天纬度的库存结构
    ​
    list<struct>
    ​
    --date
    当天
    是
    string
    格式 "2023-12-12"
    --calendar_status
    是否可预约
    是
    int
    1可预约,2不可预约
    --stock_qty_limit_type
    是否限制总库存
    是
    int
    1限制,2不限制
    --sold_qty
    已售库存
    是
    int
    已约库存
    --total_stock_qty
    总库存
    是
    int
    总库存
    --available_qty
    剩余库存
    是
    int
    可约库存
    ​
    ​
    ​
    ​
    ​

    结构体

    结构体: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:国庆节(生效的时间范围说明)
    ​

    错误码

    HTTP 状态码
    错误码
    描述
    排查建议
    ​
    3000001
    ...
    按文案排查
    ​
    3000007
    操作无权限
    ​
    ​
    4000002
    参数不合法
    ​
    ​
    5000002
    操作频繁,请稍后再试
    ​