Hotel API · Booking flow
HotelQuote()
This function must be called after HotelSearch() API call and before HotelBookingCreation() API call. It returns an up-to-date rate and availability for the selected offer (room(s))
Request
<HotelQuoteREQ>
<Credential>
<Login>?</Login>
<Password>?</Password>
</Credential>
<Details>
<User>?</User>
<Language>?</Language>
<Source>?</Source>
<IdHotel>?</IdHotel>
<FromDate>?</FromDate>
<ToDate>?</ToDate>
<Nationality>XX</Nationality>
<SourceMarket>XX</SourceMarket>
<OnlyAvailable>True/False</OnlyAvailable>
<CodePromo>?</CodePromo>
<Rooms>
<Room id="?">
<Pax>
<Adult>?</Adult>
<Child>?</Child>
<Infant>?</Infant>
</Pax>
<OfferId>?</OfferId>
<Boarding>?</Boarding>
</Room>
…
</Rooms>
</Details>
</HotelQuoteREQ>| Root | Sub root | Description | Values & Format | Tag |
|---|---|---|---|---|
| Credential | Mandatory | |||
| Login | Text | |||
| Password | Text | |||
| Details | Mandatory | |||
| User | ID User | Numeric | Mandatory | |
| Language | ID Language | Numeric | Mandatory | |
| Source | ID Source | Numeric | Mandatory if hotel is through a 3rd party supplier | |
| IdHotel | ID Hotel | Numeric | Mandatory | |
| FromDate | Frome date | date | Mandatory | |
| ToDate | To date | date | Mandatory | |
| Nationality | 2 letters iso-code, If provided, then filter only offers for the nationality | 2 letters in uppercase | Optional | |
| OnlyAvailable | Show only if available | Boolean | Optional | |
| CodePromo | Code promo to be used when calculating final price | Text | Optional | |
| Rooms | ||||
| Room@id | Id selected room | Numeric | ||
| Room:Pax:Adult | Adult number | Numeric | Mandatory | |
| Room:Pax:Child | Child number | Numeric | Mandatory | |
| Room:Pax:Infant | Infant number | Numeric | Mandatory | |
| Room:OfferId | OfferId (offer identifier) | Text | Mandatory if returned in HotelSearchRES | |
| Room:Boarding | ID Boarding | Numeric | Mandatory |
Response
<HotelQuoteRES>
<Currency>?</Currency>
<Language>?</Language>
<FromDate>?</FromDate>
<City id="’?’">?</City>
<Destination id="’?’">?</Destination>
<ToDate>?</ToDate>
<Hotel id="?" >
<QuoteId>?</QuoteId>
<Rooms>
<Room id="?" count="?">
<Title>?</Title>
<Adult>?</Adult>
<Child>?</Child>
<Infant>?</Infant>
<AvailableQuantity>?</AvailableQuantity>
<Boardings>
<Boarding id=”?” OfferId=”?”>
<Title>?</Title>
<Available>?</Available>
<DownPayment>?</DownPayment>
<Rate>?</Rate>
<RateWithoutPromotion>?</RateWithoutPromotion>
<NonRefundable>?</NonRefundable>
<CancellationPolicy>
<FromDate>?</FromDate>
</CancellationPolicy>
<TariffNotes>?</TariffNotes>
</Boarding>
</Boardings>
<Supplements>
<Supplement>
<Title>?</Title>
<Rate currency=””>?</Rate>
</Supplement>
</Supplements>
</Room>
</Rooms>
<PaymentModes>
<PaymentMode>
<Id>?</Id>
<TotalRate>?</TotalRate>
</PaymentMode>
<PaymentMode>
<Id>?</Id>
<TotalRate>?</TotalRate>
</PaymentMode>
...
</PaymentModes>
<SourceGlobalSupplement>?</SourceGlobalSupplement>
<GSC>?</GSC>
</Hotel>
<WithCreditLimit>?</WithCreditLimit>
</HotelQuoteRES>| Root | Sub root | Description | Values & Format | Tag |
|---|---|---|---|---|
| Currency | Id currency | Numeric | Mandatory | |
| Language | Id currency | Numeric | Mandatory | |
| FromDate | from date | Date | Mandatory | |
| ToDate | to date | Date | Mandatory | |
| City | City Name | Text | ||
| City :@Id | City Id | Numeric | ||
| Destination | Destination Name | Text | ||
| Destination :@Id | Destination ID | Numeric | ||
| Hotel | ||||
| Hotel:@Id | Id Hotel | Text | Mandatory | |
| Hotel: QuoteId | booking operation code | Numeric | Mandatory | |
| Rooms:@Id | Id Room | Numeric | Mandatory | |
| Rooms:@count | Room Count | Numeric | Mandatory | |
| Rooms:Room:Title | Roomt title | |||
| Rooms:Room:Adult | Adult number | Numeric | Mandatory | |
| Rooms:Room:Child | Child number | Numeric | Mandatory | |
| Rooms:Room:Infant | Infant number | Numeric | Mandatory | |
| Rooms:Room:Boardings:AvailableQuantity | Available quantity of room type | Numeric | ||
| Rooms:Room:Boardings:Boarding:@OfferId | Boarding OfferId (offer identifier) | Text | OPTIONAL to be used in HotelBookingREQ | |
| Rooms:Room:Boardings:Boarding:Title | Boarding title | Text | ||
| Rooms:Room:Boardings:Boarding:Available | Boarding status | Numeric | ||
| Rooms:Room:Boardings:Boarding:Rate | Rate for this room | Numeric | Mandatory | |
| Rooms:Room:Boardings:Boarding:TariffNotes | Display any comment about the related rate like "You will pay upon arrival a tax charge of XXX for the YY night(s)" or if NRF: "This booking is non-refundable"..etc. | Text | ||
| Rooms:Room:Boardings:Boarding:RateWithoutPromotion | Rate without promotion | Numeric | Mandatory | |
| Rooms:Room:CancellationPolicy:FromDate | Cancellation available from date | Date | Mandatory | |
| Rooms :Room :Supplements:Supplement | One Supplement details for the current room | Text | Optionnel | |
| Rooms :Room :Supplements:Supplement:Title | Supplement Title | Text | ||
| Rooms :Room :Supplements:Supplement:Rate | Rate of the supplement | Text | ||
| Rooms :Room :Supplements:Supplement:Rate:@currency | Currency code of the rate | Numeric | ||
| Hotel: PaymentModes | Available payment modes for this hotel | only for B2C API | ||
| Hotel: PaymentModes:PaymentMode:Id | 1: OnlineDownPayment 2: OnlineFullPayment 3: POSFullPayment 4: POSDownPayment 5: HotelCollect | Numeric | only for B2C API | |
| Hotel: PaymentModes:PaymentMode:TotalRate | Total rate for all selected rooms | Numeric | ||
| Hotel : SourceGlobalSupplement | Source Global Supplement for the current hotel | Numeric | applicable only for a hotel with <source> node (3rd party). This is a handling booking fee | |
| Hotel : GSC | General sales conditions (CGV) of the affiliate, in the language of the request (Language). Returned as HTML in a CDATA section, ready to display as-is. Absent when the affiliate has no conditions recorded for that language. | Text (HTML, CDATA) | only for B2C API — optional | |
| WithCreditLimit | affiliate with credit limit | text | Mandatory |