Release 2023.16

Examples of messages with complete flows can be downloaded from here.

This service is used to request priced availability for flights for the requested origin and destination, date and cabin. The service also returns priced availability for the next higher cabins (normally the next 2 higher cabins). Example, if the availability is requested for Economy, service will return priced availability for Economy, Premium Economy and Business (assuming these cabins are offered on the route requested).

The V1 version which uses the Fare Family concept, and the FareDetail information is limited to certain pricing information. We strongly recommend you migrate to use the V2 version based on Branded Fares.

The V2 version, takes advantage of ATPCo Branded Fares, which includes product attributes filed with the fares. This version of our AirShopping message also includes various improvements in quality of information, such as: Penalty attributes indicating whether there is a penalty charged for either a change, refund or cancel of the booking; and Baggage Allowance information; and cabin information for each flight segment.

The AirShoppingRQ message is made up of the following sections:

New or modified element

To be removed/deprecated

Unique to v2 - Branded Fares

Unique to V1 - Fare Families

Common Sections

HTTP Header

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:HTTP Header'.

Language, Version and Name Space

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Language, Version and Name Space'.

Point of Sale

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Point of Sale and Document'.

Document

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Point of Sale and Document'.

Party

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Party Elements'.

Shopping Preferences

Error rendering macro 'excerpt-include' : No link could be created for 'NDC2:Shopping Preferences'.

In addition to the Common Sections, this service is called with the following data:

CoreQuery

This is the principal part of the AirShoppingRQ, whose main elements are the Origin (Departure) and Destination(Arrival) Cities/Airports and departure date.

CoreQuery

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
*<CoreQuery / OriginDestinations> (see footnote )**
OriginDestination Attribute OriginDestinationKey	ID for the Origin/Destination	Alphanumeric	This attribute can be filled with any value, but first character cannot be a number digit or a special character.
OriginDestination / Departure / AirportCode	IATA 3 character code for the departure city/airport/station	3 Alphanumeric	Any valid departure point listed in the AirlineProfile.
OriginDestination / Departure / Date	Date of departure	Date (yyyy-MM-dd)	Any future date
OriginDestination / Arrival / AirportCode	IATA 3 character code for the arrival city/airport/station	3 Alphanumeric	Any valid arrival point listed in the AirlineProfile.

*Round trip on same day - The order of the OriginDestinations will be inferred from the order they are received in the AirShoppingRQ when the dates are the same.

DataLists - PassengerList

This is where you specify the number of passengers and their type

PassengerList

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:PassengerList'.

Datalists - Metadata

Metadata

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Metadata'.

Example AirShoppingRQ:

XML Sample

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <AirShoppingRQ Version="5.000" PrimaryLangID="es" xmlns="http://www.iata.org/IATA/EDIST/2017.2">
         <PointOfSale>
            <Location>
               <CountryCode>ES</CountryCode>
            </Location>
         </PointOfSale>
         <Document>
            <ReferenceVersion>5.000</ReferenceVersion>
         </Document>
         <Party>
            <Sender>
               <CorporateSender>
                  <ID>XXXXXXXX</ID>
               </CorporateSender>
            </Sender>
            <Participants>
               <Participant>
                  <TravelAgencyParticipant SequenceNumber="1">
                     <Name>NDC Agency Name</Name>
                     <Contacts>
                        <Contact>
                           <EmailContact>
                              <Address>email@email.com</Address>
                           </EmailContact>
                           <PhoneContact>
                              <Application>BUSINESS</Application>
                              <Number>#########</Number>
                           </PhoneContact>
                           <Name>
                              <Surname>MartÌnez</Surname>
                              <Given>Pepe</Given>
                           </Name>
                        </Contact>
                     </Contacts>
                     <IATA_Number>XXXXXXXX</IATA_Number>
                     <AgencyID>XXXXXXXX</AgencyID>
                  </TravelAgencyParticipant>
               </Participant>
            </Participants>
         </Party>
         <CoreQuery>
            <OriginDestinations>
               <OriginDestination OriginDestinationKey="IDA">
                  <Departure>
                     <AirportCode>MAD</AirportCode>
                     <Date>2022-04-25</Date>
                  </Departure>
                  <Arrival>
                     <AirportCode>PAR</AirportCode>
                  </Arrival>
               </OriginDestination>
               <OriginDestination OriginDestinationKey="VUELTA">
                  <Departure>
                     <AirportCode>PAR</AirportCode>
                     <Date>2022-04-30</Date>
                  </Departure>
                  <Arrival>
                     <AirportCode>MAD</AirportCode>
                  </Arrival>
               </OriginDestination>
            </OriginDestinations>
         </CoreQuery>
         <Preference>
            <FlightPreferences>
               <Characteristic>
                  <DirectPreferences>0</DirectPreferences>
               </Characteristic>
            </FlightPreferences>
            <PricingMethodPreference>
               <BestPricingOption>C</BestPricingOption>
            </PricingMethodPreference>
         </Preference>
         <DataLists>
            <PassengerList>
               <Passenger PassengerID="Pasajero1">
                  <PTC>ADT</PTC>
               </Passenger>
               <Passenger PassengerID="Pasajero2">
                  <PTC>ADT</PTC>
               </Passenger>
               <Passenger PassengerID="Pasajero3">
                  <PTC>ADT</PTC>
               </Passenger>
            </PassengerList>
         </DataLists>
         <Metadata>
            <Other>
               <OtherMetadata>
                  <CurrencyMetadatas>
                     <CurrencyMetadata MetadataKey="EUR"/>
                  </CurrencyMetadatas>
               </OtherMetadata>
            </Other>
         </Metadata>
      </AirShoppingRQ>
   </soapenv:Body>
</soapenv:Envelope>

Error messages

For further information about all kind of error messages, please go to the following link:

Error Codes