Versions Compared

Key

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

PMS

...

request and confirm that a single

...

reservation

...

was processed successfully

...

  1. PMS sends OTA_ReadRQ message to PmsXchange requesting undelivered reservations.
  2. PmsXchange responds with OTA_ResRetrieveRS containing a single new reservation.
  3. PMS successfully processes the retrieved reservation
  4. PMS sends OTA_NotifReportRQ confirming the reservation was successfully processed
  5. PmsXchange returns an OTA_NotifReportRS in reply

 

...

1

...

) OTA_ReadRQ

 

PMS requests undelivered reservations from PmsXchange

Code Block
xml
xml

<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 attribute UniqueID/@ID

  • 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)
Code Block
xml
xml

<OTA_ResRetrieveRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" TimeStamp="20102005-0108-01T12:0001T09:32:47+08:00.0Z" 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>

Exchange 2

3) OTA_NotifReportRQ

PMS confirms that reservation WTF-123456 message '3102411' was successfully processed and has been assigned a PMS reservation PMS reservation id of "PMS-1234567".

Code Block
xml
xml

<OTA_NotifReportRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" EchoToken="echo">
  <Success/>
  <NotifDetails>
    <HotelNotifReport>
      <HotelReservations>
        <HotelReservation CreateDateTime="2010-01-01T12:00:00" ResStatus="Book">
          <UniqueID Type="1416" ID="WTF-1234563102411"/>
          <ResGlobalInfo>
            <HotelReservationIDs>
              <HotelReservationID ResID_Type="14" ResID_Value="PMS-1234567"/>
            </HotelReservationIDs>
          </ResGlobalInfo>
        </HotelReservation>
      </HotelReservations>
    </HotelNotifReport>
  </NotifDetails>
</OTA_NotifReportRQ>

4) OTA_NotifReportRS

PmsXchange indicates that the processing confirmation has been acknowledged.

Code Block
xml
xml

<OTA_NotifReportRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.0" EchoToken="echo">
  <Success/>
</OTA_NotifReportRS>