Skip to end of banner
Go to start of banner

OTA_HotelResNotifRS

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Response Specification

This message will be returned by pmsXchange in response to the OTA_HotelResNotifRQ message sent by partner PMS publishers. The message will confirms whether the OTA_HotelResNotifRQ message was processed successfully by pmsXchange or not.

Elements and attributes marked with Number=1 or more are mandatory and will always be sent. 0..n means that the element or attribute is optional.

Element

@Attribute

Num

Description / Contents

OTA_HotelResNotifRS 


1

Mandatory
Root element of the message. 


@EchoToken 

As per OpenTravel Alliance Specifications. 


@Version 

1

Version is a mandatory attribute in OTA; therefore, it must remain Mandatory in HTNG in order to be able to use the same message. 


@TimeStamp 

1

Time of the transaction. 


@ResResponseType 

0..1

Given that the OTA_HotelResNotifRQ message is used for additions, modifications and cancellations, this attribute is used to replicate whether the original message was an addition, a modification or a cancellation and does not refer to the status of the transaction itself but rather to the nature of the original message. The only three enumerations allowed will therefore be: Committed, Modified and Cancelled. In this case Committed would be used. 

OTA_HotelResNotifRS / Errors / Error 


1..99 

Mandatory ONLY if Success element is not sent. Only needed if RQ message was unsuccessful. 


@Type 

1

Mandatory in OTA. Refers to OpenTravel Alliance EWT list (error warning type). 


@Code 

0..1 

Refers to OpenTravel Alliance list ERR. Should be used wherever possible. 


@RecordID 

0..1 

If the receiving system is able to identify within a batch of reservations which reservation failed, the uniqueID of the rejected reservation should be reported here. 

OTA_HotelResNotifRS / Success 


1

Mandatory if no Errors were sent. This is the annotation that the reservation batch was received successfully. It could be combined with warning messages if some of the reservations in the batch had issues. 

OTA_HotelResNotifRS / Warnings / Warning 


0..99 

Can be used in conjunction with Success message. 


@Type 

1

Refers to OpenTravel Alliance EWT list (error warning type). 


@Code 

0..1 

Refers to OpenTravel Alliance list ERR. Should be used wherever possible. 


@RecordID 

0..1 

If the receiving system is able to identify within a batch of reservations which reservation has a warning, the uniqueID of that reservation should be reported here. 

OTA_HotelResNotifRS / HotelReservations / HotelReservation 


1

Mandatory
Must be sent for the message to have a meaning. 


@ResStatus 

0..1

Indicates the current status of the reservation.
Valid values are dependant on the roles:
Reserved
Waitlisted
In-house
Checked-Out 

OTA_HotelResNotifRS / HotelReservations / HotelReservation / UniqueID 


1

Mandatory
This is the confirmation number for the reservation assigned by the immediate originator of the booking (i.e., the system that sent the OTA_HotelResNotifRQ message for which the OTA_HotelresNotifRS message is sent). 


@Type 

0..1

Type is assigned values from the UIT code list. If the original system was a CRS:
Type = 14 – Reservation
ID is the actual confirmation number
If it was a PMS: Type = 10 - Hotel 

@ID 

1

ID is the CRS confirmation number (or PMS number if the reservation was originated in the PMS). 


Response Samples

Success

<OTA_HotelResNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="879791900" TimeStamp="2014-01-26T19:31:02-05:00" Version="1.001" ResResponseType="Modified">
   <Success/>
   <HotelReservations>
      <HotelReservation>
         <UniqueID Type="14" ID="3741"/>
      </HotelReservation>
   </HotelReservations>
</OTA_HotelResNotifRS>

Failure

<OTA_HotelResNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="879791900" TimeStamp="2014-01-26T19:31:02-05:00" Version="1.001" ResResponseType="Modified">
   <Errors>
      <Error Type="5">Authentication timed out</Error>
   </Errors>
</OTA_HotelResNotifRS>

  • No labels