Reservations Import

Bulk import active reservations from SiteMinder Platform to your PMS during initial integration setup.

It is a prerequisite to develop to the SiteMinder Reservations Upload to gain access to the Reservation Import. To discuss further, reach out to our Ecosystems team via [email protected].

What is Reservation Import?

Reservation Import is a one-time bulk retrieval method where the Property Management System (PMS) triggers an import job to receive all active reservations from the SiteMinder Platform. This integration is essential during initial PMS setup, allowing hotels to migrate their existing reservation data from SiteMinder into the new PMS without manual re-entry. Once triggered, SiteMinder processes all active future reservations and delivers them to the PMS using the standard reservation delivery method.

To implement Reservations Import, the PMS must certify Reservations PUSH or Reservations PULL.

Considerations

• Delivery Method: Reservations will be delivered to the PMS using the normal reservation delivery method following the import trigger.

• Failure Notifications: The hotel will receive standard email reservation notifications if a reservation fails to deliver during the import process.

• Reservation Scope: Only active reservations and modifications are included in the import; cancellations are ignored. Active reservations are defined as future reservations that have not checked in yet.

• Import Duration: The import duration depends on several factors, including the total number of reservations to process and the volume of live reservations at the hotel.

• Duplicate Handling: The import may create duplicate entries in the hotel's PMS if some reservations have already been manually entered. It is not possible to exclude specific reservations from the import.

• Completion Verification: Currently, there is no direct way to confirm when the import has completed. A return to the normal frequency of live reservation deliveries typically indicates that the import has finished.

Usage Note: This function is intended for use when a hotel integrates with a new PMS. It should not be used to re-deliver reservations that may have failed due to an outage or other issues.

Authentication Requirements: The REST components of the pmsXchange API only support PMS-level authentication, which means using the same credentials across all properties. If you’re currently using hotel-level authentication (credentials per property), we recommend switching to PMS-level to ensure compatibility with the REST endpoints.

post

Triggers the import active reservations job for requested hotel.

Authorizations

basicAuth

AuthorizationstringRequired

Path parameters

pmsCodestring · min: 1Required

pmsCode used to identify the pmsx partner

hotelCodestring · min: 1Required

hotelCode used to identify the hotelier

Header parameters

X-SM-TRACE-TOKENstringRequired

traceToken is logged with every log messages for this request

Responses

202

Accepted for reservation import

400

Invalid request

application/json

401

Unauthorized

application/json

429

Too Many Requests

application/json

500

Unexpected error occurred

application/json

post

/pmses/{pmsCode}/hotels/{hotelCode}/reservation-import

HTTPcURLJavaScriptPython

POST /pmses/{pmsCode}/hotels/{hotelCode}/reservation-import HTTP/1.1
Host: tpi-pmsx.preprod.siteminderlabs.com
Authorization: Basic username:password
X-SM-TRACE-TOKEN: text
Accept: */*

No content

Help Centre

• Troubleshoot a failed reservation delivery to your PMS/RMS/CRS