• Register

FlightPrice 16.2 Live

New Functionality

(version 2.45) Include in the request to QPX the department code associated with the requested product.

(version: 2.23 )Example of validation of the currency we sell with the point of sale currency. This information will be optional.

    
<Metadata>
    <Other>
        <OtherMetadata>
            <CurrencyMetadatas>
                <CurrencyMetadata MetadataKey="EUR">
                <Decimals>2</Decimals>
                </CurrencyMetadata>
            </CurrencyMetadatas>
        </OtherMetadata>
    </Other>
</Metadata>
    

Message examples

FlightPrice.zip message examples

Endpoint

IATA NDC Schema Version 16.2:  https://test.api.iberia.com/iberia/beta/ndc/FlightPrice/v2

Request Body

We provide two different methods to request the flight price. 

  • GetFare: Needs a previous AirShopping for returning a price breakdown.
  • GetDirectFare: It is stateless. Including extra data it will return the price breakdown of the selected flight.

The various search parameters are described below:

NAME

DESCRIPTION

FORMAT

ALLOWED VALUES

MANDATORY FOR
PrimaryLangID Specifies preferred language by the agency 2 alphabetic any
Version

The IATA version of the message

numeric any Schema
xmlns IATA oficial website alphabetic any Schema
<PointOfSale>

Location / CountryCode

Country code

2 alpha

List of countries

NDC Mandatory if toggle feature for market validation is activated.
<Document> Schema

ReferenceVersion

The IATA Schema version.

numeric

any


<Party / Sender / TravelAgencySender> Schema

IATA_Number

Sender IATA or Pseudo IATA number

7 numeric

7/8 numbers

NDC Mandatory

AgencyID

Agency identification

alphanumeric

any

Schema
Name

Agency Name

alphanumeric any
<Party / Sender / TravelAgencySender / Contacts / Contact> Mandatory for schema if 'Contacts' tag is indicated.
EmailContact / Address Email to contact the Agency alphanumeric any Mandatory for schema if 'EmailContact' tag is indicated.
PhoneContact / Application Agency phone type alphabetic
  • BUSINESS
  • MOBILE

PhoneContact / Number

Attribute

CountryCode

Country code phone number to contact the Agency alphanumeric any
Name / Surname Reference Agency contact surname alphanumeric any Mandatory for schema if 'Name' tag is indicated.
Name / Given Reference Agency contact given alphanumeric any Mandatory for schema if 'Participants' tag is indicated.
<Party / Participants>

Participants / Participant

Attribute

SequenceNumber

Number of aggregator secuency connection numeric any
Participant / AggregatorID Aggregator ID of the participant which is connecting numeric 7/8 numbers
<Party> (With Corporates) Schema
Sender / CorporateSender / ID ID for the Corporate Alphanumeric Any NDC Mandatory
Participants / Participant / TravelAgencyParticipant / Name Agency Name alphanumeric Any
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / EmailContact / Address Email to contact the Agency alphanumeric Any Mandatory for schema if 'EmailContact' tag is indicated.
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / PhoneContact / Application Agency phone type alphabetical
  • Business
  • Mobile

Participants / Participant / TravelAgencyParticipant / Contacts / Contact / PhoneContact / Number Phone number to contact the Agency alphanumeric Any
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / Name / Surname Reference Agency contact surname alphabetic Any
Participants / Participant / TravelAgencyParticipant / Contacts / Contact / Name / Given Reference Agency contact name alphabetic Any Mandatory for schema if 'Name' tag is indicated.
Participants / Participant / TravelAgencyParticipant / IATA_Number

Sender unique identifier such as:

IATA number (if you have one)

TIDs number  (recommended if you do not have an IATA)

numeric 7/8 Numbers NDC Mandatory
Participants / Participant / TravelAgencyParticipant / AgencyID Id for the Agency alphanumeric Any Schema
Participants / Participant / AggregatorParticipant / AggregatorID

Participant / Aggregator unique identifier:

IATA number (if you have one)

TIDs number  (recommended if you do not have an IATA)

Pseudo IATA(assigned by Iberia)

