Introduction to Quotes

Quotes are used to save the details of a Booking Journey that has not been sent to booking. Quotes are helpful as they maintain a record of Booking details to be referred to in the future by creating an enquiry and quote version in iVector. Quotes can be searched for and retrieved, and can then be progressed into a booking without having to input all the data of the booking search. In this way, quotes are an invaluable resource for agents, as they give the ability to keep a record of all important bookings, and can be used to iterate searches with minor changes, eg changing the hotel search from 3* to 4*. Quotes can be created and accessed both within the Call Centre of iVector and via the website.

The Booking Journey when Including Quotes

While the basic booking journey consists of Search; Prebook; and Book, when including quotes the flow appears more complicated. The first two steps of the booking journey can, instead of proceeding to a booking, be used to create a quote. Similarly, instead of the first two steps being Search and Prebook, a quote can be recalled and used to make a booking (or a new quote). The addition of quotes creates both different starting positions, and different finishing positions in the booking journey. 

Create Quote allows the user to save the Basket Prebook without creating a booking.

Quote Search allows the user to search for quotes using a range of different filters, including by brand or date interval. The response will include a brief overview of the quote, including its reference number, number of guests, and geography.

Quote Retrieve allows the user to fetch a particular quote from the database. The response gives the full detail of the quote, and allows the user to progress the quote back into Basket Prebook, making any changes necessary.

Required Requests and Responses 

1. Create Quote 

This request is known as BasketQuoteRequest, and it contains a Basket Book request wrapped with other information that creates a quote, instead of making a booking. A response is received, which includes the Basket Book Response and pricing information. 

2. Quote Search

This request returns all quotes that match the criteria specified in the request. There are a few options for filter use, including date created and reference number. The response will contain stripped back data, only giving an overview of all quotes, including reference number, geography, and a component summary.

3. Quote Retrieve 

This returns a full quote, and can only search for a single quote at a time. The response includes all details necessary to populate a Basket Book request. If you use the Enquiry reference as the booking reference in the book request when converting a quote into a booking then the booking is created under the same enquiry as the quotes. For example, if the quote reference is 1053399/1, then if 1053399 is used as the booking reference then the booking will be created under that reference. This means that the booking and associated quotes can all be accessed from the same enquiry. 

Examples

Creating a Quote

BasketQuoteRequest

Creating a quote for a property booking.

<BasketQuoteRequest>

<LoginDetails>

<Login>DemoLogin</Login>

<Password>DemoPassword</Password>

</LoginDetails>

<LeadCustomer>

<CustomerTitle />

<CustomerId>0</CustomerId>

<CustomerFirstName />

<CustomerLastName />

<DateOfBirth>0001-01-01T00:00:00</DateOfBirth>

<CustomerAddress1 />

<CustomerAddress2 />

<CustomerTownCity />

<CustomerCounty />

<CustomerPostcode />

<CustomerBookingCountryID>0</CustomerBookingCountryID>

<CustomerPhone />

<CustomerMobile />

<CustomerFax />

<CustomerEmail />

<CustomerPassportNumber />

<CustomerExternalReference />

<ContactCustomer>false</ContactCustomer>

<ContactByPost>false</ContactByPost>

<ContactByEmail>false</ContactByEmail>

<ContactByPhone>false</ContactByPhone>

<ContactBySMS>false</ContactBySMS>

<EMarketingSignUp>false</EMarketingSignUp>

</LeadCustomer>

<GuestDetails>

<GuestDetail>

<GuestID>-1</GuestID>

<Type>Adult</Type>

<Title>Mr</Title>

<FirstName>AA</FirstName>

<MiddleName />

<LastName>TBA</LastName>

<Age>21</Age>

<DateOfBirth>1999-10-12T00:00:00</DateOfBirth>

<NationalityID>0</NationalityID>

<PassportNumber />

<Gender />

</GuestDetail>

<GuestDetail>

<GuestID>-2</GuestID>

<Type>Adult</Type>

<Title>Mr</Title>

<FirstName>BB</FirstName>

<MiddleName />

<LastName>TBA</LastName>

<Age>23</Age>

<DateOfBirth>1997-05-12T00:00:00</DateOfBirth>

<NationalityID>0</NationalityID>

<PassportNumber />

<Gender />

</GuestDetail>

</GuestDetails>

<PropertyBookings>

<PropertyBookRequest>

<BookingToken>Bce1Y4jzu379pr</BookingToken>

<ArrivalDate>2020-10-10T00:00:00</ArrivalDate>

<Duration>6</Duration>

