Getting started with our API

 

Thanks for trying our API. Please note that as you will see most of our services are available in the IATA NDC Schema version 16.2, while a few are still in 15.2.

The following is a list of the functions presently available in our API together with fhe evolution of improvements being released.

As you can see we are vey busy constantly working to deliver the best experience possible. We are listing to our customers and encourage you to send us your feedback and suggestions.

Release Version NDC Capabilities
R1.1 Shopping Availability & Pricing, Ordering & Issuance.
R1.2 Basic Seat Request & Baggage, Order retrieve, Order cancel & Order change (limited to contact modification)
R2.1 Post sale issuance with AirDocIssue (I) Time limit Offer info, Fare Rules, Baggage Allowances
R2.2 Credit Card payment, First SSRs, Basic Seat Map
R2.3 Full Refund of unused tickets (Voiding docuements cancelled on the same day as issue), Private Fares, Name Correction (max 3 characters), Seats & Bags post sale.
R2.4 Voluntary Changes (Date,Time and Class).  Basic Commissions in applicable markets.
R2.5 Refunds of partially used tickets. Bug fixes and performance improvements.
R2.6 Resident Discounts for Spanish Market.
R2.7 Large Family Discounts for Spanish Market and Order List
R2.8-2.15 OrderList returning by default only live Orders. 
R2.16 Reporting Service fee (for Resident and Large Family Discounts) and Duplicate names control
R2.17-2.19 Emergency Contact added and improvements handling Agengy/seller contact details.
R2.20-2.21 Cancel, split and change for some passenger in an order. Associate infant to any adults. Private Fares
R2.22 Partial cancelation (some passengers from Order).
R2.23 Refund Private Fares. Improvements in OrderChange, ItinReshop and improvements handling different currencies
R2.24 Bug fixes and performance improvements.
R2.25-2.26 Partial changes (ItinReshop and OrderChange for some passengers in Order). Improved payment error responses.
R2.27 Bug fixes and performance improvements.
R2.28 Improvements in handling cancellations and refunds, same day Voiding of E-tickets and EMD's and auto refunding to credit cards.
R2.29 Improvements in information returned for Orders modify ouside of NDC (Involuntary changes, direct with Airline).
R2.30 Retry Credit Card payment.
R2.31 Improvements in Ancillaries services
R2.32 Aditional improvements in information returned for Orders modify ouside of NDC (Involuntary changes, direct with Airline).
R2.33-2.36 Bug fixes and performance improvements.
R2.37 Separation of Private from Public Fares in AirShopping Response. 
R2.38 Improvements on the OrderViewRS when retrieving Orders that have been voluntarily or involuntarily modified from outside of NDC 

R2.39

Refunds within 24 hours of purchase of Ancillaries added to Orders in servicing flow.

R2.40

Ability for a Seller to include a simple remark up to 30 characters in the Order that is returned in all Views. Usefull for cross-referencing. Improved Ancillary Bag association.

R2.41

Inclusion of FareBasis in AirShoppingRS allowing the identification of the Additional Price Points.

R2.42

AirShopping for Cheapest using "BestPricingOption "C"". Returns only the cheapest fares for each flight solution, combining Fare Families. Kept very light by not including any disclosures.

R2.43-2.44

Various bug fixes including new errors/warnings when time-outs occur,. These can include indication that the OrderList should be used to check if  the Order has been created, or OrderRetrieve to check if the Order has been processed correctly.

R2.45

Improved handling of Code-Share services. Sales rejected if possitive acknowledgment not received from Operating carrier. 

 

Connectivity

Connection to the Iberia NDC API is via Mashery. An api key will be provided by Iberia upon request.

Which Type of connection should I have?

There are two types of connections, Direct Connect and via NDC Aggregator/Service Provider .

Direct Connection

If you are planning to connect directly to Iberia NDC API using your own implementation or one created for you by an IT Service Provider that is providing a unique service to you.

For this you will require a Mashery user and API Key to connect to our services.

**IMPORTANT NOTICE** Please ensure all messages are sent using GZIP to ensure the best possible service.

Indirect Connection

If you prefer to use a third party NDC Aggregator/Service Provider that provides the service to more than one Seller through the same connection to the Iberia NDC API, then you will still need to be registered with Iberia.

If you are looking for an NDC Aggregator/NDC Service Provider to provide you with this service you can find those certified by IATA here.

If you want to connect directly to our NDC API then download and complete the: Iberia NDC Registration form  and then send it to us.

If you do not want to connect directly with our NDC API, but you do want to sell using Iberia┬┤s NDC via an NDC Aggregator/Service Provider then use this  form and send it to us. Remember though to contact your NDC Aggregator/Service Provider first.

Register for Iberia NDC

Caution:

If you are an IATA Agency and you want to be certified to use our NDC Services it is mandatory that you develop at least the following endpoints:

  • AirShopping
  • FlightPrice
  • OrderCreate
  • AirDocIssue (To be able to sell non Instant Purchase offers without payment in OrderCreate)
  • ItinReShop
  • OrderCancel (Without OrderCancel refunds can not be processed)

Useful documentation and resources

In the following file you can find a list of all the Origin and Destinations that Iberia sell through NDC

Airline Profile

The following Quick Start Guide should help you through you implementation

Quick Start Guide

The Implementation Guide is more detailed explanation to assist in implementing Iberia´s NDC API

Release Notes And Examples which we hope will find even more helpful

Many of our implementers have found this SOAPUI Project helpful to understand how our implementation of the NDC API works.If someone requires the updated version please contact us

SoapUI Project

 

And some even asked us for a WSDL, so here it is, and again if you require the updated version please contact us

WSDL Files

We´re not perfect

Think something is missing? Got some constructive criticism? Please feel free to let us know, clicking on the "Support" link in the top menu above.