API Reference
The SiteMinder Exchange suite consists of two key API types:
Reservations
SOAP/XML
. When a reservation is created, modified, or canceled in the partner PMS application (Reservation Uploader/Data Publisher) and pushed to SiteMinder Exchange, SiteMinder generates a notification for each reservation event. These notifications are then pushed to subscribing SMX partner applications.
Subscribing SMX partner applications can use the reservation data to deliver value-added solutions for the hospitality and travel industries.
The SMX Partner Application should be able to accept all ResStatus values and respond with Success (200 OK status).
Reserved
Waitlisted
Cancelled
No-show
In-house
Checked-Out
Redacted
Scenarios for Reservation Delivery
Successful Delivery:
If the
OTA_HotelResNotifRQ
message is successfully delivered to the SMX partner application's web service endpoint, the application must respond with anOTA_HotelResNotifRS
Success message.
Error in SMX Partner Application:
If an error occurs while processing the
OTA_HotelResNotifRQ
message, the partner application's web service endpoint must respond with anOTA_HotelResNotifRS
error message, including an error string.In this case:
The reservation will remain in SMX's retry cycle.
It will be resent once the error is resolved.
Manual intervention may be required to resend the message after the retry cycle expires.
Delivery Failure due to Connectivity Issues:
If the
OTA_HotelResNotifRQ
message cannot be delivered due to network outages or similar connectivity issues:The reservation will be retained in SMX's retry cycle.
The message will be resent once connectivity is restored.
Manual intervention may be required after the retry cycle expiry to resend the message.
Availability and Rates
JSON
. Data uploaded by the partner PMS application (Data Publisher) is securely stored in SiteMinder Exchange platform. This data is made available for SMX Partner Applications, which can query the platform to retrieve information for their subscribing hoteliers.
Access and Authentication:
Authentication Token:
Partner applications must authenticate their queries using a token.
The token can be generated through the SMX Admin Portal.
Querying Data:
Once authenticated, partner applications can retrieve data from SMX for their associated hotels.
Endpoints
DNS TTL should be respected. IP addresses should not be cached indefinitely by the connecting application. Doing so will result in connection timeouts.
Limitation
At the moment, you are not able to obtain ARI data from the following Publishers: Little Hotelier and SiteMinder Channel Manager.
Last updated