酒店日历房可订检查SPI
接口说明
抖音侧调用第三方进行可订检查。如果不可订需要返回价量信息进行价量更新。
基本信息
Scope | life.capacity.trip_trade_order | |||
权限要求 | 酒店日历房解决方案-日历房正向交易 | |||
回调场景 | 酒店日历房可订检查 | |||
请求头
- •Content-Type:
application/json- •X-Bytedance-Logid: 请求 logid, 用于问题排查用。
- •x-life-clientkey: 服务商应用的 client_key。
- •X-life-sign: 请求签名,签名规则。
请求体
参数名称 | 参数类型 | 必须参数 | 备注 | ||
rate_plan_id | string | 必填 | 抖音售卖房型ID | ||
biz_type | int | 必填 | 2011:酒店预售券 2012:酒店预约单 2021:日历房 | ||
check_in_date | string | 必填 | 入住日期,格式:yyyy-MM-dd | ||
check_out_date | string | 必填 | 离店日期,必须晚于 check_in_date 格式:yyyy-MM-dd | ||
daily_rates | list | 选填 | 单日单间价格(加白后可支持多间夜场景下按间夜拆分,加白前多间多晚给1间多晚,加白后给多间多晚) | ||
| original_amount | int | 必填 | 原始价格(分),对于非中国大陆商家,代表税后价 支持传0和-1,表示清除价格 | |
| amount_before_tax | int | 选填 | 税前价,非中国大陆商家使用 | |
| currency | string | 选填 | 发单价格币种,CNY,USD国际标准枚举值 非国内大陆商家必填 | |
| period_start_date | string | 必填 | 时间段开始时间yyyy-MM-dd | |
| period_end_date | string | 必填 | 时间段结束时间yyyy-MM-dd | |
| period_start_time | string | 选填 | 开始时间点,新增选择钟点房时为必填,格式 yyyy-MM-dd hh:mm 钟点房第一次可订检查(提单)时无此时间,第二次可订检查(下单)时会传此时间为必填 | |
| period_end_time | string | 选填 | 结束时间点,新增选择钟点房时为必填,格式 yyyy-MM-dd hh:mm 钟点房第一次可订检查(提单)时无此时间,第二次可订检查(下单)时会传此时间为必填 | |
| usage_duration | int | 选填 | 使用时长 选择钟点房时为必填。钟点房第一次可订检查(提单)时无此时间,第二次可订检查(下单)时会传此时间为必填 | |
