You are viewing an old version of this content. View the current version.
Compare with Current
View Version History
Version 1
Next »
Reservation Confirmation Response returns information about booking that has been made, its status and reservation IDs.
OTA_HotelResRS*:
*mandatory
Element | Attribute | Type | Description | Min…Max occurs |
|---|
| TransactionIdentifier | | Unique transaction ID generated by GP Travel HUB on initiate stage in order to identify the booking request. | 0...1 |
Success | | | | |
Warnings/Warning | | | | |
HotelReservations* | | | Unites all the separate room reservations in one basket. | 1...1 |
ResStatus* | string ("Reserved", "Waitlisted", "Request denied") | Mandatory only for multibooking reservation. Reservation status that can be one of: "Reserved" - means that booking was successfully confirmed. "Waitlisted" - means that booking is waiting for confirmation. In this case you need to send Booking Retrieval request to get an actual state of booking. "Request denied" - means that supplier rejected booking. | 1...1 |
HotelReservations/ HotelReservation | | | In successful response, element represents booking information. | 1...* |
HotelReservations/Total | | | | |
HotelReservations/ HotelReservationIDs/ HotelReservationID | | | | |
OTA_HotelResRS/HotelReservations/HotelReservation*:
Element | Attribute | Type | Description | Min…Max occurs |
|---|
| ResStatus* | string ("Reserved", "Waitlisted", "Request denied") | Reservation status that can be one of: "Reserved" - means that booking was successfully confirmed. "Waitlisted" - means that booking is waiting for confirmation. In this case you need to send Booking Retrieval request to get an actual state of booking. "Request denied" - means that supplier rejected booking. | 1...1 |
RoomStays/RoomStay* | | | Room description that correspond to requested rooms. | 1...1 |
ResGuests/ResGuest* | | | Represents guest details. Guest data should be specified for each room reservation. | 1...* |
ResGlobalInfo* | | | Contains global details regarding the reservation (of a single reservation in reservation basket). | 1...1 |
TPA_Extensions/ VoucherProperties/ Property | | | Contains additional information (e.g. messages and data that should be included into voucher according suppliers requirements) | 0...* |
Name* | string | A name of special property which should be shown to customer. The list please of possible names varies between suppliers. Please get in touch with our team for more information. | 1...1 |
Value* | string | A special text which should be shown to customer. | 1...1 |
OTA_HotelResRS/HotelReservations/HotelReservation/RoomStays/RoomStay*:
Element | Attribute | Type | Description | Min…Max occurs |
|---|
RoomTypes/RoomType* | | | A collection of Room Types associated with a particular Room Stay. | 1...1 |
RatePlans/RatePlan* | | | A collection of Rate Plans associated with a particular Room Stay. | 1...1 |
RoomRates/RoomRate* | | | Contains room offer description including availability, room type, meal type, discount and price. | 1...* |
TimeSpan* | | | | |
CancelPenalties/CancelPenalty | | | Describes penalties on booking cancellation. | 0...* |
Total* | | | The total price of the offer (after discount, if any has been applied). | 1...1 |
TotalRetail | | | Retail price recommended by supplier (if applicable). | 0...1 |
BasicPropertyInfo* | | | Provide basic hotel information. | 1...1 |
OTA_HotelResRS/HotelReservations/HotelReservation/ResGlobalInfo*:
Element | Attribute | Type | Description | Min…Max occurs |
|---|
Comments/Comment/ Text | | string | Any free-text comments to be sent to supplier in your booking (e.g. you can request to hold an option for the room, or ask rooms with sea-view, etc.). Comments will be passed to supplier, but it is not guaranteed that they will be satisfied. | 0...* |
HotelReservationIDs/ HotelReservationID* | | | Contains unique identifier of a booking. | 1...10 |
ResID_Source* | string ("client", "agent") | Allows to pass client (agent) booking reference that is generated by application connecting to GP Travel HUB for identification of each booking. | 1...1 |
ResID_Value* | string | A value of booking reference that is generated by client application. It is supposed that this ID will be unique in your system. Can be used for further operations like cancellation, modification or booking retrieval. | 1...1 |
ResID_SourceContext | string ("supplier") | Сontains the supplier's name. | 0...1 |
Reservation Confirmation Response Sample XML - 2 adult 1 child
<OTA_HotelResRS Version="2.00" TransactionIdentifier="12232" EchoToken="tok1" xmlns:ota="http://www.opentravel.org/OTA/2003/05">
<Success/>
<HotelReservations>
<HotelReservation ResStatus="Reserved">
<RoomStays>
<RoomStay>
<RoomTypes>
<RoomType RoomTypeCode="2,3" SupplierRoomTypeCode="2" SupplierRoomCategoryCode="3">
<RoomDescription Name="Double">
<Text>Double sea view</Text>
</RoomDescription>
</RoomType>
</RoomTypes>
<RatePlans>
<RatePlan RatePlanCode="AB,1" SupplierRatePlanCode="AB" SupplierContractCode="1">
<MealsIncluded Breakfast="true" Dinner="false" Lunch="false" MealPlanCodes="3"/>
<AdditionalDetails>
<AdditionalDetail Code="AB" Type="15">
<DetailDescription Language="en">
<Text>Continental Breakfast</Text>
</DetailDescription>
</AdditionalDetail>
</AdditionalDetails>
</RatePlan>
</RatePlans>
<RoomRates>
<RoomRate InvBlockCode="1" RatePlanCode="AB,1" RoomTypeCode="2,3" NumberOfUnits="1" Blind="false">
<Rates>
<Rate AgeQualifyingCode="10" RateSource="Hotel">
<Total AmountAfterTax="300.00" CurrencyCode="EUR"/>
<TotalRetail AmountAfterTax="320.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
</Rate>
<Rate AgeQualifyingCode="10" RateSource="Hotel">
<Total AmountAfterTax="300.00" CurrencyCode="EUR"/>
<TotalRetail AmountAfterTax="320.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
</Rate>
<Rate AgeQualifyingCode="8" RateSource="Hotel">
<Total AmountAfterTax="60.00" CurrencyCode="EUR"/>
<TotalRetail AmountAfterTax="60.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
</Rate>
</Rates>
<RoomRateDescription Name="GRAll">
<Text>This hotel only late check-in.</Text>
</RoomRateDescription>
<Discount AmountAfterTax="90.00" CurrencyCode="EUR">
<DiscountReason>
<Text>Special offer</Text>
</DiscountReason>
</Discount>
<Services>
<Service ServiceRPH="1000136" IsPerRoom="true" Inclusive="true" SpecialServiceType="Meal">
<Price>
<Base CurrencyCode="EUR" AmountAfterTax="70.00"/>
</Price>
<ServiceDetails ShortName="Continental Breakfast">
<ServiceDescription>
<Text>Continental Breakfast</Text>
</ServiceDescription>
</ServiceDetails>
</Service>
</Services>
<Total AmountAfterTax="660.00" CurrencyCode="EUR"/>
<TotalRetail AmountAfterTax="700.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
</RoomRate>
</RoomRates>
<TimeSpan Start="2009-10-20" End="2009-10-25"/>
<CancelPenalties>
<CancelPenalty End="2009-10-20T00:00:00+02:00" Start="2009-10-17T00:00:00+02:00">
<AmountPercent Amount="199.00" CurrencyCode="EUR"/>
</CancelPenalty>
</CancelPenalties>
<Total AmountAfterTax="660.00" CurrencyCode="EUR" CommissionAmount="60.00"/>
<TotalRetail AmountAfterTax="700.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
<BasicPropertyInfo HotelCityCode="LON" HotelCode="157292" HotelCodeContext="supplierCode" HotelName="Pullman Skipper">
<Award Provider="Hotel" Rating="4"/>
<RelativePosition Name="CityCenter" Nearest="true"/>
</BasicPropertyInfo>
</RoomStay>
</RoomStays>
<ResGuests>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="1" Type="1"/>
<Profile>
<Customer>
<PersonName>
<NamePrefix>Mr</NamePrefix>
<GivenName>Oleg</GivenName>
<Surname>Ivanov</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="2" Type="1"/>
<Profile>
<Customer>
<PersonName>
<NamePrefix>Mrs</NamePrefix>
<GivenName>Olga</GivenName>
<Surname>Ivanova</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="8" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="3" Type="1"/>
<Profile>
<Customer BirthDate="2007-07-18">
<PersonName>
<NamePrefix>Mr</NamePrefix>
<GivenName>Alexey</GivenName>
<Surname>Ivanov</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<Comments>
<Comment>
<Text>non-smoking room requested;king bed</Text>
</Comment>
</Comments>
<DepositPayments>
<GuaranteePayment Type="AcceptedPaymentForms">
<AcceptedPayments>
<AcceptedPayment CostCenterID="Kuoni"/>
</AcceptedPayments>
</GuaranteePayment>
</DepositPayments>
<HotelReservationIDs>
<HotelReservationID ResID_Source="agent" ResID_Value="66589"/>
<HotelReservationID ResID_Source="client" ResID_Value="264888"/>
<HotelReservationID ResID_Source="supplier" ResID_Value="LL7F090498" ResID_SourceContext="supplierCode"/>
</HotelReservationIDs>
</ResGlobalInfo>
<TPA_Extensions>
<VoucherProperties>
<Property Name="vat" Value="324KG327I"/>
<Property Name="notes" Value="Please call to reception the day before arrival to confirm your reservation."/>
</VoucherProperties>
</TPA_Extensions>
</HotelReservation>
</HotelReservations>
</OTA_HotelResRS>
Multibooking Reservation Confirmation Request Sample XML - 1 room: 2 adult 1 child; 2 room: 2 adults 2 children
<OTA_HotelResRS EchoToken="tok1" Version="2.0" xmlns="http://www.opentravel.org/OTA/2003/05">
<Success/>
<HotelReservations ResStatus="Reserved">
<HotelReservation ResStatus="Reserved">
<RoomStays>
<RoomStay>
<RoomTypes>
<RoomType RoomTypeCode="12530768-1" SupplierRoomCategoryCode="19-1" SupplierRoomTypeCode="5140022">
<RoomDescription Name="Suite| 2 Bedroom Suite + Breakfast Flex| One Bed Requested">
<Text>Suite| 2 Bedroom Suite + Breakfast Flex| One Bed Requested</Text>
</RoomDescription>
</RoomType>
</RoomTypes>
<RatePlans>
<RatePlan RatePlanCode="4-0">
<RatePlanDescription>
<Text>Breakfast Buffet</Text>
</RatePlanDescription>
<MealsIncluded Breakfast="true" Dinner="false" Lunch="false" MealPlanCodes="4"/>
</RatePlan>
</RatePlans>
<RoomRates>
<RoomRate InvBlockCode="1" NumberOfUnits="1" RatePlanCode="4-0" RoomTypeCode="12530768-1">
<Rates>
<Rate AgeQualifyingCode="10" RateSource="Calculated">
<Total AmountAfterTax="1638.00" CurrencyCode="GBP"/>
</Rate>
<Rate AgeQualifyingCode="10" RateSource="Calculated">
<Total AmountAfterTax="1638.00" CurrencyCode="GBP"/>
</Rate>
<Rate AgeQualifyingCode="8" RateSource="Calculated">
<Total AmountAfterTax="0.00" CurrencyCode="GBP"/>
</Rate>
</Rates>
<Total AmountAfterTax="3276.00" AmountBeforeTax="2730.00" CurrencyCode="GBP">
<Taxes>
<Tax Amount="546.00" Code="17" CurrencyCode="GBP"/>
</Taxes>
</Total>
</RoomRate>
</RoomRates>
<TimeSpan End="2018-10-25" Start="2018-10-20"/>
<CancelPenalties>
<CancelPenalty End="2018-10-20T15:00:00+01:00" Start="2018-10-18T15:00:00+01:00">
<AmountPercent Amount="655.20" CurrencyCode="GBP" NmbrOfNights="1"/>
</CancelPenalty>
<CancelPenalty End="2018-10-25T00:00:00+01:00" PolicyCode="NoShow" Start="2018-10-20T15:00:00+01:00">
<AmountPercent Amount="655.20" CurrencyCode="GBP" NmbrOfNights="1"/>
</CancelPenalty>
</CancelPenalties>
<Total AmountAfterTax="3276.00" AmountBeforeTax="2730.00" CurrencyCode="GBP">
<Taxes>
<Tax Amount="546.00" Code="17" CurrencyCode="GBP"/>
</Taxes>
</Total>
<BasicPropertyInfo HotelCityCode="5981" HotelCode="1232470" HotelCodeContext="supplierCode" HotelDistrictCode="16194" HotelDistrictName="Westminster" HotelName="Taj 51 Buckingham Gate - Demo">
<CategoryCodes>
<HotelCategory Code="5" CodeDetail="5" GroupCode="Category"/>
<HotelCategory Code="20" CodeDetail="Hotel" GroupCode="Type"/>
</CategoryCodes>
<Award Provider="Hotel" Rating="5"/>
</BasicPropertyInfo>
</RoomStay>
</RoomStays>
<ResGuests>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="1" Type="1"/>
<Profile>
<Customer>
<PersonName>
<NamePrefix>Mr.</NamePrefix>
<GivenName>Alexey</GivenName>
<Surname>Feofanov</Surname>
</PersonName>
<CitizenCountryName Code="RU"/>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="2" Type="1"/>
<Profile>
<Customer>
<PersonName>
<NamePrefix>Mr.</NamePrefix>
<GivenName>Ivan</GivenName>
<Surname>Feofanov</Surname>
</PersonName>
<CitizenCountryName Code="RU"/>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="8" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="3" Type="1"/>
<Profile>
<Customer BirthDate="2016-05-14">
<PersonName>
<NamePrefix>Mr.</NamePrefix>
<GivenName>Ivan</GivenName>
<Surname>Feofanov</Surname>
</PersonName>
<CitizenCountryName Code="RU"/>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<DepositPayments>
<GuaranteePayment Type="AcceptedPaymentForms">
<AcceptedPayments>
<AcceptedPayment CostCenterID="GBP"/>
</AcceptedPayments>
</GuaranteePayment>
</DepositPayments>
<HotelReservationIDs>
<HotelReservationID ResID_Source="client" ResID_Value="tour001"/>
<HotelReservationID ResID_Source="agent" ResID_Value="tour001"/>
<HotelReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="162242738"/>
</HotelReservationIDs>
</ResGlobalInfo>
<TPA_Extensions>
<VoucherProperties>
<Property Name="ReservationId" Value="163708282"/>
<Property Name="Latitude" Value="51.498548"/>
<Property Name="Longitude" Value="-0.137168"/>
<Property Name="Check-in" Value="15:00:00"/>
<Property Name="Check-out" Value="11:00:00"/>
</VoucherProperties>
</TPA_Extensions>
</HotelReservation>
<HotelReservation ResStatus="Reserved">
<RoomStays>
<RoomStay>
<RoomTypes>
<RoomType RoomTypeCode="12530768-1" SupplierRoomCategoryCode="19-1" SupplierRoomTypeCode="5140022">
<RoomDescription Name="Suite| 2 Bedroom Suite + Breakfast Flex| One Bed Requested">
<Text>Suite| 2 Bedroom Suite + Breakfast Flex| One Bed Requested</Text>
</RoomDescription>
</RoomType>
</RoomTypes>
<RatePlans>
<RatePlan RatePlanCode="4-0">
<RatePlanDescription>
<Text>Breakfast Buffet</Text>
</RatePlanDescription>
<MealsIncluded Breakfast="true" Dinner="false" Lunch="false" MealPlanCodes="4"/>
</RatePlan>
</RatePlans>
<RoomRates>
<RoomRate InvBlockCode="2" NumberOfUnits="1" RatePlanCode="4-0" RoomTypeCode="12530768-1">
<Rates>
<Rate AgeQualifyingCode="10" RateSource="Calculated">
<Total AmountAfterTax="1638.00" CurrencyCode="GBP"/>
</Rate>
<Rate AgeQualifyingCode="10" RateSource="Calculated">
<Total AmountAfterTax="1638.00" CurrencyCode="GBP"/>
</Rate>
<Rate AgeQualifyingCode="8" RateSource="Calculated">
<Total AmountAfterTax="0.00" CurrencyCode="GBP"/>
</Rate>
<Rate AgeQualifyingCode="8" RateSource="Calculated">
<Total AmountAfterTax="0.00" CurrencyCode="GBP"/>
</Rate>
</Rates>
<Total AmountAfterTax="3276.00" AmountBeforeTax="2730.00" CurrencyCode="GBP">
<Taxes>
<Tax Amount="546.00" Code="17" CurrencyCode="GBP"/>
</Taxes>
</Total>
</RoomRate>
</RoomRates>
<TimeSpan End="2018-10-25" Start="2018-10-20"/>
<CancelPenalties>
<CancelPenalty End="2018-10-20T15:00:00+01:00" Start="2018-10-18T15:00:00+01:00">
<AmountPercent Amount="655.20" CurrencyCode="GBP" NmbrOfNights="1"/>
</CancelPenalty>
<CancelPenalty End="2018-10-25T00:00:00+01:00" PolicyCode="NoShow" Start="2018-10-20T15:00:00+01:00">
<AmountPercent Amount="655.20" CurrencyCode="GBP" NmbrOfNights="1"/>
</CancelPenalty>
</CancelPenalties>
<Total AmountAfterTax="3276.00" AmountBeforeTax="2730.00" CurrencyCode="GBP">
<Taxes>
<Tax Amount="546.00" Code="17" CurrencyCode="GBP"/>
</Taxes>
</Total>
<BasicPropertyInfo HotelCityCode="5981" HotelCode="1232470" HotelCodeContext="supplierCode" HotelDistrictCode="16194" HotelDistrictName="Westminster" HotelName="Taj 51 Buckingham Gate - Demo">
<CategoryCodes>
<HotelCategory Code="5" CodeDetail="5" GroupCode="Category"/>
<HotelCategory Code="20" CodeDetail="Hotel" GroupCode="Type"/>
</CategoryCodes>
<Award Provider="Hotel" Rating="5"/>
</BasicPropertyInfo>
</RoomStay>
</RoomStays>
<ResGuests>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="2">
<Profiles>
<ProfileInfo>
<UniqueID ID="1" Type="1"/>
<Profile>
<Customer>
<PersonName>
<NamePrefix>Mr</NamePrefix>
<GivenName>Oleg</GivenName>
<Surname>Petrov</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="2">
<Profiles>
<ProfileInfo>
<UniqueID ID="2" Type="1"/>
<Profile>
<Customer>
<PersonName>
<NamePrefix>Mr.</NamePrefix>
<GivenName>Ivan</GivenName>
<Surname>Feofanov</Surname>
</PersonName>
<CitizenCountryName Code="RU"/>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="8" ResGuestRPH="2">
<Profiles>
<ProfileInfo>
<UniqueID ID="3" Type="1"/>
<Profile>
<Customer BirthDate="2015-05-14">
<PersonName>
<NamePrefix>Mrs</NamePrefix>
<GivenName>Olga</GivenName>
<Surname>Petrova</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
<ResGuest AgeQualifyingCode="8" ResGuestRPH="2">
<Profiles>
<ProfileInfo>
<UniqueID ID="4" Type="1"/>
<Profile>
<Customer BirthDate="2012-05-14">
<PersonName>
<NamePrefix>Mrs</NamePrefix>
<GivenName>Olga</GivenName>
<Surname>Petrova</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<DepositPayments>
<GuaranteePayment Type="AcceptedPaymentForms">
<AcceptedPayments>
<AcceptedPayment CostCenterID="GBP"/>
</AcceptedPayments>
</GuaranteePayment>
</DepositPayments>
<HotelReservationIDs>
<HotelReservationID ResID_Source="client" ResID_Value="tour002"/>
<HotelReservationID ResID_Source="agent" ResID_Value="tour002"/>
<HotelReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="162242738"/>
</HotelReservationIDs>
</ResGlobalInfo>
<TPA_Extensions>
<VoucherProperties>
<Property Name="ReservationId" Value="163708283"/>
<Property Name="Latitude" Value="51.498548"/>
<Property Name="Longitude" Value="-0.137168"/>
<Property Name="Check-in" Value="15:00:00"/>
<Property Name="Check-out" Value="11:00:00"/>
</VoucherProperties>
</TPA_Extensions>
</HotelReservation>
<Total AmountAfterTax="6552.00" CurrencyCode="GBP"/>
<HotelReservationIDs>
<HotelReservationID ResID_Source="basket" ResID_Value="tourb001"/>
</HotelReservationIDs>
</HotelReservations>
</OTA_HotelResRS>