NethHotel: a NethVoice hotel management system

[andrea-marchionni]

NethVoice CTI: Hotel Reception Telephone Management Interface

This section of NethVoice CTI is designed to manage the telephone aspects of a hotel reception installation. It integrates with a hotel's PMS (Property Management System) via the FIAS protocol, serving as a bridge for communication between the two systems. While the hotel PMS will remain the primary interface for managing room statuses (e.g., check-in/check-out, cleaning, wake-up calls, guest details, etc.), NethVoice CTI will handle the telephone-related functionalities and communicate relevant data back to the PMS.

---

Features of the Hotel Telephone Management Interface

1. View and Manage Rooms

• Display all configured extensions (rooms) within the "rooms context" of NethVoice.
• Allow sorting and filtering by floor, establishment, and/or group.

2. Room Interactions

Users can interact with room extensions to perform the following actions:

1. Check-in/Check-out
2. Mark as Inspected/Occupied.
3. Enter guest name.
4. Select the language for system-generated telephone messages.
5. Set alarm.
6. Add extra costs (e.g., minibar, room service).
7. Generate cost reports broken down by telephone usage and extra services.
8. View group memberships, assign rooms to groups, or remove them from groups.
9. View and update the cleaning status (status information retrieved from FIAS).
10. Enable internal calls (restricted to the group if the room belongs to one).
11. Enable external calls.

3. Settings Section

The settings section will allow administrators to configure the following:

General Settings

1. External Call Prefix: Define the prefix for making external calls.
2. Internal Patterns: Specify the format for internal extensions (e.g., XXX).
3. Tariff Management:
   • Configure predefined tariffs (e.g., mobile calls, national calls).
   • Add custom tariffs with associated costs per second.

Room Group Management

1. Manage room groups and perform batch operations for:
   • Check-in/Check-out
   • Mark as Inspected/Occupied
   • Wake-up calls
   • Cleaning status updates
   • Language settings
2. Create custom room groups with the following options:
   • Define group name.
   • Enable calls between rooms within the group.
   • Enable or disable internal calls.
   • Enable or disable external calls.

Short Number Management

• Assign short numbers to internal numbers (e.g., extensions, queues, groups) for easy dialing.
• Configure time-based behaviors for short numbers using time groups (e.g., varying call routing based on time of day).

Call Restrictions

1. Manage call permissions for rooms not in check-in:
   • Enable/disable external calls.
   • Enable/disable internal calls.
   • Restrict calls between groups.
2. Handle unanswered wake-up calls for internal follow-up.

Telephone Code Management

1. Enable telephone codes for key operations such as:
   • Check-in/Check-out
   • Logging cleaning status updates
   • Adding extra costs
   • Setting wake-up calls

Language and Extra Costs Management

1. Define the language for reception messages.
2. Manage extra costs with options to:
   • Add, edit, or delete items (e.g., water, minibar, etc.).
   • Assign names, costs, unique codes for telephone activation, and enabling options.

4. Reporting

Generate detailed reports that include:

• Telephone Costs: Breakdown of call charges per room.
• Extras: Itemized lists of extra services and charges.

5. Telephone Codes

NethVoice will support the following telephone codes for room operations:

1. Check-in/Check-out: Initiated from the reception.
2. Cleaning Updates: Can be reported directly from the room.
3. Adding Extras: Managed via service extensions or from the room.
4. Wake-up Calls: Configurable from the room or a service extension.

FIAS Integration

This system integrates with the hotel PMS via the FIAS protocol to synchronize room-related data, including:

• Room statuses (e.g., cleaning, check-in, check-out, Inspected/Occupied).
• Telephone activity and associated costs.
• Extra charges (e.g., minibar, room service).

For more details about the FIAS protocol, refer to the [NethHotel FIAS Repository](https://github.com/nethesis/neth-hotel-fias).

Pics from old version