Generic Parameter Types and HandlingCustom Supplier Parameters have been designed for generic handling. This means that in principle you do not need to implement specific code for each possible parameter, and when a new parameter is introduced you should not need to modify your code. In the cases of 'custom' and 'notice' types, these are not generic and each one must be handled in a special way. You should implement support for all parameters of type 'custom' or 'notice'. In principle, a supplier may change its functionality at any time to require a new non-generic parameter to be added and supported. These cases are very rare, but you should build your application in such a way that any unrecognised parameters are detected and the booking process halted - developers should be alerted in such cases as they will need to implement support for the parameter.
All these parameters should be supplied in a CustomSupplierParameterList, which can be supplied in the BookingProfile element at any stage of the search / booking process. Various other parameters can be supplied in the CustomSupplierParameterList that are not specified here as they will never appear in the RequiredParameterList since they are not designed for display to the user. The BookingProfile element is specified fully in the ProcessTerms Request specification.
There are 7 types of custom parameter and the type determines exactly how they should be handled:
|
| Name | Type/ Format | Description |
| DateOfBirth | formatted_text dd/mm/yyyy |
The date of birth of the traveller. If this is as a required parameter, it is strongly recommended that you submit the correct date of birth for all passengers. If you do not supply it, the booking may still be made with the supplier, but with an incorrect, estimated, or unspecified date of birth. Travelfusion takes no formal responsibility for this behaviour or its effect, but we will do our best to make sure the behaviour is appropriate. Please contact us if you have any concerns about a particular supplier. |
| PassportExpiryDate | formatted_text dd/mm/yyyy |
The passport expiry date |
| PassportCountryOfIssue | formatted_text 2 letter country code |
The passport country of issue |
| Nationality | formatted_text 2 letter country code |
The nationality of the passenger. Using 2 letter country code like "US". |
| NumberOfBags DEPRECATED |
formatted_text An integer (0 or more) |
The number of bags to be checked in No longer in use, please see the new luggage spec description: "LuggageOptions" "OutwardLuggageOptions" "ReturnLuggageOptions" |
| AgentLogin | text | The travel agent login to submit to the supplier |
| AgentPassword | text | The travel agent password to submit to the supplier |
| AgentIATANumber | text | The IATA number of the user |
| AgentIdentifier | text | The agent identifier |
| UserLogin | text | Preregistered username or username to be registered with on the supplier's system |
| UserPassword | text | Preregistered password or password to be registered with on the supplier's system |
| PassportNumber | text | The passport number |
| FrequentFlyerNumber | text | The frequent flyer number |
| AgencyInvoiceReference | text | This enables an invoice number to be supplied to the supplier for later reconciliation |
| AgencyPaymentPassword | text | This is the extra password used to identify the agency in cases where a payment account has been set up with the supplier |
| SpecifiedFareBasisCodeOutward | text | Only the outward results with the specified fare base code will be returned |
| SpecifiedFareBasisCodeReturn | text | Only the return results with the specified fare base code will be returned |
| SpecifiedRBDCodeOutward | text | Only the outward results with the RBD code will be returned |
| SpecifiedRBDCodeReturn | text | Only the return results with the specified RBD code will be returned |
| EndUserIPAddress | text | The IP address captured from the end user's terminal - i.e. the client that is using the website where the search/ booking is being made. It takes the format of an IP address - e.g 12.123.45.67. It is a mandatory requirement to submit this parameter in StartRouting and ProcessTerms XML requests to Travelfusion during the search and book process. |
| EndUserBrowserAgent | text | This is based on the User-Agent Http header, which identifies the unique browser and/or devise through which the booking was made. An example value could be - 'Mozilla/5.0 (X11; Linux x86_64; rv:12.0) Gecko/20100101 Firefox/21.0' It is a mandatory requirement to submit this parameter in StartRouting and ProcessTerms XML requests to Travelfusion during the search and book process. |
| EndUserDeviceMACAddress | text | The unique identifier assigned to the physical device on which the user attempts the booking. This is an optional element and must be submitted whenever the end user’s MAC address was captured. An example value could be - '01-23-45-67-89-ab' |
| UserData | text | Various data related to the user must be submitted here, in the ProcessTerms request. The data must be comma separated and commas in the data items must be escaped with '\', as should the '\' character. Currently, we require the end user's email address, phone number, and the card holder's name on card. For example: bob@myemail.com, +4917182828283, Mr b t blob Travelfusion reserves the right to request more items of data to be added to this list, with 3 months notice. It is a mandatory requirement to submit this parameter in ProcessTerms XML request to Travelfusion during the book process. |
| RequestOrigin | text | This must identify the origin of the original user search. Typically it will be the domain of the website they were using and the market/ country/ Point of sale - for example "France-cheaptravelling.com". Please discuss with Travelfusion if in doubt about how to complete this field. It is a mandatory requirement to submit this parameter in StartRouting and ProcessTerms XML requests to Travelfusion during the search and book process. |
| PointOfSale | text | A point can include a market/country or a region where you either have a physical/virtual presence such as a local URL and/or local language.
The value of the parameter must correspond to the following format, but must map to a specific market/point of sale at your end.
Parameter 'PointOfSale'
Value 'GB' - 2 letter ISO code.
For e.g if you have a portal in Argentina, you would map all Argentinian traffic so that we would receive a value of 'AR'
It is a mandatory requirement to this parameter in each StartRouting request (and if you do not have this data at this stage, to submit it at the ProcessTerms request) to Travelfusion during the search and book process.
|
| VoucherCode (new) | text | If the supplier supports voucher redemption, this parameter will be returned under the 'RequiredParameterList' within the ProcessDetails response: For example: <RequiredParameter> <Name>VoucherCode</Name> <Type>text</Type> <DisplayText/> <PerPassenger>false</PerPassenger> <IsOptional>true</IsOptional> </RequiredParameter> In the ProcessTerms request, the parameter is to be submitted if the user is utilising their vouchers for redemption. Please see below an extract of the ProcessTerms request. <CustomSupplierParameter> <Supplier>xxx</Supplier> <Name>VoucherCode</Name> <Value>******</Value> </CustomSupplierParameter> Depending on the amount of the voucher vs the booking cost, the ProcessTerms response, could look like the following extracts: E.g If the booking price was 3,627 INR, whilst the voucher amount was 4000 INR <Price> <Amount>0.00</Amount> <Currency>INR</Currency> <TaxItemList> <TaxItem> <Name>Voucher Redemption</Name> <Amount>-3627.00</Amount> <Currency>INR</Currency> </TaxItem> </TaxItemList> </Price> If, however, the booking price was 3,627 INR, while the voucher amount was 3000 INR <Price> <Amount>627.00</Amount> <Currency>INR</Currency> <TaxItemList> <TaxItem> <Name>Voucher Redemption</Name> <Amount>-3000.00</Amount> <Currency>INR</Currency> </TaxItem> </TaxItemList> </Price> Notice, the negative sign in the Voucher Redemption amounts above. |
| VoucherActivationCode (new) | text | If supplier also requires activation code in addition to the VoucherCode, this parameter will be returned under the 'RequiredParameterList' within the ProcessDetails response: For example: <RequiredParameter> <Name>VoucherActivationCode</Name> <Type>text</Type> <DisplayText/> <PerPassenger>false</PerPassenger> <IsOptional>true</IsOptional> </RequiredParameter> In the ProcessTerms request, the parameter is to be submitted if the user is utilising their vouchers for redemption. Please see below an extract of the ProcessTerms request. <CustomSupplierParameter> <Supplier>xxx</Supplier> <Name>VoucherActivationCode</Name> <Value>******</Value> </CustomSupplierParameter> Note: We recommend your application should always dynamically parse the ProcessDetails response in order to determine which of the above optional parameters i.e. "VoucherCode" and "VoucherActivationCode" are to be submitted and in what format. |
| SpeedyBoarding | boolean | Indicates whether speedy boarding should be requested from the supplier |
| OnlineCheckinWithEUPassportOrId | boolean | Requests online check-in from the supplier. The user will need to check in via the supplier's website. 'Hand luggage only. EU passport/ id only. |
| ListFareBasisCode | boolean | Indicates whether fare base code should be listed in CheckRoutingResponse |
| ListRBDCode | boolean | Indicates whether RBD code should be listed in CheckRoutingResponse |
| IncludeAlternativeFares | boolean | Indicates if alternative fares, for the selected flights, are to be returned within ProcessDetails response. Can be submitted either in StartRouting or ProcessDetails API call. |
| IncludeStructuredFeatures | boolean | Indicates if the various features airlines support are to be returned within CheckRouting response. Can be submitted in StartRouting API call. |
| SubscribeToSupplierMarketingInfo | boolean | Indicates whether marketing information should be received from the airline |
| SCACorporateExempt (new) | boolean | Specifies if the payment is done with a corporate card and on secure corporate channels, marking the transaction as being SCA exempt. Please submit this CSP at StartBooking request with value 'true', see example below: XML extract: <CustomSupplierParameter> <Supplier>*****</Supplier> <Name>SCACorporateExempt</Name> <Value>true</Value> </CustomSupplierParameter> |
| UseMOTOPaymentWithSupplier (new) | boolean | Specifies if the payment transaction is MOTO, we will return this CSP in our ProcessDetails response for the airlines who support MOTO. Please submit this CSP at ProcessTerms request with value 'true', see example below: XML extract: <CustomSupplierParameter> <Supplier>*****</Supplier> <Name>UseMOTOPaymentWithSupplier</Name> <Value>true</Value> </CustomSupplierParameter> |
| CO2Emissions | boolean | Specifies if the CO2 Footprint will be returned. 'CO2Emissions' is an optional xml element, can be triggered by specifying in the StartRouting request. Example: ... <BookingProfile> <CustomSupplierParameterList> ... <CustomSupplierParameter> <Name>CO2Emissions</Name> <Value>true</Value> </CustomSupplierParameter> ... </CustomSupplierParameterList> </BookingProfile> ... We will return xml element 'CO2EmissionsTonnes' in the CheckRouting response, it's value is corresponding to the carbon footprint (in metric tonnes) of all the passengers of a specific leg (all segments included). Example: <Duration>150</Duration> <CO2EmissionsTonnes>0.625</CO2EmissionsTonnes> <SegmentList> |
| MealType | value_select | Specifies which type of meal the end user requires. |
| CheckInType | value_select | Specifies which type of Check-in the end user requires. |
| InsuranceType | value_select | Specifies which type of insurance the end user requires. |
| FrequentFlyerType | value_select | Specifies which type of frequent flyer club the end user requires. |
| LuggageOptions | value_select | Specifies the available Luggage options that can be purchased within a booking. An option denotes a combination of number of bags, their weight and its cost. For example: 'Please Select Luggage Option: 1 (1 bags - 15Kg total - 25.00 EUR), 2 (1 bags - 20Kg total - 35.00 EUR), 3 (2 bags - 15Kg+15Kg - 50.00 EUR), 4 (2 bags - 15Kg+20Kg - 60.00 EUR), 5 (3 bags - 50Kg total - 90.00 EUR)' Using the above example, by selecting option:
Depending on the booked airline, luggage selection can be either on per leg basis or for the entire booking. If the latter, this parameter will be returned, otherwise the selection will be broken down using the following parameters: 'OutwardLuggageOptions' and 'ReturnLuggageOptions'. Please note that on a round-trip booking with luggage selection on per leg basis where only one of 'OutwardLuggageOptions' and 'ReturnLuggageOptions' is submitted, bags will be purchased just for the requested leg of the booking. To preserve backward compatibility, this parameter (or its leg-based derivatives) will not be returned unless explicitly requested. If you wish to use it, as opposed to the existing parameters (NumberOfBags and BaggageWeight), please contact Travelfusion. Alternatively, just for testing purposes, you can submit the 'UseNewLuggageFramework' Custom Supplier Parameter with value 'true' at StartRouting which will activate it for the particular search. Please note luggage is not supported on supplier 'hubrouting', please refer to ''NumberOfBags'' in StartRouting and "PriceWithLuggage" in CheckRouting for further information. Hub Routing provides virtual interlined results where the traveller can change from one airline to another to reach their destination. Your application is expected to parse and display the values to the user, so that the corresponding value of the chosen option can be submitted back in the XML request - this includes any option that is presented as free of charge. |
| OutwardLuggageOptions | value_select | Specifies the available Luggage options that can be purchased for the outward leg of the booking. For more information please see 'LuggageOptions' parameter. Please note that if this parameter is missing completely, it should not be assumed that a default bag is included in any of the fare types. Please note luggage is not supported on supplier 'hubrouting', please refer to ''NumberOfBags'' in StartRouting and "PriceWithLuggage" in CheckRouting for further information. Hub Routing provides virtual interlined results where the traveller can change from one airline to another to reach their destination. Your application is expected to parse and display the values to the user, so that the corresponding value of the chosen option can be submitted back in the XML request - this includes any option that is presented as free of charge. |
| ReturnLuggageOptions | value_select | Specifies the available Luggage options that can be purchased for the return leg of the booking. For more information please see 'LuggageOptions' parameter. Please note that if this parameter is missing completely, it should not be assumed that a default bag is included in any of the fare types. Please note luggage is not supported on supplier 'hubrouting', please refer to ''NumberOfBags'' in StartRouting and "PriceWithLuggage" in CheckRouting for further information. Hub Routing provides virtual interlined results where the traveller can change from one airline to another to reach their destination. Your application is expected to parse and display the values to the user, so that the corresponding value of the chosen option can be submitted back in the XML request - this includes any option that is presented as free of charge. |
| FlightExtras | value_select | The following features are supported here: GolfBag, Skis, MusicalInstrument, Bike, SpecialAssistance NOTE, only one of these can be selected for a each passenger. An example of the Display Text format is below: Please Select Flight Extras Options: Bike (Bike - 60.00 GBP), MusicalInstrument (Musical Instrument - 50.00 GBP), Skis (Skis - 40.00 GBP), GolfBag (Golf Bag - 30.00 GBP) This format will be maintained, so if you wish, you may parse out the price and use this to dynamically update the displayed total price when the user selects an option. |
| ReducedMobilityAssistance | multi_select | Specifies which types of mobility assistance are supported. NOTE: multiple items can be selected for each passenger. An example of the Display Text format is below: Specifies the options for travellers with reduced mobility: WCHS (Wheelchair to aircraft cabin - 0.00 CNY), DEAF (Accompanied by a service animal for deaf traveller - 0.00 CNY), WCHR (Wheelchair to aircraft stairs - 0.00 CNY), WCHC (Wheelchair to aircraft cabin seat - 0.00 CNY), BLND (Accompanied by a service animal for blind traveller - 0.00 CNY |
Parameters With Type 'Custom'
| Name | Type | Description |
| BaggageWeight DEPRECATED |
custom | Similar to a value_select parameters, but the items listed for selection by the user may consist of the weight of baggage only, or both weight of baggage and number of bags, e.g.: "Please Select Baggage Weight : 1(1bags-15Kg),2(1bags-20Kg),3(1bags-23Kg),4(2bags-40Kg) Only one of 'NumberOfBags' and 'BaggageWeight' can be submitted at a time. No longer in use, please see the new luggage spec description: "LuggageOptions" "OutwardLuggageOptions" "ReturnLuggageOptions" |
| SeatOptions | custom | This is a compound select. After the
first colon, there is a seating list for each flight with all available
attributes. The flights are separated by ','. Each flight has a flight
number and then followed by a "-" separated seat numbers. all other attributes are listed in the "()". For example: "Please Select Seat Options:5477-1A(W|E|1A@12.00GBP@319), 5477-1B(N|E|1A@12.00GBP@319)," Therefore multiple drop down lists will need to be displayed to the user. Find more details here |
| UseCardPreRegisteredWithSupplier | custom | Indicates that the supplier supports preregistered cards. In order to use a pre-registerd card, this should be submitted with value 'true'. You will still need to supply a card in the BookingProfile, but it will not be used for the payment, so a dummy card number should be used. |
| BookingOnHold | custom | Indicates that
the supplier supports the function of booking on hold. In order to achieve this, this should be submitted with value 'true'. |
| UseTFPrepay | custom | Indicates that the supplier supports TF.Prepaid for this booking. If TF.Prepaid is required for this booking, submit with value 'Always' or 'WhenApplicable', Using this service requires the customer to enter into a special agreement with TF. Please see detailed spec under 'Guidelines'. |
Parameters With Type 'Notice'
| Name | Type | Effect |
| FullCardNameBreakdown | notice | If specified, the Name on the card must be specified in full detail. See the NameOnCard element in the ProcessTerms Request. |
| PostCode | notice | If specified, a postcode must be supplied in all addresses for this booking. |
| BillingAddress | notice | If specified, a billing address must be submitted for this booking (the Address element within the BillingDetails section of the booking profile.) |
| CardSecurityNumber | notice | If this is specified, the SecurityCode field in the ProcessTerms Request must be submitted (it is recommended to always submit it anyway where possible). |
| CardStartDate | notice | If specified, the StartDate field in the ProcessTerms Request must be submitted. (it is recommended to always submit it anyway if possible.) |
| ChildrenAndInfantsSearch | notice | If this is specified, you may search for children and infants for this supplier. Otherwise, only adults are supported. |
| ChildrenAndInfantsBooking | notice | If this is specified, you may book for children and infants for this supplier. Otherwise, only adults may be booked. |
| DateOfBirthIsNotRequiredForAdults | notice | In some of the cases where 'DateOfBirth' is returned as a required parameter, DateOfBirthIsNotRequiredForAdults may also be returned, indicating that it is only required for children and infants. |
| SpecialFamilyAncillaryDiscounts | notice | - There are 50% discounts of checked bags, allocated seats, priority boarding and travel insurance for up to a maximum of 2 children when 1 accompanying adult included in the same reservation purchases the corresponding fully priced item. - There are 50% discounts of checked bags, allocated seats, priority boarding and travel insurance for up to a maximum of 4 children when the 2 accompanying adults included in the same reservation, purchase the corresponding fully priced item. - Adults and children must be booked in the same reservation to receive the family discount. - These discounts will not be reflected in the prices returned by our API at the availability and pricing step. It is necessary to apply them within your application according to the logic described above. At the ProcessTerms, such discounts will be reflected accordingly. |
| TitlesSupported | notice | If specified, each title element in ProcessTerms XML request must have one of the values specified in a comma separated list (if not specified, default supported list is Mr,Mrs,Miss). <RequiredParameter> <Name>TitlesSupported</Name> <Type>notice</Type> <DisplayText>Mr,Ms,Mrs,Miss,Dr</DisplayText> <PerPassenger>false</PerPassenger> <IsOptional>true</IsOptional> </RequiredParameter> |
| ProvinceOptions | notice | If specified, this parameter provides the supported provinces applicable to each country. Each country's province-set is wrapped in parenthesis and separated from each other by a comma. Within the parenthesis each province of a country is separated from others by semi-colon, where the identifier and name of a province is separated by a hyphen. If this parameter is present in the ProcessDetails response, your system must submit the province identifier corresponding to the country of the user's contact/billing address, in the ProcessTerms request.<DisplayText>AU(AC - Australian Capital Territory; VI - Victoria; NS - New South Wales),IT(PR - Parma &#40PR&#41; PT - Pistoia &#40PT&#41; PU - Pesaro-Urbino &#40PU&#41)</DisplayText> |
Please check here the Custom Supplier Parameters used by each airline.
[For reference only, previous (deprecated) notes are provided here]