Basic architecture
The NETx Server provides an interface which can be used to integrate information from the hotel management system RMS Cloud. Using this interface, information about the check-in/check-out procedure, the hotel guests and the hotel room states can be retrieved.
The communication is based on a REST full HTTP web service protocol that is using JSON objects as data payload. The RMS Cloud software is the web API client and our NETx Server is the web API server.
Integration steps
To start, open the menu Modules > RMS Cloud > Configuration .... . With the dialog, specify at least the Client ID, the Client Password and the RMS Url.
Then, the used properties and areas (hotel rooms) have to be defined. This is done within the menu Modules > RMS Cloud > Property definitions. Each definition line corresponds to one property/area (room).
After having defined all rooms, the configured rooms are shown within the item tree. You will find the items under the sub tree NETx\XIO\RMS.
The retrieved information from CharPMS is stored as Server Items. Here all available Server Items that are available for each room are listed (including their access rights):
| Item name | Data type | Access | Notes |
|---|---|---|---|
| RoomNumber | String | read only | Specified within room definitions within NETx Server. Must be identical with the room number used within CharPMS. |
| Description | String | read only | Specified within room Definitions within NETx Server. |
| RoomChecked | Boolean | read only | True if at least 1 guest is check in this room – false if all guests are checked out. |
| RoomCheckedForecast | Boolean | read only | True if there is a forecast check in for this room – false if all guests are checked out. |
| VacancyStatus | Number | read only | Occupancy status for this room (the following default mapping can be changed here):
|
| RoomStatus | Number | read and write | Room status (the following default mapping can be changed here):
This information can also by written by the NETx Server. |
| DND | Boolean | read and write | Do not disturb information for this room.. This information can also by written by the NETx Server. |
| GuestName | String | read only | Guest name that is received from CharPMS. |
| GuestLanguage | String | read only | Language code that is received from CharPMS. E.g. EN, DE, ... |
| GuestVIP | Number | read only | VIP status that is received from CharPMS. |
| GuestArrivalDate | DateTime | read only | Arrival data and time of guest. Normally, this is equal to the check-in data and time. |
| GuestDepartureDate | DateTime | read only | Scheduled departure data and time of guest. |
Article applies to the following products:
- NETx BMS Platform
- NETx Multi Protocol Server