New Documentation Pages Structure

Following much constructive feedback from our users, the documentation explaining our NDC messages and their structure has been updated and improved. With the objective of making the pages simpler and more user friendly.

Those message elements, such as Language, Party, Datalists, etc., which repeat across multiple messages have been combined into one Common Sections, with links from the pages of those Services (AirShopping, OfferPrice, OrderView, etc.) that use the elements.

The separate documentation published for each of the two versions (v1 Fare Families, and v2 Branded Fares) has been combined with the differences between the two versions highlighted.

We hope you find the new documentation easier and clearer to use. We encourage you to send any suggestions of improvement to IBNDC.Onboarding@iberia.es

New FAQs page

In order to improve, Iberia NDC has created a Frequently Asked Questions (FAQs) page.

This page allows you to resolve doubts and reduces time from calling the Call Center or writing more emails.

See the New FAQs page.

Unspecified Gender

Iberia NDC now allows you to not specify the gender of the passenger.

When gender is selected, you can choose between the following option: “male”, “female” and “unspecified”.

Note that this information is update in the PassengerList.

IATA Delegation

Similar to the legacy concept known as “Extended Office Security”, “Branch Access” or “Bridging”, this functionality allows one IATA Travel Agent to access and service another IATA Travel Agents bookings. Both IATA Travel Agents must be using the same Aggregator, who must have the necessary functionality in place to manage the security. Do you want to learn more? Visit IATA Delegation page here.

Sports baggage inclusion in OrderChange (Private product)

As previously announced, the purchase of the Sport product was available in instant purchase scenarios and On-Hold flows.

It is now also possible to include these equipments in Post-Sale scenarios.

Please, visit our updated Sport Product page for a comprehensive definition of how to request this product and examples, along with our also recently updated Warning and Error Messages page.

Special Services Request (SSR) Update

From today, Special Services can be requested through the ServiceList flow (formerly, only through the OfferPrice flow).

The applicable SSR Codes (which have not been modified), that you can include as and when required, are taken from this table.

To request an SSR it should be included in the ServiceListRQ message as a Qualifier, as displayed in the example below:

<Qualifier>
	<SpecialNeedQualifiers>
		<Code>BLND</Code>
	</SpecialNeedQualifiers>
</Qualifier>

To learn more about how to request SSRs Services and for updated examples, please visit our Special Service Request page, along with the subpage for Error Messages

Humanitarian and Marine Products

Within our Spanish Discounts and Private Fares page, we have created a page for our new HUMANITARIAN and MARINE products, which is a separate private product coexisting with the purchase other Ancillaries.

To correctly request these products:

For Humanitarian product, the NGO Organization Name is the applicable element.
For Marine product, the name of the vessel or platform, along with the Country it is registered to, need to be included.

This information must be inserted in the InstructionList section within the DataLists, whose values will be displayed within the Remark section as shown below:

<DataLists>
<...>
	<InstructionsList>
		<Instruction listKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>HUMN/NACIONES UNIDAS</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>
</DataLists>

<DataLists>
<...>
	<InstructionsList>
		<Instruction listKey="Instruction_1">
		<FreeFormTextInstruction>
			<Remark>SEMN/Vessel Name/Country</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>
</DataLists>

By visiting our new Humanitarian and Marine Products page you will find examples along with the permitted format for each product. You will also find warning scenarios examples in our Warning Messages subpage.

Free Seats booking in On-Hold Orders

As known, the purchase of any of our Ancillaries on Unpaid (On-Hold) Orders is not permitted, and it is only available in the Pre-Sale flow.

We have, however, developed the opportunity to book free Seats on Unpaid orders, being this option available from today.

Please, note that adding Seats, including free Seats, to Unpaid orders in Post-Sale servicing flows is still not allowed.

We have updated our “Seats” page accordingly.

Sport Product

Within our Spanish Discounts and Private Fares page, we have created a page for our new SPORT product, which is a separate private product, coexisting with the purchase of Sporting Equipment Ancillaries.

This product includes sporting equipment (Surf, Scuba, and Fishing) that cannot be purchased as an Ancillary, and it can be requested in the InstructionList section within the DataLists:

By visiting our new Sport Product page you will find examples along with warning scenarios (which are located in the Warning Messages subpage).

Hola Madrid

Our Spanish Discounts and Private Fares page has been updated with information about the Hola Madrid stopover product, not combinable with any Corporate or Private Leisure Fares.

For further information about this product, please visit Iberia’s Stopover Hola Madrid page.

New Ancillary - Sporting Equipment

In addition to the 23kg, 15kg and 32kg baggage weights (explained in our Bags page), and the Priority Boarding service, Sporting Equipment options will be offered by Ancillaries through our NDC Channel.

Following, the three available options:

Golf Equipment
Bicycle Equipment
Ski Equipment

Please, note that the purchase of Sporting Equipment is only available in the Pre-Sale flow. Likewise, on Unpaid (On-Hold) Orders it is not permitted.

