对接流程场景图

对接流程

一：对接酒店基本信息、房量、房价

1、客户对接B2B接口，需先对接获取酒店列表（hotel/getHotelList）接口，获取B2B渠道所有可用酒店ID（研发1天，测试0.5天）

2、对接获取酒店详情接口（hotel/getHotelComplexList），可根据酒店ID获取酒店基本信息落库（研发2天，测试1天）

3、对接获取酒店房量房价信息接口，可根据酒店ID获取酒店每日房量房价信息。房量房价接口：hotel/getTMCRoomPrice（研发4天，测试2天）

4、对接房价变化消息推送服务（研发2天，测试1天）

5、对接房量变化消息推送服务（研发2天，测试1天）

6、房价房量接口接入方案

a、接入方每天不超过三次拉取全量房价房量，每次间隔建议6小时以上
b、接入方每次拉取全量房价房量，时间范围是1-90天
c、接入方使用验单接口发现房价房量变更，及时拉一次当前酒店的房价房量
d、接入方可以接入房价房量变更通知接口，若有房量房价变更，华住商旅系统会及时通知

7、限流整改措施

a、若监测到接入方收到整改通知后，依然存在频繁拉取房价房量，会做一定限流甚至关停IP处理

对接酒店基本信息、房量、房价流程图：

对接酒店流程图

二：订单

1、对接下单接口(order/add)（研发5天，测试3天）

2、对接下单之前的DoubleCheck接口（hotel/checkAvailability）（研发2天，测试1天）

3、对接查询订单接口(order/query) （研发1天，测试0.5天）

4、对接取消订单接口(order/cancel) （研发3天，测试1.5天）

5、对接预订单状态变更推送给企业接口（研发2天，测试1天）

下单流程图：

下单流程图

三：账单

1、对接“企业查询账单信息“接口或”接待信息推送给企业“接口（研发3天，测试1.5天）

名词解释

TMC:

商旅管理公司Travel Management Companies的英文简称，对外提供差旅管理服务，如酒店、机票预订等。国内的TMC公司有携程商旅、美团商企通等。

会员赠积分：

根据下单接口入参linkMobile查询会员信息，如是会员且已绑定至该企业下且是本人入住则赠积分，如不是会员，需自行到华住官网注FULL_AMOUNT册并绑定到某企业；

接口传参：isNeedRegisterMember=true, linkMobile=实际入住人手机号，且只能传一个手机号。

早餐信息：

根据双方商务签订的协议折扣价看是否含早，例如签订的折扣等级为88含双早，就含2份早餐，88不含早，就不含早餐，早餐信息如下：

海友全品牌无早；

桔子三家门店无早；

8000220：桔子精选杭州文一西路酒店；

8000221：桔子水晶杭州钱江新城近江酒店；

2000105：桔子精选上海外滩人民路酒店；

其他门店全部含早。

注：目前接口已支持输出早餐信息，可直接取房价接口输出的memberAndBreakFastList节点。

担保取消条款：

非担保订单的保留时间、担保订单的最晚取消时间：92和88不含早的均为18点，88bf2和85bf2均为20:00，担保订单过了最晚取消时间预订的，1小时内免费取消；

非担保订单的最晚取消时间：无限制，过了保留时间门店也可以随时取消；

担保订单的保留时间：92bf0和88bf0离店日12点，88bf2和85bf2离店日14点。

税点差额：

（1）确认前端是否显示公司总对总价companyToGroupPrice（含税价+税点差额）:针对和华住总部做结算的总对总订单，由于小规模纳税人的酒店华住总部开票和门店开票之间存在税点差额，需要补税点，请确认此部分税点差额由客人承担还是自己公司承担，由客人承担时并且订单是总对总订单，需要将companyToGroupPrice显示给客人；由于现付订单从门店直接拿票，不需要补税点差额，现付订单前端显示afterTaxPrice；

（2）afterTaxPrice为房费，companyToGroupPrice =房费+税点差额，不管前端显示afterTaxPrice还是显示companyToGroupPrice给客人，下单接口统一传afterTaxPrice。

失败重试：

（1）针对超时或华住接口返回500的下单请求，客户需要用原下单请求号requestNo重试，如未建立失败重试机制有产生NoShow订单费用风险；

（2）针对下单时，总对总结算的且返回“付款失败（code:3028，message:订单支付失败）“的订单，需要重试或调接口（order/queryByRequestNo）获取到已经生成的订单号，并观察订单的状态（bookStatus 和pmsAdapterOrderStatus），正常付款失败的订单，华住会主动取消，如因客人已经办理入住，未取消成功的订单，需要正常结算。