Fare Basis Codes (Forced Fares)

A Fare Basis is a unique identifier (within an airline) for the fare used to issue to the ticket. Fare Basis Codes can be used to create a specific fare to price, which overrides Universal API's system-generated fare responses. A Fare Basis Code can be provided for each segment in an itinerary.

Request

Fare Basis Codes can be added in the FareBasisCode attribute:

During Air Pricing in AirPriceReq/AirPricingCommand/AirSegmentPricingModifiers.
During an Air Booking in AirCreateReservationReq/AirPricingSolution/AirPricingInfo/
AirSegmentPricingModifiers.
By modifying an existing Universal Record in UniversalRecordModify/UniversalRecordModifyReq/UniversalModifyCmd/AirAdd/AirPricingSolution/AirPricingInfo/
AirSegmentPricingModifiers.

Response

The response includes Air Booking data with the requested FareBasisCode attribute included in AirPricingInfo.

The Fare Basis Code information from a fare quote can include:

Fare Basis Code (1 to 8 characters)
Ticket Code (1 to 10 characters to replace the Fare Basis Code or 1 to 9 characters appended to the Fare Basis Code)
Ticket Designator (1 to 8 characters) preceded by a ( / ) delimiter

Whichever combination of Fare Basis, Ticket Code and Ticket Designator is based on the filed fare preferences of the validating carrier and is still bound by the overall Industry limitation of 15 characters for the entire field.

The Fare Basis - Ticket Designator field is enhanced to dynamically place the ( / ) delimiter after the Fare Basis+Ticket Code digits, but before the Ticket Designator, thereby accommodating varying patterns of Fares.

When a Fare Basis Code is used to "force" the fares in an Air Booking or Universal Record Modify, the provider validates the rules of the code. Any rules that fail are returned as a warning in the response in /UniversalRecord/AirReservation/AirPricingInfo/FareInfo/FareRuleFailureInfo/Reason

Errors

For host consistency some providers need to internally duplicate SegmentRef data in AirSegmentPricingModifiers and Booking. If the SegmentRef sent in AirSegmentPricingModifiers is not the same as SegmentRef sent in AirPricingInfo/BookingInfo, an error is returned.

Exceptions

Worldspan