<Request />

<ExpectedTotal>101.67</ExpectedTotal>

<RoomBookings>

<RoomBooking>

<RoomBookingToken>FNWiXJTiVRxh1rlh1Hrd</RoomBookingToken>

<GuestIDs>

<GuestID>-1</GuestID>

<GuestID>-2</GuestID>

</GuestIDs>

</RoomBooking>

</RoomBookings>

<BookingTags />

<ThirdPartyForceFail>false</ThirdPartyForceFail>

<PayLocal>false</PayLocal>

<PackageDetails>

<PackageBooking>false</PackageBooking>

<TargetPrice>0</TargetPrice>

<MinUnderAbsorbPrice>0</MinUnderAbsorbPrice>

<MaxOverAbsorbPrice>0</MaxOverAbsorbPrice>

</PackageDetails>

</PropertyBookRequest>

</PropertyBookings>

<BookingAdjustments>

<BookingAdjustment>

<BookingAdjustmentTypeID>6</BookingAdjustmentTypeID>

<AdjustmentType>Contingency</AdjustmentType>

<AdjustmentAmount>19.00</AdjustmentAmount>

<CalculationBasis>Amount Per Person</CalculationBasis>

<ParentType>Booking</ParentType>

</BookingAdjustment>

</BookingAdjustments>

</BasketQuoteRequest>

BasketQuoteResponse

iVector Connect returns a response, confirming that the quote has been created.

<BasketQuoteResponse>

<ReturnStatus>

<Success>true</Success>

<Exceptions />

<ThirdPartyErrors />

</ReturnStatus>

<TotalPrice>116.67</TotalPrice>

<TotalCommission>0.0</TotalCommission>

<VATOnCommission>0.0</VATOnCommission>

<QuoteReference>1053384/1</QuoteReference>

<PropertyBookings>

<PropertyBookResponse>

<ReturnStatus>

<Success>true</Success>

<Exceptions />

<ThirdPartyErrors />

</ReturnStatus>

<TotalPrice>82.67</TotalPrice>

<TotalCommission>0.0</TotalCommission>

<VATOnCommission>0.0</VATOnCommission>

<PayLocalTotal>0</PayLocalTotal>

<PaymentsDue />

<Cancellations />

</PropertyBookResponse>

</PropertyBookings>

<FlightBookings />

<TransferBookings />

<ExtraBookings />

<CarHireBookings />

</BasketQuoteResponse>

Searching for a Quote

QuoteSearchRequest

A quote search request. This will return all results from the brand associated with the login details.

QuoteSearchResponse

iVector Connect returns two quotes.

<QuoteSearchResponse>

<ReturnStatus>

<Success>true</Success>

<Exceptions />

<ThirdPartyErrors />

</ReturnStatus>

<Quotes>

<Quote>

<QuoteReference>1053329/1</QuoteReference>

<TradeReference />

<Status>New</Status>

<LeadCustomerFirstName>Tom</LeadCustomerFirstName>

<LeadCustomerLastName>Cruise</LeadCustomerLastName>

<TotalPax>2</TotalPax>

<BookingDate>2019-11-22T11:38:51.05</BookingDate>

<ArrivalDate>2020-02-22T00:00:00</ArrivalDate>

<Duration>7</Duration>

<ArrivalAirportID>0</ArrivalAirportID>

<DepartureAirportID>0</DepartureAirportID>

<GeographyLevel1ID>0</GeographyLevel1ID>

<GeographyLevel2ID>0</GeographyLevel2ID>

<GeographyLevel3ID>0</GeographyLevel3ID>

<LastReturnDate>2020-02-29T00:00:00</LastReturnDate>

<TotalPrice>3278.85</TotalPrice>

<TotalCommission>0.00</TotalCommission>

<ComponentSummary>

<Component>

<ComponentType>QuoteProperty</ComponentType>

<hlpComponentName>demoname</hlpComponentName>

</Component>

<Component>

<ComponentType>QuoteExtra</ComponentType>

<hlpComponentName>demoname</hlpComponentName>

</Component>

</ComponentSummary>

</Quote>

<Quote>

<QuoteReference>1053325/1</QuoteReference>

<TradeReference />

<Status>New</Status>

<LeadCustomerFirstName>Test</LeadCustomerFirstName>

<LeadCustomerLastName>Test</LeadCustomerLastName>

<TotalPax>2</TotalPax>

<BookingDate>2019-11-18T15:02:49.96</BookingDate>

<ArrivalDate>2020-01-22T00:00:00</ArrivalDate>

<Duration>7</Duration>

