Add a hotel

更新时间：2024/09/11 访问次数：24254

Hotel Match
Request of Business Parameters
Response

Hotel Match

There is a standard product library in Alitrip containing large amount of hotels and roomtypes on sale. Alitrip system will try to match vendor’s hotel with standard one automatically when receiving a request of adding a hotel. Vendor need to handle the match work from back end manually if system automatically matches fail.

Request of Business Parameters

Method

taobao.xhotel.update

Example

http://gw.api.tbsandbox.com/router/rest?sign=FF5323D5845D853BAAA1581AF8AE2189&timestamp=2016-11-30+19%3A54%3A16&v=2.0&app_key=1023280175&method=taobao.xhotel.update&partner_id=top-apitools&session=6102727faafc05d9cd6a3db66db6185d1411a4b422b08d03688598345&format=xml&outer_id=123123131&address=%E5%8C%97%E4%BA%AC%E5%B8%82%E6%9C%9D%E9%98%B3%E5%8C%BA&tel=0086%23010%2312345678&city=110100

Notes

O: Optional; R: Required; SR: Special Required

Name	Type	O/R/SR	Example	Limitation	Description
name	String	SR	Beijing Hotel	Max length: 128	Hotel name. Required when adding a new hotel
used_name	String	O	Beijing Hotel	Max length: 60	Hotel used name
domestic	Number	O	0		0 represents domestic hotel, 1 overseas
country	String	O	China	Max length: 30	when domestic equals 1, overseas country code is required. please refer code link or ask technical support of Fliggy for countrycodes sheet;otherwise fixed value "China" required.
province	Number	O	110000		0 as default when domestic equals 1.
city	Number	SR	110100		when domestic equals 1, overseas city code is required. please refer code link or you can use "taobao.xhotel.city.coordinates.batch.upload" to upload the coordinates and after fliggy's calculate，you can thourgh "taobao.xhotel.city.coordinates.batch.download" download the citycode(recommended). Required when adding a new hotel
address	String	R	No. 1 Downing Street	Max length: 255	Hotel address
longitude	String	R	111.13	Max length: 10	Longitude
latitude	String	R	111.1222	Max length: 10	Latitude
position_type	String	O	G		G: Google, B:Baidu, A:Amap
vendor	string	SR	taobao		This is necessary if you apply the 【Fliggy-New Business】
supplier	string	SR	taobao		This is necessary if you apply the 【Fliggy-New Business】
tel	String	R	0086#010#12345678	Max length: 30	Hotel telephone number. Format: Country Code(max 6)#Area Code(max 4)#Tel(max 20).
outer_id	String	R	GJ001	Max length: 64	Hotel ID assigned by developers.
star	String	O	5		Hotel star level. Value range: 1,1.5,2,2.5,3,3.5,4,4.5,5
status	byte	O	0		Hotel Status 0:Normal, -1:Deleted, -2:Discontinued
opening_time	String	O	2015-10-01		Opening date with format "yyyy-mm-dd"
decorate_time	String	O	2015-10-01		Decorate date with format "yyyy-mm-dd"
floors	String	O	4-6		Number of floors
rooms	Number	O	20		Number of floors. Value range: 0~9999
description	String	O	1		Hotel description
hotel_facilities	String	O	{"free Wi-Fi in all rooms":"true","massage":"true","meetingRoom":"true"}		Hotel facilities with json format supporting "free Wi-Fi in all rooms", "meetingRoom", "massage", "fitnessClub", "bar", "cafe", "frontDeskSafe", "wifi", "casino", "restaurant", "smoking area", "Business Facilities"
service	String	O	{"receiveForeignGuests":"true","morningCall":"true","breakfast":"true"}		Hotel service with json format supporting "receiveForeignGuests", "morningCall", "breakfast", "airportShuttle", "luggageClaim", "rentCar", "HourRoomService24", "airportTransfer", "dryCleaning", "expressCheckInCheckOut", "custodyServices"
room_facilities	String	O	{"bathtub":"true","bathPub":"true"}		Room facilities with json format supporting "bathtub" and "bathPub"
pics	String	O	[{"url":"http://123.jpg","ismain":"true"},{"url":"http://456.jpg","ismain":"false"},{"url":"http://789.jpg","ismain":"false"}]		url is the address of picture and ismain represents whether main or not.Only one picture can be set as main.
brand	String	O	1		Hotel brands covering ruJia("1", "rujiakuaijie", "如家快捷", 1), qiTian("2", "7 days", "7天连锁", 1), hanTing("3", "Hanting Inns & Hotels", "汉庭酒店", 1), geLinHaoTai("4", "Green Tree Inn", "格林豪泰", 1), jinJiang("5", "Jinjiang Inn", "锦江之星", 1), su8("6", "Super 8", "速8", 1), moTai("7", "Motel", "莫泰", 1), zhouji("8", "InterContinental", "洲际", 4), budint("9", "Pod Inn", "布丁", 1), jiuJiu("10", "jiujiuliansuo", "99连锁", 1), piaoHome("11", "Piao Home Inn", "飘HOME", 1), juzi("12", "Orange Hotels", "桔子酒店", 1), yibai("13", "yibai", "易佰", 1), weiyena("14","weiyena","维也纳",2), huangguanjiari("15", "huangguanjiari", "皇冠假日", 4), xidawu("16", "xidawu", "喜达屋", 3), chengshiBJ("17", "chengshibianjie", "城市便捷", 1), shagnKeYou("18", "shagnkeyou", "尚客优", 1), jinjiang("19", "jinjiang", "锦江酒店", 3), wendemu("20", "Hawthorn Suites", "温德姆", 4), yibisi("21", "Ibis Hotels", "宜必思", 1), wanhao("22", "JM Hoteles", "万豪", 4), yijia365("23", "yijia365", "驿家365", 1), shoulv("24", "shoulvjituan", "首旅建国", 3), kaiyuan("25", "New Century Hotel", "开元大酒店", 4), yagao("26", "yagao", "雅高", 3), daisi("27", "daisi", "戴斯", 3), jinling("28", "jinlingliansuo", "金陵", 4), xianggelila("29", "Shangri-La City Hotels", "香格里拉", 4), xierdun("30", "Hilton", "希尔顿", 4)
postal_code	String	O	100000	Max length: 20	Postal code