To successfully request Sporting Equipment ancillaries, the Sub Code, Group, and Sub Group will appear as follows:

From ServiceListRQ:

And from ServiceListRS, where price and details can also be found:

For further examples and descriptions of this new Ancillary, please visit our Sporting Equipment page.

New Ancillary - Priority Boarding Service

Regardless of the assigned boarding group, passengers are now allowed to purchase a Priority Boarding service.

This Ancillary can be purchased by flight and passenger, it is not necessary, thus, to extend the Service to the whole booking.

Presently, the purchase of Priority Boarding on Unpaid (On-Hold) Orders is not permitted, and it is only available in the Pre-Sale flow

In order to correctly trigger the Priority Boarding Service, the Sub Code, Group, and Sub Group will appear as follows:

From ServiceListRQ:

And from ServiceListRS:

For further examples and descriptions of this new Ancillary, please visit our Priority Boarding page.

New Upsell Offers

In the OfferPriceRS it is now possible to Upsell offers higher than the requested. It is necessary to obtain an Offer combining the cheapest available Fare Families in the AirShopping response to obtain this Upsell option.

It should also be noted that this enhancement requires no changes in schema.

In order to correctly trigger the Upselling process, the following parameters must be included in the OfferPriceRQ: Parameters refs="IncludeUpsellOffers" and PriceMetadata MetadataKey="IncludeUpsellOffers", which will be displayed as follows:

New Ancillary Bags of 15 and 32 kgs

In addition to the 23kg bags you can now purchase bags of 15 and 32 kgs. The ServiceFilter/GroupCode “BG” must be included in the ServiceListRQ…

Now activated in the pre-sale flow (servicing flow will be released later).

The format of the ServiceDefinitionRef in the ServiceListRS will be different since it will include the amount of kg as well as the number of ExtraBags:

“BAGSERVICE-” + amount of kg + “-” + number of extra pieces

In the following example, ServiceList is showing an Offer along with the bag’s weight (15 kg in this case, “BAGSERVICE-15-1”):

In case we would like to select any other available option, ServiceDefinitionRef will show either:

“BAGSERVICE-23-4” (23 kg bags) OR “BAGSERVICE-32-8” (32 kg bags).

Example Message Flows

New and updated examples of complete end to end message flows can be found here.

For example, do you want to see how to create an Order with Ancillaries Pre-Sale paid with Credit Card, booked by a Travel Agent with a Pseudo IATA using an Aggregator.
Booking a Round Trip for 2ADT 2CHD and 1INF with Resident discount with a Service Fee. And then adding Ancillaries Post Sale paid with a Credit Card using 3DS v2, followed by an update of Passenger Contact Information. And finalizing it all with a full Cancellation and refund?

If there is something we have missed and you would like to see, then please contact us at New.Distribution@iberia.es

Latest Newsletters

March 2024

January 2024

December 2023

November 2023

OnBusiness comes to NDC

You are now able to add your client’s OB Number at booking time for points accrual. We are working to be able to add it in a servicing flow, and OB Fare Discounts will also be available by the end of this year.

Corporate Fares and Bookings

If you are a Travel Agent with corporate clients you can now book and service Iberia corporate fares through our NDC channel. Check out more information here. And you have some useful examples here.

Vouchers

Iberia vouchers can now be used as a Form of Payment for Orders. The voucher must cover the total cost of the Order, unless you are an IATA accredited Travel Agent, in which case you may pay any difference between the value of the voucher and the total value of the Order with Cash form of payment. Please check out this page for more information.

The voucher may be used in the OrderCreate message for instant payment or in the AirDocIssue 16.2/OrderChange 17.2 messages when paying for a previously created Order.

As ancillaries cannot be added to a previously created Order until after the flights have been paid for, presently Ancillaries can only be paid using a voucher if used in the creation of the Order in an instant purchase scenario.

Vouchers can be used to pay for all fares/products except Private Leisure fares.

3DS - Secure Payment

Three-Domain Secure (3DS or 3-D Secure) is a protocol that allows consumers to authenticate themselves with the issuer of their payment card when they wish to undertake a non-contact transaction, such as purchasing over the internet. It is another layer of security to protect against unauthorized transactions in an e-commerce environment.

This standard is being mandated by the payment industry in order to reduce fraud.

Iberia is implementing 3DS in our IATA NDC 17.2 schema version. Therefore due to the 3DS mandate, credit card payments will only be accepted in the 17.2 messages once the mandate comes into effect. More information can be found here

Multiple Changes - Servicing

We have now enabled the ability to change Orders more than once, with no additional development foreseen on your side. You can now service your Orders multiple times before they are paid for and issued, in the following scenarios:

Add or modify passenger contact details.
Change hour of departure or date of outbound, inbound or both flights.
Change cabin (upgrade).
Change up to 3 characters of name and/or surname of the passenger for free (once per passenger only).
Remove one or more passengers from a booking and change/cancel their new split booking.

IB NDC Documentation

Hot News