酒店

酒店详情-多间接入说明更新时间:2026/08/10 17:11

一、[原]多间说明

版本说明:入参中 Vesion < 1.7 ;


流程概述:

1.详情接口 hotel.detail 只支持单间,特别说明:入参的 NumberOfRooms 只会和房间的最小预订间数 MinAmount 匹配,不符合要求( NumberOfRooms < MinAmount) 的产品会被过滤;

2.用户只能在预订填写(页)时调用 hotel.data.booking 或 hotel.data.validate 切换间数(入参 NumberOfRooms) 获取多间的价格、规则等信息;

3.最后调用 hotel.order.create 入参 NumberOfRooms 成单


参考:

df52bbd839d0adb1bc79cf21a94adccf_compress.jpg9cc26f7e4634680d1fe3425c7b390ea5_compress.jpg




二、[新]详情页多间说明

版本说明:入参中 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.请保障自己系统有快速回滚能力;



举例 (表格二)

时刻
接口入参出参
T1hotel.detail

NumberOfAdults = 2

NumberOfRooms = 2

可能出来的是单人间 GoodsA
T2hotel.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 等


参考:

image.png

image.png


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 必须和详情页一致

出参:不变更




以上对接时,可咨询同程,为保证对业务的影响,请保留有快速回滚能力;