Single Reservation - Confirm Error

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

PMS request and confirm that a single reservation was NOT processed successfully

  1. PMS sends OTA_ReadRQ message to PmsXchange requesting undelivered reservations.
  2. PmsXchange responds with OTA_ResRetrieveRS containing a single new reservation.
    • PMS fail to process the retrieved reservation
  3. PMS sends OTA_NotifReportRQ confirming the reservation was NOT successfully processed
  4. PmsXchange returns an 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 one reservation. A new reservation is indicated by the ResStatus attribute value being set to "Book".

In the example below:

  • The first UniqueID element shows the unique identifier for the entire reservation (WTF-123456). This identifier will identify the reservation through any subsequent modifications or cancellations. Each HotelReservation message for a reservation will have a unique message identifier.
  • The second UniqueID element with ID_Context='MESSAGE_UNIQUE_ID' is the unique id for this message (3102411). 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)
<OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1" 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>
  </ReservationsList>
</OTA_ResRetrieveRS>

3) OTA_NotifReportRQ

PMS confirms that message "3102411" failed to process. There is no PMS reservation id returned if the PMS was unable to store the reservation.

<OTA_NotifReportRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="2005-08-01T09:30:47+08:00" EchoToken="echo-abc123">
  <Errors>
    <Error Type="3" Code="402">Invalid room type</Error>
  </Errors>
  <NotifDetails>
    <HotelNotifReport>
      <HotelReservations>
        <HotelReservation CreateDateTime="2010-11-18T16:52:00" ResStatus="Book">
          <UniqueID Type="16" ID="3102411"/>
        </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>