文档中心 > 未来酒店-服务对接

未来酒店酒店业务信息查询接口

更新时间:2017/02/08 访问次数:2883

酒店业务信息查询接口

接口需要商家实现服务接收

  • 场景

去啊平台通过调用此接口进行房态等信息查询,查询房间可预定情况

  • 要求
  1. 根据飞猪订单号做幂等处理,即同一订单,多次调用均可返回成功
  2. 处理能力要有合理评估并告知,去啊会根据性能要求投放流量

第三方系统根据此接口定义实现订单更新,并暴露成服务。去啊系统在用户订单变更时候调用

所有涉及价格的设计,单位为分,整形数值,不要带小数点。

请求参数定义列表(具体请求格式见请求样列)

名称 类型

是否

必需

最大长度 描述 示例值

QueryRoomRQ

复合类型

 

请求协议体

 

Username

String

100

第三方系统接口调用需要校验时的用户名。

Taobao

Password

String

100

第三方系统接口调用需要校验时的密码

1234

CreateToken

String

255

          单次请求的token

Taoao333333333333

RequestID

String

64

请求唯一标识,此值需要在结果中返回

taobao1387784033263

HotelCode

String

32

外部酒店编码

R444

RoomTypeID

String

32

外部房型ID

Rp333

CheckIn

Date

32

入住日期,格式 2016-03-15 00:00:00

2016-03-15 00:00:00

CheckOut

Date

32

离店日期,格式 2016-03-15 00:00:00

2016-03-15 00:00:00

Operate

int

10

本次更操作类型,此值必须传入,默认-1;

10:房态信息查询

11:查询活动

12:查询水单

104:任务结果查询

详细参见://open.alitrip.com/docs/doc.htm?&docType=1&articleId=104397

 

10

TaoOrderId

long

10

淘宝订单号tid。此值根据不同类型可能为空

 

OutOrderId

String

32

商家外部订单号,此值根据不同类型可能为空

 

1、查询房态请求定义

请求样例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

< QueryRoomRQ >

       <AuthenticationToken>

              <Username>taobao</Username>

              <Password>taobao</Password>

              <CreateToken>taobao1387784033263-1387784033266</CreateToken>

      </AuthenticationToken>

      <RequestID>请求唯一标识,此值需要在结果中返回</RequestID>

       <TaoOrderId>22222222</TaoOrderId>

       <OutOrderId>h222</OutOrderId>

<Operate>10</Operate>

<HotelCode>外部酒店编码</HotelCode>

<RoomTypeID>外部房型ID</RoomTypeID>

<CheckIn>2016-03-15 00:00:00</CheckIn>

<CheckOut>2016-03-15 00:00:00</CheckOut>

<Extensions></Extensions>

</ QueryRoomRQ >

 

注:查询房态请求过程中TaoOrderId、OutOrderId  是可选的。当已定的维度实时查询的时候有值,其余情况下无值(比如动态查询商家的房态信息)

2、查询水单请求定义

请求样例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<QueryRoomRQ>

       <AuthenticationToken>

              <Username>taobao</Username>

              <Password>taobao</Password>

              <CreateToken>taobao1387784033263-1387784033266</CreateToken>

      </AuthenticationToken>

      <RequestID>请求唯一标识,此值需要在结果中返回</RequestID>

       <TaoOrderId>22222222</TaoOrderId>

        <OutOrderId>h222</OutOrderId>

<Operate>10</Operate>

<HotelCode>外部酒店编码</HotelCode>

<Extensions></Extensions>

</QueryRoomRQ>

 

3、通用请求任务处理结果查询

(用于阿里平台主动查询某个任务的处理结果)

请求样例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<QueryRoomRQ>

       <AuthenticationToken>

              <Username>taobao</Username>

              <Password>taobao</Password>

              <CreateToken>taobao1387784033263-1387784033266</CreateToken>

      </AuthenticationToken>

      <RequestID>请求唯一标识,此值需要在结果中返回</RequestID>

      <TaoOrderId>22222222</TaoOrderId>

      <OutOrderId>h222</OutOrderId>

      <Operate>104</Operate>

      <HotelCode>外部酒店编码</HotelCode>

      <Extensions></Extensions>

</QueryRoomRQ>

 

结果返回:

名称

类型

是否必需

最大长度

描述

示例值

Result

复合类型

 

 

 

ResultCode

int

10

结果返回(0:查询成功;

1:查询失败)

0

Message

String

50

结果描述

失败原因

RequestID

String

64

请求序列号,唯一请求标识,必须返回