Response

Name	Type	Example	Description
+ xhotel	XHotel		Hotel object information
└ hid	Number	123456	Hotel ID in Alitrip
└ status	Number	0	0: Normal; -2: Offline; -1: Deleted
└ error_info	String	Hotel not exists	Failed reason
└ created_time	Date	2000-01-01 00:00:00	Created time of hotel record
└ modified_time	Date	2000-01-01 00:00:00	Modified time of hotel record
s_hotel	SHotel		Standard hotel information in Alitrip product library
└ shid	Number	123456	Standard hotel ID in Alitrip
└ name	String	Beijing Hotel	Hotel name.
└ used_name	String	Beijing Hotel	Hotel used name
└ domestic	Number	0	0 represents domestic hotel, 1 overseas
└ country	String	China	Country code
└ province	Number	110000	Province code
└ city	Number	110100	City code
└ district	Number	110101	District code
└ address	String	No. 1 Downing Street	Hotel address
└ level	String	A	Hotel level
└ business	String	Disney	Business circle
└ position_type	Number	1	G: Google, B:Baidu, A:Amap
└ longitude	String	111.13	Longitude
└ latitude	String	111.1222	Latitude
└ tel	String	0086#010#12345678	Hotel telephone number.
└ fax	String	0086#010#12345678	Hotel fax number.
└ opening_time	String	2015	Opening date
└ decorate_time	String	2015	Decorate date
└ storeys	String	11	Number of floors
└ rooms	Number	100	Number of rooms
└ desc	String		Hotel description.
└ service	String	{"airportShuttle":true}	Hotel service.
└ pic_url	String	https://img.alicdn.com/bao/uploaded/i3/T1Ym4bXeJBXXbPV7.9_104339.jpg	Hotel pictures.
└ extend	String		Ignored
└ status	Number	1	Ignored
└ created_time	Date	2000-01-01 00:00:00	Created time of standard hotel record
└ modified_time	Date	2000-01-01 00:00:00	Modified time of standard hotel record
└ brand	String	Hilton	Hotel brand
└ type	String	Economic	Hotel type
└ hotel_facilities	String	{"free Wi-Fi in all rooms":"true","massage":"true","meetingRoom":"true"}	Hotel facilities
└ room_facilities	String	{"bathtub":"true","bathPub":"true"}	Room facilities
└ city_tag	String	11,33	City tag
└ postal_code	String	100072	Postal code
└ match_status	Number	1	Matching status: 0: Having been successfully matched by the system, to be confirmed by the seller; 2. Having been matched by the system, with the result of “failed”, to be matched by manual; 3. Having been successfully matched by manual, to be confirmed by the seller; 4. Having been matched by manual, with the result of “failed”; 5. Having been confirmed by the seller as “Yes”; 6. Having been confirmed by the seller as “No”; 7. Having been matched by the system, with repeated matching, to be confirmed by manual.
└ outer_id	String	1111111	Hotel ID assigned by developers.
└ name	String	Beijing Hotel	Hotel name.
└ used_name	String	Beijing Hotel	Hotel used name
└ domestic	Number	0	0 represents domestic hotel, 1 overseas
└ country	String	China	Country code
└ province	Number	110000	Province code
└ city	Number	110100	City code
└ district	Number	110101	District code
└ address	String	No. 1 Downing Street	Hotel address
└ business	String	Disney	Business circle
└ position_type	Number	1	G: Google, B:Baidu, A:Amap
└ longitude	String	111.13	Longitude
└ latitude	String	111.1222	Latitude
└ tel	String	0086#010#12345678	Hotel telephone number.

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问