Channel Manager Integration

We provide a white label channel manager that you can host inside your PMS, so that you can provide connectivity to your properties without them logging into a separate site.

Follow the steps below to start using SWITCH.CM’s simple XML interface now.

Integration Requirements

We provide the following channels free of charge for PMS providers:

  • Booking.com
  • Expedia
  • Agoda
  • Hostelworld
  • Hostelbookers
  • Hostelsclub
  • AirBNB (private beta)

You can also provide premium channels (a full list is available here) for $249 per month per account.

We will provide:

  • a username and password for access to our server
  • a whitelist the IP address(es) of your server(s)
  • an interface compatible with your tech stack (so that it looks like this inside of your web app)

Writing your API

You will need to create the following connections:

  • Reservation request.  When reservations are made on your site, you will need to send an XML request to our server.  You will receive a response indicating whether the request was successful (or if it had any errors).  A successful request will automatically insert a guest’s reservation into a hotel’s system.
  • Receive price & availability.  When a hotel makes a new reservation, you will receive a request from us that informs you of their new pricing & availability.  Note that this happens frequently, as the availability will change every time a hotel receives a new reservation from any source.

 

Testing and Certification

You will need to demonstrate the following in order to pass certification:

  • send new reservation to server
  • receive updated availability
  • receive updated price

New Reservation API

With just 43 lines of code, we can help you connect to Siteminder’s complex distribution network.  When a new reservation is made on your site, you will need to send an XML request to the following address:

  • https://api.switch.cm/reservation/

EXAMPLE XML REQUEST
The following should be the format of your request.

Screenshot 2016-02-29 12.49.24

SYNTAX REQUIREMENTS:

  • all dates will need to be in YYYY-MM-DD format
  • currencies will need to be 3 digit ISO 4217 code
  • prices can be with or without decimal places

ROOMTYPEID & HOTEL_ID:

The hotel_id will be provided for you by the hotel.  Each of their rooms will have a unique roomtypeid, which corresponds with a specific room in our database.

Note that if a property creates a new room type, they will need to send you the new room type.  This is usually done by the hotel, BUT we highly recommend that you understand how the manual room process works.  We have found that most smaller hotels without dedicated mapping teams do not know how to do this, and have also found that even larger hotels get it wrong on occasion.


 

XML RESPONSES
The following are the responses you will receive, depending on whether there is a successful request or one with errors.

SUCCESS

Screenshot 2016-02-29 13.28.32

ERROR

Screenshot 2016-02-29 13.32.05

Price & Availability API

The Price & Availability API is used to push updated availability from the hotel to your OTA.

You will need to be able to receive this XML And handle it appropriately in your database.

Syntax Requirements

  • all dates will need to be in YYYY-MM-DD format
  • currencies will need to be 3 digit ISO 4217 code
  • prices can be with or without decimal places
  • You will need to give us an endpoint to send this to (https://www.yousite.com…)

Screenshot 2016-02-29 13.33.56