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 Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:HTTP Header'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Language, Version and Name Space'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Point of Sale and Document'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Point of Sale and Document'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Party Elements'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Party Elements'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Party Elements'. Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Preferences - AirShopping'. |
In addition to the Common Sections, this service is called with the following data:
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 | 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. |
Can, optionaly, indicate flight, fare and cabin preferences.
ShoppingPreferences Error rendering macro 'excerpt-include' : No link could be created for 'Shopping Preferences'. |
|---|
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'. |
Metadata Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Metadata'. |
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>
For further information about all kind of error messages, please go to the following link:
Error Codes
