文档中心 > API类目 > 酒店API(新)

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

添加酒店或更新酒店

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
outer_id String 必须 123123131
  • 最大长度: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
  • 最小值:1
  • 最大值:9999
  • 房间数 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 可选 {"12313":true} 标准娱乐设施,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_room_facilities String 可选 {"12313":true} 标准房型设施,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_hotel_service String 可选 {"12313":true} 标准酒店服务,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_hotel_facilities String 可选 {"12313":true} 标准酒店设施,参考文档https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891
    standard_booking_notice String 可选 {"10009":"位于景区内"} 标准预订须知,参考文档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:删除
    • └ error_info
    • String
    • 酒店不存在
    • 未通过时的拒绝原因等。
    • s_hotel
    • SHotel
    • 淘宝标准酒店信息
    • └ shid
    • Number
    • 123456
    • 酒店ID
    • └ name
    • String
    • 60
    • name
    • └ used_name
    • String
    • aaa
    • used_name
    • └ domestic
    • Number
    • 0
    • 0:国内;1:国外
    • └ country
    • String
    • China
    • 国家编码
    • └ province
    • Number
    • 110000
    • 省份编码
    • └ city
    • Number
    • 110100
    • 城市编码
    • └ district
    • Number
    • 110101
    • 区域编码
    • └ address
    • String
    • 王府井
    • 酒店地址
    • └ level
    • String
    • A
    • 酒店级别
    • └ business
    • String
    • aaa
    • business
    • └ position_type
    • Number
    • 1
    • position_type
    • └ longitude
    • String
    • 2222.44
    • longitude
    • └ latitude
    • String
    • 123456.777
    • latitude
    • └ tel
    • String
    • 0086#010#12345678
    • 酒店电话
    • └ fax
    • String
    • 0086#010#12345678
    • 传真
    • └ opening_time
    • String
    • 2012
    • 开业年份
    • └ decorate_time
    • String
    • 2013
    • 装修年份
    • └ storeys
    • String
    • 11
    • 楼层数
    • └ rooms
    • Number
    • 100
    • 房间数
    • └ desc
    • String
    • 北京饭店在王府井位于XXX
    • 酒店介绍
    • └ service
    • String
    • {"airportShuttle":true}
    • 交通距离与设施服务。JSON格式。
    • └ pic_url
    • String
    • http://img01.taobaocdn.com/bao/uploaded/i3/T1Ym4bXeJBXXbPV7.9_104339.jpg
    • 酒店图片url
    • └ extend
    • String
    • {"keyword":”上地”}
    • 扩展信息的JSON
    • └ status
    • Number
    • 1
    • 状态:0:待系统匹配1:已系统匹配,匹配成功,待卖家确认2:已系统匹配,匹配失败,待人工匹配3:已人工匹配,匹配成功,待卖家确认4:已人工匹配,匹配失败5:卖家已确认,确认“YES”6:卖家已确认,确认“NO”7:停售
    • └ created_time
    • Date
    • 2000-01-01 00:00:00
    • 创建时间
    • └ modified_time
    • Date
    • 2000-01-01 00:00:00
    • 修改时间
    • └ brand
    • String
    • aaaa
    • brand
    • └ type
    • String
    • 连锁品牌,家庭旅馆
    • 酒店类型
    • └ hotel_facilities
    • String
    • {"会议室":true,"中式餐厅":true}
    • 酒店设施
    • └ room_facilities
    • String
    • {"宽带上网":true,"空调":true}
    • 房间设施
    • └ city_tag
    • String
    • 11,33
    • 地区标签
    • └ postal_code
    • String
    • 100072
    • 邮编
    • └ fee
    • String
    • 0
    • 杂费
    • └ srid
    • Number
    • 0
    • srid
    • └ pics
    • String
    • pics
    • └ area
    • String
    • area
    • └ facility
    • String
    • facility
    • └ floor
    • String
    • floor
    • └ max_occupancy
    • Number
    • 0
    • maxOccupancy
    • └ add_bed
    • Number
    • 0
    • addBed
    • └ bed
    • String
    • bed
    • └ gmt_create
    • Date
    • gmtCreate
    • └ network_service
    • String
    • networkService
    • └ gmt_modified
    • Date
    • gmtModified
    • └ window_type
    • String
    • windowType
    • └ name_e
    • String
    • aaa
    • 标准酒店英文名
    • └ is_kezhan
    • Number
    • 1
    • 0:酒店 1:客栈
    • └ match_status
    • Number
    • 1
    • hotel匹配状态: 0:待系统匹配 1:已系统匹配,匹配成功,待卖家确认 2:已系统匹配,匹配失败,待人工匹配 3:已人工匹配,匹配成功,待卖家确认 4:已人工匹配,匹配失败 5:卖家已确认,确认“YES” 6:卖家已确认,确认“NO” 7:已系统匹配,但是匹配重复,待人工确认
    • └ outer_id
    • String
    • 1111111
    • 卖家自己系统的id
    • └ name
    • String
    • 北京饭店
    • 酒店名称
    • └ used_name
    • String
    • 北京大酒店
    • 曾用名
    • └ domestic
    • Number
    • 0
    • 0:国内;1:国外
    • └ country
    • String
    • China
    • 国家编码
    • └ 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":”上地”}
    • 扩展信息
    • └ 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("123123131");
    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("{\"12313\":true}");
    req.setStandardRoomFacilities("{\"12313\":true}");
    req.setStandardHotelService("{\"12313\":true}");
    req.setStandardHotelFacilities("{\"12313\":true}");
    req.setStandardBookingNotice("{\"10009\":\"位于景区内\"}");
    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>
            <error_info>酒店不存在</error_info>
            <s_hotel>
            </s_hotel>
            <match_status>1</match_status>
            <outer_id>1111111</outer_id>
            <name>北京饭店</name>
            <used_name>北京大酒店</used_name>
            <domestic>0</domestic>
            <country>China</country>
            <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>
            <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:NOT_RIGHTS_TO_PUBLISH_ERROR 非消保酒店卖家不能发布修改酒店、房型或宝贝 请使用消保酒店卖家操作
    isv.biz-error:HAS_NOT_MATCH_SHOTEL 酒店尚未匹配到标准酒店 请先进行酒店匹配
    isv.biz-error:HAS_NOT_CONFRIM_HOTEL 酒店匹配结果尚未确认 请先进行酒店匹配结果确认
    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
    isv.invalid-parameter:HOTEL_EXIST 重复添加酒店 酒店已存在,更新请使用taobao.xhotel.update
    isv.biz-error:PUBLISH_FORBIDDEN
    isv.null
    accesscontrol.limited-by-seller-access-count
    isv.invalid-parameter:RANGE_ERROR
    isv.remote-service-error

    API工具

    如何获得此API

    FAQ

    返回
    顶部