numeric 7/8 Numbers Mandatory for schema if 'Participants' tag is indicated.
<Travelers / Traveler> Schema

AnonymousTraveler / PTC

Attribute

Quantity

Quantity and type of anonymous passenger

  • This info is not validated against passengers introduced in previous Air Shopping request, is it only informed because of Travelers tag is mandatory for IATA schema.
  • Quantity
  • PaxType (3 alpha)

Passenger Types


RecognizedTraveler

Attribute

ObjectKey

Recognized traveler information. alphanumeric
Mandatory if passenger has Frecuent Flyer information associated
RecognizedTraveler / PTC Type of recognized passenger

PaxType (3 alpha)

Passenger Types Mandatory if passenger has Frecuent Flyer information associated
RecognizedTraveler / Name / Surname Surname of recognized passenger alphanumeric any Mandatory if passenger has Frecuent Flyer information associated
RecognizedTraveler / Name / Given Name of recognized passenger alphanumeric any Mandatory if passenger has Frecuent Flyer information associated
RecognizedTraveler / FQTVs / AirlineID Airline carrier for Frecuent Flyer number 2 alpha any Mandatory if passenger has Frecuent Flyer information associated
RecognizedTraveler / FQTVs / Account / Number Frecuent Flyer number numeric any Mandatory if passenger has Frecuent Flyer information associated
<Query>  Only for Direct Fare Schema

OriginDestination / Flight / Departure / AirportCode

The departure city (or airport)

3 alpha

any valid airport or city code

Schema

OriginDestination / Flight / Arrival / AirportCode

The arrival city (or airport)

3 alpha

any valid airport or city code

Schema

OriginDestination / Flight / Departure / Date

Date of travel

date

any future date

Schema
OriginDestination / Flight / MarketingCarrier / AirlineID The airline ID 2 alpha any Schema
OriginDestination / Flight / MarketingCarrier / Flight Number The number of the flight 4 numbers any Schema
<Query>  Only for Get Fare
Offers / Offer / OfferID ID of the Offer alphanumeric any Mandatory for schema if 'Query' tag is indicated.
Offers / Offer / OfferItemIDs / OfferItemID ID of the Offer Item alphanumeric any Mandatory for schema if 'Query' tag is indicated.
<Qualifier> 
SpecialNeedQualifiers / Code Code of the special need qualifiers 4 alpha

Special Services

  • DISA (To request for all special services available)
Mandatory for schema if 'Qualifier' tag is indicated.
<ShoppingResponseIDs> Only for Get Fare

ResponseID

ID Response of the AirShopping service

alphanumeric

any

Mandatory for schema if 'ShoppingResponseIDs' tag is indicated.
<Preference>  Only for Direct Fare
FarePreferences / TicketDesigs / TicketDesig Special Discount code 15 alphanumeric Residents Discount, Large Family Discount Mandatory for schema if 'Preferences' tag is indicated.
<Metadata>

Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / MetadataKey

Attribute

MetadataKey

Type of currency alphanumeric any available currency Mandatory for schema if 'Metadata' tag is indicated.
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / Decimals Decimals of Currency numeric any

Response Body

NAME

DESCRIPTION

FORMAT

ALLOWED VALUES
Version NDC message version Alphanumeric Any
PrimaryLangID NDC message lenguage identification Numeric Any (Ex: es)
xmlns IATA oficial website Alphabetical Any
<Document>
ReferenceVersion IATA Reference Version Alphanumeric Any
<ShoppingResponseIDs>

ResponseID

Id of the response Alphabetical Any
<PricedFlightOffers / PricedFlightOffer>

OfferID

Attribute

Owner

Marketing airline identification and offer identification Alphanumeric Any

OfferPrice

Attribute

OfferItemID

Offer Item identification for the offer and type of passenger Alphanumeric Any
<PricedFlightOffers / PricedFlightOffer / OfferPrice>

RequestedDate / PriceDetail / Total Amount / SimpleCurrencyPrice

Attribute

Code

Currency associated to offer and sum of base amount and taxes  Alphanumeric Any

RequestedDate / PriceDetail / Total Amount / BaseAmount

