OfferPrice 24.1
Functional Description
OfferPrice is used to request a Priced Offer from a previous Offer obtained via AirShopping. This Offer will be linked to OfferItems and a passenger reference.
OfferPrice returns detailed availability Offers with prices for specific flights and includes a breakdown of the Fare and taxes, along with more detailed information about the product, such as payment terms, cancellation and change policies (restrictions), and baggage allowance.
Search options:
Iberia offers three ways to use OfferPrice:
OfferPrice: Use this option when you have used our AirShopping API and obtained an OfferID and the Fare details.
OfferPrice (Longsell): Use this option when you have used a third-party booking engine and know the specific flights you require. As a result, we return several Offers containing all the available Fare products for the requested flights.
OfferPrice (Ancillaries merge): Combine the details of flight offers and ancillary offers into a single Priced Offer (Consolidation OfferPrice).
If ancillaries are included in the pre-sale, a consolidated OfferPrice must be generated. Currently unavailable.
Although the OfferPrice API is stateless, it is recommended (and assumed) that it will be called as part of the following sequence of Shop and Order APIs, unless you are using a third-party Shopping (Availability and Pricing) engine.
Upsell - In the OfferPrice response, you can obtain higher Offers with blended families than the requested Offer. This option can also be combined with several functionalities and products, such as Private Fares and Discounts.
Terms and conditions of the Offers:
Offer Expiration - This is the time at which the offer expires and is no longer in our Offer Management System. Any OrderCreateRQ Message sent after this time will not generate an Order.
Payment - For offers that have instant purchase rules and less than four hours until departure, no PaymentTimeLimitDateTime value will be returned, and full payment must be included in the OrderCreateRQ message. For offers that have instant purchase rules and more than four hours until departure, a PaymentTimeLimitDateTime will be returned, giving a grace period of two hours to complete the payment process. For all other offers, the PaymentTimeLimitDateTime value will reflect the rules of the Fare/Product.
Price Guarantee - Offers are valid for a limited period during which the price of the journey is guaranteed. If this period expires, the price of the selected offer may change.
Discounts:
Frequent Flyer details from any airline can be included in this message; however, the Iberia Plus and/or OneWorld and/or LATAM membership will be validated if the number is provided. If the validation is successful, the corresponding tier benefits will be applied. If the validation fails, the purchase process will continue and a warning will be included in the response.
Special Fares and discounts are available, such as On Business and Corporate programs.
If you are a resident of the Canary Islands, the Balearic Islands, Ceuta or Melilla, the discount offered by the Spanish Government (only for Point of Sale Spain) will appear (provided you have previously entered your details in AirShopping). If you are part of a large family, you can also benefit from a discount when booking a journey through OfferPrice.
Inputs |
|---|
The following parameters can be used as inputs for the OfferPrice:
The following parameters can be used as inputs of the Longsell OfferPrice option:
The following parameters can be used as inputs of the Consolidation OfferPrice option (Currently unavailable):
|
Outputs |
|---|
The following parameters are returned as outputs of the OfferPrice service: A single PricedOffer object containing:
An OtherOffers object containing the offers for selected services (if any), each containing:
|
OfferPrice Warnings
Warning OfferPrice Code | Description Text | PADIS Code |
|---|---|---|
NDC-200DP0001 | Cabin preference not taken into account | 155 |
NDC-200LY0001 | Loyalty program not supported | 709 |
NDC-200LY0002 | Information for the given Loyalty Account Number not found | 753 |
NDC-200LY0003 | No applicable loyalty account was found for passenger | 709 |
NDC-200LY0004 | Loyalty information provided does not match previous information for the passenger. It won’t be taken into account | 709 |
NDC-200LY0005 | New loyalty information will not be used to modify the offer conditions | 709 |
OfferPrice Errors
Error OfferPrice Code | Text | PADIS Code |
|---|---|---|
NDC-400DC0001 | Ordinals cannot be repeated in DistributionChain | 486 |
NDC-400DC0002 | DistributionChain links must be ordered by the Ordinal field | 486 |
NDC-400DC0003 | First DistributionChain link must be a Seller | 486 |
NDC-400DC0004 | Seller not included in DistributionChain | 486 |
NDC-400DC0005 | Only one seller allowed in DistributionChain | 486 |
NDC-400DC0006 | Multiple DistributionChain links with the same OrgID | 486 |
NDC-400DC0007 | Distribution chain link not accepted | 91 |
NDC-400DC0008 | Distribution chain link not accepted | 91 |
NDC-400DP0001 | Functionality not supported | 155 |
NDC-400DP0002 | Flight Item must reference a valid OriginDest | 795 |
NDC-400DP0003 | Invalid or incomplete flights info | 73Q |
NDC-400DP0004 | Only one Create Order Item accepted in Offer Price Message | 795 |
NDC-400DP0005 | All ODs must be referenced from Flight Item | 795 |
NDC-400DS0001 | Wrong format for Distributor ID | 914 |
NDC-400DS0002 | Distributor ID is not valid | 144 |
NDC-400DS0003 | Distributor not valid | 144 |
NDC-400DT0001 | Departure dates for all slices must be a date in the future | 102 |
NDC-400DT0002 | Departure date for each slice must be later than the date of the previous slices | 102 |
NDC-400DT0003 | Only flights within next 360 days are available | 102 |
NDC-400DT0004 | Departure date for each segment within an Origin/Destination must be later than the date of the previous segments in the same OD | 102 |
NDC-400DT0005 | Departure date for the first segment within an Origin/Destination must be the same as the departure date of the OD | 102 |
NDC-400LY0001 | Loyalty Account Number not provided | 753 |
NDC-400LY0002 | Airline Designator for the Loyalty Program not provided | 709 |
NDC-400OF0001 | Only one flights offer allowed | 309 |
NDC-400OF0002 | Pax association with offer and offer items has changed | 490 |
NDC-400OF0003 | Wrong offer items for this offer. Functionality not supported | 491 155 |
NDC-400OF0004 | Mandatory offer items missing. A flights offer must be provided | 491 795 |
NDC-400OF0005 | Invalid combination of offers. Only priced offers are allowed to combine with ancillaries offers | 294 |
NDC-400OF0006 | Functionality not supported | 155 |
NDC-400OF0007 | A flights offer must be provided | 795 |
NDC-400PX0001 | There are many passengers with the same PaxID | 476 |
NDC-400PX0002 | Only ADT passengers can hold references to other passengers | 486 |
NDC-400PX0003 | Only INF passengers can be referenced by other passengers | 486 |
NDC-400PX0004 | Only one ADT passenger can hold reference to each INF passenger | 486 |
NDC-400PX0005 | Some of the passenger type codes are not supported. Only valid passenger types are ADT, CHD and INF | 143 |
NDC-400PX0006 | Max number of passenger per request exceeded | 68 |
NDC-400PX0007 | Number of infants exceeds maximum allowed per adult passenger | 324 |
NDC-400PX0008 | At least an adult passenger is needed in the request | 486 |
NDC-400PX0009 | Wrong format for Passenger ID | 486 |
NDC-400PX0010 | Referenced passenger does not exist | 486 |
NDC-400PX0011 | Passenger information in request does not match information provided previously for this offer | 492 |
NDC-400PX0012 | One or more pax ids referenced in offerItems are not present in the provided pax list | 492 |
NDC-400SL0001 | Wrong format for Seller ID | 914 |
NDC-400SL0002 | Seller ID is not valid | 144 |
NDC-400SL0003 | Seller not valid | 486 |
NDC-404OF0001 | Flights Offer not found | 490 |
NDC-404OF0002 | Offer expired | 490 |