<ArrivalAirportID>0</ArrivalAirportID>

<DepartureAirportID>0</DepartureAirportID>

<GeographyLevel1ID>18</GeographyLevel1ID>

<GeographyLevel2ID>138</GeographyLevel2ID>

<GeographyLevel3ID>115</GeographyLevel3ID>

<LastReturnDate>2020-01-29T00:00:00</LastReturnDate>

<TotalPrice>1719.10</TotalPrice>

<TotalCommission>0.00</TotalCommission>

<ComponentSummary>

<Component>

<ComponentType>QuoteProperty</ComponentType>

<hlpComponentName>demoname</hlpComponentName>

</Component>

</ComponentSummary>

</Quote>

</Quotes>

</QuoteSearchResponse>

Retrieving a Quote

QuoteRetrieveRequest

A quote retrieve request for a property quote.

Response

iVectorConnect returns the quote. 

<QuoteRetrieveResponse>
<ReturnStatus>
<Success>true</Success>
<Exceptions />
<ThirdPartyErrors />
</ReturnStatus>
<QuoteID>219493</QuoteID>
<QuoteReference>1053261/1</QuoteReference>
<QuotedDate>2019-10-07T12:14:27</QuotedDate>
<TradeContactID />
<TradeID />
<LeadCustomer>
<CustomerTitle>TBA</CustomerTitle>
<CustomerId>0</CustomerId>
<CustomerFirstName>TBA</CustomerFirstName>
<CustomerLastName>TBA</CustomerLastName>
<DateOfBirth>1900-01-01T00:00:00.001</DateOfBirth>
<CustomerAddress1>123 Test Street, Test</CustomerAddress1>
<CustomerAddress2>123 Test-Street, Test</CustomerAddress2>
<CustomerTownCity>Test</CustomerTownCity>
<CustomerCounty>Test</CustomerCounty>
<CustomerPostcode>TBA</CustomerPostcode>
<CustomerBookingCountryID>1</CustomerBookingCountryID>
<CustomerPhone>+3537777777777</CustomerPhone>
<CustomerMobile />
<CustomerFax />
<CustomerEmail>TBA@TBA.com</CustomerEmail>
<CustomerPassportNumber />
<CustomerExternalReference />
<ContactCustomer>false</ContactCustomer>
<ContactByPost>false</ContactByPost>
<ContactByEmail>false</ContactByEmail>
<ContactByPhone>false</ContactByPhone>
<ContactBySMS>false</ContactBySMS>
<EMarketingSignUp>false</EMarketingSignUp>
</LeadCustomer>
<Adults>2</Adults>
<Children>0</Children>
<Infants>0</Infants>
<FirstDepartureDate>2020-01-11T00:00:00</FirstDepartureDate>
<LastReturnDate>2020-01-18T00:00:00</LastReturnDate>
<TotalPrice>585.84</TotalPrice>
<TotalCommission>0.00</TotalCommission>
<VATOnCommission>0.00</VATOnCommission>
<GuestDetails>
<GuestDetail>
<GuestID>-1</GuestID>
<Type>Adult</Type>
<Title>Mr</Title>
<FirstName>AA</FirstName>
<MiddleName />
<LastName>TBA</LastName>
<Age>0</Age>
<DateOfBirth>1900-01-01T00:00:00.001</DateOfBirth>
<NationalityID>0</NationalityID>
<PassportNumber />
<Gender />
</GuestDetail>
<GuestDetail>
<GuestID>-2</GuestID>
<Type>Adult</Type>
<Title>Mr</Title>
<FirstName>BB</FirstName>
<MiddleName />
<LastName>TBA</LastName>
<Age>0</Age>
<DateOfBirth>1900-01-01T00:00:00.001</DateOfBirth>
<NationalityID>0</NationalityID>
<PassportNumber />
<Gender />
</GuestDetail>
</GuestDetails>
<Itinerary>
<Properties>
<Property>
<PropertyQuoteID>-1</PropertyQuoteID>
<PropertyID>1037</PropertyID>
<Source>Own</Source>
<PropertyReferenceID>5200</PropertyReferenceID>
<GeographyLevel1ID>36</GeographyLevel1ID>
<GeographyLevel2ID>84</GeographyLevel2ID>
<GeographyLevel3ID>279</GeographyLevel3ID>
<Status>New</Status>
<ArrivalDate>2020-01-11T00:00:00</ArrivalDate>
<ReturnDate>2020-01-18T00:00:00</ReturnDate>
<Duration>7</Duration>
<TotalPrice>546.84</TotalPrice>
<TotalCommission>0.00</TotalCommission>
<VATOnCommission>0.00</VATOnCommission>
<Rooms>
<Room>
<PropertyRoomBookingID>-1</PropertyRoomBookingID>
<MealBasisID>1</MealBasisID>
<MealBasis>Bed &amp; Breakfast</MealBasis>
<RoomTypeID>-1</RoomTypeID>
<RoomType>One Bedroom Suite King</RoomType>
<RoomViewID>1</RoomViewID>
<PropertyRoomTypeID>4222</PropertyRoomTypeID>
<UpgradeMealBasis />
<Adults>2</Adults>
<Children>0</Children>
<Infants>0</Infants>
<TotalPrice>546.84</TotalPrice>
<PayLocalTotal>0</PayLocalTotal>
<Adjustments />
<OptionalSupplements />
<GuestIDs>
<GuestID>-1</GuestID>
<GuestID>-2</GuestID>
</GuestIDs>
<RoomBookingToken>FNWiXJTiVRxh1rlh1</RoomBookingToken>
</Room>
</Rooms>
<Errata />
<Comments>
<Comment>esrg</Comment>
</Comments>
<ComponentRepriced>true</ComponentRepriced>
<BookingToken>3D5u9NN+JyglecmEp</BookingToken>
<QuotedTotalPrice>0</QuotedTotalPrice>
<PaymentsDue>
<PaymentDue>
<Amount>54.68</Amount>
<DateDue>2019-10-07T00:00:00</DateDue>
</PaymentDue>
<PaymentDue>
<Amount>492.16</Amount>
<DateDue>2019-11-01T00:00:00</DateDue>
</PaymentDue>
</PaymentsDue>
<Cancellations>
<Cancellation>
<StartDate>2019-10-07T00:00:00</StartDate>
<EndDate>2019-11-02T00:00:00</EndDate>
<Amount>200.00</Amount>
</Cancellation>
<Cancellation>
<StartDate>2019-11-03T00:00:00</StartDate>
<EndDate>2019-11-29T00:00:00</EndDate>
<Amount>273.42</Amount>
</Cancellation>
<Cancellation>
<StartDate>2019-11-30T00:00:00</StartDate>
<EndDate>2019-12-20T00:00:00</EndDate>
<Amount>382.79</Amount>
</Cancellation>
<Cancellation>
<StartDate>2019-12-21T00:00:00</StartDate>
<EndDate>2019-12-31T00:00:00</EndDate>
<Amount>492.16</Amount>
</Cancellation>
<Cancellation>
<StartDate>2020-01-01T00:00:00</StartDate>
<EndDate>2099-12-31T00:00:00</EndDate>
<Amount>546.84</Amount>
</Cancellation>
</Cancellations>
<TermsAndConditions>See Brochure</TermsAndConditions>
<TermsAndConditionsURL>ifonly.net/booking-conditions</TermsAndConditionsURL>
<SalesTaxes />
<ComponentReference>1053261/1A</ComponentReference>
</Property>
</Properties>
<Flights />
<Transfers />
<Extras />
<CarHires />
<AdHocComponents />
<Cruises />
<BookingAdjustments>
<BookingAdjustment>
<BookingAdjustmentTypeID>69</BookingAdjustmentTypeID>
<AdjustmentType>Fee</AdjustmentType>
<AdjustmentID>420</AdjustmentID>
<Adjustment>ATOL Fee</Adjustment>
<AdjustmentAmount>20.00</AdjustmentAmount>
<CustomerAdjustmentAmount>20.00</CustomerAdjustmentAmount>
<CalculationBasis>Per Booking</CalculationBasis>
<ParentType />
</BookingAdjustment>
</BookingAdjustments>
<CustomerPayments>
<CustomerPayment>
<DueDate>2019-10-14T00:00:00</DueDate>
<CurrencyID>1</CurrencyID>
<Symbol>£</Symbol>
<TotalPayment>250.00</TotalPayment>
</CustomerPayment>
<CustomerPayment>
<DueDate>2019-11-14T00:00:00</DueDate>
<CurrencyID>1</CurrencyID>
<Symbol>£</Symbol>
<TotalPayment>250.00</TotalPayment>
</CustomerPayment>
<CustomerPayment>
<DueDate>2019-12-11T00:00:00</DueDate>
<CurrencyID>1</CurrencyID>
<Symbol>£</Symbol>
<TotalPayment>85.84</TotalPayment>
</CustomerPayment>
</CustomerPayments>

</QuoteRetrieveResponse>