Unassisted implementation
Do you have any questions regarding KWHotel functions or development?
>>>Ask them here
Attention! Technical support available under the email: support@kwhotel.com and the phone number: 0048 12 333 78 77 does not provide technical support in regards to implementing KWHotel Booking Engine. In case of any difficulties, it is possible to purchase an extra service for our Support Team to implement the system for you.
This manual includes:
1.Introduction
2. KWHotelBookingEngine
3. Allotment calendar
4. Reservation calendar
KWHotel Booking Engine consists of 3 elements:
– standard booking engine with an offer search (see point 2)
– allotment calendar (see point 3)
– reservation calendar (see point 4)
1. Introduction
After configuration the booking engine as indicated in the instructions the next step is to implement the system onto a website.
To start the implementation process it is necessary to find the KWHotel Booking Engine link. It is located in the online control panel available under the internet address dev.kwhotel.com. After login in enter the tab Configuration–>Online reservation–>Settings. Located at the top of the window is the booking engine link. Copy the link with the yellow option on the right. Save it in Windows notepad for later use.
2. KWHotelBookingEngine
2.1 The basic structure of the booking engine link:
https://be-v2.kwhotel.com/lang/HASH/HotelID
where:
lang is responsible for the booking engines language: en (English), fr (French), de (German), it (Italian), gr (Greek), ua (Ukrainian), ru (Russian) or pl (Polish),
HASH is unique for each client – it can be located in the booking engine link found in the online control panel, Configuration–>Online reservation–>Settings.
HotelID by default is set at 0. This value should not be edited unless more than one property is located on a single database.
0 – shows offers for all properties
1 – shows offer for the first hotel in the database
2,3,… – shows offer for the Hotel with the ID 2,3,…
Example link for the Demo KWHotel Booking Engine: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0
2.2 Additional parameters available for Step 1 of the order process in KWHotel Booking Engine.
- The link can be created for a specific date by using the following format:
https://be-v2.kwhotel.com/lang/HASH/HotelID?checkIn=YYYY-MM-DD&checkOut=YYYY-MM-DD
where:
?checkIn= start date (format YYYY-MM-DD)
?checkOut= end date (format YYYY-MM-DD)
Example: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0?checkIn=2018-01-24&checkOut=2018-01-25
- The link can be created for a specific room group:
https://be-v2.kwhotel.com/lang/HASH/HotelID?roomGroupId=x
where: x is the room group ID. Room group ID can be located in Rooms–>Room groups
Example: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0?roomGroupId=1
- The link can be created for specific categories (more on categories can be here under point 4.3). Categories and their IDs can be found be found be found in the online control panel, Rooms–>Room groups. IDs are based on the order categories were created in. The first category created will have the ID 1, 2, etc.
https://be-v2.kwhotel.com/lang/HASH/HotelID?categoryId=X
Example: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0?categoryId=2
- The link can be created for specific discount codes:
https://be-v2.kwhotel.com/lang/HASH/HotelID?discountCode=X
where:
?discountCode= refers to the name of the discount code created in the online control panel, Configuration–>Online reservation–>Discount codes.
Example: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0?discountCode=BE47
- The link can be created for a specific number of rooms and groups of guests:
https://be-v2.kwhotel.com/lang/HASH/HotelID?occupancy=[{“count”:X}]
where:
?occupancy= indicates the number of guests and rooms. The variable [{“count”:X}] j is used to indicate the number of guests in searched room. In order to search for more rooms (for a group reservation) add the parameter [{“count”:X}] again after a comma (,).
Example for a group reservation containing two rooms. The first reservation is for a double room, and the second for a triple room:
https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0?occupancy=[{“count”:2},{“count”:3}]
- All elements listed above can be combined into one link:
https://be-v2.kwhotel.com/lang/HASH/HotelID?roomGroupId=X&discountCode=X
Example: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0?roomGroupId=1&discountCode=BE47
2.3 Directing clients to Step 2 of the order process in KWHotel Booking Engine.
It is possible to make reservations without selecting a room for the reservation by using the following link:
https://be-v2.kwhotel.com/lang/HASH/HotelID/step2?checkIn=X&checkOut=X&occupancy=[{“count”:X}]&cart=[{“roomId”:X,”rateplanId”:X,”persons”:X}]
Example: https://be-v2.kwhotel.com/en/e22dd1d13499cfd0eed19a6c108b5d22/0/step2?checkIn=2018-01-24&checkOut=2018-01-25&occupancy=[{“count”:2}]&cart=[{“roomId”:1,”rateplanId”:2,”persons”:2}]
3. Availability calendar
3.1 The allotment calendar is available with the link:
http://availability-graphic.kwhotel.com/HASH/lang/X/Y?monthsLength=x&columnsCount=x
where:
HASH(#) is unique for each client – it can be located in the booking engine link found in the online control panel, Configuration–>Online reservation–>Settings.
x is the room group ID. Room group ID can be located in Rooms–>Room groups
y is the rate plan ID
?monthsLength=x&columnsCount=x defines the number of month and columns shown
Example link based Demo KWHotel Booking Engine: http://availability-graphic.kwhotel.com/e22dd1d13499cfd0eed19a6c108b5d22/en/1/1?monthsLength=2&columnsCount=1
4. Reservation calendar
The reservation calendar is available with the link:
http://reservation-graphic.kwhotel.com/HASH/HotelID/lang
where:
x is the room group ID. Room group ID can be located in Rooms–>Room groups
HotelID by default is set at 0. This value should not be edited unless more than one property is located on a single database.
0 – shows offers for all properties
1 – shows offer for the first hotel in the database
2,3,… – shows offer for the Hotel with the ID 2,3,…
Example link based Demo KWHotel Booking Engine: http://reservation-graphic.kwhotel.com/e22dd1d13499cfd0eed19a6c108b5d22/0/pl
Attention! Changes to the Booking Engine’s display can be made in the online control panel, Configuration–>Online reservation–>CSS style tab.
