Versions Compared

Key

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

...

The SMX For Applications Reservation API is based on the Open Travel Alliance (OTA) specifications for 2017A. Although this document attempts to be technically comprehensive it is expected that the connecting system’s developers be somewhat familiar with the OTA specifications found here.

...

Endpoint Requirements

Partners will need to provide SMX with a single web service endpoint to be used for message delivery. This endpoint must be global for all hotels using the connection, not for each individual hotel.

...

Security

Encryption is provided by the transport layer via HTTPS. Each message contains a WS-Security (WSSE) UsernameToken SOAP header for authentication/authorization purposes. Each connecting SMX Partner Application will need to provide a webservice endpoint to receive the reservation notifications.

...

SSL/TLS

SMX supports TLSv1.2 and above.

SiteMinder does not support self-signed SSL certificates.

...

Content-Type

The ‘Content-Type’ for all SOAP XML messages must be application/xml; charset=utf-8.

...

Response Time

Note

Response time should not exceed 1000ms.

...

Process Flow

When a reservation is created, modified or cancelled in the partner PMS application (Reservation Uploader/Data Publisher) and is pushed to SiteMinder’s SMX platform, SiteMinder will generate a notification for each reservation event and PUSH reservation notifications to subscribing SMX partner applications. Partner applications will need to provide a webservice endpoint to receive the reservation notifications. The subscribing SMX partner applications can then use these reservations to offer value added solutions for the hospitality and travel industry.

...

  • If the OTA_HotelResNotifRQ message is delivered successfully by SiteMinder to the SMX partner application, the partner application's web service endpoint will need to respond with an OTA_HotelResNotifRS success message.

  • If the OTA_HotelResNotifRQ message delivery flags an error in the SMX partner application, the partner application's web service endpoint will need to respond with an OTA_HotelResNotifRS error message, which should include an error string. The reservation will be retained in SMX's retry cycle and resent once the error is resolved. The message resend process may need to be done manually upon expiry of retry cycle time period.

  • If the OTA_HotelResNotifRQ message is unable to be delivered to SMX partner application due to a network outage or similar connectivity issues, the reservation will be retained in SMX's retry cycle and resent once the error is resolved. The message resend process may need to be done manually upon expiry of retry cycle time period.

Endpoint Requirements

Partners will need to provide SMX with a single web service endpoint to be used for message delivery. This endpoint must be global for all hotels using the connection, not for each individual hotel.

Security

Encryption is provided by the transport layer via HTTPS. Each message contains a WS-Security (WSSE) UsernameToken SOAP header for authentication/authorization purposes. Each connecting SMX Partner Application will need to provide a webservice endpoint to receive the reservation notifications.

SSL/TLS

SMX supports TLSv1.2 and above.

SiteMinder does not support self-signed SSL certificates.

Content-Type

The ‘Content-Type’ for all SOAP XML messages must be application/xml; charset=utf-8.

Response Time

...

  • .