Task: Best Buy Compare

This transaction is used to compare the fare for a booked itinerary, and the best buy fare returned by the FareQuoteBestBuyCompare request. The response includes all the same FareQuoteStandard response, with an additional detail item; a comparison to current booking codes. This displays the lowest fare available as booked, the lowest available fare, and the difference (savings) between the two fares.

Section 1: Short Answer

Transaction Name:

FareQuoteBestBuyCompare_13

Can this task be performed in a sessionless environment?

No. A current PNR/BF needs to exist. The Best Buy Compare request has must be sent after the first PNR/BF is retrieved.

Are the request and response identical on both the Apollo and Galileo systems?

Yes.

List any industry-specific knowledge required to understand this task in terms of the specific business process.

It is important to be able to book and retrieve a fare.

Explain any special limits or distinct restrictions to the input data that may not be readily apparent.

The itinerary can only have a maximum of eight segments. More than eight segments in the itinerary returns an error.

Section 2: Detailed Description

Request

Unless otherwise specified, use ALL CAPS in any request data.

Before the FareQuoteBestBuyCompare request can be sent, a booked itinerary must exist.

The 1418 <BestBuyCompareMods> element must be sent with <PassengerType>. The <PassengerType> element supports several functions. <PassengerType> can be used to:

Supply personal geography details in the request, which allow pricing of fares that have geographical restrictions, such as country residency or state employment. Fares that have geographical restrictions are not quoted unless matching personal geography information for the passenger is sent in the request.

Without appropriate personal geography information, a user may not receive a lower fare based on their request. If a lower fare is NOT returned, either higher fares or an error response are returned.

Enter an amount increase (IF) or decrease (DF) of more than six characters when necessary, e.g., 'IF20000'.
Supply Spanish residency modifiers in the request, which allows the pricing of Spanish resident fares:
- A Spanish resident fare can only be quoted if the appropriate Spanish resident PTC and Spanish resident modifier is given in the request.
- You must use the Spanish modifier in conjunction with the residency SSR from the booking file to provide required residency information.
Enter a PTC and a discount in the <PassengerType> in a single request.

Note: The use of proprietary Galileo International Passenger Information Codes (PIC) was discontinued in early 2005. PICs have been replaced with ATPCo Passenger Type Codes (PTC).

Previously, PIC data was sent in the <PIC> child element within <PsgrMods> or <FqPicOnly>. <PsgrMods> searches for a lower fare with the specified passenger type. If a lower fare does not exist, it sends back the lowest adult fare. <FqPicOnly> only searches for a lower fare for the specified passenger type. While these elements are still available, it is now recommended to send PTCs using the <PTC> child element in <PassengerType>.

The <PassengerType> element also allows the <PricePTCOnly> (PIC Only) search to be requested for fares for a specific PTC only (similar to <FqPicOnly>).
Override any fare ticket codes or designators using the <TkDesignator> and <TkCode> elements.

Other data in the request can include:

The <ClassPreference> contains the cabin preference modifier. You can specify what Cabin Class the fares should be returned in for the itinerary.
A <GenQuoteInfo> element to include ticket dates in the request. If no dates are sent, today’s date is assumed.
For a historical fare quote, <GenQuoteInfo> must include ticket dates. For an accurate historical quote, a <SegSelection> element with <FareType> set to ‘F’, and a fare basis code <FIC> are recommended.
If the user wishes to define whether the most restrictive rules for the entire quote (single fare component) are returned in <RsvnRules>, <GenQuoteInfo> must be sent with the <RulesProcess> indicator set to N. If the indicator is set to Y, applicable rules are returned in <AdvRsvnTktRule>/ <MinStayRule>/ <MaxStayRule>/ <SalesRestrictionsRule>/ <PenaltiesRule> per fare component.
For public and private fares to be considered in the response, the <PublishedFaresInd> child element in <SegSelection> must be set to 'Y'. The lowest fares, whether public or private are returned. If public fares will not be considered, <PublishedFaresInd> must be set to 'N'.
Fares with rule category 35 (CAT 35) data, which is net fare information, will potentially contain multiple fare levels: sell, net, ticket-audit, ticket-passenger. For users requesting the additional CAT 35 data, this information is returned in the elements identified with an asterisk (*) within the <FareInfo> (1425 Data Record) response (see the <FareInfo> Response table in Section 3).
Note: The <EnhancedPrivateFare> (GFPX KLR) is used for rules follow-ons. It is returned with rules follow-on transactions so that the correct rules text displays. Do not use or modify anything in this element.

Prerequisite tasks:

Before the fare quote best buy compare request can be sent, a booked itinerary must exist.

Expected response:

The expected response is a <FareInfo> element, with child elements that detail the cost of the specific itinerary.

