AirShopping 24.1

AirShopping 24.1

Functional Description

 

AirShopping is used to obtain availability and find Offers for specific origins, destinations and dates, for one or more passengers.

You can also specify the cabin class and the maximum number of stopovers. If you select a specific cabin, all options for that cabin will be returned. If that cabin is not available, no other options will be returned, and you will need to make a different request.

In version 24.1, the Destination (Departure) comes first, and the Origin (Arrival) comes second.

AirShopping will return the available Offers, including prices (in the local currency), terms and conditions, dates, and the requested origin and/or destination.

Flights may include those operated by the carrier (Iberia), codeshare flights, interline flights (a journey involving an agreement between airlines) and intermodal journeys (a journey involving one or more modes of transport). More information in the IATA Glossary:

 

Search options:

You can search for the following types of journeys: one-way, round-trip, multi-city, open-jaw, and point-to-point.

We recommend using the Airline Profile mechanism (list of origins and destinations) provided by Iberia.

 

Offers:

Each Offer will include two services: the transport service and a bundle service containing all the features included in the selected Offer.

You can choose from different types of requests (for example, ‘Best Pricing Option’) to get a mix of cabins/families and obtain the best Offer for each itinerary.

We offer Public and Private (Corporate and Leisure) Fares, with Multiple Price Points (MPP).

 

Terms and conditions of the Offers:

Offers have a specific Time Limit (OfferExpirationTimeLimitDateTime). When this time limit expires, a new journey search will need to be carried out, and the conditions may have changed.

Offers also have a Time Limit for payment (PaymentTimeLimitDateTime). If this period expires, a new journey search will need to be carried out, and the conditions may have change.

Finally, Offers have a Time Limit during which the journey Price is Guaranteed (PriceGuaranteeTimeLimitDateTime). If this period expires, the selected Offer may have a different price.

For Offers where the fare rule is instant purchase and there are more than four hours until departure, a two-hour payment window will be provided.

If the fare rule is instant purchase and there are fewer than four hours until departure, the payment window will not be displayed, meaning payment must be made immediately.

 

Discounts:

Frequent Flyer details from any airline can be included in this message; however, only Iberia Plus memberships will be validated if the Iberia Plus and/or OneWorld and/or LATAM membership number provided. If the validation is successful, the corresponding tier benefits will be applied. If the validation fails, the purchase process will continue and a warning will be included in the response.

Special Fares and discounts are available, such as On Business and Corporate programs.

If you are a resident of the Canary Islands, the Balearic Islands, Ceuta or Melilla, you can apply for discounted Fares offered by the Spanish Government (for Spanish Point of Sale only). If you have a large family, you can also benefit from a discount when booking a journey.

 

Inputs

Inputs

The following parameters can be used as inputs for the AirShopping service:

Mandatory:

  • Origin & Destination

  • Journey dates for outbound and inbound

  • Participant identifier (IATA number or Aggregator ID)

  • Number of passengers broken down by type ADT, CHD or INF

Optional:

  • Frequent Flyer information

  • On Business information

  • Loyalty program

  • Corporate

  • Cheapest

  • Resident information

  • Large family information

Outputs

Outputs

The following parameters are returned as outputs from the AirShopping service:

  • Fare attributes and conditions for each Offer

  • List of offers, each containing:
     

    • Total Offer price for all passengers for the requested itinerary

    • Price breakdown per passenger, including applicable base fare and surcharges.

    • Journey details such as flight number, booking class, cabin, marketing or operating segments, etc.
       

  • List of Offers for your journey, including a summary of the lowest available price.
     

  • Below are some important points about the AirShopping response structure:
     

    • Each Offer may contain different OfferItems if the passengers have different attributes (price, services included, conditions, etc)

    • Each OriginDestination list is unique from a flight segment perspective. This unique OriginDestination will have a reference ID. The OriginDestination can have multiple flight segments for connections.

AirShopping Warnings

Warning AirShopping Code

Description Text

PADIS Code

Warning AirShopping Code

Description Text

PADIS Code

NDC-200CO0001

Public fares will be applied

486

NDC-200CO0002

Public fares will be applied

486

NDC-200LY0001

Loyalty program not supported

709

NDC-200LY0002

Information for given Loyalty Account Number not found

753

NDC-200LY0003

No applicable loyalty account was found for passenger

709

NDC-200OB0001

