Note: This page has been deprecated. We strongly recomment you to use ShowLuggageCharges/ShowCardCharges command to obtain luggage charge, credit card charge and etc... Please contact Travelfusion API Support before making use of this functionality.
Following changes in the airline industry to separate out ancillary services as part of the booking process, the Travelfusion API now provides the cost of these ancillary services ("Air Extras") in the form of single API commands. The ancillary services include the costs of baggage, speedy (priority) boarding, meal type and online check-in, amongst others. Please note that this data must not be sold, redistributed or used for commercial gain in any way without written permission from Travelfusion.
It must be noted that the
There are two methods of obtaining the ancillary services fees via the Travelfusion API.
GetExtraServicesCharge Request: This request is to be used if you wish to get the full list of ancillary service charges for a specific supplier or for all suppliers. This XML request must not be submitted more than 3 times per day for each supplier and, by no means, submitted for each booking attempt. Please note that the response will highlight only the price calculation rules, take baggage with linear scale for instance, the price 1 bag, 2 bags, 3 bags... won't be returned, but only the fee of 1 bag will be provided, along with the linear scale property.
CalculateExtraServicesCharge Request: This request is to be used if you wish to get the ancillary service charges for a specific supplier and for a specific list of ancillary services. The response will contain the total amount attributable to the different ancillary services as well as a break down on the individual cost of the ancillary services.
The following XML command returns the full list of air extra charges offered by a specific supplier or all suppliers. By omitting the optional SupplierList element, a full list of extra services charges provided by all available suppliers can be obtained.
A detailed specification for the GetExtraServiceCharge Request and GetExtraServiceCharge Response here.
Please note that if the amount is 0, no currency would be returned.
The example above shows the extra service charge list for the specified supplier. It represents two services - baggage and online check-in.
The online check-in service is a simple type as there is a fixed fee of 5.00 GBP
However, the baggage service fee is determined based on the RestrictionList element. Until the 15th of Jul, 2010, the cost of baggage is free. After this date, the cost of 1 bag is free, while the costs of 2 bags is 5GBP and the cost of 3 bags is 15 GBP respectively. This charge can be applied to a specific flight if and only if all restrictions are met.
Regarding the charge, please note that there could be three different types:
Amount/Currency - a set value as charged by the supplier.
Percentage - value represents the percentage levied by the supplier, for that air-extra, on the total price charged.
FixedAdditionalAmount - the value represents an amount that will be charged over and above what is returned in either of the above cases.
Only one of amount and percentage is returned. FixedAdditionalAmount will be omitted if it is irrelevant. With reference to the following scenario of a particular card charge policy of a supplier:
All bookings will incur a 4.00 EUR booking fee except for bookings made by Visa electron which is free. Bookings made by Visa Credit Card, MasterCard, Diners Club, American Express, UATP/Airplus will all incur an additional fee of 2.5% of the total transaction value, but with a minimum charge of 5.00 EUR whichever is greater.
Please see the extract of a GetExtraServiceCharge response (Visa Credit only) below:
The example shows the extra service charge table of Supplier_ABC. It describes two services: baggage and online check-in. For the online check-in, it is a flat fee of 5.00 GBP. However, baggage is a bit more complex. The
The first description is for the restriction
Another notable element is the
To calculate service charges for a certain supplier, the following command should be sent:
For exact spec please see CalculateExtraServiceCharge request.
Here's an example of full