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

酒店商品API

taobao.xhotel.add (酒店新增接口（ID重复自动更新）)

添加酒店或更新酒店

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
outer_id String 必须 12312313
  • 最大长度：64
    		•  外部酒店ID, 这是卖家自己系统中的ID
    name String 必须 北京饭店
  • 最大长度：128
    		•  酒店名称,国内酒店请传中文名称
    used_name String 可选 北京饭店
  • 最大长度：60
    		•  酒店曾用名
    domestic Number 可选 0
  • 默认值：0
    		•  是否国内酒店。0:国内;1:国外。默认是国内
    country String 可选 China
  • 最大长度：30
    		•  domestic为0时，固定China； domestic为1时，必须传定义的海外国家编码值。参见：http://hotel.alitrip.com/area.htm
    province Number 可选 110000 省份编码。选填，不填入的时候已city字段为准.参见：http://hotel.alitrip.com/area.htm，domestic为false时默认为0
    city Number 必须 110100 城市编码。参见：http://hotel.alitrip.com/area.htm，domestic为false时，输入对应国家的海外城市编码，可调用海外城市查询接口获取；（更新酒店时为可选）
    district Number 可选 110101
  • 默认值：0
    		•  区域（县级市）编码。参见：http://hotel.alitrip.com/area.htm
    business String 可选 aaa
  • 最大长度：20
    		•  商业区（圈）长度不超过20字
    address String 必须 西直门
  • 最大长度：255
    		•  酒店地址。长度不能超过255。不填入会导致不能自动匹配。
    longitude String 可选 111.13
  • 最大长度：10
    		•  经度
    latitude String 可选 111.1222
  • 最大长度：10
    		•  纬度
    position_type String 可选 G 坐标类型，现在支持：G – GoogleB – 百度A – 高德M – MapbarL – 灵图
    tel String 必须 0086#010#12345678
  • 最大长度：30
    		•  酒店电话。格式：国家代码（最长6位）#区号（最长4位）#电话（最长20位）。国家代码提示：中国大陆0086、香港00852、澳门00853、台湾00886
    extend String 可选 {"keyword":”上地”}
  • 最大长度：500
    		•  扩展信息的JSON。注：此字段的值需要ISV在接入前与淘宝沟通，且确认能解析
    shid Number 可选 123123 该字段只有确定的时候，才允许填入。用于标示和淘宝酒店的匹配关系。目前尚未启动该字段。
    vendor String 可选 taobao
  • 最大长度：50
    		•  对接系统商名称：可为空不要乱填，需要申请后使用
    star String 可选 1
  • 最大长度：3
    		•  酒店档次，星级。取值范围为1,1.5,2,2.5,3,3.5,4,4.5,5
    opening_time String 可选 2015-01-01 开业时间，格式为2015-01-01
    decorate_time String 可选 2015-01-01 装修时间，格式为2015-01-01装修时间
    floors String 可选 4-6层
  • 最大长度：32
    		•  楼层信息。
    rooms Number 可选 10 房间数 0~9999之内的数字
    description String 可选 酒店描述 酒店描述
    pics String 可选 [{"url":"http://123.jpg","ismain":"false","type":"大堂","attribute":"普通图"},{"url":"http://456.jpg","ismain":"true","type":"公共区域","attribute":"全景图"},{"url":"http://789.jpg","ismain":"false","type":"大堂","attribute":"普通图"}] 酒店图片只支持远程图片，格式如下：[{"url":"http://123.jpg","ismain":"false","type":"大堂","attribute":"普通图"},{"url":"http://456.jpg","ismain":"true","type":"公共区域","attribute":"全景图"},{"url":"http://789.jpg","ismain":"false","type":"大堂","attribute":"普通图"}] 其中url是远程图片的访问地址（URL地址必须是合法的，否则会报错），main是是否为主图（主图只能有一个，如果有多个或者没有，则会报错）,attribute表示图片属性，取值范围只能是：[普通图, 平面图, 全景图] ,type表示图片类型，取值范围只能是：[周边, 外观, 商务中心, 其他,餐厅, 浴室, 客房, 公共区域, 娱乐设施, 大堂]，图片数量最多是能是10张。
    brand String 可选 1 酒店品牌。取值为数字。枚举见链接：https://open.alitrip.com/docs/doc.htm?spm=0.0.0.0.S16vXH&docType=1&articleId=120180
    postal_code String 可选 邮编
  • 最大长度：20
    		•  邮政编码。
    booking_notice String 可选 {"hotelInMountaintop":1,"needBoat":1,"hotelInScenicSpot":1,"extraBed":"加床收费xx元","extraCharge":"","arrivalTime":"入住日18点前","extend":""}
  • 最大长度：2000
    		•  预订须知。json字段描述：hotelInMountaintop 酒店位于山顶 1在山顶、0不在；needBoat 酒店需要坐船前往 1需要、0不需要；酒店位于景区内 1在景区、0不在；extraBed 加床收费；extraCharge 额外收费；arrivalTime 到店时间；extend 其他补充项
    credit_card_types String 可选 1,2,3 逗号分隔的字符串 1visa；2万事达卡；3美国运通卡；4发现卡；5大来卡；6JCB卡；7银联卡
    orbit_track String 可选 { "orbitTrack":[ { "platform":"飞猪", "ways":"直连" }, { "platform":"去哪儿", "ways":"直连" } { "platform":"如家", "ways":"电话" }, { "platform":"如家西湖店", "ways":"人工" } ] } 扩展信息的JSON。 orbitTrack 业务字段是指从飞猪到酒店说经过平台名以及方式的一个数组，按顺序，从飞猪，再经过若干平台，最后到酒店， platform是指定当前平台名，ways 是指通过哪种方式到该平台 其中，飞猪到下一个平台里, ways 字段只能是【直连】、【人工】两个方式之一； 从最后一个平台到酒店的ways字段只能是【电话】、【传真】、【人工】、【系统】之一； 第一个 飞猪平台 和 最后具体酒店是至少得填的
    name_e String 可选 Beijing hotel 卖家酒店英文名称
    supplier String 可选 abc 供应商标识，需要提前开通权限，如果需要对接请联系技术支持，请谨慎使用。注：如商家申请的应用类型为“飞猪-新业务”，此项则必填。
    settlement_currency String 可选 HKD 结算过程中的结算币种符合，如需对接请联系飞猪技术支持，请谨慎使用
    standard_amuse_facilities String 可选 {"dataVersion":"2.0.0","facilityList":[{"75":true}]} 标准娱乐设施,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_room_facilities String 可选 废弃 已废弃(房型设施信息请在房型上推送)
    standard_hotel_service String 可选 {"dataVersion":"2.0.0","facilityList":[{"12":true,"free":true}]} 标准酒店服务,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_hotel_facilities String 可选 {"dataVersion":"2.0.0","facilityList":[{"51":true,"option":"2"}]} 标准酒店设施,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_booking_notice String 可选 {"dataVersion":"2.0.0","facilityList":[{"500":true,"free":true}]} 标准预订须知,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    service_type Number 可选 0 0:可以接待外宾；1:仅内宾
    hotel_type Number 可选 0 0:酒店；1:客栈
    coordinate_system String 可选 WGS84 标识坐标系类型。WGS84，表示地球坐标系 ；GCJ02，表示火星坐标系
    room_facilities String 可选 废弃 废弃
    service String 可选 废弃 废弃
    hotel_facilities String 可选 废弃 废弃
    hotel_policies String 可选 废弃 废弃

    响应参数

    名称 类型 示例值 描述
    xhotel XHotel 酒店信息
    • └ hid
    • Number
    • 123456
    • 酒店ID
    • └ status
    • Number
    • 0
    • 酒店状态：0: 正常;-2:停售；-1：删除
    • s_hotel
    • SHotel
    • 淘宝标准酒店信息
    • └ shid
    • Number
    • 123456
    • 酒店ID
    • └ name
    • String
    • 60
    • name
    • └ used_name
    • String
    • aaa
    • used_name
    • └ type
    • String
    • 连锁品牌，家庭旅馆
    • 酒店类型
    • └ domestic
    • Number
    • 0
    • 0:国内;1:国外
    • └ country
    • String
    • China
    • 国家编码
    • └ city_tag
    • String
    • 11,33
    • 地区标签
    • └ province
    • Number
    • 110000
    • 省份编码
    • └ city
    • Number
    • 110100
    • 城市编码
    • └ district
    • Number
    • 110101
    • 区域编码
    • └ business
    • String
    • aaa
    • business
    • └ address
    • String
    • 王府井
    • 酒店地址
    • └ level
    • String
    • A
    • 酒店级别
    • └ longitude
    • String
    • 2222.44
    • longitude
    • └ latitude
    • String
    • 123456.777
    • latitude
    • └ position_type
    • Number
    • 1
    • position_type
    • └ tel
    • String
    • 0086#010#12345678
    • 酒店电话
    • └ fax
    • String
    • 0086#010#12345678
    • 传真
    • └ opening_time
    • String
    • 2012
    • 开业年份
    • └ decorate_time
    • String
    • 2013
    • 装修年份
    • └ storeys
    • String
    • 11
    • 楼层数
    • └ extend
    • String
    • {"keyword":”上地”}
    • 扩展信息的JSON
    • └ rooms
    • Number
    • 100
    • 房间数
    • └ desc
    • String
    • 北京饭店在王府井位于XXX
    • 酒店介绍
    • └ service
    • String
    • {"airportShuttle":true}
    • 交通距离与设施服务。JSON格式。
    • └ hotel_facilities
    • String
    • {"会议室":true,"中式餐厅":true}
    • 酒店设施
    • └ room_facilities
    • String
    • {"宽带上网":true,"空调":true}
    • 房间设施
    • └ pic_url
    • String
    • http://img01.taobaocdn.com/bao/uploaded/i3/T1Ym4bXeJBXXbPV7.9_104339.jpg
    • 酒店图片url
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ status
    • Number
    • 1
    • 0,营业中；-1，筹建中；-2，暂停营业；-3，已停业；默认为0
    • └ postal_code
    • String
    • 100072
    • 邮编
    • └ brand
    • String
    • aaa
    • brand
    • └ outer_id
    • String
    • 1111111
    • 卖家自己系统的id
    • └ name
    • String
    • 北京饭店
    • 酒店名称
    • └ domestic
    • Number
    • 0
    • 0:国内;1:国外
    • └ country
    • String
    • China
    • 国家编码
    • └ used_name
    • String
    • 北京大酒店
    • 曾用名
    • └ province
    • Number
    • 110100
    • 省份编码
    • └ city
    • Number
    • 110101
    • 城市编码
    • └ district
    • Number
    • 110101
    • 地区编码
    • └ business
    • String
    • aaa
    • 商圈信息
    • └ address
    • String
    • 北京市朝阳区
    • 酒店地址
    • └ longitude
    • String
    • 100.122
    • 经度
    • └ latitude
    • String
    • 110.122
    • 纬度
    • └ position_type
    • String
    • A
    • 坐标类型
    • └ tel
    • String
    • 0086#010#12345678
    • 酒店电话
    • └ extend
    • String
    • {"keyword":”上地”}
    • 扩展信息
    • └ match_status
    • Number
    • 1
    • 此字段已废弃
    • └ error_info
    • String
    • 酒店不存在
    • 未通过时的拒绝原因等。
    • └ credit_card_types
    • String
    • 1,2,3
    • 逗号分隔的字符串 1visa；2万事达卡；3美国运通卡；4发现卡；5大来卡；6JCB卡；7银联卡
    • └ name_e
    • String
    • Beijing hotel
    • 卖家酒店英文名称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelAddRequest req = new XhotelAddRequest();
