Modification Initiate Request is sent before actual modification to check possibility of making changes and get final price that user will have to pay after modification. This is not real modification yet, but just a quote.
Depending on booking details you want to change, you should provide the appropriate element in modification request.
OTA_HotelResModifyRQ*:
*mandatory
OTA_HotelResModifyRQ/HotelResModifies/HotelResModify*:
Element | Attribute | Type | Description | Min…Max occurs |
|---|
RoomStays/ RoomStay/ RoomRates/ RoomRate* | | | Describes the offer to modify. | 1...* |
InvBlockCode* | integer (default - 1) | A room identifier, should be the same as in Reservation Initiate request. | 1...1 |
NumberOfUnits* | integer (1) | Always has fixed value =1. | 1...1 |
RoomStays/RoomStay/TimeSpan | | | Should be specified only if you want to change dates of stay. | 0...1 |
ResGuests/ResGuest | | | For more information see Common Data Description section in Glossary. | 0...* |
ResGlobalInfo/ Comments/ Comment/ Text | | | For more information see Reservation Initiate Request section. | 1...10 |
ResGlobalInfo/ HotelReservationIDs/ HotelReservationID* | | | Contains unique identifier of a booking. | 1...2 |
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 in Reservation Initiate Request. | 1...1 |
Modification Initiate Request Sample XML
<OTA_HotelResModifyRQ ResStatus="Initiate" EchoToken="EchoToken" PrimaryLangID="en" Version="2">
<POS>
<Source>
<RequestorID ID="client" MessagePassword="pwd" Type="22"/>
<BookingChannel Type="7" PriceDomain="1"/>
</Source>
</POS>
<HotelResModifies>
<HotelResModify>
<RoomStays>
<RoomStay>
<RoomRates>
<RoomRate InvBlockCode="1" NumberOfUnits="1"/>
</RoomRates>
<TimeSpan Start="2020-10-18" End="2020-10-23"/>
</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>Ivanov</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="client" ResID_Value="264888"/>
</HotelReservationIDs>
</ResGlobalInfo>
</HotelResModify>
</HotelResModifies>
</OTA_HotelResModifyRQ>
Multibooking Modification Initiate Request Sample XML
<OTA_HotelResModifyRQ ResStatus="Initiate" EchoToken="EchoToken" Version="2" xmlns="http://www.opentravel.org/OTA/2003/05">
<POS>
<Source>
<RequestorID ID="client" MessagePassword="pwd" Type="22"/>
<BookingChannel Type="7"/>
</Source>
</POS>
<HotelResModifies>
<HotelResModify>
<RoomStays>
<RoomStay>
<RoomRates>
<RoomRate InvBlockCode="1" NumberOfUnits="1"/>
</RoomRates>
</RoomStay>
</RoomStays>
<ResGuests>
<ResGuest AgeQualifyingCode="10" ResGuestRPH="1">
<Profiles>
<ProfileInfo>
<UniqueID ID="1" Type="1"/>
<Profile>
<Customer BirthDate="1980-07-18">
<PersonName>
<NamePrefix>Mr</NamePrefix>
<GivenName>Max</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>Maria</GivenName>
<Surname>Ivanova</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<Comments>
<Comment>
<Text>non smoking room</Text>
</Comment>
</Comments>
<HotelReservationIDs>
<HotelReservationID ResID_Source="client" ResID_Value="qwerty251"/>
</HotelReservationIDs>
</ResGlobalInfo>
</HotelResModify>
<HotelResModify>
<RoomStays>
<RoomStay>
<RoomRates>
<RoomRate InvBlockCode="2" NumberOfUnits="1"/>
</RoomRates>
</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>Ivanov</Surname>
</PersonName>
</Customer>
</Profile>
</ProfileInfo>
</Profiles>
</ResGuest>
</ResGuests>
<ResGlobalInfo>
<HotelReservationIDs>
<HotelReservationID ResID_Source="client" ResID_Value="qwerty252"/>
</HotelReservationIDs>
</ResGlobalInfo>
</HotelResModify>
<HotelReservationIDs>
<HotelReservationID ResID_Source="basket" ResID_Value="basket1"/>
</HotelReservationIDs>
</HotelResModifies>
</OTA_HotelResModifyRQ>