一、[原]多间说明
版本说明:入参中 Vesion < 1.7 ;
流程概述:
1.详情接口 hotel.detail 只支持单间,特别说明:入参的 NumberOfRooms 只会和房间的最小预订间数 MinAmount 匹配,不符合要求( NumberOfRooms < MinAmount) 的产品会被过滤;
2.用户只能在预订填写(页)时调用 hotel.data.booking 或 hotel.data.validate 切换间数(入参 NumberOfRooms) 获取多间的价格、规则等信息;
3.最后调用 hotel.order.create 入参 NumberOfRooms 成单;
参考:


二、[新]详情页多间说明
版本说明:入参中 Vesion >= 1.7 ;
2.1 通用说明
所有接口入参中的以下字段(表格一)
| 字段名 | 字段含义 | 变更前含义 | 变更后含义 |
|---|---|---|---|
| NumberOfAdults | 成人数 | 单间 | 多间,且必填,同程会结合 NumberOfRooms 拆分 |
| ChildAges | 儿童年龄 | 单间 | 多间,且必填,同程会结合 NumberOfRooms 拆分 |
举例:NumberOfAdults = 3, NumberOfRooms = 2, 同程会拆分为每一间入住2人,筛选符合要求的产品
重要说明:
1.因定义改为多间总人数(NumberOfAdults、ChildAges),同程根据 NumberOfRooms 拆分,所以要求从详情 hotel.detail --> 试单 (hotel.data.booking\hotel.data.validate) ---> 成单 hotel.order.create , 在变更 NumberOfRooms 时 同比增长 NumberOfAdults 和 ChildAges ,否则可能会造成预订失败;
2.请保障自己系统有快速回滚能力;
举例 (表格二)
| 时刻 | 接口 | 入参 | 出参 |
|---|---|---|---|
| T1 | hotel.detail | NumberOfAdults = 2 NumberOfRooms = 2 | 可能出来的是单人间 GoodsA |
| T2 | hotel.data.booking、hotel.data.validate | GoodsA NumberOfAdults = 4 NumberOfRooms = 3(算出来要双人间才能满足) | 试单失败 因为入参的 GoodsA 是详情页出的单人间,而最新入参的 NumberOfAdults 、NumberOfRooms 拆分出来需要至少双人间才满足; 因此当 NumberOfRooms 从 2 --> 3 时,NumberOfAdults 应该同比从 2 --> 3; ChildAges 也是同样的道理 |
新增异常码(表格三):
| Code |
|---|
| H000035|最大成人数限制,不能超过{x} |
| H000039|请入参有效的NumberOfAdults |
| H000038|请入参有效的NumberOfRooms |
2.2 流程接口变更说明
2.2.1 详情接口 hotel.detail
可支持单/多间
入参:见 表格一
出参的字段含义变更如下(表格四):
| 字段名 | 字段含义 | 变更前含义 | 变更后含义 |
|---|---|---|---|
| PrepayResult | 预付规则结果 | 单间 | 多间 |
| GuaranteeResult | 现付规则结果 | 单间 | 多间 |
| UsedPromotionValues | 同程促销 | 单间 | 多间 |
| AdditionalTax | 另付税和服务费 | 单间 | 多间 |
| swNoRms | 全流程是否可切换间数 | 之前无该字段 | 从详情->试单->成单,全流程不可切换 NumberOfRooms |
其他不在上表中的字段代表 单间(多间均值),比如每日价格 NightlyRate 节点中的 Member 、Cost、Rate、MinRate 等
参考:


2.2.2 填写页接口
用户也可在预订填写(页)时调用 hotel.data.booking 或 hotel.data.validate 切换间数 获取(校验)多间的价格、规则等信息;
入参:见 表格一,NumberOfRooms、NumberOfAdults、ChildAges 保持同比增长,当详情接口返回的 swNoRms = 1 时,这里入参的 NumberOfRooms 必须和详情页一致
出参:不变更
2.2.3 成单接口
最后调用 hotel.order.create 入参 NumberOfRooms 成单;
入参:见 表格一,NumberOfRooms、NumberOfAdults、ChildAges 保持同比增长,当详情接口返回的 swNoRms = 1 时,这里入参的 NumberOfRooms 必须和详情页一致
出参:不变更
以上对接时,可咨询同程,为保证对业务的影响,请保留有快速回滚能力;