Attribute

Code

Currency associated to offer and base amount (Fare)  Alphanumeric Any

RequestedDate / PriceDetail / Taxes / Total

Attribute

Code

Currency associated to offer and sum of taxes Alphanumeric Any

RequestedDate / PriceDetail / Taxes / Breakdown / Tax / Amount

Attribute

Code

Currency associated to offer and quantity of specific tax Alphanumeric Any
RequestedDate / PriceDetail / Taxes / Breakdown / Tax / TaxCode Specific tax identification Alphabetical Any
RequestedDate / Associations / AssociatedTraveler / TravelerReferences Traveler references Alphanumeric

Any

Ex: ADULT_01

FareDetail / FareComponent

Attribute

refs

Flight identification like (IB343820190426 or IB382620190504 TO-TO for a private fare) Alphanumeric Any
FareDetail / FareComponent / FareRules / Penalty / ApplicableFeeRemarks / Remark Text specifying charges applied in case of cancelations, changes, No-Show flights... Text Any
FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Type Type of action like Cancel, Change... Alphabetical

Any

Ex: Cancel, Change

FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Application / Code

Associated Code to action refered above like Change, Cancel

FAT Fare or application penalty type
1 No show
2 Prior to departure
3 After departure

Numeric Any (1, 2, 3...)
FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Application / TableName

Code of table name associated to action refered above like Change, Cancel

 

Alphabetical FAT

FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Amounts /Amount / CurrencyAmountValue

Attribute

Code

Associated currency and penalty amount Alphanumeric Any
FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Amounts /Amount / AmountApplication Identifies minimum and maximun penalty amount Alphabetical
  • minPrice
  • maxPrice
<PricedFlightOffers / PricedFlightOffer / TimeLimits>

OfferExpiration

Attribute

DateTime

TimeStamp Date associated to offer expiration

  • Madrid hour
Alphanumeric Any

Payment

Attribute

DateTime

TimeStamp Date associated to payment expiration

  • UTC hour
Alphanumeric Any
<PricedFlightOffers / PricedFlightOffer / Associations>

ApplicableFlight / FlightSegmentReference

Attribute

ref

Flight identification like (IB343820190426) Alphanumeric Any

ApplicableFlight / FlightSegmentReference / ClassOfService / Code

Attribute

SeatsLeft

Associated cabin code and reamining seats Alphanumeric Any

ApplicableFlight / FlightSegmentReference / ClassOfService / MarketingName

Attribute

CabinDesignator

Type and fare family name of the cabin, like ECONOMY > Flexible Alphabetical Any
ApplicableFlight / FlightSegmentReference / BagDetailAssociation / CheckedBagReferences Service reference for checked bags associated to offer Alphanumeric Any
ApplicableFlight / FlightSegmentReference / BagDetailAssociation / CarryOnReferences Service reference for carry on bags associated to offer Alphanumeric Any
ApplicableFlight / OriginDestinationReferences References associated to origin and destination (Ex: MADFLR FLRMAD) Alphabetical Any
ApplicableFlight / FlightReferences References associated to flights (Ex: MADFLR20190426092000 FLRMAD20190428203000) Alphanumeric Any
AssociatedTraveler / TravelerReferences Traveler Identification (Ex: ADULT_01) Alphanumeric Any
AssociatedService / ServiceReferences Special Need service identification associated to traveler Alphanumeric Any
<PricedFlightOffers / PricedFlightOffer / Disclosure>

Description

Attribute

refs

Reference to associated flight conditions specified in disclosure list Alphanumeric Any
<AirlineOffers / AirlineOffer> Only for Direct Fare

OfferID

Attribute

Owner

Marketing airline identification and offer identification Alphanumeric Any

OfferExpiration

Attribute

DateTime

TimeStamp Date associated to offer expiration

  • Madrid hour
Alphanumeric Any

Payment

Attribute

DateTime

TimeStamp Date associated to payment expiration

  • UTC hour
Alphanumeric Any

TotalPrice / DetailCurrencyPrice / Total

Attribute

Code

Currency associated to offer and sum of base amount and taxes Alphanumeric Any

