抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 餐饮
  • 大交通
  • 酒旅
  • 酒店行业新预售券解决方案
  • 酒店行业日历房解决方案
  • 度假行业解决方案
  • 预售券
  • KA核销对账
  • 日历品
  • 旅行社日历品操作
  • 旅行社日历品价量态信息同步
  • 日历品商品价量态信息查询
  • 日历套餐价库信息拉取更新(SPI)
  • 旅行社日历品价量态操作
  • 旅行社日历品行业交易商家接单
  • 旅行社日历品行业交易可定检查
  • 旅行社日历品行业交易创建订单
  • 旅行社日历品行业交易支付结果通知
  • 旅行社日历品行业交易退款成功通知
  • 旅行社日历品-订单取消通知
  • 酒旅-旅行社支付结果通知
  • 旅行社poi查询
  • 旅行社直连相关枚举&常见错误码
  • 景区行业解决方案
  • 通用错误码
  • 综合
  • 历史版本文档(不推荐)
  • 使用场景

    商家在来客后台创建商品成功后,通过接口调整日历套餐的价格库存信息。使用场景如下图

    接口说明

    抖音 ->商家

    请求参数

    接口入参
    参数
    名称
    是否必填
    参数类型
    备注
    product_id
    抖音平台商品ID
    string
    和商家商品预售券ID二选一
    out_id
    商家商品ID
    string
    和抖音平台商品预售券ID二选一
    account_id
    商家ID
    string
    商家在抖音平台的id

    请求json示例

    { "product_id": "0", "out_id": "qlltest商品编码0123", "account_id": "7124319264303286286" }

    响应参数

    接口入参
    一级参数
    二级参数
    名称
    是否必填
    参数类型
    备注
    data
    product_id
    抖音平台商品ID
    string
    和商家商品日历商品ID二选一
    out_id
    商家商品ID
    string
    和抖音平台日历商品ID二选一
    booking_calendar_stock
    商品的日历价格库存
    list<struct>
    日历库存最大支持360天.目前仅为单个
    - calendar_list
    日历结构体
    list<struct>
    日历库存最大支持360天,单次最多90个结构体,不可出现重叠日期
    --calendar_value
    日历值
    list<struct>
    可设置批量,1到10个 (包含10)(预计3.18号支持到90个)
    --- start_date
    开始日期
    string
    设置日历范围开始日期(不传默认未来90天)
    --- end_date
    结束日期
    string
    设置日历范围结束日期 (start_data end_date可为同一天)
    ---available_weekday_list
    具体周几
    int
    周1、2、3、4、5、6、7
    --calendar_status
    是否可销售
    int
    1可购买,2不可购买
    --available_qty
    剩余库存
    int
    如果可销售则必填
    --actual_amount
    实际售卖价格
    int
    如果可销售则必填,单位分
    error_code
    返回码
    int
    0代表成功,非0代表失败
    description
    描述信息
    string
    描述信息

    响应json示例

    { "data": { "product_id": "123", "out_id": "456", "booking_calendar_stock": [ { "calendar_list": [ { "calendar_value": [ { "start_date": "2024-02-08", "end_date": "2024-02-28", "available_weekday_list": [ 1, 2, 3, 4, 5, 6, 7 ] } ], "calendar_status": 1, "available_qty": 777, "actual_amount": 777 } ] } ], "error_code": 0, "description": "success" } }