Spanish Discounts, Private Fares, and Hola Madrid

 

Spanish Discounts

The Spanish government subsidizes certain air travel within Spain. For residents of certain areas of Spain, travelling between those areas and the rest of Spain, and also people with large families travelling 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

<Application> Code

<Discount>/<Description>

Explanation

<Application> Code

<Discount>/<Description>

Explanation

BP

Residente Baleares

To indicate that the travellers are residents of the Balearic Islands when booking flights to and from or within the Balearic Islands. The same code will be returned to indicate that the discount has been applied to the fare. Unless the flights are purely within the Balearic Islands (see BI code).

BI (used only in response message)

Inter Island Flights Baleares

Indicates that the Balearic inter-island discount has been applied to the fare.

RC

Residente Canarias

To indicate that the travellers are residents of the Canary Islands when booking flights to and from or within the Canary Islands. The same code will be returned to indicate that the discount has been applied to the fare. Unless the flights are purely within the Canary Islands (see DC code).

DC (used only in response message)

Inter Island Flights Canarias

Indicates that the Canary inter-island discount has been applied to the fare.

RE

Residente Ceuta

This code is used in for residents of Ceuta using domestic flights from/to Malaga, Sevilla and Jerez

RM

Residente Melia

This code used in the request and response for residents of and flights to and from Melilla.

Spanish Large Family Discount

<Application> Code

<Discount>/<Description>

Explanation

<Application> Code

<Discount>/<Description>

Explanation

F1

General - for families with 3 children

To indicate that the family has 3 children and is entitled to the general familia numerosa discount

F2

Special - for families with 4 or more children

To indicate that the family has more than 3 children and is entitled to the special familia numerosa discount

The Resident discount can combined with the Large Family Discount.

AirShoppingRQ and OfferPriceRQ Message

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):

<Preference> <FarePreferences> <TicketDesigs> <TicketDesig>RC</TicketDesig> <TicketDesig>F1</TicketDesig> </TicketDesigs> </FarePreferences> .... </Preference>

AirShoppingRS and OfferPriceRS Message

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.

<OfferItem OfferItemID="IBc28de6ef678f46fcb7e42f2800dbb331OC_01-3-4" MandatoryInd="true"> <TotalPriceDetail> <TotalAmount> <SimpleCurrencyPrice Code="EUR">369.16</SimpleCurrencyPrice> </TotalAmount> <BaseAmount Code="EUR">313.20</BaseAmount> <Discount> <DiscountAmount Code="EUR">1252.80</DiscountAmount> <Application>RCF1</Application> <Description>Residente Canarias, Familia numerosa (General)</Description> </Discount>

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

<FareDetail> .... <Remarks> <Remark>DISCOUNT/SD/RCF1/626.40EUR</Remark> </Remarks> </FareDetail>

 

OrderCreateRQ Message

Spanish Resident 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:

Spanish Large Family Discount

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.

Municipality and Autonomous Community Codes

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.

are in the following Excel file.

 

*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.

The following is and example of how the information is passed in the OrderCreate message

OrderViewRS

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.

The passenger information provide in the OrderCreate is also returned in the OrderView.

 

Private Fares

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.

Corporate Fares

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”.

AirShoppingRQ and OfferPriceRQ Messages

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)

AirShoppingRS and OrderViewRS Messages

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.

Private Leisure 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.

AirShoppingRQ and OrderReshopRQ Messages

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 incuded in the first OrderReshopRQ message:

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

AirShoppingRS, OfferPriceRS, OrderReshopRS and OrderViewRS Messages

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 travellers.

Private Fare Types

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

Private Fare Type

Preference / FarePreferences / Types / Type

Code from PADIS 9910

Preference / FarePreferences / Types / Type @ PreferencesContext

Extra Request Information

Private Fare Type

Preference / FarePreferences / Types / Type

Code from PADIS 9910

Preference / FarePreferences / Types / Type @ PreferencesContext

Extra Request Information

Tour Operation

758

TO

 

Semideferred Tour Operation**

758

TO SEMIDEFERRED

 

Cruise Tour Operation

758

CRUISE

 

Semideferred Cruise Tour Operation**

758

CRUISE SEMIDEFERRED

 

Visiting Friends and Family

758

VFR

 

Disney

758

DISNEY

 

Sport

758

SPORT

Further information on this product, and how to request it, can be found in our SPORT Product page.

Humanitarian

758

HUMANITARIAN

Further information on this product, and how to request it, can be found in our Humanitarian and Marine Products page.

Marine

758

MARINE

Further information on this product, and how to request it, can be found in our Humanitarian and Marine Products page.

Entertainment

758

ENTERTAINMENT

 

** 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 authorised to sell them.

Hola Madrid

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.

 

Product Name

Preference / FarePreferences / Types / Type

Code from PADIS 9910

Preference / FarePreferences / Types / Type @ PreferencesContext

Product Name

Preference / FarePreferences / Types / Type

Code from PADIS 9910

Preference / FarePreferences / Types / Type @ PreferencesContext

Hola Madrid

758

HM