Skip to end of metadata
Go to start of metadata

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

Compare with Current View Version History

« Previous Version 4 Next »

Modification Confirmation Response contains information about booking with new modified data.

OTA_HotelResModifyRS*:

*mandatory

Element

Attribute

Type

Description

Min…Max occurs

TransactionIdentifier

Unique transaction ID generated by GP Travel HUB on Modification Initiate step in order to identify the booking 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", "Waitlisted", "Request denied")

Mandatory only for multi-room booking. In other cases is not shown. Reservation status that can be one of:

"Reserved" - means that booking was successfully modified.

"Waitlisted" - means that modification request is waiting for confirmation. In this case you need to send Booking Retrieval request to get an actual state of booking (see Hotel Booking Retrieval section).

"Request denied" - means that supplier rejected modification.

Important note: in Multibooking the status of the whole reservation (basket) is defined according to the status of sub-reservations and is calculated according to 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 Waitlisted=> ResStatus of the whole booking is Waitlisted. 3. If any of HotelReservation has ResStatus Reserved=> ResStatus of the whole booking is Reserved.

1...1

HotelResModifies/ HotelResModify*

In successful response element represents modified 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*:

Has the same structure as in Modification Initiate Response, but with updated data and prices if they changed. TPA_Extensions/VoucherProperties/Property element is added:

Element

Attribute

Type

Description

Min…Max occurs

TPA_Extensions/ VoucherProperties/ Property

Contains the updated booking details need to be displayed in new voucher.

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

 Modification Confirmation Response Sample XML
<OTA_HotelResModifyRS Version="2" TransactionIdentifier="12232" EchoToken="tok1" xmlns:ota="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <HotelResModifies>
      <HotelResModify 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>American Breakfast</Text>
                           </DetailDescription>
                        </AdditionalDetail>
                     </AdditionalDetails>
                  </RatePlan>
               </RatePlans>
               <RoomRates>
                  <RoomRate InvBlockCode="1" RatePlanCode="AB,1" RoomTypeCode="2,3" NumberOfUnits="1">
                     <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>Early Booker Rate</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">
                  <VendorMessages>
                     <VendorMessage InfoType="C10">
                        <SubSection>
                           <Paragraph>
                              <Text>Pets not allowed!</Text>
                           </Paragraph>
                        </SubSection>
                     </VendorMessage>
                  </VendorMessages>
                  <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>
            <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="kuoni"/>
            </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>
      </HotelResModify>
   </HotelResModifies>
</OTA_HotelResModifyRS>
 Multibooking Modification Confirmation Response Sample XML
