The OfferPrice Webservice provides the ability to quote (price) for flights for the selected itinerary as per IATA NDC schema standards. It returns a price quote for the selected flights, fare rules for each fare component and product attributes. It also returns Cabin Upsell (upgrade to the next available cabin only) options, if applicable.
Interface Design
Prepaid excess bag lead in price for all the Origin/Destinations in the itinerary, if applicable
In order to access our API, you will need to pass the following two http headers for each call
Client-key: Your 24-bit API connection key SOAPAction: OfferPrice17_2_V2
LIVE | PRE-LIVE | BETA |
---|---|---|
https://api.ba.com/selling-distribution/OfferPrice/17.2/V2 | https://test.api.ba.com/selling-distribution/OfferPrice/17.2/V2 | https://test.api.ba.com/selling-distribution/sandbox/OfferPrice/17.2/V2 |
WSDL
https://api.ba.com/selling-distribution/OfferPrice/17.2/V2?WSDL
Please update your WSDL to point to the correct endpoint.
Paste this URL into the SOAP address location.
Example:
<service name= "OfferPriceDistributionAdapter" >
<port name= "OfferPriceDistributionAdapterSoap11" binding= "tns:OfferPriceDistributionAdapterSoap11" >
<soap:address location= "[Paste the Test URL here]" />
</port>
</service> |
The service returns the total price, fare, and tax with tax break down along with the fare rules for each passenger type for the requested itinerary for all passengers in PricedOffer.
The service will return prices in the currency of the agent’s country. Please note that the penalty fee will still be returned in the currency of the country where the journey commences. Example, if an agent from Paris making a request for LHR-NYC then both AirShopping and OfferPrice service will return prices in Euro (based on the agent’s country) and the penalty fee in GBP.
The service returns price quote in the next available selling class of the same cabin if the requesting selling class was sold out. A warning message will be returned in this scenario to inform the customer of the change in the selling class.
The service will not return Cabin Upsell option for MultiCity/Stopover, open jaw Itineraries, itineraries containing mixed cabins (e.g. LHRJFK in Economy and JFKLHR in Premium Economy)
The service supports the below Leisure Fare types
The service expects clients to always pass the fare basis code in OfferPriceRQ when creating a booking in order to quote the correct fare product for the itinerary even if the request is for a non-Economy cabin
The service returns an error if the requested Leisure fare is not available i.e the service will not default to the published fare if the requested leisure fare is not available
The service rejects the request and returns an error if the agent is not eligible to request for leisure fare types
The service will returning Cabin Upsell option for corporate and agents eligible for private fares.
The service returns prices in exact decimal value based on the currency (e.g. GBP will be returned at 2 decimals, while JPY will be returned at integer level only).
The service checks if the agent calling the service has the right to create BA bookings. If the agent does not have such authority then the service will not proceed and will return an error.
The service checks if the requesting Travel Management Company (TMC) is allowed to service the corporate and returns error if it is not allowed.
The service returns responses in the agent’s preferred language. If the agent’s preferred language is not supported by BA or the agent’s preferred language is not passed in the request then the default language will be used, which is English. Please see section 7 for the languages that are supported by BA.
The service returns Payment Time Limit (also known as Ticket Time Limit) if applicable. This is the deadline by which a commitment to pay must be made for the confirmed items in an offer as agreed with the airline. This is also called as Ticket Time Limit, as tickets will only be issued once payment is made.
Air Passenger Duty (APD) no longer applies to passengers aged between 12 and under 16 years old travelling in Economy after 1st March 2016. For travel on or after this date, BA needs to know if anyone in this age range is travelling so that APD is not charged for them. Therefore, it is advised for clients to provide passenger’s age in all BA NDC services so that the service will know the passenger is a young adult and won’t charge APD.
The OfferPrice service returns prepaid excess baggage lead in price for all origin/destination (if applicable) in the itinerary. If for any of the origin/destination prepaid excess bag lead in price is not returned, it means prepaid excess bags can’t be purchased on that origin/destination.
The total price returned by the OfferPrice service is the amount to be charged for the flights. The booking will not succeed even if there is a penny difference.
Cabin Upsell option –. Cabin upsell offer is returned in OtherOffer. The service returns both one way and return journey cabin upsell offers. Example: If the requested itinerary is LHR-AMS Economy then cabin upsell option will be returned for LHR-AMS in Business, if applicable. Similarly, if the requested journey is LHR-AMS-LHR in Economy then cabin upsell option will be returned for LHR-AMS in Business and AMS-LHR in Business. Cabin upsell option is returned with the total price, base fare and total tax with a break down along with fare rules for each passenger type and total offer price for all the passengers. If the client were to choose the cabin upsell option then they have all the information to construct OrderCreateRQ and create a booking
The OfferPrice service returns seat lead in price for all flights (if applicable) in the itinerary. If for any of the flights seat lead in price is not returned, it means seats can’t be purchased on that flight
Seat Lead-in price is returned only for the requested itinerary and not for the cabin upsell offers.
Prepaid Excess Bag Lead-in price is returned only for the requested itinerary
Prepaid Excess Bag Lead-in price is returned only for the requested itinerary and not for the cabin upsell offers
In OfferPriceRS, the secure flight flag is returned for each flight segment – Client should pass the APIS details (DOB and Gender) in OrderCreateRQ if this Boolean was returned as “true” for at least one of the flight segment.
In OfferPriceRS, applicable payment cards that the client can use in OrderCreateRQ are returned. Applicable payment cards are decided based on agent’s country and customers billing country. If customer’s billing country is not specified in OfferPriceRQ then applicable payment cards will be returned based on agents country only
Although the list of applicable cards remain the same for both PricedOffer (requested itinerary) and OtherOffer (cabin upsell offer) some credit cards may not incur a card surcharge if the customer has chosen to book cabin upsell offer. This is clearly indicated in the response by associating each card with an offer id (PricedOffer or OtherOffer or Both)
Clients can only request one Leisure Fare type per request. If more than one Leisure Fare is requested then the service will apply the first Leisure Fare type it finds from the list
BA offers different fare products within Economy cabin only and the name will vary based on the journey haul type
For short-haul journeys, the below fare products are offered