NethHotel

NethHotel is a specialized module of NethVoice designed for the management of extensions properly configured as hotel rooms. It provides comprehensive features for managing guest communications, billing, and property management system integration.

By default, access to NethHotel is granted to the admin user.

Configuration

Enabling NethHotel

NethHotel can be enabled within the NethVoice instance configuration:

1. Access the NethVoice applications inside NethServer
2. Go to the Settings page
3. Check the Enable Hotel module option
4. (Optional) Specify the address and port of the FIAS server if using PMS integration
5. Save the changes

PBX Configuration

After enabling the NethHotel module, some configurations are required on the NethVoice side:

1. Create Outbound Routes

   • In the advanced interface of NethVoice, go to Connectivity > Outbound Routes
   • Create a dedicated outbound route for hotel rooms
   • Use a prefix (typically 0) and place it at the end of the route list
   • Click Save and Apply Configuration

2. Configure Hotel Profile

   • From the NethVoice wizard page, access the Hotel profile
   • Enable the newly created outbound route

3. Add Room Extensions

   • Add room extensions to the hotel profile using the NethVoice configuration panel or the Multiple Extension Management tool
   • All extensions included in the hotel profile will automatically be managed by NethHotel

Accessing NethHotel

The NethHotel application is accessible at:

https://<nethvoice_domain>/freepbx/hotel/rooms.php

It can also be accessed from the NethVoice administrator wizard: Administration → Advanced (freepbx) → Applications → NethHotel

How to Configure the PBX

We recommend the following configuration:

Room Extensions

• All room extensions must be added to the hotel profile via the Configurations section or by using the Multiple Extension Management application

Service Extensions

• Service extensions (such as reception) should not be added to the hotel profile
• Configure them as standard extensions following your hotel's numbering policy
• Example: If room extensions range from 201 to 299, set reception as 200 or 300
• Allow rooms to call reception by configuring a speed dial number (see Speed Dial Numbers)
• Service extensions can call each other directly

Outbound Routes

• Use a separate Outbound Route without a prefix for service extensions
• This should be different from the route used for room extensions

Phone Feature Codes

In the NethVoice PBX management interface, under Service Codes, you can find codes to use NethHotel features directly from the phones.

Example Feature Codes

Add an extra charge to a room:

*33 + Room Extension + # + Extra ID + # + Quantity

Example: *33201#99#3 charges three units of the extra code 99 to room 201

Set an alarm (guest call):

977

Room Management

Room Status Display

On the main page, all configured extensions are displayed in tabs based on the numeric value of the callgroup field (configured in NethVoice).

The room status is indicated by color:

Color	Status	Meaning
Green	Available	The room is empty and ready for check-in
Red	Occupied	The guest has checked in
Yellow	Cleaning	The room needs cleaning

Accessing Room Functions

All available functions are presented directly in the room panel. It is also possible to use the context menu by right-clicking on the room.

Wake-Up Call

The wake-up call feature can be scheduled as a single event or repeated over multiple days.

For Guests

Guests can set the wake-up call for their room by dialing:

977

From the NethHotel Interface

Administrators can schedule wake-up calls for rooms through the NethHotel web interface.

Groups

It is possible to group multiple rooms into a single group to perform multiple operations:

• Check-in/Check-out: perform these actions on all rooms in the group
• Wake-Up Calls: schedule wake-up calls for all rooms in a group
• Call Policies: define call rules for group members:
  • Enable calls between rooms
  • Enable calls among all rooms in the group
  • Allow external calls

Billing and Reporting

Add an Extra

To add a charge to a room:

1. Open the room panel
2. Click on the icon of the corresponding extra
3. The charge will be added to the room's bill

Generate Reports

To generate the report of the bills for currently occupied rooms:

1. Click on the report icon
2. The report includes:
   • A detailed list of all calls made from the room
   • All extras/charges applied to the room
   • Real-time updated total

Rates

NethHotel includes a predefined set of phone rates based on the type of call (mobile, local, long-distance, etc.).

Managing Rates

• Modify existing rates according to your pricing policy
• Create new custom rates
• Enable or disable calls to specific types of numbers (e.g., premium, international)

Extras

Extras are additional charges assignable to rooms for services or items.

Configuring Extras

Extras can be configured and assigned to rooms:

• Web Interface: use NethHotel to add charges to rooms
• Directly from the Phone: guests or staff can dial function codes (e.g., *33)

Example

Charge three units of the extra code 99 to room 201:

*33201#99#3

Options

The General Options section allows you to configure policies valid for the entire hotel:

• External Call Prefix: set the prefix for making external calls
• Internal Numbering Format: define how extensions should be formatted
• Calls Between Rooms: enable/disable calls between rooms
• Calls Between Rooms in the Same Group
• External Calls: enable/disable external calls from rooms
• Calls from Rooms Without Check-in
• Missed Wake-Up Call Notification Extension
• Room Cleaning Status Function
• Room Cleaning Status Code
• Language: default language for reception messages (fallback)

Speed Dial Numbers

The Speed Dial section allows you to define quick numbers for easily calling predefined destinations.

Basic Speed Dial

• Define shortcuts to quickly call extensions
• Example: Dial 9 to call the reception

Conditional Speed Dial with Time Group

It is possible to associate a speed dial with time groups configured in the NethVoice PBX:

• Destination: where the call goes if the time condition is met
• Otherwise: where the call goes if the condition is NOT met

Allows different routing between working hours and nighttime (e.g., reception during the day, voicemail at night).

Call History

View all calls made from the rooms through the History section.

Filtering Options

• Filter by date range
• Filter by room number
• Search by called number

Use Cases

• Verify calls for billing
• Investigate unusual patterns
• Generate reports for accounting

FIAS Integration

NethHotel can be connected to a PMS (Property Management System) for automated operations.
See FIAS Integration for full details.