KWHotel Configuration Module
KWHotel Configuration Module
KWHotel Configuration Module
KWHotel software is highly customizable - you can adjust it to match the individual requirements of your
property. This manual contains a description of each function you may find in the Configuration module.
1. Calendar ................................................................................................................................................................ 2
2. Taxes.............................................................................................................................................................................. 5
3.1. Invoices (page 1)............................................................................................................................................... 8
3.2. Invoices (page 2)............................................................................................................................................. 11
3.3. Invoices (page 3)............................................................................................................................................. 13
3.4. Invoices (cash documents) ....................................................................................................................... 15
4. Meals ............................................................................................................................................................................ 16
5. Users ............................................................................................................................................................................ 16
6. Email ............................................................................................................................................................................ 16
7.1. Layout (page 1) ................................................................................................................................................ 17
7.2. Layout (page 2) ................................................................................................................................................ 18
8. Security ...................................................................................................................................................................... 19
9.1. Other (page 1) ................................................................................................................................................... 21
9.2. Other (page 2) ................................................................................................................................................... 24
9.3. Other (page 3) ................................................................................................................................................... 26
9.4. Other (external devices 1) ......................................................................................................................... 28
9.5. Other (payments settings) ......................................................................................................................... 29
10. KWHotel API ......................................................................................................................................................... 29
12. Price Optimizer ................................................................................................................................................... 29
13. SMS API ................................................................................................................................................................... 29
14. Campground ......................................................................................................................................................... 30
1. Calendar
Restore defaults (1) - restores the default settings of the reservation Calendar.
Reservation colour codes (2) - here you may modify the color of each reservation status. Just
click it and select another color.
Sharp edges (4) - changes the reservation strips from rectangular to haxagonal
Font color in the room list (6) - colors the fonts of room symbols presented on the calendar
Number of people (7) - displays the number of people on every reservation`s strip
Address (8) - displays the main guest`s address on every reservation`s strip
Comments (9)- displays comments from reservation on every reservation`s strip
Page 2 of 30
„Configuration” module
Reservation strip frame thickness (10) - allows to determine the strip thickness of package-
based and online reservations. Accepts values from 1 to 20.
Default room deposit (11) - allows to set a default room deposit. This option is only applied to
reservations done via KWHotel Booking Engine.
How does room deposit work in KWHotel? If any deposit is inserted in a reservation window >
"Other" tab > "Deposit" field,
KWHotel will remind you about it when you try to check-out your guest. This ensures you return him
the deposit.
Display rooms from all hotels in one calendar (12) - connects all properties on a single
calendar. Rooms from each property are shown one by one.
Please note that each property is still treated as a separate entity in the program.
Set reservation status to occupied day after it stars (13) - automatically changes a reservation
status from "Reservation scheduled" to "Occupied (...)" a day after it begins.
Page 3 of 30
„Configuration” module
Display number of clean beds (16) - shows the number of clean beds. The number is displayed
right above the room housekeeping status.
Double-clicking the housekeeping status allows to select the number of beds prepared. Having
enabled this option, please restart the program.
Show prices in decimal format (17) - displays prices on calendar in a decimal format.
Show reservation source on the calendar (18) - displays reservation source on a reservation
strip.
Page 4 of 30
„Configuration” module
2. Taxes
Allow fractional tax (5) - allows to type tax with decimal value
Extra tax (added on top of the room rate) (6) - additional tax which is added to room rate
during the final calculation. It can also be selected manually in a reservation screen.
Page 5 of 30
„Configuration” module
Calculation will be based on the net price - Amount x Net price x 1,Tax % = gross value
Example:
Net price: 20
Number of units: 1
Tax value: 8%
Calculation will be based on the gross price - Amount x Gross price / 1,Tax % = net value
Example:
Gross price: 20
Number of units: 1
Tax value: 8%
ATTENTION! Changing the above option will change the method of calculating the gross price in all
invoices.
Gross price on exisitng invoices will also be corrected.
Local tax payments (10) - allows to configure how will the local tax be calculated. Below you will
find the possible values:
0 - every day (reservation from 1.09 to 2.09 will be counted as two days)
1 - every 24 hours (reservation from 1.09 to 2.09 will be counted as one day)
2 - starting from the second day (reservation from 1.09 to 3.09 will be counted as one day)
9 - starting from the second day, including the first day as well (reservation from 1.09 to 2.09 will
not be taken into account; reservation from 1.09 to 3.09 will be counted as two days)
10 - every 24 hours, per room (program will not number of people into account; reservation for 3
people, from 1.09 to 3.09 will be counted as 3 days x 1 person)
Adult (11)- allows to insert the local tax value for an adult
Child1 (12) - allows to insert the local tax value for a person from the first age group.
Age groups can be configured in the Tools > Configuration > Other > Page 1 - option on the very
top.
Child2 (13) - allows to insert the local tax value for a person from the second age group.
Child3 (14) - allows to insert the local tax value for a person from the third age group.
Tax office address (15) - allows to insert the address of a tax office that will be visible on the local
tax document.
Local tax: add it to total price by default (16) - automatically includes local tax in a reservation
window
Page 6 of 30
„Configuration” module
Local tax: show it on the bills (17) - adds another entry on a fical document - "Local tax".
Local tax: create tax document with an invoice (18) - when invoice is created, a separate local
tax document is issued automatically.
Such document can be accessed both in a reservation screen and Accounting module ("Local fees"
tab).
Local tax name field (19) - allows you to define how will the local tax entry be named in the fiscal
documents.
Do not show the 0% tax warning in the document creation screen (20) - when active,
KWHotel will not show the message informing you about a 0% tax being applied to the fiscal
document you are creating.
Page 7 of 30
„Configuration” module
Abbreviated Business Identification Number (1) - allows to insert an abbreviation for your Tax
ID`s name. The default value is "TAX ID".
Titles on bills (2) - this section lets you insert the headlines of the following documents:
- Invoice
- Advance invoice
- Pro forma invoice
- Corrective invoice
- Receipt correction
- Cash documents (leaving this field empty will cause the default values to be used)
Print "Original" and "Copy" in the accounting documents (3) - allows to print the "Original"
and "Copy" headlines, to distinguish documents easily.
Page 8 of 30
„Configuration” module
Invoices numeration system (4) - allows to pick between a monthly and annual invoice
numeration.
In the examples above, "A" means the location of the custom prefix you can use in such numeration.
Automatically generate cash register receipt and disbursement after issuing a receipt (5) -
automatically generates a cash document for every issued receipt.
Automatically generate cash register receipt and disbursement after issuing an invoice
(6) - automatically generates a cash document for every issued invoice.
Obligatory cash register status confirmation after changing the user (7) - enables "Shift
reports" in KWHotel.
Activating this option forces every non-administrator user to provide the amount located in the cash
register, when he logs in to KWHotel. This marks the beginning of his shift.
The generated shift reports can be viewed by an Administrator in the Statistics > Shift reports.
Automatically issue deleting shift report on fiscal printer (9) - KWHotel, when the day is
over (midnight) will send a signal to fiscal printer to issue a deleting shift report.
Default invoice prefix (10) - allows to include an additional prefix to issued invoices. The
prefix is located between an invoice number and its` month / year. Pattern: 1 / Prefix / 2018.
Default bill prefix (11) - allows to include an additional prefix to issued bills. The prefix is
located between a bill number and its` month / year. Pattern: 1 / Prefix / 2018.
Page 9 of 30
„Configuration” module
Default advance invoices prefix (12) - allows to include a separate prefix for advance
invoices (i.e. ADV)
Default name for the accommodation service on the invoice (13) - allows to customize the
way the accommodation service will be displayed on the issued invoices. The following variables can
be used:
Example:
Accommodation from {0} to {1} in room {2} = Accommodation from 22.11.2018 to 24.11.2018 in
room 03.
Default name of advance payments on the invoice (14) - allows to customize the way the
advance will be displayed on the issued invoices. The following variables can be used:
Product code (15) - allows to include a product code for your accommodation services.
Postscript to partial positions (16) - option used to insert uneven payments on the invoice (if we
add another payment to the base payment).
Page 10 of 30
„Configuration” module
To place a logo of your company on invoices, a .jpg file must be replaced in the KWHotel directory.
The exact location is described here.
The easiest way to reach this location is to press the magnifying glass button (1).
Payment types (2) - allows to create additional forms of payment. These can be used when issuing
fiscal documents.
ATTENTION! The "Cash" form of payment is the only one which causes KWHotel to issue a cash
document.
Every other form of payment will result in issuing a bank document.
Address printed on the invoice (3) - allows to use a different place of issuing a fiscal document,
than it results from the license credentials.
Page 11 of 30
„Configuration” module
Do not fill any form of payment in the documents automatically (4) - when enabled, it is
required to manually select a form of payment before saving a fiscal document (it`s not set to Cash
automatically)
Document prefix (does not impact the numeration) (5) - selecting this option allows you to
change the default document prefixes
Print prefixes in documents (6) - if you select this option, KWHotel will print the newly created
prefixes in the fiscal documents.
Prefix does not impact the numeration (7) - when enabled, prefix does not impact the
numeration.
Otherwise, KWHotel would change the numeration each time a different prefix is used.
Example:
FS 1 / 2018
FSR 2 / 2018
FSR 3 / 2018
FS 4 / 2018
Invoice - include information about a receipt assigned to this invoice (8) - enabling this
option will cause KWHotel to show on the invoice, which receipt is assigned to it.
Default remarks for accommodation service on the invoice (9) - allows you to create a
scheme which will be used to populate remarks on invoices.
You may use variables (i.e. {3} - Room symbol) to populate some data automatically.
Example: Typing "Accommodation of guest {5} in {0} - {1}, room {2}" will cause the following
remarks to be displayed:
You may view the exemplary result dynamically, if you press the "Insert default content of remarks
in the invoice" button.
ATTENTION! This option will only work for invoices issued in a reservation window.
Page 12 of 30
„Configuration” module
Force issuing a receipt bill after each payment in the reservation (1) - related to reservation
window.
Inserting any amount in "Advance" or "Amount paid" fields and pressing the "Save" button will force
KWHotel to open a receipt creation window.
This prevents from accepting payments without issuing a receipt.
Force issuing an invoice after each payment in the reservation (2) - related to reservation
window.
Inserting any amount in "Advance" or "Amount paid" fields and pressing the "Save" button will force
KWHotel to open an invoice creation window.
This prevents from accepting payments without issuing an invoice.
Force issuing a cash document after each payment in the reservation (3) - related to
reservation window.
Inserting any amount in "Advance" or "Amount paid" fields and pressing the "Save" button will force
KWHotel to open a cash document creation window.
This prevents from accepting payments without issuing a cash document.
Page 13 of 30
„Configuration” module
Disable to create an invoice in the booking window (the invoice will be issued only from
the ticket editing window) (5) - disables issuing invoices in a reservation window.
Invoices can only be issued by editing a receipt and pressing the "Issue invoice" button. Please note
this feature does not disable attaching one invoice to multiple receipts.
Group meals to one position on invoices (6) - causes all meals to be merged into a single entry
on invoice.
The name of this entry can be set in the "Default name for meals on the invoice" field (12).
Documents issued for this hotel will be stored in the first hotel (7) - this option can only be
seen in case you are running multiple properties on the same database.
Enabling it will cause all documents to be issued to the first property`s account (numeration from the
first property will be used as well).
Documents from current property have common numeration with documents from
property 1 (without receipts) (8) -
selecting this option causes documents from the currently opened property and those from the first
property to have the same numeration.
They are still issued independently, though. Does not take receipts into account.
Enable multiple cash registers (9) - this function is not used in KWHotel yet.
Every document on the computer will be issued for a specified hotel location, not for the
currently selected hotel (10) -
allows you to pick a property location that will be displayed on accounting documents.
Letter added to the prefix to the current object (11) - field used to insert additional prefix for
documents issued from this property for another.
Hide Cash Documents in the booking window (12) - this feature will be described later.
Default name for grouped items on the invoice (13) - allows to determine the first part of
assortment name that will be created when the "Group" option is used on the invoice.
When I group together the "Accommodation" (8%) and Lunch (8%) entries, the single entry created
will be "Product 8%".
Product code (15) - allows to insert the default product code for meals.
Page 14 of 30
„Configuration” module
Cash accepted (1) - this field allows you to set your own abbreviation for "Cash accepted"
document.
Cash released (2) - this field allows you to set you own abbreviation for "Cash released" document.
Bank accepted (3) - this field allows you to set your own abbreviation for "Bank accepted"
document.
Bank released (4) - this field allows you to set your own abbreviation for "Bank released"
document.
Separate with a slash instead of a space (5) - enabling this option will cause adding an
additional " / " to separate cash document`s prefix from its` number.
Annual numeration (i.e. 32/A/2010) (6) - enabling this option will cause adding to cash
documents an annual numeration.
Monthly numeration (i.e. 32/A/06/2010) (7) - enabling this option will cause adding to cash
documents a monthly numeration.
Page 15 of 30
„Configuration” module
4. Meals
The detailed manual can be found here.
5. Users
The detailed manual can be found here.
6. Email
The detailed manual can be found here.
Page 16 of 30
„Configuration” module
Fields displaying file names of every fiscal document (1). Icons located in the right part of
the screen can be used to change the file location.
Replace 0% tax with (2) - allows to insert an alternative value that will replace the 0% tax in
fiscal documents.
Documents templates for all hotels (3) - this function will be described later.
Fields used to select the old booking confirmation templates if we still wish to use them in a
reservation screen (4).
Enable old booking confirmation (5) - allows to generate the old booking confirmations (.rdlc
extension).
Enabling this option will make them reappear in a reservation window > Issue document > Old
booking confirmations.
Download rates from the channel manager (6) - this option is currently unavailable.
Hotel ID card (7) - this option is no longer used in KWHotel 0.47. Instead, please use the new
registration card template, available in the Email section.
Page 17 of 30
„Configuration” module
This field allows you to define regulations that will be displayed on booking confirmations (1).
Additional "Save" button will appear when you make any changes (2). Please click it for
changes to be saved.
Page 18 of 30
„Configuration” module
8. Security
Ask me if I want to create database backup before closing the program (1) - when enabled,
you will be asked about creating a database backup each time you close KWHotel.
Automatically create database backup before closing the application (2) - when enabled, a
database backup will be created automatically when closing KWHotel.
Selecting this option will also allow you to select a location where database backup will be stored.
Automatically create backup every 30 minutes and save copy in the default location (3) -
when enabled, KWHotel will automatically create database backup every 30 minutes, as separate
files.
Create each backup as a separate file (4) - enabling this option will cause KWHotel to create
database backups in separate files.
Database online backup (5) - enabling this option will cause KWHotel to automatically create a
database backup and store it on our servers.
Database copy is created on a daily basis.
Page 19 of 30
„Configuration” module
To activate the option, two keys must be set up - the primary and secondary one. The primary is
stored directly in the database. The secondary is stored on the computer.
This ensures that credit card data cannot be viewed on another workstation, than was used to
encrypt it.
Keys can only be inserted when KWHotel has been started as an Administrator (right click on the
desktop icon > Run as Administrator).
When keys are created, please accept the regulations and save changes.
The credit card tab will appear in a reservation screen after you restart the program. Keys can be
deleted by pressing the "Delete keys" button.
Page 20 of 30
„Configuration” module
Enable overbooking option (makes it possible to book the same room more than once at
the same time) (3) -
when enabled, you can create multiple reservations for the same room and at the same date.
Page 21 of 30
„Configuration” module
Example:
If we issue an invoice, KWHotel will insert an accommodation service for 470 EUR total.
If amount already paid is less than total price (amount payable), show amount paid as
advance payment (5) -
when enabled, every payment lower than the total amount due will be automatically transferred to
"Advance" field.
This option requires restarting the program to take effect.
Page 22 of 30
„Configuration” module
Page 23 of 30
„Configuration” module
Transfer advance amount as second payment. Option used to gather commissions and
provisions by travel agencies (3) -
This feature will be described later.
Selected and finished reservations will be automatically deleted after {days} (5) -
when active, you may use the "Permanently delete the reservation after it is settled and finished"
option, located in a reservation screen > "Other" tab.
Page 24 of 30
„Configuration” module
Automatically delete a reservation for a private person once a bill has been printed (6) -
when enabled, you will receive the following message when printing a bill - "Choose "Yes" not to
save the document and delete the reservation".
Accepting the message will permanently erase reservation from the calendar. Bill can only be printed
and will be deleted from the database afterwards.
Enable four decimal places in the invoices (10) - when enabled, additional two decimal places
will be available for amounts found on invoices.
ID of the company responsible for issuing meals-related fiscal documents (11) - This option
will be described later.
Page 25 of 30
„Configuration” module
This hotel is not a tax payer. Force KWHotel to issue bills instead of invoices (1) -
this option will be described later.
Page 26 of 30
„Configuration” module
Automatically change the room status to "Dirty"; after this amount of days (6) -
when enabled, a room housekeeping status will be automatically changed to "Dirty"; when a set
number of days passes since the check-in date.
when enabled, KWHotel will not display a warning when you attempt to check-in more people into a
room than you have beds in it.
Enable eGost synchronization (10) - this function is no longer available in the program.
Page 27 of 30
„Configuration” module
ARH_OCR Combo Scan (1) - ID cards scanner - enables synchronization with an ID Scanner. This
is an extra paid feature.
Turn on SPA (2) - enables synchronization with KWSpa module, used to manage Wellness & SPA
services.
This is an extra paid feature which requires typing a password to unlock it.
Renting Lock (3) - allows to enable synchronization with the RentingLock hotel locks. This is an
extra paid feature.
Gold Lock (4) - allows to enable synchronization with the Gold Lock system. This is an extra paid
feature.
Enable (5) - allows to enable synchronization with BTLock hotel locks. This is an extra paid feature.
Page 28 of 30
„Configuration” module
Espago / Elavon - requires purchasing an Espago synchronization module and signing agreement
with that partner. This tab allows you to perform a detailed configuration of the credit card payment
links sending. A detailed manual on how to set up Espago synchronization is provided after
purchasing the addon.
Allows you to enable synchronization with OTAs or channel managers supported by KWHotel.
Requires additional fee. A detailed manual on how to set up the online synchronization is provided
after purchasing the addon.
This module allows to enable synchronization with the Price Optimizer, system created by the
YieldPlanet company. This function is still under construction.
Allows to enable synchronization with the SMS API. This module lets you send automated and
manual SMS messages to your guests. Requires additional payment. Manual on how to configure
SMS API is provided once the module is purchased.
Page 29 of 30
„Configuration” module
14. Campground
The "Enable camping" button allows to activate the Camping module. Requires additional fee.
Page 30 of 30