International Hotel
Add a roomtype
更新时间：2026/06/29
访问次数：13080
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
Example
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 |
| name_e | String | O | Standard room | Maximum length: 200 | Roomtype name. Room type name (default: English). Required when adding a new room type. Note: It is also acceptable if you previously submitted English text in the "name" field; English names are the primary requirement for international contexts. |
| 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. |
| status | byte | O | 0 | RoomType Status 0:Normal, -1:Deleted, -2:Discontinued | |
| bed_info | String | O | [{ "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" }] }] | Bed type information is a key field for our matching process; please provide it if available. If you do not have the width for the bed type, you may omit that specific field. For details, please refer to the documentation link below:: 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 / 2: partially with window / 3: blind window / 4: partially blind window | |
| 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. | |
| standard_room_facilities | String | O | { "dataVersion":"2.0.0", "facilityList":[ {"500":true,"fee":true}, {"501":true,"option":"1"}, {"506":true,"mul-option":["1","2"],"desc":"说明"}, {"507":true,"desc":"说明"}, {"509":true,"value":"12:00","fee":true}, {"2":true,"list":[ {"inDoorType":"1","fee":true}, {"inDoorType":"2","fee":true} ]}, {"7":true,"list":[ {"restaurantType":"1","name":"品珍中餐厅"}, {"restaurantType":"2","name":"和日式料理"} ]} ] } | Room amenities, reference document:https://open.alitrip.com/docs/doc.htm?docType=1&articleId=108891 |
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-30m2 | 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: ≤15m2, B: 16-30m2, C: 31-50 m2; D: ≥50 m2. The value may be customized, for example, 40 m2. |
| └ 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. |
