文档中心 > API类目 > 酒店商品API

taobao.xhotel.baseinfo.get (酒店基础信息查询接口)

酒店基础信息(酒店/房型/房价定义)查询接口, 包括 酒店房型可售, 以及 hid 下 的标准房型列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
hid Number 可选 100000 淘宝酒店ID
out_hid String 可选 HOTEL123
  • 最大长度:64
  • 推荐使用卖家系统中的酒店ID。
    vendor String 可选 taobao
  • 最大长度:50
  • 用于标示该酒店发布的渠道信息
    is_need_rate_plan Boolean 可选 true
  • 默认值:true
  • 是否需要房价基本信息(false为不需要),默认为需要
    is_need_room_type Boolean 可选 true
  • 默认值:true
  • 是否需要房型基本信息(false为不需要),默认为需要
    need_s_room_type_list Boolean 可选 false
  • 默认值:false
  • 是否需要 根据 hid 查询 标准房型列表
    need_hotel_dynamic_info Boolean 可选 false
  • 默认值:false
  • 是否需要酒店房型可售详情
    json_hotel_seller_inv_query String 可选 0 在查询酒店房型可售详情 时的入参JSON , {@link com.taobao.trip.hpc.client.query.HotelSellerInvQuery}

    响应参数

    名称 类型 示例值 描述
    result ResultSet result
    • └ error_code
    • String
    • errorCode
    • errorCode
    • └ error_msg
    • String
    • errorMsg
    • errorMsg
    • xhotel_base_info
    • XHotelBaseInfo
    • 酒店基础信息
    • room_type_list
    • RoomType []
    • 房型基础信息
    • └ name
    • String
    • 标准间
    • 房型名称
    • └ rid
    • Number
    • 123456
    • 阿里房型id
    • └ status
    • byte
    • 0
    • 房型状态。0:正常,-1:删除,-2:停售
    • └ vendor
    • String
    • taobao
    • 系统商,一般不填写,使用须申请
    • └ outer_id
    • String
    • 123123
    • 商家房型ID
    • rate_plan_list
    • RatePlan []
    • 房价基础信息(需要新增rp时绑定酒店)
    • └ vendor
    • String
    • taobao
    • 系统商,一般不填写,使用须申请
    • └ name
    • String
    • abc
    • 房价名称
    • └ rate_plan_code
    • String
    • abc123
    • 卖家自己系统的Code,简称RateCode
    • └ rate_plan_id
    • Number
    • 123456
    • 阿里房价id
    • └ status
    • Number
    • 1
    • 1:开启2:关闭。
    • hotel
    • Hotel
    • 卖家酒店对象
    • └ hid
    • Number
    • 11910015271
    • 酒店ID
    • └ remark
    • String
    • 0
    • 酒店修改备注
    • └ tel
    • String
    • 0086#010#85636963
    • 酒店电话。格式:国家代码(最长6位)#区号(最长4位)#电话(最长20位)。国家代码提示:中国大陆0086、香港00852、澳门00853、台湾00886
    • └ hotel_facilities
    • String
    • 0
    • 酒店设施。json格式
    • └ type
    • String
    • 0
    • 酒店类型
    • └ ext
    • String
    • 0
    • 扩展信息
    • └ city
    • Number
    • 110100
    • 城市编码
    • └ postal_code
    • String
    • 0
    • 邮编
    • └ floors
    • String
    • 0
    • 楼层信息
    • └ seller_nick
    • String
    • 1111vvc3
    • 卖家名称
    • └ description
    • String
    • 0
    • 酒店中文描述
    • └ province
    • Number
    • 110000
    • 省份编码
    • └ longitude
    • String
    • 116.436851
    • 经度
    • └ data_confirm
    • Number
    • 0
    • 匹配是否人工确认
    • └ rooms
    • Number
    • 0
    • 房间数
    • └ currency_code_name
    • String
    • CNY
    • 货币类型(编码,字母编码)
    • └ status
    • Number
    • 0
    • 酒店状态
    • └ en_desc
    • String
    • 0
    • 酒店英文描述
    • └ country
    • String
    • China
    • domestic=0时,固定China; domestic=1时,是海外国家编码值
    • └ hotel_policies
    • String
    • 0
    • 酒店入住政策
    • └ latitude
    • String
    • 39.91646
    • 纬度
    • └ oper_xiaoer_name
    • String
    • XXX小二
    • 操作人信息
    • └ outer_id
    • String
    • 11910015272
    • 酒店外部ID
    • └ gmt_modified
    • Date
    • 1498484382000
    • 酒店修改时间
    • └ down_shelf_type
    • Number
    • 2
    • 酒店下架类型
    • └ en_addr
    • String
    • 0
    • 酒店英文地址
    • └ shid
    • Number
    • 10004368
    • 标准酒店ID
    • └ business
    • String
    • 0
    • 商圈
    • └ used_name
    • String
    • 0
    • 酒店曾用名
    • └ pics
    • String
    • 0
    • 酒店图片信息
    • └ room_facilities
    • String
    • 0
    • 房间设施
    • └ name
    • String
    • 北京易涛万邦酒店1
    • 酒店名
    • └ position_type
    • String
    • B
    • 坐标类型,现在支持:G : Google:B : 百度;A : 高德;M : Mapbar;L : 灵图
    • └ billing_process_type
    • Number
    • 1
    • 酒店支付结算类型
    • └ district
    • Number
    • 110105
    • 地区编码
    • └ name_e
    • String
    • 0
    • 酒店名称(英文)
    • └ gmt_create
    • Date
    • 1409285077000
    • 酒店创建时间
    • └ vendor
    • String
    • taobao
    • 酒店的销售渠道
    • └ extend
    • String
    • 0
    • 扩展信息
    • └ star
    • String
    • 0
    • 酒店星级
    • └ booking_notice
    • String
    • 0
    • 预订须知
    • └ domestic
    • Number
    • 0
    • 是否国外。
    • └ decorate_time
    • String
    • 0
    • 装修时间
    • └ source
    • Number
    • 1
    • 来源
    • └ address
    • String
    • 北京市 北京 朝阳区 外交部南街14号
    • 酒店地址
    • └ seller_id
    • Number
    • 2049618271
    • 卖家ID
    • └ match_status
    • Number
    • 5
    • 匹配状态
    • └ service
    • String
    • 0
    • 酒店服务
    • └ brand
    • String
    • 0
    • 品牌
    • └ kzzy_tag
    • Number
    • 0
    • 判断该酒店是不是对应的卖家直营
    • └ opening_time
    • String
    • 0
    • 开业时间
    • s_room_type_list
    • Sroomtypelist []
    • 标准房型列表
    • └ window_type
    • String
    • 0
    • 窗型
    • └ pics_info
    • String
    • 0
    • 酒店图片结构化信息
    • └ network_service
    • String
    • 0
    • 宽带服务
    • └ last_modify
    • String
    • 0
    • 最后变更人
    • └ include_types
    • String
    • 0
    • includeTypes
    • └ auditor
    • String
    • 0
    • 创建人
    • └ shid
    • Number
    • 0
    • 标准酒店ID
    • └ original_pics
    • String
    • 0
    • 房型原始图片
    • └ version
    • Number
    • 0
    • 版本号
    • └ srid
    • Number
    • 0
    • 标准房型ID
    • └ pics
    • String
    • 0
    • 房型图片
    • └ pics_ext
    • String
    • 0
    • 图片扩展字段
    • └ area
    • String
    • 0
    • 面积
    • └ facility
    • String
    • 0
    • 设施
    • └ name
    • String
    • 0
    • 标准房型名称
    • └ properties_d_os
    • String
    • 0
    • propertiesDOs
    • └ add_bed
    • Number
    • 0
    • 是否可加床
    • └ name_e
    • String
    • 0
    • 标准房型的英文名
    • └ status
    • Number
    • 0
    • 状态
    • └ extend
    • String
    • 0
    • 扩展信息
    • └ bed
    • String
    • 0
    • 床型
    • └ transfer_pics
    • String
    • 0
    • transferPics
    • └ floor
    • String
    • 0
    • 楼层
    • └ source
    • Number
    • 0
    • 来源
    • └ bed_list
    • String
    • 0
    • bedList
    • └ max_occupancy
    • Number
    • 0
    • 最大入住人数
    • └ outer_id
    • String
    • 0
    • 外部id
    • └ total_hotel_dynamic_info
    • Number
    • 0
    • 酒店房型可售详情查询总数
    • hotel_dynamic_info_list
    • Hoteldynamicinfo []
    • 酒店房型可售详情查
    • └ unsale_reason
    • String
    • 0
    • 不可售原因
    • └ hid
    • Number
    • 0
    • 酒店hid
    • └ status
    • Number
    • 0
    • 酒店状态
    • └ vendor
    • String
    • 0
    • 酒店的销售渠道
    • └ ks_heathy_room_num
    • Number
    • 0
    • 可售健康房型数
    • └ tel
    • String
    • 0
    • 电话
    • └ shid
    • Number
    • 0
    • 标准酒店ID
    • └ city_str
    • String
    • 0
    • 城市名称
    • └ city
    • Number
    • 0
    • 城市编码
    • └ id
    • Number
    • 0
    • id
    • └ room_nun
    • Number
    • 0
    • 房型数
    • └ seller_nick
    • String
    • 0
    • 卖家昵称
    • └ address
    • String
    • 0
    • 地址
    • └ ks_room_num
    • Number
    • 0
    • 可售房型数
    • └ seller_id
    • Number
    • 0
    • 卖家ID
    • └ unsale_type
    • Number
    • 0
    • 不可售原因
    • └ name
    • String
    • 0
    • 酒店名字
    • └ calculate_date
    • String
    • 0
    • 分析日期
    • └ data_confirm
    • Number
    • 0
    • 酒店匹配
    • └ outer_id
    • String
    • 0
    • 酒店外部ID
    • └ tag_json
    • String
    • {"pure-direct-hotel":0,"direct-manual-order-hotel":1,"ebk-direct-hotel":0,"non-direct-hotel":1,"allow-dingding-business-travel-hotel":1,"willing-dingding-bussiness-travel-hotel":0,"calendar-room-package-hotel":1,"dijiajiajia-hotel":0,"ebk-number-of-confirm-room-hotel":1}
    • 酒店维度特殊标签含义, json: {"pure-direct-hotel":0,"direct-manual-order-hotel":1,"ebk-direct-hotel":0,"non-direct-hotel":1,"allow-dingding-business-travel-hotel":1,"willing-dingding-bussiness-travel-hotel":0,"calendar-room-package-hotel":1,"dijiajiajia-hotel":0,"ebk-number-of-confirm-room-hotel":1} , key含义: pure-direct-hotel 表示纯直连酒店, direct-manual-order-hotel 和 ebk-direct-hotel 和 non-direct-hotel 这三个key对应value都是0 . direct-manual-order-hotel 表示 人工承接失败订单的酒店标签。如果某个直连酒店打了该标签,那么直连下单失败以后,允许人工承接订单,由人工跟进 . ebk-direct-hotel 表示 ebk直连酒店标。如果某个酒店打了该标签,那么这个酒店下允许通过ebk发布直连rp . non-direct-hotel 表示 卖家非直连酒店标签。如果某个酒店打了该标签,那么该酒店下单不会走直连交易。 allow-dingding-business-travel-hotel 表示 允许进入阿里商旅渠道(钉钉)售卖信用住的单体酒店 willing-dingding-bussiness-travel-hotel 表示 已签协议愿意加入阿里商旅渠道售卖信用住的单体酒店 . calendar-room-package-hotel 表示 酒店可以参加日历房套餐活动包括创建,修改,删除活动信息(高星集团GMV项目) dijiajiajia-hotel 表示 底价加价酒店权限标。只有打了该标的酒店才允许维护底价加价规则和包房rp . ebk-number-of-confirm-room-hotel 表示ebk确认订单,是否要输入外部确认号
    • └ success
    • Boolean
    • true
    • success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    XhotelBaseinfoGetRequest req = new XhotelBaseinfoGetRequest();
    req.setHid(100000L);
    req.setOutHid("HOTEL123");
    req.setVendor("taobao");
    req.setIsNeedRatePlan(true);
    req.setIsNeedRoomType(true);
    req.setNeedSRoomTypeList(false);
    req.setNeedHotelDynamicInfo(false);
    req.setJsonHotelSellerInvQuery("0");
    XhotelBaseinfoGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_baseinfo_get_response>
        <result>
            <error_code>errorCode</error_code>
            <error_msg>errorMsg</error_msg>
            <xhotel_base_info>
                <room_type_list>
                    <room_type>
                        <name>标准间</name>
                        <rid>123456</rid>
                        <status>0</status>
                        <vendor>taobao</vendor>
                        <outer_id>123123</outer_id>
                    </room_type>
                </room_type_list>
                <rate_plan_list>
                    <rate_plan>
                        <vendor>taobao</vendor>
                        <name>abc</name>
                        <rate_plan_code>abc123</rate_plan_code>
                        <rate_plan_id>123456</rate_plan_id>
                        <status>1</status>
                    </rate_plan>
                </rate_plan_list>
                <hotel>
                    <hid>11910015271</hid>
                    <remark>0</remark>
                    <tel>0086#010#85636963</tel>
                    <hotel_facilities>0</hotel_facilities>
                    <type>0</type>
                    <ext>0</ext>
                    <city>110100</city>
                    <postal_code>0</postal_code>
                    <floors>0</floors>
                    <seller_nick>1111vvc3</seller_nick>
                    <description>0</description>
                    <province>110000</province>
                    <longitude>116.436851</longitude>
                    <data_confirm>0</data_confirm>
                    <rooms>0</rooms>
                    <currency_code_name>CNY</currency_code_name>
                    <status>0</status>
                    <en_desc>0</en_desc>
                    <country>China</country>
                    <hotel_policies>0</hotel_policies>
                    <latitude>39.91646</latitude>
                    <oper_xiaoer_name>XXX小二</oper_xiaoer_name>
                    <outer_id>11910015272</outer_id>
                    <gmt_modified>1498484382000</gmt_modified>
                    <down_shelf_type>2</down_shelf_type>
                    <en_addr>0</en_addr>
                    <shid>10004368</shid>
                    <business>0</business>
                    <used_name>0</used_name>
                    <pics>0</pics>
                    <room_facilities>0</room_facilities>
                    <name>北京易涛万邦酒店1</name>
                    <position_type>B</position_type>
                    <billing_process_type>1</billing_process_type>
                    <district>110105</district>
                    <name_e>0</name_e>
                    <gmt_create>1409285077000</gmt_create>
                    <vendor>taobao</vendor>
                    <extend>0</extend>
                    <star>0</star>
                    <booking_notice>0</booking_notice>
                    <domestic>0</domestic>
                    <decorate_time>0</decorate_time>
                    <source>1</source>
                    <address>北京市 北京 朝阳区 外交部南街14号</address>
                    <seller_id>2049618271</seller_id>
                    <match_status>5</match_status>
                    <service>0</service>
                    <brand>0</brand>
                    <kzzy_tag>0</kzzy_tag>
                    <opening_time>0</opening_time>
                </hotel>
                <s_room_type_list>
                    <sroomtypelist>
                        <window_type>0</window_type>
                        <pics_info>0</pics_info>
                        <network_service>0</network_service>
                        <last_modify>0</last_modify>
                        <include_types>0</include_types>
                        <auditor>0</auditor>
                        <shid>0</shid>
                        <original_pics>0</original_pics>
                        <version>0</version>
                        <srid>0</srid>
                        <pics>0</pics>
                        <pics_ext>0</pics_ext>
                        <area>0</area>
                        <facility>0</facility>
                        <name>0</name>
                        <properties_d_os>0</properties_d_os>
                        <add_bed>0</add_bed>
                        <name_e>0</name_e>
                        <status>0</status>
                        <extend>0</extend>
                        <bed>0</bed>
                        <transfer_pics>0</transfer_pics>
                        <floor>0</floor>
                        <source>0</source>
                        <bed_list>0</bed_list>
                        <max_occupancy>0</max_occupancy>
                        <outer_id>0</outer_id>
                    </sroomtypelist>
                </s_room_type_list>
                <total_hotel_dynamic_info>0</total_hotel_dynamic_info>
                <hotel_dynamic_info_list>
                    <hoteldynamicinfo>
                        <unsale_reason>0</unsale_reason>
                        <hid>0</hid>
                        <status>0</status>
                        <vendor>0</vendor>
                        <ks_heathy_room_num>0</ks_heathy_room_num>
                        <tel>0</tel>
                        <shid>0</shid>
                        <city_str>0</city_str>
                        <city>0</city>
                        <id>0</id>
                        <room_nun>0</room_nun>
                        <seller_nick>0</seller_nick>
                        <address>0</address>
                        <ks_room_num>0</ks_room_num>
                        <seller_id>0</seller_id>
                        <unsale_type>0</unsale_type>
                        <name>0</name>
                        <calculate_date>0</calculate_date>
                        <data_confirm>0</data_confirm>
                        <outer_id>0</outer_id>
                    </hoteldynamicinfo>
                </hotel_dynamic_info_list>
                <tag_json>{&quot;pure-direct-hotel&quot;:0,&quot;direct-manual-order-hotel&quot;:1,&quot;ebk-direct-hotel&quot;:0,&quot;non-direct-hotel&quot;:1,&quot;allow-dingding-business-travel-hotel&quot;:1,&quot;willing-dingding-bussiness-travel-hotel&quot;:0,&quot;calendar-room-package-hotel&quot;:1,&quot;dijiajiajia-hotel&quot;:0,&quot;ebk-number-of-confirm-room-hotel&quot;:1}</tag_json>
            </xhotel_base_info>
            <success>true</success>
        </result>
    </xhotel_baseinfo_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

    返回
    顶部