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

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

更新时间：2017/02/08 访问次数：5591

酒店业务信息查询接口

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

  • 场景

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

  • 要求
  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.fliggy.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.fliggy.com/docs/doc.htm?&docType=1&articleId=104397

 

FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
文档标签:
未来酒店
查询
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号