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