TotalPrice / DetailCurrencyPrice / Taxes / Total

Attribute

Code

Currency associated to offer and sum of taxes Alphanumeric Any

Disclosure / Description

Attribute

refs

Reference to associated flight conditions specified in disclosure list Alphanumeric Any

PricedOffer / OfferPrice

Attribute

OfferItemID

Offer Item identification for the offer and type of passenger Alphanumeric Any

PricedOffer / OfferPrice / RequestedDate / PriceDetail / TotalAmount / SimpleCurrencyPrice

Attribute

Code

Currency associated to offer and sum of base amount and taxes  Alphanumeric Any

PricedOffer / OfferPrice / RequestedDate / PriceDetail / BaseAmount

Attribute

Code

Currency associated to offer and base amount (Fare)  Alphanumeric Any

PricedOffer / OfferPrice / RequestedDate / PriceDetail / Taxes / Total

Attribute

Code

Currency associated to offer and sum of taxes Alphanumeric Any

PricedOffer / OfferPrice / RequestedDate / PriceDetail / Taxes / Breakdown / Tax / Amount

Attribute

Code

Currency associated to offer and quantity of specific tax Alphanumeric Any
PricedOffer / OfferPrice / RequestedDate / PriceDetail / Taxes / Breakdown / Tax / TaxCode Specific tax identification Alphabetical Any
PricedOffer / OfferPrice / RequestedDate / Associations / AssociatedTraveler / TravelerReferences Traveler reference associated to offer item and price Alphanumeric Any

PricedOffer / FareDetail / FareComponent

Attribute

refs

Flight identification like (IB343820190426 or IB382620190504 TO-TO for a private fare) Alphanumeric Any
PricedOffer / FareDetail / FareComponent / FareRules / Penalty / ApplicableFeeRemarks / Remark In this case, QPX only returns associated remarks for first solution, so this field will be emty. Empty Empty
PricedOffer / FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Type Type of action like Cancel, Change... Alphabetical

Any

Ex: Cancel, Change

PricedOffer / FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Application / Code

Associated Code to action refered above like Change, Cancel

FAT Fare or application penalty type
1 No show
2 Prior to departure
3 After departure

Numeric Any (1, 2, 3...)
PricedOffer / FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Application / TableName Code of table name associated to action refered above like Change, Cancel Alphabetical FAT

PricedOffer / FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Amounts / Amount / CurrencyAmountValue

Attribute

Code

Associated currency and penalty amount Alphanumeric Any
PricedOffer / FareDetail / FareComponent / FareRules / Penalty / Details / Detail / Amounts / Amount / AmountApplication Identifies minimum and maximun penalty amount Alphabetical
  • minPrice
  • maxPrice
PricedOffer / Associations / AssociatedTraveler / TravelerReferences Traveler reference associated to the offer item and specified price Alphanumeric Any

PricedOffer / Associations / ApplicableFlight / FlightSegmentReference

Attribute

refs

Flight identification like (IB343820190426 or IB382620190504 TO-TO for a private fare) Alphanumeric Any

PricedOffer / Associations / ApplicableFlight / FlightSegmentReference / ClassOfService / Code

Attribute

SeatsLeft

Associated cabin code and reamining seats Alphanumeric Any

PricedOffer / Associations / ApplicableFlight / FlightSegmentReference / ClassOfService / MarketingName

Attribute

CabinDesignator

Type and fare family name of the cabin, like ECONOMY > Flexible Alphabetical Any
PricedOffer / Associations / ApplicableFlight / FlightSegmentReference / BagDetailAssociation / CheckedBagReferences Service reference for checked bags associated to offer Alphanumeric Any
PricedOffer / Associations / ApplicableFlight / FlightSegmentReference / BagDetailAssociation / CarryOnReferences Service reference for carry on bags associated to offer Alphanumeric Any
<Commission> (Only if Sender is Real IATA)

Percentage

Percentage of commission Numeric Any

Amount

Amount of commission Numeric Any
<Datalists / AnonymousTravelerList>

AnonymousTraveler 

Attribute

ObjectKey

