Providing access, calculating commissions
Do you have any questions regarding KWHotel functions or development?
>>>Ask them here
With KWHotel Pro, you may provide your apartment owners with access to a dedicated web panel.
It can be used to view availability in their apartments and earned commissions.
Please note that web panel for apartment owners is an extra paid module.
The below manual contains all information required to grant access and prepare commissions for your apartment owners.
***** Part 1. Preparing accounts for apartment owners *****
Each apartment owner must receive a separate account in KWHotel Pro. Below you will find a detailed manual on how to achieve that:
Step 1. Go to Tools –> Configuration –> Users.
Step 2. Click “Add”.
Step 3. Insert apartment owner`s name.
Step 4. Insert apartment owner`s login. He will use it to log to the web panel.
Step 5. Fill in the email address if you wish to send automated messages to this owner. A manual for automated email messages can be found here.
Step 6. Insert the owner`s password twice. He will use it to log to the web panel.
Step 7. From the “User role” field, pick the “Portal” option.
Step 8. Time to assign apartments to this owner. Press the “Rooms visible by this user” button.
Step 9. Pick the apartments that shall belong to the given apartment owner.
Step 10. Press the “Save” button.
Step 11. Time to configure commissions that will be calculated for the given owner. Proceed to “Owner settings”.
Step 12. In the “Settlement method” field select one of the following options:
“User is not owner”: turns off any possibilities to calculate commissions for the given user.
Such person will not be taken into account when calculating commissions in the web panel. It`s worth using this option if you wish to provide web access to your housekeeping staff.
Attention! Using the above option will not prevent the given user from seeing the apartment owner`s commissions.
a) “Commission from net price”: takes into account a cost of reservation minus tax.
b) “Commission from gross price”: takes into account a cost of reservation, including tax.
Step 13. Insert percentage value of commission for this apartment owner.
Step 14. Insert percentage value of tax, based on which the final net or gross amount will be calculated for this apartment owner.
Step 15. In the “Order of commission calculation” field select one of the below variants:
1) “From the total price for booking”.
2) “After subtracting commission`s source, breakfast and additional charges”.
3) “After subtracting commission`s source, breakfast and additional charges pattern 2”.
Attention! Calculations will also include a tax for room rates.
Below you will find detailed patterns for calculating price, which will serve as a base to calculate the broker`s commission.
(a1, b1) from net price for reservation; from the total price for booking
net = total net price for reservation
(a2, b1) from gross price for reservation; from the total price for booking
gross = total gross price for reservation
(a1, b2) from net price for reservation; after subtracting commission`s source, breakfast and additional charges
net = total net price for reservation – commission`s source – commission from additional charges
(a2, b2) from gross price for reservation; after subtracting commission`s source, breakfast and additional charges
gross = total gross price for reservation – commission`s source – commission from additional charges
(a1, b3) from net price for reservation; after subtracting commission`s source, breakfast and additional charges pattern 2
net = (total gross price for reservation – commission`s source – commission from additional charges) / (1 + Tax for rooms)
Below you will find possible calculations of amounts for apartment owner. Amounts are calculated based on a value from the previous point (net or gross) and broker`s commission.
(a1) from net price for reservation
owner`s net amount = net – (net * broker`s commission)
owner`s gross amount = net * (1 + broker`s tax)
(a2) from gross price for reservation
owner`s gross amount = gross – (gross * broker`s commission)
owner`s net amount = net / (1 + broker`s tax)
Below link presents exemplary commission calculations for each of the before-mentioned variants: https://docs.google.com/spreadsheets/d/1KevQxE9XQAHcgON6XRY0HzGqs5vLUJUJpjkXjzI6J54/edit#gid=0
Step 16. Once you have finished configuration, press the “Save” button.
***** Part 2. Configuring sources of reservations *****
First make sure that you have prepared all sources you wish to use. It can be done in Tools –> Data editor –> Reservation sources.
In case synchronization with channel manager or Booking.com is enabled, sources are inserted automatically. You may also add more manually:
Step 1. Press the “Add” button.
Step 2. An empty field will appear on top of the list. Insert the source`s name in the “Name” column.
Step 3. Click the “Save” button.
***** Part 3. Configuring commissions of sources *****
Now that your reservation sources are ready, you may configure separate commissions for each source or apartment.
To achieve that, proceed to Tools –> Data Editor –> Channel manager commissions. After that please:
Step 1. Click the “Add” button.
Step 2. Select reservation source from the “Booking source” list.
Step 3. Select apartment group where commission will be assigned, from the “Room group” list.
Step 4. Insert the source`s commission in the “Commission” field.
Step 5. Press the “Save” button to save the changes.
Apply the above steps to all sources you need.
***** Part 4. Configuring additional charges in the web panel *****
If you charge your apartment owners with additional fees for cleaning or collect commissions for breakfast, it can be configured now. Please use the following manual to achieve that:
Step 1. Log in to administrator panel, located here: https://dev.kwhotel.com/#/login.
Step 2. Go to Configuration –> Apartment owners –> Calculations.
Step 3. Insert value of the regular fee if you wish to use it or insert “0”. It will be deducted from the final amount, calculated for an apartment owner at the end of the month.
Step 4. Provide an amount for breakfast commission if you wish to use it or insert “0”. It will be deducted from the final amount, calculated for an apartment owner at the end of the month.
Step 5. Set the “New calendar for apartment owners” option to “Yes”.
Step 6. Press the “Save” button.
***** Part 5. Configuring data displayed for apartment owners *****
Attention! In order to perform the configuration process in part 5, please remain logged in the administrator panel on https://dev.kwhotel.com/#/login.
In the web panel you may configure which data will be displayed to apartment owners. To perform such configuration, please refer to the below manual:
Step 1. Go to Configuration –> Apartment owners –> Calendar
Step 2. On the bottom of the screen you will notice two columns. On the left you will see “Disabled columns” (they are not displayed to apartment owners)
and on the right you will see “Enabled columns” (they are displayed to apartment owners). Please select the desired value from the column on the left and press the arrow button to move it to enabled columns.
Step 3. Having finished the configuration, press the “Save” button.
***** Part 6. Verifying the correctness of configuration *****
In order to check the correctness of performed configuration, press the “Availability” button, located in the web panel.
In the newly opened window check, whether the displayed data is correct.
If that is confirmed, you may provide your apartment owners with access credentials to the web panel.
Link to the panel remains under https://dev.kwhotel.com/#/login
but instead of using the “Administrator panel”, the owner must choose the “Client panel” instead.
There he logs in using the credentials you created for him in KWHotel Pro, in the part 1 of this manual.
***** Part 7. Settling with apartment owner at the end of month *****
Apartment owner, when logged in the “Availability” module, may check in the bottom of the screen, if his calculations were confirmed.
Below you will find a manual on how to confirm settlements with apartment owners in KWHotel Pro.
Step 1. Go to “Rooms” module.
Step 2. Edit apartment you wish to confirm settlement for (just double click it or select it on the list and press the “Edit” button).
Step 3. In the apartment configuration screen proceed to the “List of repairs” tab.
Step 4. Select a month for which you wish to confirm settlement.
Step 5. Press the “Checked” button. It will confirm settlement for the current month (a new value named “Checked” will appear).
Congratulations! You can now fully manage commissions and availabilities for your apartment owners!