Accessing Airline Content

NDC Solutions source code provides airlines and sellers a means of connecting via a single API. There are two types of sellers accessing airline content via NDC, IATA/ARC (Airline Reporting Corporation) Accredited seller (also known as, agency-driven flow) and Non-IATA/ARC Accredited seller (also known as, consumer-driven flow).

IATA/ARC Accredited

For requests for airline content from IATA/ARC Accredited sellers, IATA_Number and AgencyID must be provided in each request, as shown in the XML code snippet below. IATA_Number determines the location and currency to be applied. AgencyID is the assigned identification number for a specific travel agency and can be an IATA or non-IATA number.

Sellers are issued specific test credential codes for the sandbox (i.e., test environment) by the airline. Do not use any IATA codes that are used in the provided examples. In a production environment, sellers use their accredited IATA code(s).

Non-IATA/ARC Accredited

For requests for airline content from Non-IATA/ARC Accredited sellers, IATA_Number should not be included in the request, as shown in the XML snippet below.

CountryCode is required for the Non-IATA/ARC Accredited seller and defines the currency, as seen in the below XML code snippet. The ability to change the currency (i.e., override) for the Non-IATA/ARC Accredited seller is based on CountryCode, which must be the same throughout the entire workflow (e.g., AirShopping through OrderCancel). CountryCode is not required for the IATA/ARC Accredited seller.

There are a limited number of currencies and country codes supported by the Non-IATA/ARC Accredited seller (see the Country and Currency table below). Currency codes and country codes not included in the below table will result in errors. Permitted currencies are associated with your airline's credentials.

CountryCurrencyCountryCurrency
ARUSDITEUR
AUAUDJPJPY
CACADKRCAD
CHCHFMXMXN
CLUSDNLEUR
CNCNYNONOK
COUSDPAUSD
DEEURPEUSD
DKDKKSESEK
ESEURTWTWD
FREURUKGBP
HKHKDUSUSD
IEEURNLEUR
ILUSD

Not including required information throughout the NDC workflow will result in errors. For example, the same IATA_Number and CountryCode should be used throughout your message requests.

IATA NDC Message

The below values represent the general structure for IATA 17.2 supported messages.

IATA NDC Message RQSample ValueRemarks
Version17.2Mandatory
EchoToken12345Optional, used for transaction identification
TimeStamp2011-04-28T12:48:00ZOptional, timestamp when response was built
TransactionIdentifierdaadf3d1d87245a187c64fdbba9b235Optional, echo back in response
SequenceNumbr1Optional, echo back in response
PointOfSaleOptional
LocationPoint of sale location information
CountryCodeUSISO 3166 country code, two - three alpha or three numeric
DocumentMandatory in schema
NameATPCO NDCFixed value
ReferenceVersionIATA NDC 17.2Fixed value
PartyMandatory
SenderMandatory
TravelAgencySenderIndicates that the sender is a travel agency
AgencyID99111222Mandatory
IATA_Number88888888Identifies a travel agency or other airline ticketing entity within the IATA network
AgentUser/PseudoCityIADOptional
ParticipantsOptional, specifies the service provider details
ParticipantParticipant credentials such as, Name, Category, and SystemID
EnabledSystem
SystemID4cdcdba1Unique NDC-Enabled system ID
ParametersParameters that determine the overall message results; supported parameter groups such as Inventory Guarantee (offer-associated), Service Filter (offer-associated), and Pricing
LanguagesPrimary and/or alternate language(s)
LanguageCodeen-caISO 639-1 Code or Microsoft National Language Support (NLS) Code
CurrCodesCurrency information; an airport's local currency code
FilledInCurrency
CurrCodeUSDISO 4217 (three-alpha character) currency code; for example: USD