Airline Taxonomy

Overview

The Airline Taxonomy is a shared language for Airlines to describe their products and services to Sellers and a way for Sellers to optionally request specific features in an Offer.

 

Codeset

The Taxonomy is a hierarchy of related items which is used to convey the context of the product or service and can be found in this section.

As the Taxonomy is a hierarchy, the level of granularity can be customized, for example, by adding ‘0064' for ‘Flight' as an Airline Taxonomy, the Airline is describing that the Service is a flight, however by stipulating ‘04B0’ for 'Breakfast’, the airline is also advising that Breakfast is part of a Meal Service, which is on the Flight.

Management of the Airline Taxonomy

The Airline Taxonomy is a codeset managed by Airlines through the Standards Settings Governance. During a release, the Standards Group can add items to the Airline Taxonomy at any time through industry approval processes.

To request changes to the Airline Taxonomy, email standards@iata.org or contact a representative within the Offer & Order Group.

Airline Taxonomies at Different Levels

The Airline Taxonomy is attached at various items such as a Service, Service Definition, etc.; which potentially leads to various implementations. These below examples try to explain the preference on how the Airline may use this to appropriately describe their products and services.

  1. Offer/Order Item vs Service Level

    1. If an item relates specifically to a Service within an OfferItem/OrderItem, then the taxonomy for non-seat ancillaries should be returned at ServiceDefinition level to qualify these ancillaries.

    2. Conversely, an Airline may add an Airline Taxonomy at the level which will apply to everything with that OfferItem/OrderItem, such as Change (012C) denoting that the OfferItem/OrderItem and all services within are changeable.

  2. Consolidating Airline Taxonomies

    1. If an Offer/Order Item has three Services, and those Services all have the same Taxonomy item, which has not been derived from a ServiceDefinition, for example, Refundable (0190), the Airline may consolidate up to the Offer/Order Item Level. As this is within the Offer or Order structure.

    2. Conversely, it does not make sense to consolidate Airline Taxonomies from the Service Definition to the Offer/Order Item level as these can be derived.

Request Services using the Airline Taxonomy

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.

<OfferCriteria> <ServiceCriteria> <PrefLevel> <PrefLevelCode>Required<PrefLevelCode> </PrefLevel> <TaxonomyCode>0258</TaxonomyCode> </ServiceCriteria> </OfferCriteria>

The absence of the PrefLevel element should be interpreted in the respective offer criteria as being the equivalent of "Preferred"

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.

<OfferCriteria> <ServiceCriteria> <PrefLevel> <PrefLevelCode>Exclude<PrefLevelCode> </PrefLevel> <TaxonomyCode>06A4</TaxonomyCode> </ServiceCriteria> </OfferCriteria>

Requesting Multiple Services using the Airline Taxonomy

The Seller may choose to have any Offer which contains any of the following services. In this case they should repeat the ServiceCriteria node for each service requested. In the case below, the Seller is requesting both checked baggage and a wheelchair.

<OfferCriteria> <ServiceCriteria> <TaxonomyCode>13EC</TaxonomyCode> </ServiceCriteria> <ServiceCriteria> <TaxonomyCode>0898</TaxonomyCode> </ServiceCriteria> </OfferCriteria>

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.

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

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).

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.

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.

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 not defined at an industry level; this is up to the Airline to use.

Airlines Developer Guide

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

Taxonomy

Codeset

Feature Key

Feature Value

Description

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.

Airline Taxonomy Codeset is currently published here: https://standards.atlassian.net/wiki/spaces/EASDedit/pages/607355621