Skip to main content

Enhanced Hotel Book

2.2.0
Hotel
Reservation
SOAP API
Travel Agency

Enhanced Hotel Book (EnhancedHotelBookRQ) is an orchestrated API that allows booking hotel content (GDS or aggregator) in a single call.

Not Signed In.

Looks like you may not have access to all of the resources and documentation for this page.
Please log-in or contact your support desk team if you believe you should have access.

Target Audience
Travel Agency
API Version
2.2.0
Authentication
Session Token
Service Action Code
EnhancedHotelBookRQ

What is it?

With the release of Content Services for Lodging (CSL), Sabre has expanded its traditional GDS hotel offering with content from external aggregators. The Enhanced Hotel Book API (EnhancedHotelBookRQ) facilitates the booking of both traditional GDS hotel content as well as lodging aggregator content.

Why use it?

Features in the Enhanced Hotel Book API include:

  • Ability to book an Aggregator hotel as a CSL segment.
  • Ability to book a Sabre GDS hotel as a CSL segment or as a legacy segment.
  • Ability to specify a “Hotel Booking Key” that uniquely identifies the hotel property, room type, room rate, number of guests, etc.
  • Ability to identify failures during the orchestrated process, and properly notify the user.

How it works

The API performs several steps when booking a hotel room:

  • It will decode and retrieve shopped rate details based on the data provided by the "Hotel Booking Key".
  • Depending on the data of the booking key and user input, the API will follow one of the following three strategies to book the desired hotel rate:
    • Aggregator hotel via CSL
    • GDS hotel via CSL
    • GDS hotel as a legacy segment
  • If the booking is successful, the API will validate the newly added segment statuses as returned by the hotel vendor (HK/SS/NN/PN/UC/NO):
    • HK/SS/NN/PN are considered successful
    • UC/NO are considered unsuccessful and the API will return an error
  • Finally, it will return the current state of the session in the response payload (an internal call to TravelItineraryReadRQ).

How to use

For detailed instructions on using this API, refer to the Help tab.

Sample Request
<EnhancedHotelBookRQ xmlns="http://services.sabre.com/sp/enhanced/hotel/book/v2_2" version="2.2.0">
    <BookingInfo RequestorID="SG000000">
        <BookingKey>fef21245-d571-4fb8-8cbb-38143e44f29e</BookingKey>
    </BookingInfo>
    <Rooms>
        <Room RoomIndex="1" NonSmoking="true">
            <Guests>
                <Guest FirstName="TEST" LastName="API" Email="Witold.Petriczek@sabre.com" Type="10" Index="1" LeadGuest="true">
                    <Contact Phone="817-555-1212" />
                </Guest>
            </Guests>
        </Room>
    </Rooms>
    <PaymentInformation Type="GUARANTEE">
        <FormOfPayment>
            <PaymentCard>
                <PaymentType>CC</PaymentType>
                <CardCode>VI</CardCode>
                <CardNumber>4000000000006</CardNumber>
                <ExpiryMonth>7</ExpiryMonth>
                <ExpiryYear>2021</ExpiryYear>
                <FullCardHolderName>
                    <FirstName>TEST</FirstName>
                    <LastName>API</LastName>
                    <Email>Witold@sabre.com</Email>
                </FullCardHolderName>
                <CSC>123</CSC>
                <Address>
                    <AddressLine>Wadowicka 6</AddressLine>
                    <CityName>Krakow</CityName>
                    <StateProvince code="KR" />
                    <StateProvinceCodes>
                        <Code>KR</Code>
                    </StateProvinceCodes>
                    <PostCode>30-415</PostCode>
                    <CountryCodes>
                        <Code>PL</Code>
                    </CountryCodes>
                </Address>
                <Phone>
                    <PhoneNumber>817-555-1212</PhoneNumber>
                </Phone>
            </PaymentCard>
        </FormOfPayment>
    </PaymentInformation>
    <POS>
        <Source AgencyName="SABRE" ISOCountryCode="US" PseudoCityCode="TM61">
            <RequestorID Type="5" Id="000000" IdContext="IATA" />
            <AgencyAddress>
                <AddressLine1>3150 SABRE DRIVE</AddressLine1>
                <CityName />
                <CountryName Code="US" />
            </AgencyAddress>
        </Source>
    </POS>
