Modification Initiate Response contains information about changes that supposed to be done. Also, here is important information about room availability, new price, and possible charges.
There could be additional fees applied for booking modification, as well as cancellation fees (in case the stay date was shifted and cancellation policies applied). Modification fee’s amount is not returned in Response explicitly. In case of Booking Modification you can calculate the modification fee (if needed) as:
Modification Fee = RoomStay/Total/@Amount - RoomRates/RoomRate/Rates/Total/@Amount.
| Expand |
|---|
That means that RoomRates/RoomRate/Rates/Total/@Amount should always have the same value after cancellation and modification. This value is the total price of the booking that we received after ResCommit.
But RoomStay/Total/@Amount should be the current total price for the booking.
If modification is made - this price should be the latest price for modification
If cancellation is made - this price should be the price for cancellation |
OTA_HotelResModifyRS*:
*mandatory
Element | Attribute | Type | Description | Min…Max occurs |
|---|
| TransactionIdentifier | string | Unique transaction ID generated by GP Travel HUB. This attribute must be further passed on Ignore or Confirmation step to identify the modification request. | 0...1 |
Success | | | For more information see Common Data Description section in Glossary. | |
Warnings/Warning | | | |
HotelResModifies* | | | Describes the modification. | 1...1 |
ResStatus* | string ("Reserved", "Request denied", "Requested") | Mandatory only for multi-room booking. In other cases is not shown. Reservation status that can be one of: "Reserved" - means that modification was successfully requested. "Request denied" - means that supplier denied this modification. "Requested" - means that GP Travel HUB has done best effort to ensure that accommodation can be modified, however, this status doesn't guarantee, that accommodation will be modified. This status usually denotes, that supplier doesn't support two-pass modification. | Info |
|---|
Important note: in Multibooking the status of the whole reservation (basket) is defined according to the status of sub-reservations and is calculated by the following priority: 1. If any of HotelReservation has ResStatus Request denied=> ResStatus of the whole booking is Request denied. 2. If any of HotelReservation has ResStatus Requested=> ResStatus of the whole booking is Requested. 3. If any of HotelReservation has ResStatus Reserved=> ResStatus of the whole booking is Reserved. |
| 1...1 |
HotelResModifies/ HotelResModify* | | | In successful response element represents booking information. | 1...* |
HotelResModifies/Total | | | For more information see Reservation Initiate Response section. | 0...1 |
HotelResModifies/ HotelReservationIDs/ HotelReservationID | | | For more information see Reservation Initiate Response section. | 0...1 |
OTA_HotelResModifyRS/HotelResModifies/HotelResModify*:
Element | Attribute | Type | Description | Min…Max occurs |
|---|
| ResStatus | string ("Reserved", "Request denied", "Requested") | Reservation status that can be one of: "Reserved" - means that modification was successfully requested. "Request denied" - means that supplier denied this modification. "Requested" - means that GP Travel HUB has done best effort to ensure that accommodation can be modified, however, this status doesn't guarantee, that accommodation will be modified. This status usually denotes, that supplier doesn't support two-pass modification. | Info |
|---|
Important note: in Multibooking the status of the whole reservation (basket) is defined according to the status of sub-reservations and is calculated by the following priority: If any of HotelReservation has ResStatus Request denied=> ResStatus of the whole booking is Request denied. If any of HotelReservation has ResStatus Requested=> ResStatus of the whole booking is Requested. If any of HotelReservation has ResStatus Reserved=> ResStatus of the whole booking is Reserved.
|
| 0...1 |
RoomStays/RoomStay* | | | Description that correspond to the modified room. | 1...1 |
ResGuests/ResGuest* | | | For more information see Common Data Description section in Glossary. | 1...* |
ResGlobalInfo* | | | For more information see Reservation Confirmation Response section. | 1...1 |
| Expand |
|---|
| title | Modification Initiate Response Sample XML - Change date of booking |
|---|
|
| Code Block |
|---|
| <OTA_HotelResModifyRS Version="2" TransactionIdentifier="12232" EchoToken="EchoToken" xmlns:ota="http://www.opentravel.org/OTA/2003/05">
<Success/>
<HotelResModifies>
<HotelResModify ResStatus="Requested">
<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>American Breakfast</Text>
</DetailDescription>
</AdditionalDetail>
</AdditionalDetails>
</RatePlan>
</RatePlans>
<RoomRates>
<RoomRate InvBlockCode="1" AvailabilityStatus="AvailableForSale" NumberOfUnits="1" RatePlanCode="AB,1" RoomTypeCode="2,3" RatePlanCategory="PackageOnly">
<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>
<Total AmountAfterTax="660.00" CurrencyCode="EUR"/>
<TotalRetail AmountAfterTax="700.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
</RoomRate>
</RoomRates>
<TimeSpan Start="2020-09-18" End="2020-09-23"/>
<CancelPenalties>
<CancelPenalty End="2020-10-20T00:00:00+02:00" Start="2020-10-17T00:00:00+02:00">
<AmountPercent Amount="199.00" CurrencyCode="EUR"/>
</CancelPenalty>
</CancelPenalties>
<Total AmountAfterTax="660.00" CurrencyCode="EUR"/>
<TotalRetail AmountAfterTax="700.00" CurrencyCode="EUR" IsMin="true" IsMax="true"/>
<BasicPropertyInfo HotelCityCode="LON" HotelCode="157292" HotelCodeContext="supplierCode" HotelName="Pullman Skipper" ChainCode="PLMN" ChainName="Pullman" BrandCode="ACR" BrandName="ACCOR">
<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="2014-07-18">
<PersonName>
<NamePrefix>Mr</NamePrefix>
<GivenName>Alexey</GivenName>
<Surname>Ivanovs</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<Comments>
<Comment>
<Text>non-smoking room requested;king bed</Text>
</Comment>
</Comments>
<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>
</HotelResModify>
</HotelResModifies>
</OTA_HotelResModifyRS> |
|
...