文档中心 > API类目 > 酒店在线预订API

taobao.xhotel.order.future.info.get (获取(查询)订单变更信息)

支持操作类型 1.在线开发票请求 3.在线选房请求 4.自助checkIn请求 13.扫脸入住身份信息请求 10.房态信息查询请求 103.通用任务取消指令

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_uuid String 必须 333333 请求流水号
tids String 可选 123455666;123455666;123455666 指定淘宝订单ID。以英文分号隔开的字符串“123455666;123455666;123455666”
created_start Date 可选 2015-12-12 00:00:00 开始时间
created_end Date 可选 2015-12-12 00:00:00 结束时间
hotel_code String 必须 123 酒店编码
vendor String 可选 zhuzhe 系统商分配的身份识别
operate_type Number 必须 1 操作类型 1.在线开发票请求 3.在线选房请求 4.自助checkIn请求 13.扫脸入住身份信息请求 10.房态信息查询请求 103.通用任务取消指令

响应参数

名称 类型 示例值 描述
results HotelOrderDirectInfo [] 结果返回列表
  • └ request_i_d
  • String
  • 22
  • 单次请求的唯一标识
  • └ tid
  • Number
  • 123
  • 淘宝订单号
  • └ out_order_id
  • String
  • 345
  • 外部订单号
  • └ seller_id
  • Number
  • 44
  • 卖家id
  • └ hotel_code
  • String
  • 44
  • 酒店编码
  • └ gmt_create
  • Date
  • 2016-03-11 00:00:00
  • 创建时间
  • └ gmt_modified
  • Date
  • 2016-03-11 00:00:00
  • 修改时间
  • └ biz_type
  • Number
  • 1
  • 操作类型 1.在线开发票请求 3.在线选房请求 4.自助checkIn请求 13.扫脸入住身份信息请求 10.房态信息查询请求 103.通用任务取消指令
  • └ context
  • String
  • <CheckInInfo><RoomNum>8008</RoomNum><DeviceId>NO12001</DeviceId><Guests><Guest><GuestName>张三</GuestName><CertificateType>20</CertificateType><CertificateNum>367719189009873678</CertificateNum></Guest></Guests></CheckInInfo>
  • xml内容格式字符串,详细参考 http://open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.2gmWOz&treeId=191&articleId=106152&docType=1
  • └ extensions
  • String
  • {“key”:"value"}
  • json格式的扩展字段
  • └ action
  • Number
  • 0
  • * PMS处理消息的动作(pms端应该考虑增加代办任务列表) * 0:普通,不需要特殊动作 * 1:弹窗提示(Pms中央模态窗) * 2:托盘信息提示(给酒店广播通知或者平台公告) * 3:发送请求给酒店前台人员,前台人员需要看到后确认处理(比如督促前台结账、督促前台上报入住状态) * 4:请求pms自动处理(自动发起结账,自动上报订单状态等)
  • └ status
  • Number
  • 0
  • * 消息状态(tips:Pms定时get走请求,状态可以考虑不变化) * 0:新建消息(接收到交易系统请求) * 1:请求已获取(pms已经取走请求数据) * 2:请求已认领(pms已经有人认领消息,正在处理) * 3:请求已反馈(Pms反馈请求处理结果) * 4:处理完成(已通知相关系统(交易)) * 5:请求失效
  • └ display_text
  • String
  • 请尽快发起结账
  • 给酒店前台展示的文案提示
issuccess Boolean false 是否成功标记
out_uuid String 3333 返回外部请求流水号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelOrderFutureInfoGetRequest req = new XhotelOrderFutureInfoGetRequest();
req.setOutUuid("333333");
req.setTids("123455666;123455666;123455666");
req.setCreatedStart(StringUtils.parseDateTime("2015-12-12 00:00:00"));
req.setCreatedEnd(StringUtils.parseDateTime("2015-12-12 00:00:00"));
req.setHotelCode("123");
req.setVendor("zhuzhe");
req.setOperateType(1L);
XhotelOrderFutureInfoGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_order_future_info_get_response>
    <results>
        <hotel_order_direct_info>
            <request_i_d>22</request_i_d>
            <tid>123</tid>
            <out_order_id>345</out_order_id>
            <seller_id>44</seller_id>
            <hotel_code>44</hotel_code>
            <gmt_create>2016-03-11 00:00:00</gmt_create>
            <gmt_modified>2016-03-11 00:00:00</gmt_modified>
            <biz_type>1</biz_type>
            <context>&lt;CheckInInfo&gt;&lt;RoomNum&gt;8008&lt;/RoomNum&gt;&lt;DeviceId&gt;NO12001&lt;/DeviceId&gt;&lt;Guests&gt;&lt;Guest&gt;&lt;GuestName&gt;张三&lt;/GuestName&gt;&lt;CertificateType&gt;20&lt;/CertificateType&gt;&lt;CertificateNum&gt;367719189009873678&lt;/CertificateNum&gt;&lt;/Guest&gt;&lt;/Guests&gt;&lt;/CheckInInfo&gt;</context>
            <extensions>{“key”:&quot;value&quot;}</extensions>
            <action>0</action>
            <status>0</status>
            <display_text>请尽快发起结账</display_text>
        </hotel_order_direct_info>
    </results>
    <issuccess>false</issuccess>
    <out_uuid>3333</out_uuid>
</xhotel_order_future_info_get_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部