Passenger Identifier (ADULT_01...) Alphanumeric Any
PTC Passenger Type (ADT, CHD, INF) Alphabetical Passenger Types
<Datalists / RecognizedTravelerList>

RecognizedTraveler

Attribute

ObjectKey

Passenger Identifier (ADULT_01...) Alphanumeric Any
PTC Passenger Type (ADT, CHD, INF) Alphabetical Passenger Types
Name / Surname Recognized passenger surname Alphabetical Any
Name / Given Recognized passenger name Alphabetical Any
FQTVs / AirlineID Airline carrier for Frecuent Flyer number 2 Alpha 2 Alpha
FQTVs / Account / Number Frecuent Flyer number Numeric Number
<Datalists / CarryOnAllowanceList>

CarryOnAllowance 

Attribute

ListKey

Carry on Allowance Identifier Alphanumeric Any
CarryOnAllowance / PieceAllowance / ApplicableParty Text "Party" (Identifier for all conditions) Alphabetical Any
CarryOnAllowance / PieceAllowance / TotalQuantity Quantity allowed Numeric Number
CarryOnAllowance / PieceAllowance / ApplicableBag Identifier (Carry-On) Alphabetical Any

CarryOnAllowance / PieceAllowance / PieceMeasurements 

Attribute

Quantity

Quantity allowed Numeric Number
<Datalists / CheckedBagAllowanceList>

CheckedBagAllowance

Attribute

ListKey

Bag Allowance Identifier  Alphanumeric Any
AllowanceDescription / ApplicableParty Text "Party" (Identifier for all conditions) Alphabetical Any
AllowanceDescription / Descriptions / Description / Text Associated quantity text Alphanumeric Any

PieceAllowance 

Attribute

PieceAllowanceCombination

Piece Allowance Identifier

It will not be shown when the quantity text is 0
Alphabetical Any
PieceAllowance PieceAllowanceCombination / ApplicableParty

Text "Party" (Identifier for all conditions)

It will not be shown when the quantity text is 0

Alphabetical Any
PieceAllowance PieceAllowanceCombination / TotalQuantity

Quantity of allowed pieces 

It will not be shown when the quantity text is 0

Numeric Number
PieceAllowance PieceAllowanceCombination / Descriptions / Description / Text

Associated and descriptive text (Golf equipment, Ski Equipment...)

It will not be shown when the quantity text is 0

Alphanumeric Any
PieceAllowance PieceAllowanceCombination / PieceMeasurements Quantity

Quantity of pieces

It will not be shown when the quantity text is 0

Numeric Number
<Datalists / DisclosureList>

Disclosures

Attribute

ListKey

Identifier of selected fare (BFLROES, TBAESEU...) Alphabetical Any
Disclosures / Description / Text Descriptive text indicating services included in selected fare (Ex: Selección de asiento: Incluido, Equipaje de mano: 1 bulto) Alphanumeric Any
<Datalists / FlightSegmentList>

FlightSegment

Attribute

SegmentKey