<OTA_HotelResModifyRS EchoToken="tok1" Version="2.0" xmlns="http://www.opentravel.org/OTA/2003/05">
   <Success/>
   <Warnings>
      <Warning Code="568" DocURL="http://generation-p.com/gphub/errors568" Language="en" RecordID="tourico" ShortText="Unable to identify timezone." Status="SENT" Type="3">Unable to identify timezone. Periods of penalties (dates and time) have timezone where hotel is located.</Warning>
   </Warnings>
   <HotelResModifies ResStatus="Reserved">
      <HotelResModify ResStatus="Reserved">
         <RoomStays>
            <RoomStay>
               <RoomTypes>
                  <RoomType RoomTypeCode="15163842-1" SupplierRoomCategoryCode="17-1" SupplierRoomTypeCode="3">
                     <RoomDescription Name="Standard| Standard| One Bed Requested">
                        <Text>Standard| Standard| 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="15163842-1">
                     <Rates>
                        <Rate AgeQualifyingCode="10" RateSource="Calculated">
                           <Total AmountAfterTax="342.10" CurrencyCode="EUR"/>
                        </Rate>
                        <Rate AgeQualifyingCode="10" RateSource="Calculated">
                           <Total AmountAfterTax="342.10" CurrencyCode="EUR"/>
                        </Rate>
                     </Rates>
                     <Total AmountAfterTax="684.20" CurrencyCode="EUR"/>
                  </RoomRate>
               </RoomRates>
               <TimeSpan End="2012-01-07" Start="2012-01-03"/>
               <CancelPenalties>
                  <CancelPenalty End="2012-01-05T15:00:00" Start="2012-01-02T15:00:00">
                     <AmountPercent Amount="92.65" CurrencyCode="EUR"/>
                     <PenaltyDescription Language="en">
                        <Text>Periods of penalties (dates and time) have timezone where hotel is located.</Text>
                     </PenaltyDescription>
                  </CancelPenalty>
                  <CancelPenalty End="2012-01-07T00:00:00" PolicyCode="NoShow" Start="2012-01-05T15:00:00">
                     <AmountPercent Amount="92.65" CurrencyCode="EUR"/>
                     <PenaltyDescription Language="en">
                        <Text>Periods of penalties (dates and time) have timezone where hotel is located.</Text>
                     </PenaltyDescription>
                  </CancelPenalty>
               </CancelPenalties>
               <Total AmountAfterTax="684.20" CurrencyCode="EUR"/>
               <BasicPropertyInfo HotelCityCode="5981" HotelCode="1205222" HotelCodeContext="supplierCode" HotelDistrictCode="12080" HotelDistrictName="Bayswater-Paddington" HotelName="Carlton's Hotel - Demo">
                  <CategoryCodes>
                     <HotelCategory Code="3" CodeDetail="3" GroupCode="Category"/>
                     <HotelCategory Code="20" CodeDetail="Hotel" GroupCode="Type"/>
                  </CategoryCodes>
                  <Award Provider="Hotel" Rating="3"/>
               </BasicPropertyInfo>
            </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>
            <DepositPayments>
               <GuaranteePayment Type="AcceptedPaymentForms">
                  <AcceptedPayments>
                     <AcceptedPayment CostCenterID="EUR"/>
                  </AcceptedPayments>
               </GuaranteePayment>
            </DepositPayments>
            <HotelReservationIDs>
               <HotelReservationID ResID_Source="agent" ResID_Value="qwerty251"/>
               <HotelReservationID ResID_Source="client" ResID_Value="qwerty251"/>
               <HotelReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="14319215"/>
            </HotelReservationIDs>
         </ResGlobalInfo>
         <TPA_Extensions>
            <VoucherProperties>
               <Property Name="ReservationId" Value="14822735"/>
               <Property Name="Latitude" Value="51.513600908938"/>
               <Property Name="Longitude" Value="-0.1915588051113"/>
            </VoucherProperties>
         </TPA_Extensions>
      </HotelResModify>
      <HotelResModify ResStatus="Reserved">
         <RoomStays>
            <RoomStay>
               <RoomTypes>
                  <RoomType RoomTypeCode="15163842-1" SupplierRoomCategoryCode="17-1" SupplierRoomTypeCode="3">
                     <RoomDescription Name="Standard| Standard| One Bed Requested">
                        <Text>Standard| Standard| 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="15163842-1">
                     <Rates>
                        <Rate AgeQualifyingCode="10" RateSource="Calculated">
                           <Total AmountAfterTax="684.20" CurrencyCode="EUR"/>
                        </Rate>
                     </Rates>
                     <Total AmountAfterTax="684.20" CurrencyCode="EUR"/>
                  </RoomRate>
               </RoomRates>
               <TimeSpan End="2012-01-07" Start="2012-01-03"/>
               <CancelPenalties>
                  <CancelPenalty End="2012-01-03T15:00:00" Start="2011-12-31T15:00:00">
                     <AmountPercent Amount="92.65" CurrencyCode="EUR"/>
                     <PenaltyDescription Language="en">
                        <Text>Periods of penalties (dates and time) have timezone where hotel is located.</Text>
                     </PenaltyDescription>
                  </CancelPenalty>
                  <CancelPenalty End="2012-01-07T00:00:00" PolicyCode="NoShow" Start="2012-01-03T15:00:00">
                     <AmountPercent Amount="92.65" CurrencyCode="EUR"/>
                     <PenaltyDescription Language="en">
                        <Text>Periods of penalties (dates and time) have timezone where hotel is located.</Text>
                     </PenaltyDescription>
                  </CancelPenalty>
               </CancelPenalties>
               <Total AmountAfterTax="684.20" CurrencyCode="EUR"/>
               <BasicPropertyInfo HotelCityCode="5981" HotelCode="1205222" HotelCodeContext="supplierCode" HotelDistrictCode="12080" HotelDistrictName="Bayswater-Paddington" HotelName="Carlton's Hotel - Demo">
                  <Award Provider="Hotel" Rating="3"/>
               </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>Ivanov</Surname>
                           </PersonName>
                        </Customer>
                     </Profile>
                  </ProfileInfo>
               </Profiles>
            </ResGuest>
         </ResGuests>
         <ResGlobalInfo>
            <DepositPayments>
               <GuaranteePayment Type="AcceptedPaymentForms">
                  <AcceptedPayments>
                     <AcceptedPayment CostCenterID="EUR"/>
                  </AcceptedPayments>
               </GuaranteePayment>
            </DepositPayments>
            <HotelReservationIDs>
               <HotelReservationID ResID_Source="agent" ResID_Value="qwerty252"/>
               <HotelReservationID ResID_Source="client" ResID_Value="qwerty252"/>
               <HotelReservationID ResID_Source="supplier" ResID_SourceContext="supplierCode" ResID_Value="14319215"/>
            </HotelReservationIDs>
         </ResGlobalInfo>
         <TPA_Extensions>
            <VoucherProperties>
               <Property Name="ReservationId" Value="14822736"/>
               <Property Name="Latitude" Value="51.513600908938"/>
               <Property Name="Longitude" Value="-0.1915588051113"/>
            </VoucherProperties>
         </TPA_Extensions>
      </HotelResModify>
      <Total AmountAfterTax="1368.40" CurrencyCode="EUR"/>
      <HotelReservationIDs>
         <HotelReservationID ResID_Source="basket" ResID_Value="basket1"/>
      </HotelReservationIDs>
   </HotelResModifies>
</OTA_HotelResModifyRS>
  • No labels