Frequently Asked Questions
- General
- Reservation API
- How are messages sent?
- When will I receive reservation data?
- How do I know what was modified?
- How do I receive historical data?
- Can you resend reservations?
- What is the difference between the ResGuest and ResGlobalInfo profiles?
- I didn't receieve data that I am after. How can I get the missing data?
- Can I send data back to the publisher?
- Can you send reservation data in a JSON format?
- Why do we need to provide a hotel code to SMX?
- Availability and Rate API
General
Do 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.
Reservation API
How are messages sent?
SMX uses SOAP xml
messages to transmit data to the connecting application. You can find samples of these messages in the Resources - XML Samples section.
When 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).
How do I know what was modified?
Data publishers will provide the full details of the reservation as it stands after the modification has been made. This means you will also receive the complete reservation details again.
It is important to note that SMX will not compare the changes that have been made and cannot provide a 'summary' of the changes.
How 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 push through historical data.
Can you resend reservations?
Reservations can be resent upon request by the SMX support team.
ResGuest
and ResGlobalInfo
profiles?
What is the difference between the ResGuest
: This will contain the details of the 'staying' guest if provided by the data publisherResGlobalInfo
: This will contain the details of the 'booking' customer, and may also contain details business, wholesaler or travel agent information
It is a good idea to ensure you are able to use both the ResGuest
and ResGlobalInfo
profiles, as it cannot be guaranteed that both will always be sent.
I 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.
Can I send data back to the publisher?
Not yet. However, this is planned for a future enhancement.
JSON
format?
Can you send reservation data in a No. SMX is derived from the Open Travel Alliance (OTA) industry standards, which uses 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.
Why do we need to provide a hotel code to SMX?
We ask you to provide us with an identifier for the hotlier 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 handle. As we connect to multiple data publishers, there is the possiblility that duplicate codes will exist between these data publishers (ie: HOTEL1
may exist in 2 different data publishers).
Availability and Rate API
Coming soon!