req.setOuterId("12312313");
req.setName("北京饭店");
req.setUsedName("北京饭店");
req.setDomestic(0L);
req.setCountry("China");
req.setProvince(110000L);
req.setCity(110100L);
req.setDistrict(110101L);
req.setBusiness("aaa");
req.setAddress("西直门");
req.setLongitude("111.13");
req.setLatitude("111.1222");
req.setPositionType("G");
req.setTel("0086#010#12345678");
req.setExtend("{\"keyword\":”上地”}");
req.setShid(123123L);
req.setVendor("taobao");
req.setStar("1");
req.setOpeningTime("2015-01-01");
req.setDecorateTime("2015-01-01");
req.setFloors("4-6层");
req.setRooms(10L);
req.setDescription("酒店描述");
req.setPics("[{\"url\":\"http://123.jpg\",\"ismain\":\"false\",\"type\":\"大堂\",\"attribute\":\"普通图\"},{\"url\":\"http://456.jpg\",\"ismain\":\"true\",\"type\":\"公共区域\",\"attribute\":\"全景图\"},{\"url\":\"http://789.jpg\",\"ismain\":\"false\",\"type\":\"大堂\",\"attribute\":\"普通图\"}]");
req.setBrand("1");
req.setPostalCode("邮编");
req.setBookingNotice("{\"hotelInMountaintop\":1,\"needBoat\":1,\"hotelInScenicSpot\":1,\"extraBed\":\"加床收费xx元\",\"extraCharge\":\"\",\"arrivalTime\":\"入住日18点前\",\"extend\":\"\"}");
req.setCreditCardTypes("1,2,3");
req.setOrbitTrack("{ 	\"orbitTrack\":[ 		{ 			\"platform\":\"飞猪\", 			\"ways\":\"直连\"  		}, 		{ 			\"platform\":\"去哪儿\", 			\"ways\":\"直连\" 		} 		{ 			\"platform\":\"如家\", 			\"ways\":\"电话\" 		}, 		{ 			\"platform\":\"如家西湖店\", 			\"ways\":\"人工\" 		} 	] }");
req.setNameE("Beijing hotel");
req.setSupplier("abc");
req.setSettlementCurrency("HKD");
req.setStandardAmuseFacilities("{\"dataVersion\":\"2.0.0\",\"facilityList\":[{\"75\":true}]}");
req.setStandardRoomFacilities("废弃");
req.setStandardHotelService("{\"dataVersion\":\"2.0.0\",\"facilityList\":[{\"12\":true,\"free\":true}]}");
req.setStandardHotelFacilities("{\"dataVersion\":\"2.0.0\",\"facilityList\":[{\"51\":true,\"option\":\"2\"}]}");
req.setStandardBookingNotice("{\"dataVersion\":\"2.0.0\",\"facilityList\":[{\"500\":true,\"free\":true}]}");
req.setServiceType(0L);
req.setHotelType(0L);
req.setCoordinateSystem("WGS84");
req.setRoomFacilities("废弃");
req.setService("废弃");
req.setHotelFacilities("废弃");
req.setHotelPolicies("废弃");
XhotelAddResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <xhotel_add_response>
    <xhotel>
        <hid>123456</hid>
        <status>0</status>
        <s_hotel>
            <shid>123456</shid>
            <name>60</name>
            <used_name>aaa</used_name>
            <type>连锁品牌，家庭旅馆</type>
            <domestic>0</domestic>
            <country>China</country>
            <city_tag>11,33</city_tag>
            <province>110000</province>
            <city>110100</city>
            <district>110101</district>
            <business>aaa</business>
            <address>王府井</address>
            <level>A</level>
            <longitude>2222.44</longitude>
            <latitude>123456.777</latitude>
            <position_type>1</position_type>
            <tel>0086#010#12345678</tel>
            <fax>0086#010#12345678</fax>
            <opening_time>2012</opening_time>
            <decorate_time>2013</decorate_time>
            <storeys>11</storeys>
            <extend>{&quot;keyword&quot;:”上地”}</extend>
            <rooms>100</rooms>
            <desc>北京饭店在王府井位于XXX</desc>
            <service>{&quot;airportShuttle&quot;:true}</service>
            <hotel_facilities>{&quot;会议室&quot;:true,&quot;中式餐厅&quot;:true}</hotel_facilities>
            <room_facilities>{&quot;宽带上网&quot;:true,&quot;空调&quot;:true}</room_facilities>
            <pic_url>http://img01.taobaocdn.com/bao/uploaded/i3/T1Ym4bXeJBXXbPV7.9_104339.jpg</pic_url>
            <created_time>2000-01-01 00:00:00</created_time>
            <modified_time>2000-01-01 00:00:00</modified_time>
            <status>1</status>
            <postal_code>100072</postal_code>
            <brand>aaa</brand>
        </s_hotel>
        <outer_id>1111111</outer_id>
        <name>北京饭店</name>
        <domestic>0</domestic>
        <country>China</country>
        <used_name>北京大酒店</used_name>
        <province>110100</province>
        <city>110101</city>
        <district>110101</district>
        <business>aaa</business>
        <address>北京市朝阳区</address>
        <longitude>100.122</longitude>
        <latitude>110.122</latitude>
        <position_type>A</position_type>
        <tel>0086#010#12345678</tel>
        <extend>{&quot;keyword&quot;:”上地”}</extend>
        <match_status>1</match_status>
        <error_info>酒店不存在</error_info>
        <credit_card_types>1,2,3</credit_card_types>
        <name_e>Beijing hotel</name_e>
    </xhotel>