For a Best Buy Compare response, in <FareInfo>, the <GenQuoteDetails> contains the lowest available fare, and the lowest fare as booked. Relevant elements in the <GenQuoteDetails> include;

· The <BaseFareAmt> sub-element contains the base fare amount of the lowest fare available.

· The <LowestOrNUCFare> sub-element contains the price the itinerary will be if the itinerary is left “as booked”. For example, if you book an itinerary in Y class, and you submit a <BestBuyCompareMods>, and the lowest fare available is G class, then the Lowest or NUC field will contain the fare of the Y class for the currently-booked itinerary.

· The <TotAmt> sub-element contains the lowest available fare.

The <NewBICSegMapping> element contains the class in which the itinerary has to be rebooked to get the lowest available fare.

Error and warning responses:

The following error/warning messages can display:

MAXIMUM OF 9 PAX ALLOWED FOR BEST BUY ENTRY
USE BEST BUY FOR CONFIRMED SEGMENTS ONLY
MAXIMUM OF 8 SEGMENTS ALLOWED FOR BEST BUY ENTRY

Follow-on requests:

You can rebook the itinerary with the lowest available fare using PNRBFManagement.

Section 3: Tables

Request (Input) Tags

<BestBuyCompareMods>

Terminal Equivalents:

Apollo $BBC

Galileo FQBC

Ordering	KLR	Min-Max	XML Tag
A	GQPA GQNP or GQPO	1-1	<PassengerType> <PsgrMods> <FqPicOnly>
B	GQCB	0-1	<ClassPreference>
B	GQFP	0-1	<GenFarePrefs>
B	GQFS	0-1	<SegInfo>
B	GQPC	0-1	<PlatingAirVMods>
B	GQQM	0-1	<GenQuoteInfo>
B	GQSR	0-1	<SegMods>
B	GQSS	0-1	<SegSelection>
B	GQTE	0-1	<TaxExemptMods>

Response (Output) Tags

Tags with asterisks (*) in the Ordering column can contain CAT 35 elements on the Galileo CRS.

<FareInfo>

Ordering	KLR	Min/Max	XML Tag
	EROR		<ErrText>
	GF0A		<GeneralConstraints>
	GF0B		<BICConstraints>
	GF0C		<DayTmConstraints>
	GF0D		<ValidDates>
	GF0E		<FlightConstraints>
	GF0F		<InvalidDates>
	GF0G		<LastTravelConstraints>
	GFBC		<PrevBICSegMapping>
	GFBK		<NextBICSegMapping>
*	GFC7		<CommNetGrossInfo>
	GFCI		<CityIndInfo>
	GFDR		<TkRestrictionInfo>
*	GFEQ		<ExtendedQuoteInformation>
	GFFC		<FareConstruction>
	GFFO		<OverrideInfo>
	GFFP		<FictitiousStartPt>
	GFFS		<FilingStatus>
	GFFU		<FollowUpEntries>
	GFGQ		<GenQuoteDetails>
	GFIS		<ItinSeg>
	GFJT		<JrnyType>
	GFMM		<InfoMsg>
*	GFN1		<SellFareConstruct>
*	GFN2		<NetFareConstruct>
*	GFN3		<TkAuditFareConstruct>
*	GFN4		<TkPsgrFareConstruct>
	GFOM		<Msg>
	GFPF		<PsgrFacilityCharge>
	GFPI		<PsgrTypes>
	GFPU		<PlusUps>
	GFRF		<RulesDisplayBySegment>
	GFRH		<RespHeader>
	GFPX		<EnhancedPrivateFare>
	GFRI		<RulesInfo>
	GFRP		<RulesData>
	GFRR		<RvsnRules>
	GFJ5		<AdvRsvnTktRules>
	GFJ6		<MinStayRules>
	GFJ7		<MaxStayRules>
	GFJF		<SalesRestrictionRules>
	GFJG		<PenaltyRules>
*	GFS2		<NetStructFareConstruct>
*	GFS3		<TkAuditStructFareConstruct>
*	GFS4		<TkPsgrStructFareConstruct>
*	GFSF		<SellStructFareConstruct>
	GFSR		<SegRelatedInfo>
	GFSU		<Surcharge>
	GFT1		<TkPsgrFareConstructTaxInfo>
	GFTD		<Tariff>
	GFTS		<TaxBreakdown>
	GFXE		<BBQIntuitiveSystemsData>
	GFXG		<BBQGenQuoteInfo>
	GFXI		<FlightItemCrossRef>
	GFXJ		<BBQAvailJourneyItem>
	GFXO		<BestBuyQuoteOriginDest>
	GFXR		<BBQInfo>
	GFZ6		<SegMapping>
	GRFB		<FareBasisCodeSummary>
	GROM		<OutputMsg>

Related Samples

FareQuoteBestBuyCompare_13_s1

FareQuoteBestBuyCompare_13_s2