价量态拉取接口

我的收藏

接口说明

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

基本信息

Scope	//WIP
权限要求	//WIP
使用场景	根据服务商提供配置，定时触发。默认为5分钟。

请求头

•

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	必填	拉取时间范围
»» 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"
    }
}

响应参数

参数名称	参数类型	必须参数	备注
» status	bool	必填	本次请求是否成功，成功才会更新价量，失败则整个请求的所有价量都会被丢弃
» errors	list<string>	选填	不成功必填错误信息
» room_rates	list<object>	必填	价量信息
»» rate_plan_id	string	必填	抖音售卖计划ID
»» rate_avail_infos	list<object>	必填	售卖计划的价量信息
»»» timerange	object	必填	时间范围
»»»» end	string	必填	结束日期 eg. 2022-01-04
»»»» start	string	必填	开始日期 eg. 2022-01-01
~~»»» stay_length~~	~~int~~	选填	~~连住天数~~
»»» length_of_stay	int	选填	连住天数。适用于连住（LosRate）场景下，不同连住天数具有单独的连住价格。 •length_of_stay字段值应大于1，当不传或者值小于等于1时，不会被认定为LosRate模式，而是当作单日价格处理 •length_of_stay字段值最大不能超过7天
»»» fplos	string	选填	fplos=“0111011”，则表示允许连住2天,3天,4天,6天,7天；但是不允许连住1天,5天； •抖音支持最长传入14天 •flops中只要有“1”存在，那么总房态available就应该置为true
»»»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	选填	单天售卖税前价
»» sub_error	string	选填	子错误信息
»» sub_error_code	int	选填	子错误码
» timestamp	string	必填	秒时间戳，取服务商返回数据时的时间

响应示例

{
    "room_rates": [
        {
            "rate_plan_id": "723587692345234534",
            "rate_avail_infos": [
                {
                    "timerange": {
                        "start": "2023-01-01",
                        "end": "2023-05-01"
                    },
                    "stay_length": 1,
                    "original_amount": 10000,
                    "available": true,
                    "inventory": 20
                }
            ],
            "status": true,
            "sub_error": "售卖计划ID错误",
            "sub_error_code": 60021
        }
    ],
    "timestamp": "17346834298",
    "status": true,
    "errors": [
        "错误"
    ]
}