</xhotel_add_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:NOTNULL 参数不能为空 请检查参数
    isv.invalid-parameter:ERROR 参数不正确 请检查参数
    isv.biz-error:STATUS_NOT_CORRECT 状态不正确 请检查状态
    isv.biz-error:NOT_RIGHTS_TO_PUBLISH_ERROR 非消保酒店卖家不能发布修改酒店、房型或宝贝 请使用消保酒店卖家操作
    isv.biz-error:HAS_NOT_MATCH_SHOTEL 酒店尚未匹配到标准酒店 请先进行酒店匹配
    isv.biz-error:HAS_NOT_CONFRIM_HOTEL 酒店匹配结果尚未确认 请先进行酒店匹配结果确认
    isv.invalid-parameter:HOTEL_EXIST 酒店已经存在 请不要重复添加酒店
    isv.invalid-parameter:HOTEL_NOT_EXIST 酒店不存在 请检查输入参数
    isv.biz-error:UPDATE_HOTEL_ERROR 更新酒店失败 请稍后重试
    isv.biz-error:CAN_NOT_UPDATE_HOTEL 酒店处于待匹配待确认或已确认成功状态无法更新 请检查匹配状态或稍后重试
    isv.invalid-parameter:BUSINESS_AREA_NOT_EXIST 商圈不存在 请检查商圈信息
    isv.biz-error:ALREADY_EXIST_SHOTEL 该卖家已经有酒店匹配了该标准酒店 请检查酒店信息，不要重复匹配
    isv.permission-error:NO_PERMISSIONS_ERROR 权限不够、非法访问 请申请权限
    isv.remote-service:CONVERT_ERROR 转换对象时出错 请检查输入参数
    isv.invalid-parameter:LENGTH_OVERRANGE 长度非法 长度非法
    isv.biz-error:UPDATE_HOTEL_CITY_ERROR 城市编码错误 需要传输正确的城市编码，编码在这里查找 http://kezhan.trip.taobao.com/area.html
    biz-error:PUBLISH_FORBIDDEN 酒店发布数量超限，请联系飞猪业务 请联系飞猪业务

    API工具

    API测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    尚景

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