Parameter Format:
All URLs created contain the parameters that instruct the system what information to display.
Note: All parameter values listed are for example purposes only. Please verify parameter values specific to your Property/Chain/Destination before linking.
All parameters passed to Control Center must be in the following format:
oParameter Name = Parameter Value
oFor example, the parameter for passing in the arrival date field is arrive=9/15/06.
When the first parameter is added to the root page URL, it must be separated from the root URL with a “?”. All other parameters that are added must be prefaced with an ampersand (“”).
oIn the following examples, the Hotel parameter is the first added parameter, while the Chain, arrival and departure dates and adults are separated by ampersands as they follow the first added parameter.
oExample HTML Configuration of the Booking Engine call with parameters
?Hotel=10081&Chain=5130&arrive=9/12/2005&depart=9/14/2005&Adult=1
Do not include empty parameters. In the following example, the child parameter should be omitted:
oIncorrect: &Hotel=10001&Child=&Adult=1
oIncorrect: &Hotel=10001&Child=0&Adult=1
oCorrect: &Hotel=10001&Adult=1
Do not include invalid parameters in the URL. For example, when setting the URL for the entire Chain, do not pass invalid values in the hotel parameter:
oIncorrect: &Hotel=N/A&Chain=12345
oCorrect: &Chain=12345
Pre-Filling Values:
Hotels that wish to override the default values prior to checking availability will often pre-fill values on the Booking Engines via the URL. For example, if a hotel would prefer that the default number of adults was 2, they would pass the &Adult=2 parameter when linking to the Booking Engine.
If you wish to pre-select the values on the first page (Stay Details page) of the Booking Engines, you may pass any combination of the following parameters:
Arrive
Depart
Nights
Adult
Child
IATA
Promo
Example calls to the Stay Details page with pre-filled values:
HTML Configuration of the Booking Engine –
Page 15 of 65
By-Passing Steps:
Bypassing the Stay Details Page:
If you wish to by-pass the first page (Stay Details page) of the Booking Engines, you may directly call the Availability results page.
There are four required parameters to access the Availability results page:
Hotel
Arrive
Depart
Step - - Must be set to 2.
The Adult and Child parameters are optional and default to 1 adult and no children.
Example HTML Configuration of the Booking Engine call to Availability Results: hotel=12345arrive=10/01/2008depart=10/02/2008&adult=2&step=2
Linking to the Amend Reservation Page:
If you wish to by-pass the booking process and directly access the Amend Reservations page in the HTML Booking Engine, you may do so using parameters. This option is chosen when the hotel wishes to offer the ability for customers to enter their identifying reservation criteria (email, confirmation number) on their own site. When a customer on their website opts to search for a reservation, they will be directed to the Amend Reservation search results.
There are four required parameters to access the Room Availability page:
Confirm
Path - Must be set to 2 for the Amend Reservation page to display.
Step - Must be set to 2 for the Amend Reservation page to display.
Example call to the Amend Reservation page:
Page 16 of 65
Linking to the Reservation Search Page:
If you wish to by-pass the “Check Availability” page in the HTML Booking Engine, you may directly call the “Reservation Search Page”. This option allows the hotels to include a “Find Reservation” or a “Modify Reservation” link on their website.
There are three required parameters:
Hotel
Step - Must be set to 2
Path - Must be set to 2 for the search page to display
Example call to the Reservation Search Page: