Release 2024.04

*Functionality improvements do not necessarily affect the message structure.

Examples of messages with complete flows can be downloaded from here.

New or modified element

To be removed/deprecated

Unique to v2 - Branded Fares

Unique to V1 - Fare Families

Common Sections

/wiki/spaces/NDC2/pages/3727032388

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:HTTP Header'.

Language, Version and Name Space

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Language, Version and Name Space'.

Point of Sale

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Point of Sale and Document'.

Document

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Point of Sale and Document'.

Party

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:Party Elements'.

In addition to the Common Sections, this service is called with the following data:

Query

Query - OrderReshopRQ

Query - OrderID

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query>
OrderID	Id of the Order	Alphanumeric	Any

Query - Reprice Flow (to be deprecated in the future, and replaced with Reprice on hold )

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / Reshop / OrderServicing / Add / Qualifier / ExistingOrderQualifier>
OrderKeys / OrderID Attribute Owner	Order Identification	Alphanumeric	Any
OrderKeys / AssociatedIDs / AssociatedID / OfferItemID Attribute Owner	The ID of the Offer to be purchased together with the identity of the Owner of the Offer (which in this case is always Iberia).	2-character Alphabetical	IB
PassengerReferences	Reference of the passenger	Alphanumeric	Any

Query - Reshop Availability (Add)

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / Reshop / OrderServicing / Add / FlightQuery>
OriginDestinations / OriginDestination Attribute OriginDestinationKey	ID for the Origin/Destination	Alphanumeric	This attribute can be filled with any value, but first character cannot be a number digit or a special character.
OriginDestinations / OriginDestination / Departure / AirportCode	Departure airport code Mandatory for schema if 'OriginDestination' tag is indicated.	3 Alphabetical	Any valid airport code (JFK)
OriginDestinations / OriginDestination / Departure / Date	Departure date Mandatory for schema if 'OriginDestination' tag is indicated.	Date	Any Date (2019-10-06<)
OriginDestinations / OriginDestination / Arrival / AirportCode	Arrival airport code Mandatory for schema if 'OriginDestination' tag is indicated.	3 Alphabetical	Any valid airport code (BCN)
OriginDestinations / OriginDestination / MarketingCarrierAirline / AirlineID	Airline identification code Mandatory for schema if 'MarketingCarrierAirline' tag is indicated.	2 Alphabetical	Any valid, in our case IB
OriginDestinations / OriginDestination / MarketingCarrierAirline / FlightNumber	Flight number identification	Alphanumeric	It is valid to fill in with the following options for flight changes in paid orders (Not available for unpaid orders): OPEN (All flights availability will be displayed) XXXX (Specific Flight Number - This flight number availability will be displayed).
<Query / Reshop / OrderServicing / Add / Passengers>
PassengerReferences	Passenger references the new search applies to Mandatory for schema if 'Passengers' tag is indicated.	Alphanumeric	Any (Ex: ADULT_01 CHILD_01 INFANT_01)
<Query / Reshop / OrderServicing / Add / Preference> If the Preference tag is included in the request, one or more of the following must be included. If more that one is used, then they must be sent in the same order as listed below.
FarePreferences / Types / Type Attribute PreferencesContext	Type of product selected.	Alphanumeric	For the Products currently available through our NDC channel, and the codes required to request them please see the information in Private Leisure Fares.
FarePreferences / TicketDesigs / TicketDesig	Spanish Resident discount code.	Alphanumeric	RC (Residente Canarias) BP (Residente Baleares) RM (Residente Melilla) RE (Residente Ceuta) BI (Para el interior de Baleares) DC (Para el interior de Canarias)
FarePreferences / TicketDesigs / TicketDesig	Spanish Large Family discount code	Alphanumeric	F1 (General discount) F2 (Special discount)
FlightPreferences / Characteristic / DirectPreferences	Maximum number of stops.	Numeric	0 or Empty - Direct Flights (Default) n (1, 2, 3...) - Maximum number
CabinPreferences / CabinType / Code	IATA PADIS Cabin code (This info will be applied as a preference, so other offers will also be returned).	1 Numeric	PADIS → 9873 Cabin class of service, coded 1 → First class, Highest class of service (First Class Category) 2 → Second class, Medium class of service (Business Class Category) 3 → Third class, lowest class of service (all economy/coach class categories) 4 → Economy/coach premium 5 → Economy/coach

Query - Reshop Availability (Delete)

NAME

DESCRIPTION

FORMAT

ALLOWED/POSSIBLE VALUES

<Query / Reshop / OrderServicing / Delete>

OrderItem

Attribute

OrderItemID

Identification of the flight item associated to the passenger who is asking for new availabilities options.

Mandatory for schema if 'Delete' tag is indicated.

Alphanumeric

Any valid flight item returned in Order Create RS.

ServiceRetainRequestIDs

Flight services that passenger wants to mantain in new search.

Alphanumeric

Any valid flight service returned in Order Create RS.

Query - Reshop Fare

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Query / Reshop / OrderServicing / Add / Qualifier / ExistingOrderQualifier>
OrderKeys / OrderID Attribute Owner	The ID of the Order being serviced together with the identity of the Owner of the Offer (which in this case is always Iberia). Mandatory for schema if 'ExistingOrderQualifier' tag is indicated.	2-character Alphabetical	IB
OrderKeys / AssociatedIDs / AssociatedID / OfferItemID Attribute Owner	The ID of the Offer to be purchased together with the identity of the Owner of the Offer (which in this case is always Iberia).	2-character Alphabetical	IB
PassengerReferences	References the passenger(s) to which the Offer applies.	Alphanumeric	Any (Ex: ADULT_01 CHILD_01 INFANT_01)

Preferences

NAME	DESCRIPTION	FORMAT	ALLOWED/POSSIBLE VALUES
<Preference> *See Note Below
FarePreferences / Types / Type Attribute PreferencesContext	Mandatory for schema if 'Preference' tag is indicated and don't have other preference inside. Type of product selected (e.g. “TO“, Tour Operator private product): <Type PreferencesContext="TO">758</Type>	Alphanumeric	For the Products currently available through our NDC channel, and the codes required to request them please see the information in Private Leisure Fares.
FarePreferences / TicketDesigs / TicketDesig	Spanish Resident discount code. Mandatory for schema if 'Preference' tag is indicated and don't have other preference inside.	Alphanumeric	RC (Residente Canarias) BP (Residente Baleares) RM (Residente Melilla) RE (Residente Ceuta) BI (Para el interior de Baleares) DC (Para el interior de Canarias)
FarePreferences / TicketDesigs / TicketDesig	Spanish Large Family discount code	Alphanumeric	F1 (General discount) F2 (Special discount)
FlightPreferences / Characteristic / DirectPreferences	Maximum number of stops. Mandatory for schema if 'Preference' tag is indicated and don't have other preference inside	Numeric	0 or Empty - Direct Flights (Default) n (1, 2, 3...) - Maximum number
CabinPreferences / CabinType / Code	IATA PADIS Cabin code (This info will be applied as a preference, so other offers will also be returned). Mandatory for schema if 'Preference' tag is indicated and don't have other preference inside	1 Numeric	PADIS → 9873 Cabin class of service, coded 1 → First class, Highest class of service (First Class Category) 2 → Second class, Medium class of service (Business Class Category) 3 → Third class, lowest class of service (all economy/coach class categories) 4 → Economy/coach premium 5 → Economy/coach
PricingMethodPreference / BestPricingOption	Code to select best pricing option. Optional and just for NDC.	1 Alphabetical	C (cheapest fares) Y (cheapest fares for a specific cabin type)

*Preference

Please note that the preferences Fare, Flight, Cabin and PricingMethod must always be past in this sequence if more that one is being used.

DataLists - PassengerList

Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'NDC2:PassengerList'.

Example :

