酒店预订流程
渠道客户端负责展示酒店、价格和订单;渠道服务端负责签名并调用 YSystem Open API。以下展示主预订流程,图中的接口均为 POST,省略环境域名和版本前缀。
sequenceDiagram
accTitle: 酒店预订流程
accDescr: 渠道客户端通过渠道服务端查询酒店、价格方案和规则,确认后提交预订并查询订单状态。
autonumber
box rgb(235, 247, 243) 渠道方
participant C as 渠道客户端
participant S as 渠道服务端
end
box rgb(255, 246, 229) YSystem
participant Y as YSystem 服务端
end
C->>S: 查询酒店(目的地、入住日期、人数)
S->>Y: /hotel/search
Y-->>S: 酒店列表
S-->>C: 展示酒店列表
C->>S: 选择酒店,查询价格方案
S->>Y: /hotel/rates
Y-->>S: 房型与价格方案
S-->>C: 展示可选方案
C->>S: 选择方案,查询价格明细与规则
S->>Y: /hotel/rateRule
Y-->>S: 最新价格明细与预订规则
S-->>C: 展示价格、付款及取消政策
C->>S: 确认条款,提交入住人与预订信息
S->>Y: /hotel/book
Y-->>S: 订单或业务错误
S-->>C: 展示订单状态或失败原因
opt 订单仍待确认
S->>Y: /order/search
Y-->>S: 最新订单与预订结果
S-->>C: 更新预订状态
end
接入要点
- 下单前必须调用
/hotel/rateRule,向用户展示最新价格及规则;不要直接把酒店列表或价格方案列表中的价格当作最终价格。 - 支付方式取决于价格方案和渠道配置,按对应版本的字段参考传入预订及支付信息。
- 返回订单不代表预订已经确认,应检查订单状态及预订结果;需要更新时调用
/order/search。 - 酒店和价格查询支持分批获取结果,见 异步任务。所有接口请求由渠道服务端按 请求认证与签名 处理。
可通过 酒店 API Demo 体验流程;完整请求和响应字段见 Open API。