接入前准备

通用能力

餐饮

大交通

酒旅

酒店行业新预售券解决方案

酒店行业日历房解决方案

酒店日历房接口

酒店静态信息匹配/创建/更新能力

酒店静态信息自助获取能力

代理商-酒店静态信息自助获取

物理房型静态信息匹配/创建/更新

物理房型静态信息自助获取能力

物理房型上下架能力

售卖房型创建/更新能力

房价/房态/房量更新

酒店会员管理

日历房交易正向

日历房上下架能力

日历房线上开票

入住/离店状态同步能力

营销查询

营销规则价格模式推送

营销规则价格推送

营销价量态拉取

营销库存推送

营销退出报名

主动拉取价量态

价量态拉取接口

创建及修改佣金计划

修改佣金计划状态

根据商品查佣金计划

根据佣金计划查商品

日历房交易逆向

营销规则推送

度假行业解决方案

景区行业解决方案

通用错误码

综合

历史版本文档（不推荐）

价量态拉取接口

我的收藏

接口说明

抖音侧调用第三方主动拉取价量态信息。

基本信息

Scope	life.capacity.trip_hotel_ari_cron_pull
权限要求	酒店日历房解决方案-主动拉取价量态能力
使用场景	根据服务商提供配置，定时触发。配置需咨询抖音研发。

请求头

•

Content-Type：application/json

•

X-Bytedance-Logid: 请求 logid，用于问题排查用

•

x-life-clientkey: 服务商应用的 client_key

•

X-life-sign: 请求签名，签名规则

请求体

参数名称	参数类型	必须参数	备注
» hotel_ids	list<string>	必填	抖音酒店ID
» rate_plan_ids	list<string>	选填	抖音售卖房型 ID
» date_range	object	必填	拉取时间范围 •[start,end]为闭区间，多段日期之间不能重复
»» end	string	必填	结束日期 eg. 2022-01-04
»» start	string	必填	开始日期 eg. 2022-01-01

抖音的拉取和推送接口都是增量更新，时间范围外的日期会保持不变

请求示例

{
    "hotel_ids": [
        "7643219873621464"
    ],
    "date_range": {
        "start": "2023-01-01",
        "end": "2023-05-01"
    }
}

相应参数