Example - OrderReshopRQ - Availability 17.2v2

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <OrderReshopRQ xsi:schemaLocation="http://www.iata.org/IATA/EDIST/2017.2 ../../OrderReshopRQ.xsd" Version="5.000" PrimaryLangID="es" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.iata.org/IATA/EDIST/2017.2">
         <PointOfSale>
            <Location>
               <CountryCode>ES</CountryCode>
            </Location>
         </PointOfSale>
         <Document>
            <ReferenceVersion>5.000</ReferenceVersion>
         </Document>
         <Party>
            <Sender>
               <TravelAgencySender>
                  <Name>Alvaros Agency Tests SA</Name>
                  <Contacts>
                     <Contact>
                        <EmailContact>
                           <Address>pruebas@pruebas.com</Address>
                        </EmailContact>
                        <PhoneContact>
                           <Application>MOBILE</Application>
                           <Number CountryCode="+34">666666666</Number>
                        </PhoneContact>
                        <Name>
                           <Surname>Hernandez</Surname>
                           <Given>Raul</Given>
                        </Name>
                     </Contact>
                  </Contacts>
                  <IATA_Number>12345678</IATA_Number>
                  <AgencyID>Alvaros VIAJES</AgencyID>
               </TravelAgencySender>
            </Sender>
         </Party>
         <Query>
            <OrderID>IB73b10257e52c4aeba1fd7c6b40588064OC</OrderID>
            <Reshop>
               <OrderServicing>
                  <Add>
                     <FlightQuery>
                        <!--Solo indicamos lo que queremos cambiar, lo que se mantiene lo decimos abajo diciendo el servicio que queremos mantener.-->
                        <OriginDestinations>
                           <OriginDestination>
                              <Departure>
                                 <AirportCode>SDR</AirportCode>
                                 <Date>2024-03-05</Date>
                              </Departure>
                              <Arrival>
                                 <AirportCode>EZE</AirportCode>
                              </Arrival>
                           </OriginDestination>
                           <OriginDestination>
                              <Departure>
                                 <AirportCode>EZE</AirportCode>
                                 <Date>2024-03-10</Date>
                              </Departure>
                              <Arrival>
                                 <AirportCode>SDR</AirportCode>
                              </Arrival>
                           </OriginDestination>
                        </OriginDestinations>
                     </FlightQuery>
                     <Preference>
                        <FlightPreferences>
                           <Characteristic>
                              <DirectPreferences>4</DirectPreferences>
                           </Characteristic>
                        </FlightPreferences>
                     </Preference>
                     <Passengers>
                        <PassengerReferences>ADULT_01 ADULT_02</PassengerReferences>
                     </Passengers>
                  </Add>
                  <Delete>
                     <OrderItem OrderItemID="IB73b10257e52c4aeba1fd7c6b40588064OC_01"/>
                     <OrderItem OrderItemID="IB73b10257e52c4aeba1fd7c6b40588064OC_02"/>
                  </Delete>
               </OrderServicing>
            </Reshop>
         </Query>
         <DataLists>
            <PassengerList>
               <Passenger PassengerID="ADULT_01">
                  <PTC>ADT</PTC>
                  <Individual>
                     <GivenName>Luis Alfonso</GivenName>
                     <Surname>PÈrez PÈrez</Surname>
                  </Individual>
               </Passenger>
               <Passenger PassengerID="ADULT_02">
                  <PTC>ADT</PTC>
                  <Individual>
                     <GivenName>Ana Laura</GivenName>
                     <Surname>Santos Perez</Surname>
                  </Individual>
               </Passenger>
            </PassengerList>
         </DataLists>
      </OrderReshopRQ>
   </soapenv:Body>
</soapenv:Envelope>

Example - OrderReshopRQ - Fare 17.2v2

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <OrderReshopRQ xsi:schemaLocation="http://www.iata.org/IATA/EDIST/2017.2 ../../OrderReshopRQ.xsd" Version="5.000" PrimaryLangID="es" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.iata.org/IATA/EDIST/2017.2">
         <PointOfSale>
            <Location>
               <CountryCode>ES</CountryCode>
            </Location>
         </PointOfSale>
         <Document>
            <ReferenceVersion>5.000</ReferenceVersion>
         </Document>
         <Party>
            <Sender>
               <TravelAgencySender>
                  <IATA_Number>12345678</IATA_Number>
                  <AgencyID>Alvaros VIAJES</AgencyID>
               </TravelAgencySender>
            </Sender>
         </Party>
         <Query>
            <OrderID>IB73b10257e52c4aeba1fd7c6b40588064OC</OrderID>
            <Reshop>
               <OrderServicing>
                  <!--Cambiamos solo la ida, queremos mantener la vuelta-->
                  <Add>
                     <Qualifier>
                        <ExistingOrderQualifier>
                           <OrderKeys>
                              <OrderID Owner="IB">IB73b10257e52c4aeba1fd7c6b40588064OC</OrderID>
                              <AssociatedIDs>
                                 <AssociatedID>
                                    <OfferItemID Owner="IB">IB16e45cf7c4c1447abddaea68fb5242dbOP_01</OfferItemID>
                                    <!--Reference to previous ReshopOffer so we can use the items-->
                                 </AssociatedID>
                              </AssociatedIDs>
                           </OrderKeys>
                           <PassengerReferences>ADULT_01 ADULT_02</PassengerReferences>
                        </ExistingOrderQualifier>
                     </Qualifier>
                  </Add>
               </OrderServicing>
            </Reshop>
         </Query>
         <DataLists>
            <PassengerList>
               <Passenger PassengerID="ADULT_01">
                  <PTC>ADT</PTC>
                  <Individual>
                     <GivenName>Luis Alfonso</GivenName>
                     <Surname>PÈrez PÈrez</Surname>
                  </Individual>
               </Passenger>
               <Passenger PassengerID="ADULT_02">
                  <PTC>ADT</PTC>
                  <Individual>
                     <GivenName>Ana Laura</GivenName>
                     <Surname>Santos Perez</Surname>
                  </Individual>
               </Passenger>
            </PassengerList>
         </DataLists>
      </OrderReshopRQ>
   </soapenv:Body>
</soapenv:Envelope>

Error messages

For further information about all kind of error messages, please go to the following link:

Error Codes