Skip to main content

Widget

The widget can be programmed to access/enter iQ-WebBook in three different ways:

  1. FORM / POST
  2. Advanced URL parameters
  3. Simple URL GET parameters

ie:

  1. <FORM> ...... </FORM>
  2. https://us01.iQ-WebBook.com?parms ...........
  3. https://us01.iQ-WebBook.com?cid=10&cim10&ciy=2015& ....

Adults, Children and Infants​

iQ-WebBook and roomMaster support one field for Adults and one field for Children. If you have a second level of Children that are not charged (ie: Infants or Children under 3), you can simply have a third Widget field (SPIN or DROPDOWN) and simply have the guest enter the information but just not send it to WebBook. (ie: a dummy field for Children under 3 that the guest enters, and knows to separate Children from Children under 3, and just not send the third field into the booking engine.

If you do not accept children, please create a hidden field and send 0 (zero) for the CH parameter.

Form Parameters​

Below is a simple example of how to use form parameters. Make sure if you use forms, that redirection happens if needed in your programming environment. For a FULL example, please see the iQ-WebBook Admin Panel / Branding and Themes / Widgets.

<form action="https://us01.iQ-WebBook.com/YOUR_SITE_ID/Integration/Search" method="POST" name="SearchForm">
 <!-- CIM = CheckInMonth-->
 <!-- CID = CheckInDay-->
 <!-- CIY = CheckInYear-->
 <!-- COM = CheckOutMonth-->
 <!-- COD = CheckOutDay-->
 <!-- COY = CheckOutYear-->
 <!-- AD = Adults-->
 <!-- CH = Children-->
 <!-- RMS = Rooms-->
 <input type="hidden" name="UF1"/>
 <input type="hidden" name="UF2"/>
 <input type="hidden" name="LG"/>
 <button type="submit">Check Availability</button>
 </form>

If you are not using rooms (ie: only 1), then use a hidden field for rooms (RMS) as 1.

 <input type="hidden" name="RMS" value="1"/>

Advanced URL Parameters​

The HBE supports url query parameters to navigate directly to the results of a room search. The advanced parameters allow for a standard approach as well as ability to handle multiple room requests.

The url for this purpose must have the following format:

https://us01.iQ-WebBook.com/{YOUR_SITE_ID}/~/?[Search Parameters]

• SiteWebID - Code assigned by InnQuest Software to access the Hotel Booking Engine site, for example XYZ999

The Search Parameters can be any combination of the following parameters separated by an &

• arrivalDate: Specifies the arrival date in the ddd, MMM d yyyy format.

Example: arrivalDate=Tue, Oct 20 2015

• departureDate: Specifies the departure date in the ddd, MMM d yyyy format.

Example: departureDate=Thu, Jan 1 2015

• rooms: Specifies the number of rooms and the numbers of adults and children per room, in the format [{"adultsCount": n, "childrenCount": n}, {"adultsCount": n, "childrenCount": n}, ...].

Example for two rooms where the first room has 2 adults and 2 children and the second room has 1 adult and 0 children:

[{"adultsCount": 2, "childrenCount": 2}, {"adultsCount": 1, "childrenCount": 0}]

• coupon: Specifies a Group Code or a Promotional Code.

Example: coupon=SAVE10

• uf1: Specifies a value for the User Field 1.

Example: uf1=ABC123

• uf2: Specifies a value for the User Field 2.

Example: uf2=ABC123

• language: Specifies the language in which the reservations website should be shown, using the standard ISO language codes en, es, fr, de, etc.

Example: language=fr

For example, for a search with the arrival date of October 10, 2015, a departure date of October 13, 2015, and a single room for 2 adults and 1 child, the url would be:

https://us01.iQ-WebBook.com/YOUR_SITE_ID/~/?arrivalDate=Tue, Oct 20 2015&departureDate=Fri, Oct 13 2015&rooms=[{"adultsCount":2, "childrenCount":1}]

NOTE: If the url is constructed by another system, or added as a link in a website, the value of the parameters must be encoded, using simple url encoding, so the above url would be:

https://us01.iQ-WebBook.com/YOUR_SITE_ID/~/?arrivalDate=Tue,%20Oct%2020%202015&departureDate=Fri,%20Oct%2013%202015&rooms=[{%22adultsCount%22:2,%20%22childrenCount%22:1}]

Simple URL Parameters​

Below is an example using a simple URL request using the following parameters:

  • CIM = CheckInMonth
  • CID = CheckInDay
  • CIY = CheckInYear
  • COM = CheckOutMonth
  • COD = CheckOutDay
  • COY = CheckOutYear
  • AD = Adults
  • CH = Children
  • RMS = Rooms
  • UF1 = UserField1
  • UF2 = UserField2
https://us01.iQ-WebBook.com/YOUR_SITE_ID/Integration/Search/?CIM=11&CID=01&CIY=2015&COM=12&COD=24&COY=2015&AD=2&CH=0&RMS=1

If you are not using rooms (ie: only 1), then use a hidden field for rooms (RMS) as 1.

....&RMS=1