TOPSAIL™ IMPLEMENTATION GUIDE : Deep Link URL Layout

A deep link is a special URL that routes to a specific spot, whether that's on a booking engine or website.

The following guide walks through how to set up deep links into the TopSail™ Internet Booking Engine from SHR.
Base TopSail™ URL: https://res.windsurfercrs.com/ibe/index.aspx?
Variables are all appended onto the base link following the ‘?’. Additional variables can be added to the end of the URL by adding a ‘&’.
Example URL: https://res.windsurfercrs.com/ibe/index.aspx?propertyID=1002&checkin=11/01/2022

Property ID/Code Variables

PCode – CRS Property code in Windsurfer CRS

• Found under Property Description > Address/Contacts > CRS Property ID

propertyID – CRS property numeric ID

• All clients: Found by hovering over the property name in Windsurfer CRS
• Multi-property clients: also found next to the property name in the select property drop-down box in Windsurfer CRS

Language and Currency Variables

langID – Property language (numerical value)

• See Language ID List for full details
• Default is &langID=1 for US English

currID – Currency ID (numeric value)

• See Currency ID List for full details
• Will default to the currency listed as default in Property Description > Currency

Calendar Variables

checkin - Arrival date, Format: MM/DD/YYYY (e.g. 12/01/2017 for December 1st, 2017)

checkout - Departure date, Format: MM/DD/YYYY (e.g. 12/03/2017 for December 3rd, 2017)

nights - Number of nights stayed (numeric value)

opencalendar=1 – Opens calendar automatically

suppressavail=1 - Works in conjunction with ‘open calendar’ allowing the system to ignore restrictions and still open the calendar to view

Occupancy Variables

adults – Specifies the number of adults per room (numeric value)

children – Specifies the number of children per room (numeric value)

rooms – Specifies the number of rooms in the request (numeric value 1-5)

bed – Bed Type (King=10, Queen=20, Double=30, Twin=40)

nonsmoking – Smoking or non-smoking rooms (YES = Non smoking room, NO or empty = no preference)

Room Type, Rate Code and Package Variables

Must use details view base URL: https://res.windsurfercrs.com/ibe/details.aspx?

Rate - Rate code (text string), Rate code as loaded in Windsurfer CRS

• Rate Code AAA – Use of “&Rate=aaa” will bring results showing the association rate offer first.
• https://res.windsurfercrs.com/ibe/index.aspx?propertyID=1002&langId=1&checkin=05/21/2015&nights=2&checkout=05/23/2014&adults=1&rooms=1&children=0&rcID=aaa
• Multiple rates can be specified by using a comma separator, no spaces between each rate code

rcID - Rate Code ID (Numeric ID)

• (Numeric ID) is the specific CRS rate code numeric ID found by hovering over the rate code directly in the CRS under Rate Management > Rate Code > Rate Code List
• Alternately, it can be found in the browser URL bar if the rate code is selected from the rate code list after “RatecodeID=”

rmID – Room Type ID (Numeric ID)

• (Numeric ID) is the specific CRS rate code numeric ID found by hovering over the rate code directly in the CRS under Property Description > Room Type > Room Type List
• Alternately, it can be found in the browser URL bar if the room type is selected from the room type list after “RoomTypeID=”

PackageID – Package ID (Numeric ID)

• (Numeric ID) is the specific CRS rate code numeric ID found by hovering over the package directly in the CRS under Group/Package/Add-Ons > Package > Package List
• Alternately, it can be found in the browser URL bar if the package is selected from the package list after “PackageID=”

Access and ID Code Variables

Promo – Promo code (text string)

• Specifies a promotional rate code or ID offered by the property.
• Do not enter standard, discount, package, group, or corporate rate codes or IDs.
• https://res.windsurfercrs.com/ibe/index.aspx?propertyID=1002&langId=1&checkin=05/21/2015&nights=2&checkout=05/23/2014&adults=1&rooms=1&children=0&promo=promofall

Group – Group attendee ID (text string)

• Group attendee code: the code entered by a guest to retrieve and book a group rate.
• Group rates will not be displayed unless requested by the guest.
• Not the CRS or PMS group rate code, but what is entered in the ‘Group Code’ field on the UI of the IBE
• https://res.windsurfercrs.com/ibe/details.aspx?propertyid=1002&nights=1&checkin=01/01/2015&group=beourguest

Corp – Corporate Code (text string)

• Use of “corp=” for negotiated or corporate travelers will bring the rate within the corporate category directly to the guest.
• https://res.windsurfercrs.com/ibe/index.aspx?propertyID=1002&langId=1&checkin=05/21/2015&nights=2&checkout=05/23/2014&adults=1&rooms=1&children=0&corp=ibm

IATA – Travel agency IATA/ARC number (Numeric ID, 8 characters max)

• Assigns Travel Agent’s IATA or ARC ID to reservation made on the booking

Appendix

Language ID List

Currency ID List