</EnhancedHotelBookRQ>
Sample Response
<EnhancedHotelBookRS xmlns="http://services.sabre.com/sp/enhanced/hotel/book/v2" version="2.2.0">
    <ApplicationResults xmlns="http://services.sabre.com/STL_Payload/v02_01" status="Complete">
        <Success timeStamp="2020-07-15T11:10:18.361-05:00" />
    </ApplicationResults>
    <TravelItineraryRead>
        <TravelItinerary>
            <CustomerInfo>
                <Address>
                    <AddressLine Id="7" type="O">SABRE TRAVEL</AddressLine>
                    <AddressLine Id="8" type="O">3150 SABRE DRIVE</AddressLine>
                    <AddressLine Id="9" type="O">SOUTHLAKE, TX US</AddressLine>
                    <AddressLine Id="10" type="O">76092</AddressLine>
                </Address>
                <ContactNumbers>
                    <ContactNumber LocationCode="BWI" Phone="817-555-1212-H-1.1" RPH="001" Id="6" />
                </ContactNumbers>
                <PaymentInfo>
                    <Payment>
                        <Form RPH="001" Id="40">
                            <Text>CHECK</Text>
                        </Form>
                    </Payment>
                </PaymentInfo>
                <PersonName WithInfant="false" NameNumber="01.01" NameReference="ABC123" PassengerType="ADT" RPH="1" elementId="pnr-3.1">
                    <GivenName>TEST</GivenName>
                    <Surname>API</Surname>
                </PersonName>
            </CustomerInfo>
            <ItineraryInfo>
                <ReservationItems>
                    <Item RPH="1">
                        <Hotel DayOfWeekInd="7" NumberInParty="01" NumberOfUnits="1" SegmentNumber="0001" Status="HK" Type="HHL" IsPast="false" Id="15">
                            <BasicPropertyInfo ChainCode="7E" HotelCityCode="DFW" HotelCode="0" HotelName="HOLIDAY INN EXP STES LAS COLINA">
                                <Address>
                                    <AddressLine>333 W JOHN CARPENTER FREEWAY</AddressLine>
                                    <AddressLine>I</AddressLine>
                                    <CountryCode>US</CountryCode>
                                </Address>
                                <CancelPenalty PolicyCode="NOR" />
                                <ConfirmationNumber>340527037</ConfirmationNumber>
                                <ContactNumbers>
                                    <ContactNumber Fax="1-972-910-0299" Phone="1-972-910-0302" />
                                </ContactNumbers>
                            </BasicPropertyInfo>
                            <Customer>
                                <ReserveUnderName>API TEST</ReserveUnderName>
                            </Customer>
                            <Guarantee>VI4XXXXXXXX0006EXP 07 21-API</Guarantee>
                            <POS>
                                <Source>
                                    <RequestorID>000000</RequestorID>
                                </Source>
                            </POS>
                            <RoomRates>
                                <Commission NonCommission="false" />
                                <Rate Amount="164.96" CurrencyCode="USD" RoomTypeCode="null">
                                    <HotelTotalPricing>
                                        <TotalTax>
                                            <Tax Id="TX1">101.83 TAXANDSERVICE</Tax>
                                        </TotalTax>
                                        <RateChange Effective="00091.00USD 13OCT-001NT" Tax="0.00TX" />
                                        <RateChange Effective="00119.00USD 14OCT-001NT" Tax="0.00TX" />
                                        <RateChange Effective="00174.00USD 15OCT-001NT" Tax="0.00TX" />
                                        <RateChange Effective="00174.00USD 16OCT-001NT" Tax="0.00TX" />
                                    </HotelTotalPricing>
                                </Rate>
                            </RoomRates>
                            <TimeSpan Duration="004" End="10-17" Start="10-13" />
                        </Hotel>
                        <Product>
                            <ProductBase>
                                <SegmentReference>15</SegmentReference>
                            </ProductBase>
                            <ProductDetails productCategory="AGTLCSSEGMENT" productType="HHL" vendorCode="HI" statusCode="HK" startPoint="DFW" startDateTime="2019-10-13T00:00:00" endPoint="DFW" endDateTime="2019-10-17T00:00:00">
                                <ProductName type="HHL">Lodging</ProductName>
                            </ProductDetails>
                        </Product>
                    </Item>
                </ReservationItems>
                <Ticketing RPH="01" TicketTimeLimit="TAW/" />
            </ItineraryInfo>
            <ItineraryRef AirExtras="false" ID="GRAVTD" InhibitCode="U" PartitionID="AA" PrimeHostID="1S">
                <Source AAA_PseudoCityCode="TM61" CreateDateTime="2019-07-15T11:10" CreationAgent="ASP" HomePseudoCityCode="TM61" PseudoCityCode="TM61" ReceivedFrom="SP TEST" LastUpdateDateTime="2019-07-15T11:10" SequenceNumber="1" />
            </ItineraryRef>
            <RemarkInfo />
            <SpecialServiceInfo RPH="001" Type="GFX" Id="11">
                <Service SSR_Code="OSI">
                    <Airline Code="7E" />
                    <Text>HHL 100075042 D SUITE, 2 DOUBLE BEDS, NON SM</Text>
                </Service>
            </SpecialServiceInfo>
            <SpecialServiceInfo RPH="002" Type="GFX" Id="12">
                <Service SSR_Code="OSI">
                    <Airline Code="7E" />
                    <Text>HHL 100075042 C THIS RATE IS NON-REFUNDABLE.</Text>
                </Service>
            </SpecialServiceInfo>
            <SpecialServiceInfo RPH="003" Type="GFX" Id="13">
                <Service SSR_Code="OSI">
                    <Airline Code="7E" />
                    <Text>HHL 100075042 D SUITE, 2 DOUBLE BEDS, NON SM</Text>
                </Service>
            </SpecialServiceInfo>
            <SpecialServiceInfo RPH="004" Type="GFX" Id="14">
                <Service SSR_Code="OSI">
                    <Airline Code="7E" />
                    <Text>HHL 100075042 D OKING</Text>
                </Service>
            </SpecialServiceInfo>
            <SpecialServiceInfo RPH="005" Type="GFX" Id="39">
                <Service SSR_Code="SSR" SSR_Type="OTHS">
                    <Airline Code="YY" />
                    <Text>CC TEST API</Text>
                </Service>
            </SpecialServiceInfo>
            <OpenReservationElements>
                <OpenReservationElement id="3" elementId="pnr-or-3" />
                <OpenReservationElement id="4" type="FP" displayIndex="1" elementId="pnr-or-4">
                    <FormOfPayment migrated="false">
                        <Check>
                            <Text>CHECK</Text>
                        </Check>
                    </FormOfPayment>
                </OpenReservationElement>
                <OpenReservationElement id="11" type="SRVC" elementId="pnr-11">
                    <ServiceRequest airlineCode="7E" serviceType="OSI" ssrType="GFX">
                        <FreeText>HHL 100075042 D SUITE, 2 DOUBLE BEDS, NON SM</FreeText>
                        <FullText>7E HHL 100075042 D SUITE, 2 DOUBLE BEDS, NON SM</FullText>
                    </ServiceRequest>
                </OpenReservationElement>
                <OpenReservationElement id="12" type="SRVC" elementId="pnr-12">
                    <ServiceRequest airlineCode="7E" serviceType="OSI" ssrType="GFX">
                        <FreeText>HHL 100075042 C THIS RATE IS NON-REFUNDABLE.</FreeText>
                        <FullText>7E HHL 100075042 C THIS RATE IS NON-REFUNDABLE.</FullText>
                    </ServiceRequest>
                </OpenReservationElement>
                <OpenReservationElement id="13" type="SRVC" elementId="pnr-13">
                    <ServiceRequest airlineCode="7E" serviceType="OSI" ssrType="GFX">
                        <FreeText>HHL 100075042 D SUITE, 2 DOUBLE BEDS, NON SM</FreeText>
                        <FullText>7E HHL 100075042 D SUITE, 2 DOUBLE BEDS, NON SM</FullText>
                    </ServiceRequest>
                </OpenReservationElement>
                <OpenReservationElement id="14" type="SRVC" elementId="pnr-14">
                    <ServiceRequest airlineCode="7E" serviceType="OSI" ssrType="GFX">
                        <FreeText>HHL 100075042 D OKING</FreeText>
                        <FullText>7E HHL 100075042 D OKING</FullText>
                    </ServiceRequest>
                </OpenReservationElement>
                <OpenReservationElement id="39" type="SRVC" elementId="pnr-39">
                    <ServiceRequest airlineCode="YY" code="OTHS" serviceType="SSR" ssrType="GFX">
                        <FreeText>CC TEST API</FreeText>
                        <FullText>OTHS YY CC TEST API</FullText>
                    </ServiceRequest>
                </OpenReservationElement>
            </OpenReservationElements>
            <AssociationMatrices>
                <AssociationMatrix>
                    <Name>PssIDType</Name>
                    <Parent ref="pnr-15" />
                    <Child ref="pnr-11" />
                    <Child ref="pnr-12" />
                    <Child ref="pnr-13" />
                    <Child ref="pnr-14" />
                    <Child ref="pnr-or-3" />
                </AssociationMatrix>
            </AssociationMatrices>
        </TravelItinerary>
    </TravelItineraryRead>
</EnhancedHotelBookRS>