Multiple Reservations - Confirm Success

Owned by Mike Rogers
Last updated: 03, Oct 2012 by Malin Atkins (Unlicensed)Version comment
3 min read

PMS request 2 new reservations and confirm that both were processed successfully

  1. PMS sends OTA_ReadRQ message to PmsXchange requesting undelivered reservations. 
  2. PmsXchange responds with OTA_ResRetrieveRS containing 2 new reservations.
    • PMS successfully processes both retrieved reservations.
  3. PMS sends OTA_NotifReportRQ confirming that the 2 reservations were successfully processed.
  4. PmsXchange returns one OTA_NotifReportRS in reply.

1) OTA_ReadRQ

PMS requests undelivered reservations from PmsXchange

<OTA_ReadRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="echo-abc123">
   <ReadRequests>
    <HotelReadRequest HotelCode="ABC">
      <SelectionCriteria SelectionType="Undelivered" ResStatus="Book"/>
    </HotelReadRequest>
  </ReadRequests>
</OTA_ReadRQ>

2) OTA_ResRetrieveRS

PmsXchange returns 2 new reservations.

In the example below:

  • There are 2 HotelReservation entries in the ReservationsList. For each reservation the first UniqueID element shows the unique identifier for the entire reservation (WTF-123456 and WTF-123457). This identifier will identify the reservation through any subsequent modifications or cancellations.
  • The second UniqueID element with ID_Context='MESSAGE_UNIQUE_ID' is the unique id for this message (3102411 and 3102432). This identifier should be used to confirm the message once processed
  • The attribute HotelReservationID/@ResID_Value holds the original reservation id from the original booking channel source (123456 and 123457)
<OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="echo-abc123">
  <Success/>
  <ReservationsList>

    <HotelReservation CreateDateTime="2010-01-01T12:00:00" ResStatus="Book">
      <UniqueID Type="14" ID="WTF-123456"/>
      <UniqueID Type="16" ID="3102411" ID_Context="MESSAGE_UNIQUE_ID"/>
      <!-- RESERVATION DETAIL OMITTED -->
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="123456"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>

    <HotelReservation CreateDateTime="2010-01-01T12:00:00" ResStatus="Book">
      <UniqueID Type="14" ID="WTF-123457"/>
      <UniqueID Type="16" ID="3102432" ID_Context="MESSAGE_UNIQUE_ID"/>
      <!-- RESERVATION DETAIL OMITTED -->
      <ResGlobalInfo>
        <HotelReservationIDs>
          <HotelReservationID ResID_Type="14" ResID_Value="123457"/>
        </HotelReservationIDs>
      </ResGlobalInfo>
    </HotelReservation>

  </ReservationsList>
</OTA_ResRetrieveRS>

3) OTA_NotifReportRQ

PMS confirms that both message "3102411" and "3102432" were successfully processed and and were assigned a PMS reservation ids of "PMS-1234567" and "PMS-1234568" respectively.

<OTA_NotifReportRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="echo-abc123">
  <Success/>
  <NotifDetails>
    <HotelNotifReport>
      <HotelReservations>

        <HotelReservation CreateDateTime="2010-01-01T12:00:00" ResStatus="Book">
          <UniqueID Type="16" ID="3102411"/>
          <ResGlobalInfo>
            <HotelReservationIDs>
              <HotelReservationID ResID_Type="14" ResID_Value="PMS-1234567"/>
            </HotelReservationIDs>
          </ResGlobalInfo>
        </HotelReservation>

        <HotelReservation CreateDateTime="2010-01-01T12:00:00" ResStatus="Book">
          <UniqueID Type="16" ID="3102432"/>
          <ResGlobalInfo>
            <HotelReservationIDs>
              <HotelReservationID ResID_Type="14" ResID_Value="PMS-1234568"/>
            </HotelReservationIDs>
          </ResGlobalInfo>
        </HotelReservation>

      </HotelReservations>
    </HotelNotifReport>
  </NotifDetails>
</OTA_NotifReportRQ>

4) OTA_NotifReportRS

PmsXchange indicates that the processing confirmation has been acknowledged.

<OTA_NotifReportRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="echo-abc123">
  <Success/>
</OTA_NotifReportRS>