Invalid On Business Account ID. The request continues with public fares

144

AirShopping Errors

Error AirShopping Code

Text

PADIS Code

Error AirShopping Code

Text

PADIS Code

NDC-400CB0001

Cabin preference required for Cheapest “Y” requests

486

NDC-400CB0002

Cabin preference must have “Required” level for Cheapest “Y” requests

486

NDC-400CB0003

Only one preferred cabin is accepted

486

NDC-400CB0004

Only one cabin admitted for Cheapest “Y” requests

486

NDC-400CY0001

Currency not applicable for this market

71A

NDC-400CY0002

Invalid currency code

729

NDC-400DC0001

Ordinals cannot be repeated in DistributionChain

486

NDC-400DC0002

DistributionChain links must be ordered by the Ordinal field

486

NDC-400DC0003

First DistributionChain link must be a Seller

486

NDC-400DC0004

Seller not included in DistributionChain

486

NDC-400DC0005

Only one seller allowed in DistributionChain

486

NDC-400DC0006

Multiple DistributionChain links with the same OrgID

486

NDC-400DC0007

Distribution chain link not accepted

91

NDC-400DC0008

Distribution chain link not accepted

91

NDC-400DN0004

Discount only available in ES market

72G

NDC-400DN0005

Discount only valid for Spanish domestic itineraries

130

NDC-400DN0006

Discount not valid for given routes

130

NDC-400DS0001

Wrong format for Distributor ID

914

NDC-400DS0002

Distributor ID is not valid

144

NDC-400DS0003

Distributor not valid

144

NDC-400DT0001

Departure dates for all slices must be a date in the future

102

NDC-400DT0002

Departure date for each slice must be later than the date of the previous slices

102

NDC-400DT0003

Only flights within next 360 days are available

102

NDC-400FL0001

All OriginDestID must be different

486

NDC-400GN0001

Incorrect layout at service entrance

486

NDC-400LY0001

Loyalty Account Number not provided

753

NDC-400LY0002

Airline Designator for the Loyalty Program not provided

709

NDC-400PG0001

Only one Program can be specified

795

NDC-400PG0002

Only one Program Account ID can be specified

795

NDC-400PG0003

Account ID for a program is mandatory

795

NDC-400PG0004

Program name is mandatory

795

NDC-400PG0005

Airline Designator Code of the carrier is mandatory for a program

795

NDC-400PR0001

Product not supported

349

NDC-400PR0002

Product not specified

349

NDC-400PR0003

Invalid product type

349

NDC-400PR0004

Product not available in market

349

NDC-400PR0005

Only one Fare Criteria accepted in request. Product not supported for corporates

795

349

NDC-400PR0006

Only one Fare Type Code or Fare Subtype Code accepted in Fare Criteria

795

 

NDC-400PR0007

Only “Required” Pref Level supported in Fare Criteria

795

 

NDC-400PR0008

Only one Fare Criteria accepted in request

795

NDC-400PX0001

There are many passengers with the same PaxID

476

NDC-400PX0002

Only ADT passengers can hold references to other passengers

486

NDC-400PX0003

Only INF passengers can be referenced by other passengers

486

NDC-400PX0004

Only one ADT passenger can hold reference to each INF passenger

486

NDC-400PX0005

Some of the passenger type codes are not supported. Only valid passenger types are ADT, CHD and INF

143

NDC-400PX0006

Max number of passenger per request exceeded

68

NDC-400PX0007

Number of infants exceeds maximum allowed per adult passenger

324

NDC-400PX0008

At least an adult passenger is needed in the request

486

NDC-400PX0009

Wrong format for Passenger ID

486

NDC-400PX0010

Referenced passenger does not exist

486

NDC-400RT0001

Origin and Destination must be in a different city

130

NDC-400RT0002

Invalid combination of Origin and Destination

130

NDC-400SL0001

Wrong format for Seller ID

914

NDC-400SL0002

Seller ID is not valid

144

NDC-400SL0003

Seller not valid

486

NDC-404AV0001

No offers found for given criteria

913

NDC-404PR0001

Invalid product

354

NDC-412PR0001

Product not available for the seller

349

NDC-412PR0002

Invalid itinerary for this product

465

NDC-412PR0003

Invalid Point of Commencement

465

NDC-500GN0001

An error has occurred, please try again later

486

 

New NDC Footer.png