Segment Identifier (Ex.: IB343820190426) Alphanumeric Any
FlightSegment / Departure / AirportCode Departure Airport Code Identifier (MAD, LIS...) Alphabetical Any
FlightSegment / Departure / Date Departure Flight Date (2018-12-27) numeric yyyy-MM-dd
FlightSegment / Departure / Time Departure Flight Time (17:50) numeric hh:mm
FlightSegment / Departure / AirportName Departure Airport Name (Madrid Adolfo Suarez-Barajas...) Alphabetical Any
FlightSegment / Departure / Terminal / Name Departure Terminal Name (4, 4S...) Alphanumeric Any
FlightSegment / Arrival / AirportCode Arrival Airport Code Identifier (MAD, LIS...) Alphabetical Any
FlightSegment / Arrival / Date Arrival Flight Date (2018-12-27) numeric yyyy-MM-dd
FlightSegment / Arrival / Time Arrival Flight Time (17:50) numeric hh:mm
FlightSegment / Arrival / AirportName Arrival Airport Name (Madrid Adolfo Suarez-Barajas...) Alphabetical Any
FlightSegment / Arrival / Terminal / Name Arrival Terminal Name (4, 4S...) Alphanumeric Any
FlightSegment / MarketingCarrier / AirlineID Marketing airline Identifier (IB, I2...) Alphanumeric Any
FlightSegment / MarketingCarrier / Name Marketing airline Name(Iberia...) Alphanumeric Any
FlightSegment / MarketingCarrier / FlightNumer Marketing flight Number Identifier (4370...) numeric Number
FlightSegment / OperatingCarrier / AirlineID Operating airline Identifier (IB, I2...) Alphanumeric Any
FlightSegment / OperatingCarrier / Name Operating airline Name(I2...) Alphanumeric Any
FlightSegment / OperatingCarrier / Disclosures / Description / Text Operating airline text description  Alphanumeric Any
FlightSegment / Equipment / AircraftCode Aircraft identifier (32A...) Alphanumeric Any
FlightSegment / Equipment / Name Aircraft Name (Airbus Industrie A320 (Sharklets)) Alphanumeric Any
FlightSegment / FlightDetail / FlightDuration / Value Estimated duration of flight (Ex: PT2H25M) Alphanumeric Any
<Datalists / FlightList>

Flight

Attribute

FlightKey

Flight Identifier (MADCDG20180927175000...) Alphanumeric Any
Flight / Journey / Time Flight time duration (PT2H5M)  Alphanumeric PT'hh'H'mm'M
Flight / Journey / SegmentReferences Segment Identifier (IB374020180927)  Alphanumeric Any
<Datalists / OriginDestinationList>

OriginDestination

Attribute

OriginDestinationKey

Origin and destination Identifier (MADCDG) alphabetic Any
OriginDestination / DepartureCode Departure Airport Code (MAD...) alphabetic Any
OriginDestination / ArrivalCode Arrival Airport Code (PAR...) alphabetic Any
OriginDestination / FlightReferences Complete flight reference (MADCDG20180927175000) alphabetic Any
<Datalists / MediaList>

Media

Attribute

ListKey

Identifier (Legal-Information") alphabetic Any
Media / MediaLink Link to information  alphabetic Any
<Datalists / ServiceList>

Service

Attribute

ObjectKey

Service object and reference alphanumeric Any

Service / ServiceID

Attribute

Owner

Airline ID and identifier of special need service alphanumeric Any
Service / Name Name of special need service (Ex: Silla de ruedas para rampas) alphabetic Any
Service / Descriptions / Description / Text Informative text of special need service, not needed to fill in order create xml with this text because this text is an only read text. alphanumeric Any

Service / Price / Total 

Attribute

Code

Associated amount and currency of special need service alphanumeric Any
Service  / BookingInstructions / SSRCode Special need code (BLND, WHCS...) alphabetic Special Needs
Service  / Associations /Traveler / TravelerReferences Reference of passenger with special need service (ADULT_01...) alphanumeric Any
<FareList> Only for Private Fares

FareGroup

Attribute

ListKey

Fare group reference alphabetic Any
FareGroup / Fare / FareCode / Code

Fare code

alphanumeric
  • 758
FareGroup / Fare / FareCode / Definition Fare group product definition alphabetic Any (Ex: TO-TO)
FareGroup / FareBasis / Code Fare basis code associated

Error messages

NDC Standard allow errors and warnings to be returned inside an 200 OK response. Errors returned with 200 OK will always be controlled errors result of external limitations as "Max accepted non-infant passengers is 9".

Update Cancel

HTTP STATUS CODE

EXAMPLE MESSAGE ERROR

REASON

795 ShoppingResponseID invalid: incorrect or out-of-date We apologise for the inconvenience. Please start your search again.
486 More than one resident code Only one Resident Discount may be selected
486 Incorrect resident or large family code Incorrect resident or large family code
486 More than one large family code Only one Large Family Discount may be selected
486 Point of sale different from España El descuento de familia numerosa no está disponible.
486 No enough time between flights The difference between the arrival time of your outbound flight and the departure time of your return flight is less than the minimum connecting time required to make the connection. Please modify your last selection and try again.
118 Incorrect data in FP System Unable to Process.