酒店

【国际酒店】国际对接指南更新时间:2024/04/01

一、接入模式

国际仅支持搜索模式


二、接口对接注意事项

1、公共协议入参:

国际对接的所有接口通用参数入参"Version"使用最高版本即可

2、涉及国际处理的环节及接口如下:

环节

使用接口

注意事项

获取静态信息

hotel.static.city

hotel.static.list

hotel.static.info

1、  调用顺序city、list、info。city接口入参:CountryType=2获取国际国家城市

2、  港澳台酒店按国际入参获取

搜索

hotel.filter

hotel.list

hotel.detail

1、  hotel.filter接口:返参中的筛选项是根据城市动态变化的

2、  hotel.list接口:如果不进行资源管控可以支持使用,若有资源管控分销进行后置资源过滤就不支持使用

以上两个接口当渠道无自建搜索能力时使用,若渠道有自建搜索能力即不用使用

3、  hotel.detail接口:

入参:需必填儿童和成人数;hotelid只能单个请求

返参:①价格取Rate;②税费=Rate-MinRate;③取消政策取PrepayResult;④早餐取BoardDetail,不到天,若有早餐即每天都有;④无需解析促销相关节点。

接口说明中标注“国际特有字段”都需要关注并解析

试单

hotel.data.validate

入参:“国际特有字段”一定要回传,例如HotelCode、SupplierId、SubSupplierId、ShopperProductId、Customer.FirstName、 Customer.LastName等

出参:需关注“国际特有字段”,CancelPolicy节点

创单

hotel.order.create

入参:“国际特有字段”一定要回传

支付

hotel.order.pay

订单

hotel.incr.id

hotel.incr.order

hotel.order.detail

hotel.order.cancel

hotel.order.promote

工单

hotel.sr.finddic

hotel.sr.create

hotel.sr.modify

hotel.sr.urge

hotel.sr.visual


三、业务相关

1、国际不存在促销

2、产品均为二次确认,具体确认时长由于底层供应商数据不准确,所以不会输出