Fee Assessment
Fee Assessment fields for Policies
This feature can be enabled in the API request by including:
Overview
This feature allows clients to extend their refundability UTA attribute response with additional policy information to assess the refund penalty for the requested itinerary. This feature will show the field called fee_assessment inside the cancellation object. The data for these fields are based on the filed fare policy data in Category 33.
This feature only provides additional details for clients to calculate the overall refund fees for a cancellation, should they decide to assess it. Below shows the information for clients to use the fee assessment values to determine the resulting fees.
Voluntary Refunds Penalty Fees
Once refund policy information is returned in the API for each fare component, including fee application details, the data in the Fee Assessment object will specify how to assess the refund fee.
Cancellation values
| Field Name | Possible Values |
|---|---|
| assessment | F = Fare Component P = Pricing Unit J = Journey S = Sum of Nonref + highest penalty N = Nonref if at least one fare component is nonref |
| hierarchy | X = Least Restrictive M = Most Restrictive |
Fee Assessment Values Processing
Penalty Assessment
The assessment field specifies how the total penalty amount should be assessed. Penalty data is validated across all fare owning carriers on the ticketed journey.
Per fare component (value F)
The penalty amount is assessed for each fare component being validated. When the penalty amount is expressed as a percentage, the percentage is applied to the value of the fare component. When the fare component is nonrefundable, then the penalty is 100% of the value of the fare component. The total penalty amount is the sum of all fare component penalty amounts.
Highest in Pricing Unit (value P)
Processing compares the penalties for all fare components governed by all carriers in the pricing unit encompassing the fare component being validated. The highest of all penalty amounts is assessed for that pricing unit. Only one penalty amount will be assessed for the pricing unit.
- When the penalty amount is expressed as a specified amount, take the highest amount on the pricing unit.
- When the penalty amount is expressed as a percentage, the percentage is applied to the total base fare for the pricing unit (total value of the pricing unit). When nonrefundable, then the penalty is 100% of the total value of the pricing unit.
- When there is a mixture of highest percentage and highest amount within the pricing unit, calculate the highest percentage on the total fare for the pricing unit and compare the result to the highest specified amount, and then take the higher of those two figures.
The total penalty amount is the sum of all pricing unit penalty amounts.
Highest in Journey (value J)
Processing compares all penalty amounts for all fare components on the journey. Only the highest penalty amount across all fare components will be assessed for the entire journey.
- When the penalty amount is expressed as a specified amount, take the highest amount on the journey.
- When the penalty amount is expressed as a percentage, the percentage is applied to the total base fare for the journey (total value of the journey). When nonrefundable, then the penalty is 100% of the total value of the ticketed journey.
- When there is a mixture of highest percentage and highest amount, calculate the highest percentage on the total fare for the journey and compare the result to the highest specified amount, and then take the higher of those two amounts.
The total penalty amount is the highest penalty amount on the journey.
All nonrefundable fares plus highest penalty (value S)
Processing will add up the penalty amount for all nonrefundable fare components and the highest penalty amount among all refundable fare components.
- When nonrefundable, then the penalty is 100% of the value of the fare component. Add up all penalty amounts that equal 100% of the fare component. Compare all remaining penalty amounts expressed as a specified amount or a specified percentage and add the highest amount to the sum of nonrefundable penalty amounts.
The total penalty amount is the sum of all nonrefundable fare component amounts plus the highest penalty amount among all other fare components. If there are no nonrefundable fares, the total penalty amount is the highest penalty amount on the journey (same processing as value J).
Nonrefundable if at least one fare is nonrefundable (value N)
Processing compares all penalties for fare components governed by all carriers on the journey. If at least one fare component is nonrefundable, then the penalty is 100% of the total value of all fare components.
The total penalty amount is 100% of the total value of the journey.
When there is a mix of penalty assessment values, apply the hierarchy as indicated in Penalty Assessment Hierarchy.
Penalty Assessment Hierarchy
The Penalty Assessment Hierarchy (hierarchy field) indicates whether the most restrictive or least restrictive hierarchy should be applied when the assessment field values are not the same for all fare components on the previous ticket. If there is a mix of most restrictive (value M) and least restrictive (value X) hierarchy for the different fare components on the ticket, processing will apply the most restrictive hierarchy.
The most restrictive hierarchy is determined with the following steps:
1. Are any fare components coded with byte 135 = N?
a) If yes, value N will be applied.
b) If no, continue to the next step.
2. Are any fare components coded with byte 135 = F?
a) If yes, value F will be applied.
b) If no, continue to the next step.
3. Are any fare components coded with byte 135 = S?
a) If yes, value S will be applied.
b) If no, continue to the next step.
4. Are any fare components coded with byte 135 = P?
a) If yes, value P will be applied.
b) If no, value J will be applied.
The least restrictive hierarchy is determined with the following steps:
1. Are any fare components coded with byte 135 = J?
a) If yes, value J will be applied.
b) If no, continue to the next step.
2. Are any fare components coded with byte 135 = P?
a) If yes, value P will be applied.
b) If no, continue to the next step.
3. Are any fare components coded with byte 135 = S?
a) If yes, value S will be applied.
b) If no, continue to the next step.
4. Are any fare components coded with byte 135 = F?
a) If yes, value F will be applied.
b) If no, value N will be applied.