Airline Taxonomy Capabilities
  • Updated on 09 Oct 2019
  • 3 minutes to read
  • Contributors
  • Print
  • Dark
    Light

Airline Taxonomy Capabilities

  • Print
  • Dark
    Light

Request Services using the Airline Taxonomy

01. Requesting a Specific Service using the Airline Taxonomy

A Seller may use the Airline Taxonomy (or bilateral) to request specific products or services within the Offers to be returned. In this example, the Seller requests Offers with WIFI.

<iata:ShoppingCriteria>
	<iata:ServiceCriteria>
		<iata:TaxonomyCode>0258</iata:TaxonomyCode>
	</iata:ServiceCriteria>
</iata:ShoppingCriteria>

02. Requesting not to return Specific Services

A Seller may wish to filter the other way by specifically requesting that one or more services are not returned. In this example, the Seller requests that the Airline does not return any Offers which have alcoholic drinks included.

<iata:ShoppingCriteria>
	<iata:ServiceCriteria>
		<iata:IncludeInd>false</iata:IncludeInd>
		<iata:TaxonomyCode>0258</iata:TaxonomyCode>
	</iata:ServiceCriteria>
</iata:ShoppingCriteria>

03. Requesting Multiple Services using the Airline Taxonomy

The Seller may choose to have any Offer which contains any of the following services.

<iata:ShoppingCriteria>
	<iata:ServiceCriteria>
		<iata:TaxonomyCode>0258</iata:TaxonomyCode>
		<iata:TaxonomyCode>01F4</iata:TaxonomyCode>
	</iata:ServiceCriteria>
</iata:ShoppingCriteria>

04. Requesting Services as Bilaterally Agreed between Parties

A Seller may specifically request a service that has been bilaterally agreed between the Airline and the Sellers previously. In this example, the Seller understands that the value ZZZA is a Pet Grooming Service, which the Seller would like within the returned Offers.

<iata:ShoppingCriteria>
	<iata:ServiceCriteria>
		<iata:TaxonomyCode>ZZZA</iata:TaxonomyCode>
	</iata:ServiceCriteria>
</iata:ShoppingCriteria>
Bilateral Content
It is possible to use bilaterally agreed content, however the Airline Taxonomy can also be updated to include new items to better describe a product or service.

Responding with Services within the Airline Taxonomy

01. Responding with a Taxonomized Service

An Airline may return a Service which is described using the Airline Taxonomy. In this example, the Airline has returned Lounge as defined within the Airline Taxonomy. (Airport -> Lounge)

<iata:ServiceTaxonomy>
	<iata:DescText>Lounge Access</iata:DescText>
	<iata:TaxonomyCode>1B58</iata:TaxonomyCode>
</iata:ServiceTaxonomy>

02. Responding with multiple Taxonomies for a Service

An Airline can describe a service with multiple Taxonomies. Here, the Airline describes its Lounge as having a Shower and Internet access.

<iata:ServiceTaxonomy>
	<iata:TaxonomyCode>1BBC</iata:TaxonomyCode>
</iata:ServiceTaxonomy>
<iata:ServiceTaxonomy>
	<iata:TaxonomyCode>1BBC</iata:TaxonomyCode>
</iata:ServiceTaxonomy>

03. Responding with Bilaterally agreed Taxonomies

An Airline may not find an appropriate Taxonomy structure for its product and may choose to add its own definitions to the structure bilaterally. In this example, the Airline is offering a Pet Grooming Service onboard. They’ve used the Shared Taxonomy to describe Pet but used their own value to describe it’s a Grooming Service.

This can be done by the airline assigning a value and detailing this within its developer guidance. The Airline or Seller may, if they choose, bring this to the Standard Settings Group to add this in to the Shared Taxonomy if desired.

<iata:ServiceTaxonomy>
	<iata:TaxonomyCode>ZZZA</iata:TaxonomyCode>
</iata:ServiceTaxonomy>

04. Responding Airline Specific information around that Service

An Airline may also send additional information through a simply Key-value pair associated with a Taxonomy value. In this example, the Airline states that it has Internet (via WI-FI) and choose to further specify information around the Internet service Onboard. The Keys are values are not defined at an industry level; this is up to the Airline to use.

<iata:ServiceTaxonomy>
	<iata:DescText>Onboard Wi-Fi Internet Service</iata:DescText>
	<iata:ServiceFeature>
		<iata:CodesetCode>speed</iata:CodesetCode>
		<iata:CodesetNameCode>BILATERAL</iata:CodesetNameCode>
		<iata:ValueText>50</iata:ValueText>
	</iata:ServiceFeature>
	<iata:ServiceFeature>
		<iata:CodesetCode>altitude</iata:CodesetCode>
		<iata:CodesetNameCode>BILATERAL</iata:CodesetNameCode>
		<iata:ValueText>10000</iata:ValueText>
	<iata:TaxonomyCode>01F4</iata:TaxonomyCode>
</iata:ServiceTaxonomy>

Airlines Developer Guide

With a bilaterally agreed feature set, the airline should advise the integrators the expected Keys to be delivered within a Taxonomy, simliar to the below example.

Taxonomy Codeset Feature Key Feature Value Description
Pet Grooming Service BILATERAL MaxPetLength Double (expressed in centimeters) The maximum length of the pet which can be groomed during a flight.
Pet Grooming Service BILATERAL MaxPetHeight Double (expressed in centimeters) The maximum height of the pet which can be groomed during a flight.
Pet Grooming Service BILATERAL MaxPetWeight Double (expressed in grams) The maximum weight of the pet which can be groomed during a flight.