请求参数中传递过来的值

RoomInfo

 

 

 

房态信息节点

 

Room

 

 

 

可以有多个,每个房间的信息描述节点

 

HotelCode

String

50

外部酒店编码

R8888

RoomTypeID

String

50

房型ID

Rid444

DailyInfo

 

 

 

房间每日可预订情况列表

 

Day

 

 

 

每天一个节点

 

AvailableDate

String

32

可预订日期(格式:2016-03-15)

2016-03-15

BuildingNum

String

10

楼号

2

FloorNum

String

50

可选楼层

F4

RoomNum

String

50

可选房间号

8205

Operate

 

 

同请求中的operateType

 

RoomStatus

int

10

房间可预订状态(0:不可选;1:可选可选)

0

 

1、    返回样例(房态查询返回样列):

请返回酒店房间的全集,包括可选,不可选的所有房态。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Result>

<Message>信息更新成功</Message>

<ResultCode>0</ResultCode>

<RequestID>3333332222</RequestID>

<Operate>10</Operate>

<RoomInfo>

        <Room>

        <RequestID>查询请求的ID(如果是主动上传房态此值为空)</RequestID>

        <HotelCode>外部酒店编码</HotelCode>

        <RoomTypeID>外部房型ID</RoomTypeID>

         <DailyInfo>

                <Day>

                        <AvailableDate>预订日期格式:2016-03-15)</AvailableDate>

                         <BuildingList>

                                <Builiding><!—可有多栋楼-->

                                <BuildingNum>楼号</BuildingNum>

                                 <FloorList><!—每栋楼多层楼-->

                                       <Floor>

                                        <FloorNum>楼层</FloorNum>

                                 <RoomUnitList><!—每层楼有多个实体房间-->

                                         <RoomUnit>

                                         <RoomStatus>房间可预订状态(0:不可选;1可选)</RoomStatus>

                                         <RoomNum>房间号</ RoomNum>

                                          </RoomUnit>

                                           ..........

                                   </RoomUnitList>

                                         </Floor>

                                         ..........

                                   </FloorList>                                               

                              </Building>

                               ..........

 

                          </BuildingList>

                   </Day>

                    .................

 

        </DailyInfo>

        </Room>

         ...........

 </RoomInfo>

</Result>

 

 

2、查询水单的返回节点样列:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Result>

<Message>信息更新成功</Message>

<ResultCode>0</ResultCode>

<RequestID>3333332222</RequestID>

<Operate>12</Operate>

<OrderInfo>

       <Order>

               <RequestID>请求唯一标识</RequestID>

               <tid>12222</tid>

               <OutOrderId>r23323323</OutOrderId>

               <HotelCode>酒店编码</HotelCode>

               <RoomNo>房间号</RoomNo>

               <TotalFee>总费用</TotalFee>

               <Price>房费</Price>

               <OtherFee>杂费</OtherFee>

               <Remark>备注</Remark>

               <DailyPrice><!--每日房费列表-->

                        <DailyPriceItem>

                                 <Date >日期(格式 yyyy-MM-dd)</Date>

                                 <Price>每日金额</Price>

                        </DailyPriceItem>

                        ..................                       

               </DailyPrice>

               <OtherFeeDetail><!--杂费明细列表-->

                        <OtherFeeItem>

                                 <Name>杂费名称</Name>

                                 <Price>杂费金额</Price>

                        </OtherFeeItem>

                        ...................                       

               </OtherFeeDetail>

       </Order>

       .................

 

</OrderInfo>

</Result>

 

3、通用请求任务处理结果查询,返回样例

(用于阿里平台主动查询某个任务的处理结果)

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Result>

<Message>请求接收成功 </Message>

<ResultCode>0</ResultCode>

<RequestID>3333332222</RequestID>

<Operate>104</Operate>

<OrderInfo>

     <Order>

         <RequestID>请求唯一标识</RequestID>

         <HotelCode>酒店编码</HotelCode>

         <ProcessName>确认人员姓名(一般是酒店前台人员姓名,如果PMS自动处理则写“PMS”)</ProcessName>

         <Status>0:成功;1:失败(处理失败、拒绝处理等)</Status>

         <Message>失败原因</Message>

     </Order>

          ...............

 

</OrderInfo>

</Result>

 

其余样列后续补充

 

注:此文档会根据业务需要进行适当增删除。

 

参考附件OperateType定义:

详细定义参见 OperateTypeEnum定义部分

//open.alitrip.com/docs/doc.htm?&docType=1&articleId=104397

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部