Reservation Identifiers

This page details how to properly compose the reservation upload message for the three main reservation upload scenarios. Following these specific reservation ID guidelines is essential to maximise the data enrichment value of these reservations within the SiteMinder Ecosystem.

Other elements and attributes in xml samples have been omitted for brevity

POS Reservation Header

For all reservation upload messages the POS Source RequestorID of 10 to identify the requests are coming from a PMS.

Reservations/Modifications and Cancellations that originate from the PMS, we would expect BookingChannel@Type to be 4 and the Company name and Code to be populated with the PMS Details.

<POS>
   <Source>
     <RequestorID Type="10" ID="PMS"/>
     <BookingChannel Primary="true" Type="4">
        <CompanyName Code="PMS">PMS</CompanyName>
     </BookingChannel>
   </Source>
</POS>

Walk in reservation

To represent a walk in reservation in addition to the POS element as shown above, there are 2 key items to consider.

• WalkInIndicator attribute flag set to true on the HotelReservation element.

• ResID_Type ="14" to identify the ResID_Value is the reservation ID from your PMS

<OTA_HotelResNotifRQ>
  <HotelReservations>
    <HotelReservation ResStatus="Book" WalkInIndicator="true">
      <POS>
        <Source>
          <RequestorID Type="10" ID="PMS"/>
          <BookingChannel Primary="true" Type="4">
            <CompanyName Code="PMS">PMS</CompanyName>
          </BookingChannel>
        </Source>
      </POS>
      <RoomStays>...</RoomStays>
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="123456789"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>
  </HotelReservations>
</OTA_HotelResNotifRQ>

Modification or Cancellation of a reservation originally delivered to the PMS via SiteMinder

In this case we use 3 types of reservation ID

• ResID_Type ="14" to identify the ResID_Value is the reservation ID from your PMS

• ResID_Type ="25" to identify the ResID_Value is the reservation ID from SiteMinder

• ResID_Type ="40" to identify the ResID_Value is the confirmation ID from your PMS

<OTA_HotelResNotifRQ>
  <HotelReservations>
    <HotelReservation ResStatus="Modify">
      <POS>
        <Source>
          <RequestorID Type="10" ID="PMS"/>
           <BookingChannel Primary="true" Type="4">
              <CompanyName Code="PMS">PMS</CompanyName>
           </BookingChannel>
        </Source>
      </POS>
      <RoomStays>...</RoomStays>
      <ResGlobalInfo>
        <HotelReservationIDs>
           <HotelReservationID ResID_Type="14" ResID_Value="123456789"/>
	   <HotelReservationID ResID_Type="25" ResID_Value="BDC-123456789"/>
           <HotelReservationID ResID_Type="40" ResID_Value="1122334455"/>
	 </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>
  </HotelReservations>
</OTA_HotelResNotifRQ>

Reservations from a direct booking channel

These are reservations that originate from a direct booking channel connected to the PMS (not via SiteMinder).

There are 2 sections that are key for these kinds of reservations.

The first is sending the booking channel information in the POS reservation header. In this case we would expect BookingChannel@Type to be 7 and the Company name and Code to be populated with details of that channel.

<POS>
  <Source>
    <RequestorID Type="10" ID="PMS"/>
    <BookingChannel Primary="true" Type="7">
      <CompanyName Code="DBT">Direct Booking Tool</CompanyName>
    </BookingChannel>
  </Source>
</POS>

We also require two types of reservation ID.

• ResID_Type ="14" to identify the ResID_Value is the reservation ID from your PMS

• ResID_Type ="29" to identify the ResID_Value is the reservation ID from the Booking Channel

<OTA_HotelResNotifRQ>
  <HotelReservations>
    <HotelReservation ResStatus="Book">
      <POS>
        <Source>
          <RequestorID Type="10" ID="PMS"/>
          <BookingChannel Primary="true" Type="7">
            <CompanyName Code="DBT">Direct Booking Tool</CompanyName>
          </BookingChannel>
        </Source>
      </POS>
      <RoomStays>...</RoomStays>
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="123456789"/>
          <HotelReservationID ResID_Type="29" ResID_Value="987654321"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>
  </HotelReservations>
</OTA_HotelResNotifRQ>

For more information about the different ResID_Type Codes you can refer to OpenTravel Code List Unique ID Type (UIT).