ReservationRead

Method Goals

This method aims to retrieve detailed information about a specific Reservation

Request Format

The request requires one of the following data depending on supplier:

  • Locators: booking codes (this element contains two elements Client (client’s booking code) and Provider (supplier’s booking code), one or both will be required depending on the supplier)
  • Currency: the currency code
  • CreationDate: the booking date
  • StardDate: the check-in date
  • EndDate: the check-out date
  • HotelCode: Hotel code

Response Format

The result returns the full details of a booking.

Remarks

180000 millisecond is the maximum amount of time permitted in our system before the connection is closed.

ReservationReadRQ Example

In the request for this call it is necessary to use the object: “HotelBaseRQ”. You can find the information in the section ‘Common elements’.

<ReservationReadRQ>
    <Locators>
        <Client>5356342</Client>
        <Provider>MGNZ12345</Provider>
    </Locators>
    <Currency>EUR</Currency>
    <StartDate>28/01/2014</StartDate>
    <EndDate>29/01/2014</EndDate>
    <CreationDate>17/01/2014</CreationDate>
    <HotelCode>AAA</HotelCode>
    <Holder title = "Miss" name = "Test11" surname = "TestAp11"/>
</ReservationReadRQ>

Important information about Number (Cardinal):

Go to Common-Elements for more information.

ReservationReadRQ Description

Element Number Type Description
ReservationReadRQ 1 Root node.
Locators / 1 Information about the locators (it is mandatory to indicate either client or supplier’s locator).
Locators /Client 0..1 String Client locator.
Locators /Provider 0..1 String Supplier locator.
Currency 1 String Currency code.
StartDate 0..1 String Start date of booking. Format dd/MM/yyyy
EndDate 0..1 String End date of booking. Format dd/MM/yyyy
CreationDate 0..1 String Creation date of booking. Format dd/MM/yyyy
HotelCode 1 String Hotel code.
Holder 0..1 Holder of the booking.
@title 1 String Holder’s title. Possible values: Mr, Mrs, Miss, Ms.
@name 1 Holder’s name.
@surname 1 Holder’s surname.

ReservationReadRS Example

<ReservationReadRS>
    <Locators>
        <Client>2578478</Client>
        <Provider>10TTT31</Provider>
        <Property>HCN8273</Property>
    </Locators>
    <Hotel>
        <Name>LEO</Name>
        <Code>10</Code>
        <CreationDate>17/01/2016</CreationDate>
        <StartDate>28/01/2016</StartDate>
        <EndDate>29/01/2016</EndDate>
        <Holder name = "Test11" surname = "TestAp11"/>
        <Price currency = "EUR" amount = "36.20" binding = "false" commission = "-1"/>
        <Rooms>
            <Room id = "4582" roomCandidateRefId = "1" description = "Standard.."/>
        </Rooms>
        <CancelPenalties nonRefundable = "false">
            <CancelPenalty>
                <HoursBefore>120</HoursBefore>
                <Deadline>2016-01-01T05:00:00Z</Deadline>
                <CalculatedDeadline>false</CalculatedDeadline>
                <Penalty type = "Importe" paymentType = "MerchantPay" currency = "EUR">72.40</Penalty>
            </CancelPenalty>
        </CancelPenalties>
    </Hotel>
    <TransactionStatus>
        <ComunicationStatus>OK</ComunicationStatus>
        <RSStatus>EXISTE</RSStatus>
        <ResStatus>OK</ResStatus>
    </TransactionStatus>
</ReservationReadRS>

ReservationReadRS Description

Element Number Type Description
ReservationReadRS 1 Root node.
Locators / 1 Information about the locators.
Locators /Client 0..1 String Client locator.
Locators /Provider 0..1 String Supplier locator.
Locators /Property 0..1 String Property locator(see Metadata method in order to verify if a supplier implements it).
Hotel / 0..1 Hotel reservation.
Hotel /Code 0..1 String Hotel Code.
Hotel /Name 0..1 String Hotel Name.
Hotel /City 0..1 String Hotel city.
Hotel /CreationDate 0..1 String Date of booking. Format dd/MM/yyyy
Hotel /StartDate 0..1 String Check-in date. Format dd/MM/yyyy
Hotel /EndDate 0..1 String Check out date. Format dd/MM/yyyy
Hotel /MealPlanCode 0..1 String Booking Mealplan code.
Hotel /Holder 0..1 String Reservation Holder .
@name 1 String Holder name.
@surname 1 String Holder surname.
Hotel /Price 1 String Price of the reservation.
@currency 1 String Displays the currency provided by the supplier
@amount 1 Decimal Total amount for the booking.
@binding 1 Boolean Identifies if is the price is binding (When true the sale price returned must not be less than the price informed).
@commission 1 Decimal Commission (-1 = not specified), 0 = net price, X = % of the commission applied to the amount .
Hotel /Rooms 0..1 List of rooms reserved
Hotel /Rooms/Room 1..n Details of room reserved.
@id 0..1 String Identifier of the room.
@roomCandidateRefId 0..1 Integer Identifier of room candidate.
@code 0..1 String Room code.
@description 0..1 String Room description.
Hotel /RoomCandidates / 0..1 Rooms requested at the time of booking.
Hotel /RoomCandidates /RoomCandidate 1..n Room required.
@id 0..1 Integer Id of the requested room (starting at 1).
RoomCandidates /RoomCandidate/Paxes/Pax 1..n Pax required.
@age 0..1 Integer Passenger age on the day of check-in.
@id 0..1 Integer Id of the requested room (starting at 1).
Hotel /CancelPenaltiesCancelPenalties / 0..1 Information of cancellation policies.
@nonRefundable 1 Boolean Indicate if this option is nonRefundable (true or false).
Hotel /CancelPenalties /CancelPenalty 0..n Listing of cancellation penalties.
Hotel /CancelPenalties /CancelPenalty/HoursBefore 1 String Number of hours prior to arrival day in which this Cancellation policy applies.
Hotel /CancelPenalties /CancelPenalty/Deadline 1 String Date on UTC Standard TimeZone in which this Cancellation policy applies (ISO 8601 e.g: 2016-07-01T05:00:00Z)
Hotel /CancelPenalties /CancelPenalty/CalculatedDeadline 1 Boolean Indicate if the Deadline is returned by the supplier or it’s been calculated by TravelGate -> true = has been calculated by XTG / false = bypass of supplier data without calculation
Hotel /CancelPenalties /CancelPenalty/Penalty 1 Contains the value to be applied in net price.
@type 1 String Type of penalty Possible values: “Noches” (nights) , “Porcentaje” (percentage) ,“Importe” (price value).
@paymentType 1 String Indicates payment type.
@currency 1 String Currency code.
Hotel /Remarks 0..1 String Remarks.
TransactionStatus / 1 Trans. Status.
TransactionStatus /ComunicationStatus 1 String Status communication (OFFLINE, OK and KO).
TransactionStatus /RSStatus 1 String Response status - DESCONOCIDO (Unknown), EXISTE (Exists), EXISTECANCELADA (exists but it’s cancelled), NO_EXISTE (Does not exist).
TransactionStatus /ResStatus 1 String Status booking (OK = confirmed, RQ = on request, CN = cancelled, UN = unknown).