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.

attention

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

Copy
Copied
<PointOfSale>
	<Location>
		<CountryCode>US</CountryCode>
	</Location>
</PointOfSale>
<Document>
	<Name>ATPCO NDC</Name>
	<ReferenceVersion>IATA NDC 17.2</ReferenceVersion>
</Document>
<Party>
	<Sender>
		<TravelAgencySender>
			<PseudoCity>IAD</PseudoCity>
			<IATA_Number>88888888</IATA_Number>
			<AgencyID>99111222</AgencyID>
		</TravelAgencySender>
	</Sender>
</Party>
<Parameters>
	<Languages>
		<LanguageCode>en-CA</LanguageCode>
	</Languages>
	<CurrCodes>
		<FiledInCurrency>
			<CurrCode>USD</CurrCode>
		</FiledInCurrency>
	</CurrCodes>
</Parameters>

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.

Copy
Copied
<Party>
	<Sender>
		<EnabledSystemSender>
			<SystemID>SELLER NAME</SystemID>
		</EnabledSystemSender>
	</Sender>
</Party>

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.

Copy
Copied
    <PointOfSale>
        <Location>
            <CountryCode>US</CountryCode>
        </Location>
    </PointOfSale>
    <Parameters>
        <Languages>
            <LanguageCode>en-CA</LanguageCode>
        </Languages>
        <CurrCodes>
            <FiledInCurrency>
                <CurrCode>USD</CurrCode>
            </FiledInCurrency>
        </CurrCodes>
    </Parameters>

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.

Country Currency Country Currency
AR USD IT EUR
AU AUD JP JPY
CA CAD KR CAD
CH CHF MX MXN
CL USD NL EUR
CN CNY NO NOK
CO USD PA USD
DE EUR PE USD
DK DKK SE SEK
ES EUR TW TWD
FR EUR UK GBP
HK HKD US USD
IE EUR NL EUR
IL USD
attention

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 RQ Sample Value Remarks
Version 17.2 Mandatory
EchoToken 12345 Optional, used for transaction identification
TimeStamp 2011-04-28T12:48:00Z Optional, timestamp when response was built
TransactionIdentifier daadf3d1d87245a187c64fdbba9b235 Optional, echo back in response
SequenceNumbr 1 Optional, echo back in response
PointOfSale Optional
Location Point of sale location information
CountryCode US ISO 3166 country code, two - three alpha or three numeric
Document   Mandatory in schema
Name ATPCO NDC Fixed value
ReferenceVersion IATA NDC 17.2 Fixed value
Party Mandatory
Sender Mandatory
TravelAgencySender Indicates that the sender is a travel agency
AgencyID 99111222 Mandatory
IATA_Number 88888888 Identifies a travel agency or other airline ticketing entity within the IATA network
AgentUser/PseudoCity IAD Optional
Participants Optional, specifies the service provider details
Participant Participant credentials such as, Name, Category, and SystemID
EnabledSystem
SystemID 4cdcdba1 Unique NDC-Enabled system ID
Parameters Parameters that determine the overall message results; supported parameter groups such as Inventory Guarantee (offer-associated), Service Filter (offer-associated), and Pricing
Languages Primary and/or alternate language(s)
LanguageCode en-ca ISO 639-1 Code or Microsoft National Language Support (NLS) Code
CurrCodes Currency information; an airport's local currency code
FilledInCurrency
CurrCode USD ISO 4217 (three-alpha character) currency code; for example: USD