Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The Partner Integration Team have put together a list of common questions we get from SMX for Apps partners working on development to the API.

We ask that you bookmark this page and refer to it regularly, as many questions you might have are likely to be answered here. Below we've broken up the FAQ into sections that relate to the different parts of the API.

...

Table of Contents
minLevel1
maxLevel7

...

Reservations API

Expand
titleDo I need to certify to receive data from each data publisher individually?

No. SMX is built on the mentality of 'develop once, connect to many'. Once your connection is certified with SMX you will be able to connect to all available data publishers. SMX will handle any message conversion required.

Expand
titleHow are messages sent?

SMX uses SOAP XML messages to transmit data to the connecting application. You can find samples of these messages in the Reservation XML Samples section.

Expand
titleWhen will I receive reservation data?

Data publishers should send through an updated version of the reservation message when it is modified within their system. This can include events such as a reservation status being adjusted to In-house (guest is checked in), a guest has been moved to another room, or a modification was received from the booking source (ie: Booking.com).

...

Expand
titleI didn't receieve data that I am after. How can I get the missing data?

SMX can only provide you with reservation data that is sent by the data publisher. It is expected that your system will be able to return an appropriate error message in the event that a reservation message cannot be processed. Please refer to the Error Handling section of the documentation for more detail.

...

Expand
titleCould you give me more information about the Certification process?

Certification process is very straightforward. We will create some reservations (some of them will be modified and/or cancelled) and will verify that all of them will trigger either a successful response or a meaningful error response. Your responses should be well in line with our OTA_HotelResNotifRS specifications. We will also test sending through our Minimum and Maximum content samples.

 If some reservations trigger an error (for instance, due to missing data), this error must be as eloquent as possible and it should not impact the http status that should remain as 200. If you have server level issues, then it is OK to respond with HTTP standard error codes. See our Error Handling specs for more details.

The only thing that is required from your side is to leave your endpoint up and running until we complete certification.

 If there's an issue with your responses or some of the reservations could not be delivered and we don't understand why, we will let you know and once it has been fixed, we will resume the certification. This means you can "fail" it any number of times, the important thing is that at the end of this process we fixed all the issues.

...