Open

ONLY FOR POINT OF SALE SPAIN

The Spanish government subsidizes certain air travel within Spain. For residents of certain areas of Spain, traveling between those areas and the rest of Spain, and also people with large families traveling within Spain (more information can be found here in English and here in Spanish). The following explains how this is handled through our NDC channel. 

The different discounts are identified in the messages using specific codes as per the following:

Spanish Resident Discount

Spanish Large Family Discount

The Resident discount can combined with the Large Family Discount.

The type(s) of discount must be requested in the initial Shopping flow using the TicketDesig as per the following example (which shows a Canary Islands Resident Discount being combined with a General Large Family Discount):

In the Shopping responses information about the discount applied (description, type of discount, ticket designator, quantity and currency for special discount) is returned in a Remark as per the following examples.

Specific information is contained in the Discount section in the OfferItem including the total discount amount given.

And the Remarks in the FareDetail which contains a description / type of discount / ticket designator / quantity and currency per passenger of the special discount:

When creating Orders with Spanish Resident Discounts the following information must be included:

• The Spanish national ID (DNI/NIE) for those 14 years and older.

• The Resident Certificate (Certificado de Residencia) for those under 14 and without Spanish national ID (DNI/NIE).

• The Municipal Code of residence.

  • A list of the latest codes (as of publication of this page) can be found in the attached Excel file in this page in the tab “Códigos Residentes”.

  • The Government site for the latest updated Spanish Resident Discount Municipality Codes can be obtained from here.

The official Spanish Government guidelines covering these discounts can be found here and here.

When creating bookings with Spanish Resident Discount, the passenger information is validated against the Spanish government SARA system, and if unable to validate then an OrderViewProcessing Remark is returned advising that the passengers must present documentation at the airport. In addition, SARA works with the usual Spanish double surnames, and to accommodate this in the NDC messages we ask you to send a “@” between the first and second surnames, as per the following example:

When creating Orders with Spanish Large Family Discount the following information must be included:

• The Spanish national ID (DNI/NIE) for those 14 years and older.

• The Large Family Certificate (Certificado Familia Numerosa) for all passengers

• The Autonomous Community Code (Código Comunidad Autónoma) for all passengers.

  • A list of the codes can be found in the attached Excel file in this page in the tab “Códigos Fam. Num.”

The official Spanish Government guidelines covering these discounts can be found here.

The following is and example of how the information is passed in the OrderCreateRQ message. This information cannot be added or modified in the OrderChangeRQ:

In the attached file there are two tabs:

The first tab, “Códigos Residentes”, are the Municipality* codes to be used when booking the Spanish Resident Discounts.

The second tab, “Códigos Fam. Num.”, contains the short list of Autonomous Community codes, to be used when booking the Spanish Large Family Discounts: 

Open

*Please be aware that the Municipality codes can be updated at any time by the government of Spain, and therefore the latest version can be found here.

In the OrderCreate, you can communicate the Service Fee (as a payment method) charged to the passenger, to report it to Fomento (Spanish government) on the ticket:

You can modify a Service Fee at the OrderChangeRQ if there is some mistake in the OrderCreateRQ.

You can also add a new Service Fee and/or delete one replacing the Service Fee information to “0”.

The following is an example of how the Service Fee information is passed in the OrderChangeRQ message, please note that the passenger information for whom the Service Fee applies must be included in the PassengerList section and referenced in the Payment section.

In the case that the Spanish Government are unable to verify that the passenger is entitled to the discount, a remark will be returned informing that the passenger must present the necessary documentation at check-in.

Failure to present the correct documentation proving entitlement to the discount will result in the need to pay the difference at the airport in order to fly.

Also returned is the TicketDesignator with the discount codes.

And if a Service Fee has been included in the Order it is returned in the Payments section of the OrderView:

The passenger information provide in the OrderCreate and in the OrderChange is also returned in the OrderView:

Iberia’s private fares are initially divided in two categories: Corporate Fares and Private Leisure Fares

Iberia has agreements with certain IATA/ARC Travel Agents to sell these private fares. These fares will only be returned in the shopping response once the Travel Agent’s eligibility to sell them has been verified.

By default, public fares are returned together with Seat Only Private Fares, when the IATA/ARC Travel Agent has access to them, when no FarePreferences is included in the request. Private fares are identified by a FareCode in the response.

Available to IATA/ARC Accredited Travel Agents who act as a Travel Management Company (TMC) for a Corporation that has contracted fares with Iberia.

The Shopping and Ordering messages must be sent to Iberia with the Corporation identified. This is done by including their Client ID (JBID) as the “CorporateSender” in the Party section of the messages, with the IATA accredited Travel Agent included in the message as a “TravelAgencyParticipant”.

The Party section in both messages shows the identifier of the Corporate for whom the travel is being booked, with the Travel Agent who is managing their bookings as a Participant.

This same structure is repeated in all the other messages:

The relationship between the Travel Agent and the Corporation is validated by Iberia to obtain the applicable corporate fares. Corporate fares are returned together with Public Fares.

When shopping for corporate fares, the cheapest fare within the Family/Brand is returned, whether Public or Corporate. The type is indicated by the FareCode (Public Fares = 70J, Corporate Private Fares = 70M)

When shopping for Corporate fares, both private and public fares are returned.

Both messages include a FareCode indicating whether the fare returned is the Corporate Fare (70M) or a normal public fare (70J). Both can be returned when the Offer combines Corporate Fares with Public Fares.

IATA/ARC Accredited Travel Agents that have Private Leisure Fares contracted with Iberia can Shop and Order them through the NDC channel. Indicating the Fare/Product that applies to the customer, for whom they are shopping, by indicating the product they wish to shop for using the FarePreferences element.

For example an agent wishing to shop for Tour Operator fares would include the following in the AirShoppingRQ message. In a servicing flow it would also be included in the first OrderReshopRQ message:

No special passenger type code (PTC) is required, normal ADT, CHD and INF should be used.

When shopping for Private Leisure fares using FarePreferences, ONLY private fares for the specified preference are returned.

In the response the Private Leisure Type requested is returned in the DescriptionList and FareList

Private Leisure Fare Types cannot be mixed in the same shopping flow, as each are restricted to sell to specific types of travelers.

Private Fare Types

As of July 2023, the following private leisure fare types are available through our NDC channel:

** Available for the UK market only.

Due to the nature of each of these fares being available to certain customer types, and non-combinable, the different fares/products cannot be mixed in the same request.

Iberia validates that the Travel Agent has a valid contract to sell the Fare/Product requested.

• Seat Only

In the case of Seat Only private fares, they do not have to be requested specifically as they are returned with the public fares if the Seller is authorized to sell them.

Only for certain routes (and depending on which O/D), passengers whose flight makes a Stopover in Madrid are offered exclusive plans and offers, as well as night(s) stay(s) with no extra cost.

Please, note that this product in not combinable with any Corporate or Private Leisure Fares.

As seen in the table below, and in order to sell this product, these are the FarePreferences code and attribute that need to be selected.

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

Open