Versions Compared

Old Version 17

changes.mady.by.user Paul Collado Orta

Saved on

compared with

New Version Current

changes.mady.by.user Cian Ó Ceallaigh

Saved on

Key

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

...

Expand
titleWhich customers can connect through SiteMinder Exchange?

Any hotel who that is using a an SMX-certified PMS and a an SMX-certified application can use the interface without the need to be a SiteMinder customer.

Expand
titleAre all PMSs listed in your website able to connect through SMX?

The PMSs listed on our website are connected to our Channel Manager, but not all have an agreement to publish any data to SMX. 

pmsXchange and SMX are 2 different products that need to be built separately, and being in our PMS List in our web, does not imply that the PMS is available in SMX. The PMSs connected to SMX will have a ‘Hotel App Store’ logo. You can also find the list here: SMX PMSs Reservations Capabilities Table

Expand
titleFor RMSs (Revenue Management System) connecting to SMX (SiteMinder Exchange). What is the difference between pmsXchange API and SMX API?

For RMSs connecting to both pmsXchange and SMX API, please note the difference:
- pmsXchange API is used to send Rate updates to the property’s SiteMinder Platform.
- SMX API is used to receive Reservations.

Please note that both connections will have different Hotel codes used to activate data flow. Consult with the relevant SiteMinder team for questions about the Hotel Code used.

Reservation 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
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 (the guest is checked in), a guest has been moved to another room, or a modification was being received from the booking source (ie: Booking.com).

...

Expand
titleHow do I receive historical data?

In most scenarios, the data publisher can simply push the data through to SMX and it will be passed on to you. However, you will need to discuss with the data publisher to determine if they are able to can push through historical data.

...

Expand
titleWhat is the difference between the ResGuest and ResGlobalInfo profiles?

  • ResGuest: This will contain the details of the 'staying' guest if provided by the data publisher.

  • ResGlobalInfo: This will contain the details of the 'booking' customer, and may also contain details of business, wholesaler or travel agent information

It is a good idea to ensure you are able to can use both the ResGuest and ResGlobalInfo profiles, as it cannot be guaranteed that both will always be sent.

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 Success+Warning response for missing data or an Error message if a reservation message cannot be processed. Please refer to the Error Handling section of the documentation for more detaildetails.

Expand
titleCan I send data back to the publisher?

Not yet. However, this is planned for a future enhancement.

Expand
titleCan you send reservation data in a JSON format?

No. SMX is derived from the Open Travel Alliance (OTA) industry standards, which uses use SOAP XML. At the time SMX was created, JSON was not a supported message format. However, there are plans to introduce a JSON version of the reservation API in the future.

Expand
titleWhy do we need to provide a hotel code to SMX?

We ask you to provide us with an identifier for the hotelier within your system as this ensures that the HotelCode attribute within each message is unique to your system and in a format you are able to can handle. As we connect to multiple data publishers, there is the possibility that duplicate codes will exist between these data publishers (ie: HOTEL1 may exist in 2 different data publishers).

Expand
titleCan the ResID_Type and ResID_Value be empty in the OTA_HotelResNotifRS?

HotelReservationIDs / ResID_Type and ResID_Value are mandatory in our Response specs and cannot be empty. This section should not be taken from the reservation request XML received (In case it is not present in the Request XML).
This is the HotelReservationID generated in your application after you confirm/create this reservation in your portal. You should be passing the ID generated in your extranet.
Most partners use the same ID received under UniqueID as their ResID_Value if your system is not able to generate its own confirmation ID.

Reservation API Integration Process

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

Certification The 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 which 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 cannot be delivered and we don't understand why, we will let you know and once . Once it has been fixed, we will resume the certification. This means you can "fail" it any number of times, the . The important thing is that at the end of this process, we fixed all the issues.

Availability and Rate API

Expand
titleCan we connect with properties using Little Hotelier and The Channel Manager to get ARI?

No, Little Hotelier and The Channel Manager are not pushing yet ARI data to SMX just yet.