参数名称	参数类型	必须参数	备注
data	struct	必填
» room_rates	list<object>	必填	价量信息
»» rate_plan_id	string	必填	抖音售卖计划ID
»» rate_avail_infos	list<object>	必填	售卖计划的价量信息
»»» timerange	object	必填	时间范围 •[start,end]为闭区间，多段日期之间不能重复
»»»» end	string	必填	结束日期 eg. 2022-01-04，不得早于今天
»»»» start	string	必填	开始日期 eg. 2022-01-01，不能超过365天外
»»» original_amount	int	必填	房价支持传0和-1，表示清除价格
»»» retail_amount	int	选填	门市价，单位分 •门市价 ≥ 售卖价格，不传则与售卖价格相同
»»» currency	string	选填	发单价格币种，CNY，USD国际标准枚举值非国内大陆商家必填
»»» available	bool	必填	房态
»»» inventory	int	必填	房量
»»» fplos	string	选填	fplos=“0111011”，则表示允许连住2天,3天,4天,6天,7天；但是不允许连住1天,5天； •抖音支持最长传入14天 •flops中只要有“1”存在，那么总房态available就应该置为true
»»» length_of_stay	int	选填	连住天数。适用于连住（LosRate）场景下，不同连住天数具有单独的连住ARI。 •length_of_stay字段值应大于1，当不传或者传入1时，不会被认定为LosRate模式，而是当作单日ARI处理 •length_of_stay字段值最大不能超过7天
»»»los_rate_break_down	list<object>	选填	连住模式下单日价格明细列表 •列表长度需要和length_of_stay的值相等 •按列表顺序设定每天价格，即当length_of_stay = 3时，los_rate_break_down[0]为第一天的价格，los_rate_break_down[1]为第二天的价格，依此类推。
»»»»day_original_amount	int	选填	单天售卖原价
»»»»day_amount_before_tax	int	选填	单天售卖税前价
»»»meals	list< object >	选填	餐食信息（动态价格模式必填，静态价格模式置空即可）
»»»»num	int	必填	餐食数额 •type=1,2或3时, num必须大于0; 否则不需要传 •type=4表示无餐食，num必须为0
»»»»type	enum	必填	餐食类别，早/中/晚，不能重复传递，若有多餐更改对应数额 (结构见公共结构2.2.6)
»»» stay_rules	object	选填	连住规则（仅动态模式需要填）
»»»» min_los	int	选填	最小连住天数（若有值，需保证>=1）
»»»» max_los	int	选填	最大连住天数
»»» cancel_rules	list<object>	选填	取消规则（动态价格模式必填，静态价格模式置空即可）
»»»» cancel_type	enum	必填	取消订单规则 (结构见公共结构2.2.4)
»»»» cancel_time_type	enum	选填	若取消订单规则为限时取消，该字段表示取消订单需要参考的时间点，例如以入住时间为参考，判断用户是否可取消。 (结构见公共结构2.2.2)
»»»» cancel_offset_time	object	选填	若取消订单规则为限时取消，该字段表示取消订单需要参考的时间时间长度，例如以入住时间为参考，长度6小时，则用户最晚可在入住前6小时取消。
»»»»» day	int	选填
»»»»» hour	int	选填
»»»»» minute	int	选填
»»»» cut_type	enum	选填	取消扣费类型 (结构见公共结构2.2.3)
»»»» cut_value	int	选填	取消扣费数额可选 0% 10% 30%
»»» book_rules	object	选填	预约规则（动态价格模式必填，静态价格模式置空即可）
»»»» midnight_room	object	选填	凌晨房设置（动态模式，开启T-1价量态拉取需联系开发配置）
»»»»» is_midnight_room	bool	选填	是否开启凌晨房关闭：false，开启：true。默认为false关闭
»»»»» latest_booking_time	int	选填	最晚预定时间次日凌晨1-6点
»»»»»» max_advance_time	object	选填	最晚提前预定限制
»»»»»»» day	int	选填	最早（最多）提前xx天预定 •最大值支持365
»»»» check_in_from	string	选填	最早入住时间，仅支持整点，当和酒店入住时间保持一致可不传
»»»» check_out_to	string	选填	最晚离店时间，仅支持整点，当和酒店入住时间保持一致可不传
»»»» check_in_to	string	选填	最晚入住时间，仅支持整点，当和酒店入住时间保持一致可不传
»»»» applicable_people	list< object >	选填	适用人群，限制内宾或外宾（%不填默认为内外宾） (结构见公共结构2.2.5)
»»»» max_quantity_limt	int	选填	每单限购间数
»»» book_time_rules	object	选填	预定时间规则 •用于限定用户可购买的时间段
»»»» is_time_nextday	bool	必填	预定时间段是否跨天 •如果设置跨天，商品类型必须为凌晨房
»»»» time_span	object	必填	预定时间段
»»»»» from	string	必填	可预定开始时间 •格式：HH:mm
»»»»» to	string	必填	可预定结束时间 •格式：HH:mm •当结束时间跨天时，该时间需要等于凌晨房的最晚预定时间
»» status	bool	必填	该售卖房型是否成功，成功会更新该售卖房型
»» sub_error	string	选填	子错误信息
»» sub_error_code	int	选填	子错误码
» timestamp	string	必填	秒时间戳，取服务商返回数据时的时间

响应示例

{
    "data": {
        "error_code": 0,
        "description": null,
        "room_rates": [
            {
                "rate_plan_id": "723587692345234534",
                "rate_avail_infos": [
                    {
                        "timerange": {
                            "start": "2023-01-01",
                            "end": "2023-05-01"
                        },
                        "original_amount": 10000,
                        "available": true,
                        "inventory": 20,
                        "length_of_stay":2,
                        // 仅动态模式需要传
                        "stay_rules": {
                            "min_los": 2,
                            "max_los": 10
                        },
                        // 仅动态模式必传
                        "book_rules": {
                            // 表示用户需要提前【1，30】天预约
                            "min_advance_time": {
                                "day": 1
                            },
                            "max_advance_time": {
                                "day": 30
                            },
                            "check_in_from": "12:00",
                            "check_in_to": "15:00",
                            "check_out_to": "10:00",
                            "max_quantity_limt": 10,
                            "applicable_people": [
                                1,
                                2
                            ]
                        },
                        // 仅动态模式必传
                        "cancel_rules": [
                            {
                                "cancel_type": 2,
                                "cancel_time_type": 2,
                                "cancel_offset_time": {
                                    "day": 0,
                                    "hour": 6,
                                    "minute": 0
                                },
                                "cut_type": 1,
                                "cut_value": 10
                            }
                        ],
                        // 仅动态模式必传
                        "meals": [
                            {
                                "type": 1,
                                "num": 1
                            }
                        ]
                    }
                ],
                "status": true,
                "sub_error": "售卖计划ID错误",
                "sub_error_code": 60021
            }
        ],
        "timestamp": "17346834298",
        "status": true,
        "errors": [
            "错误"
        ]
    }
}