Add a roomtype

更新时间：2025/01/07 访问次数：10213

RoomType Match
Request of Business Parameters
Response
Error Code

RoomType 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 roomtype with standard one automatically when receiving a request of adding a roomtype. Vendor need to handle the match work from back end manually if system automatically matches fail.

Request of Business Parameters

Method

taobao.xhotel.roomtype.update

Example

http://gw.api.tbsandbox.com/router/rest?sign=16DF6D5616632AB8E9244FC8D4421AA3&timestamp=2016-11-30+19%3A58%3A06&v=2.0&app_key=1023280175&method=taobao.xhotel.roomtype.update&partner_id=top-apitools&session=6102727faafc05d9cd6a3db66db6185d1411a4b422b08d03688598345&format=xml&hotel_code=123123131&outer_id=11111&name=%E6%A0%87%E5%87%86%E9%97%B4

Notes

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

Name	Type	O/R/SR	Example	Limitation	Description
name	String	SR	Standard room	Maximum length: 200	Roomtype name,Default English. Required when adding a new roomtype
max_occupancy	Number	O	2	Default value: 2	Maximum occupancy, value range: 1-99
area	String	O	10	Maximum length: 30	Room area. The format used should be correct. Two format types are optional, e.g. 40 or 10-20.
floor	String	O	3~5F	Maximum length: 30	Floor No. of a bed room in the building.
bed_type	String	SR	Large bed	Maximum length: 30	Bed type. Please refer link for bed type enumeration value.Required when adding a new roomtypeDeprecated, please use bed_info
bed_info	String	SR	[{ "main_bed_type": "10", "sub_bed_type": [{ "sub_bed_num": 1, "bed_type": "0", "length": "1.8", "width": "2" }, { "sub_bed_num": 1, "bed_type": "0", "length": "1.8", "width": "2" }] }]		main_bed_type: Main Bed Type sub_bed_type: Sub Bed Type For more details, please refer to the document: https://open.alitrip.com/docs/doc.htm?spm=0.0.0.0.jbUBUl&treeId=228&articleId=121920&docType=1
bed_size	String	O	1.8m	Maximum length: 30	Bed width
internet	String	O	A		Internet service, optional values: A, B, C, D. A: not available, B: free, C: charged, D: partially charged.
service	String	O	{"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}	Maximum length: 1024	Facility service, in JSON format. If the value is true, the service is available; if false, unavailable. Bar: bar counter, catv: cable TV, ddd: domestic direct dial, idd: internet direct dialing, toilet: separate toilet, pubtoilet: public toilet. E.g. {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
window_type	Number	O	1		0: no window/1: window available
outer_id	String	R	123123	Maximum length: 64	Vendor room type ID
vendor	string	SR	taobao		This is necessary if you apply the 【Fliggy-New Business】
hotel_code	String	R	abc	Maximum length: 64	Vendor hotel ID
pics	String	O	[{"url":"http://123.jpg","ismain":"true"},{"url":"http://456.jpg","ismain":"false"},{"url":"http://789.jpg","ismain":"false"}]		Only remote room type photos are supported, format: [{"url":"http://123.jpg","ismain":"true"},{"url":"http://456.jpg","ismain":"false"},{"url":"http://789.jpg","ismain":"false"}]. url is the address to access remote photos and ismain is used to confirm if a photo is the main photo. Only one photo can be used as the main photo.

Response

Name	Type	Example	Description
+ xroomtype	XRoomType		Room type information
└ rid	Number	123456	rid
└ hid	Number	123456	hid
└ created_time	Date	2000-01-01 00:00:00	Date of creation
└ modified_time	Date	2000-01-01 00:00:00	Date of modification
└ status	Number	1	Room type status. 0: Normal, -1: deleted, -2: sales suspended
+ s_roomtype	sRoomType		Standard room type information
└ srid	Number	123456	Matched standard room type
└ name	String	aaa	Room type name
└ floor	String	7-8F	Floor No.
└ internet	String	aaa	Internet service. “0”, “cabled (for free)”; “1”, “wireless (unavailable); “2”, “cabled (charged)”; “3”, “cabled (available in some rooms and for free)”; “4”, “cabled (available in some rooms and charged)”
└ shid	Number	123456	shid
└ pic_url	String	aaa	Pic_url
└ facility	String	aaa	facility
└ max_occupancy	Number	1	Maximum occupancy
└ area	String	16-30m²	Area
└ extend	String	Aaa	Extended field
└ created_time	Date	2000-01-01 00:00:00	Time of creation
└ modified_time	Date	2000-01-01 00:00:00	Time of modification
└ window_type	String	With windows	Window type, enumerated. 0: without window; 1: with windows.
└ bed	String	[{“bedType”:”large bed”, “bedSize”: “1.5m” , {“bedType”: “double beds”, “bedSize”: “1.2m”}]	Room type, in json format: [{“bedType”:”large bed”, “bedSize”: “1.5m” , {“bedType”: “double beds”, “bedSize”: “1.2m”}]
└ status	Number	1	Status. 0: Normal; -1: deleted
└ 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.
└ error_info	String	Room type unavailable	Error cause. The reason why the seller refuses when no standard room type is matched.
└ outer_id	String	1111	Seller’ system id
└ name	String	Standard room	Room type name
└ max_ occupancy	Number	2	Maximum occupancy
└ area	String	A	Optional values: A, B, C, D. A: ≤15m², B: 16-30m², C: 31-50 m²; D: ≥50 m². The value may be customized, for example, 40 m^2.
└ floor	String	3-5F	Floor No. of a bed room in the building. For skip floors, there are 1-2F, 4-5F and 7-8F.
└ bed_type	String	Large bed	Bed type
└ bed_size	String	2.1m	Bed width
└ internet	String	A	Internet service, optional values: A, B, C, D. A: not available, B: free, C: charged, D: partially charged.
└ service	String	{"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}	Facility service, in JSON format. If the value is true, the service is available; if false, unavailable. Bar: bar counter, catv: cable TV, ddd: domestic direct dial, idd: internet direct dialing, toilet: separate toilet, pubtoilet: public toilet. E.g. {"bar":false,"catv":false,"ddd":false,"idd":false,"pubtoilet":false,"toilet":false}
└ window_type	Number	1	0: no window/1: window available

Error Code

Error Code	Error Description	Solutions
isv.invalid-parameter:NOTNULL	Parameter not null	Please check the parameter.
isv.invalid-parameter:ERROR	Parameter error	Please check the parameter.
isv.biz-error:STATUS_NOT_CORRECT	Status not correct	Please check the status.
isv.biz-error:NOT_RIGHTS_TO_PUBLISH_ERROR	The seller who doesn't sign consumer protection agreement cannot publish or modify hotel, room type or product information	Please sign consumer protection agreement
isv.biz-error:CAN_NOT_UPDATE_ROOMTYPE	The room type is to be matched and confirmed or “Confirmed” status cannot be updated	Please change room type operation or Retry later.
isv.biz-error:UPDATE_ROOMTYPE_ERROR	Room type update failed	Please Retry later.
isv.biz-error:HAS_NOT_MATCH_SHOTEL	The hotel has not matched the standard hotel	Match hotel information first.
isv.biz-error:HAS_NOT_CONFRIM_HOTEL	The matching result of hotel has not been confirmed	Confirm hotel matching result first.
isv.biz-error:CAN_NOT_UPDATE_HID	The hotel where the room type cannot be updated	Don’t update room type hid.
isv.biz-error:ALREADY_EXIST_SROOMTYPE	The room type matching the standard room type has already existed	Please check room type information. Repeated matching is not allowed.
isv.permission-error:NO_PERMISSIONS_ERROR	No authorization or unauthorized visit	Please request authority.
isv.remote-service:CONVERT_ERROR	Convert error	Please check the input parameter
isv.invalid-parameter:RANGE_ERROR	Range error	Please check the parameter.
isv.invalid-parameter:HOTEL_NOT_EXIST	The hotel does not exist	Publish hotel information first.
isv.invalid-parameter:ROOM_TYPE_EXIST	The room type does not exist	The room type does not exist. Check the parameter.

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

开放平台

International Hotel