Introduction

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

1. This web service is called with the following inputs:
   • List of flight segments and for each flight segment the departure airport, arrival airport, flight number, booking class (selling class) and cabin name etc.
   • Number of passengers with passenger type
   • Passenger details can also contain Name & FQTV details, if applicable.
   • Optional customer’s billing country
   • Leisure Fare Type
      
2. ​​​The output data this service returns include:
   • PricedOffer which contains:
     • The total amount for the requested itinerary for all the passengers
     • The total amount for the requested itinerary per passenger type
     • Fare and Tax split per passenger type with tax breakdown
     • Fare rules for each fare component
     • Product attributes per flight segment where applicable
     • Baggage allowance (hand baggage allowance and ticketed checked baggage allowance)
     • Price class details
     • Fare basis code for each passenger type and for each flight segment
     • Payment Time Limit (Ticket Time Limit), if applicable
        
   • OtherOffer with Offer which contains:
     • Cabin Upsell option (upgrade to next cabin) price per passenger type, if applicable
     • The total amount for the Upsell option for all the passengers
     • Fare and Tax split per passenger type with tax breakdown for Upsell option
     • Fare rules for each fare component of Upsell option
     • Product attributes per flight segment where applicable
     • Baggage allowance (hand baggage allowance and ticketed checked baggage allowance)
     • Price class details of Upsell 
     • Fare basis code for each passenger type and for each flight segment for Upsell
        
   • OtherOffer with Alacarte Offer which contains:
     • Seat lead in price for all flights in the itinerary, if applicable

     • Prepaid excess bag lead in price for all the Origin/Destinations in the itinerary, if applicable 

   • Payment options:
     • List of applicable payment cards with surcharge, if applicable
     • Mandatory and optional payment card details that should be specified when making a payment
     • Mandatory and optional billing address details that should be specified when making a payment

 

HttpHeaders

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

 

Endpoints

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. 

1. Copy the Test URL ie  https://test.api.ba.com/selling-distribution/OfferPrice/api/V1

2. Paste this URL into the SOAP address location.
   Example:

   WSDL Snippet Example

   <service name="OfferPriceDistributionAdapter">     <port name="OfferPriceDistributionAdapterSoap11" binding="tns:OfferPriceDistributionAdapterSoap11">       <soap:address location="[Paste the Test URL here]"/>     </port> </service>

 

Service Features and Restrictions

 

Returns the total price, fare and tax with tax break down

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. 

Return prices in the currency of the agent’s country

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.

Returns price quote in the next available selling class of the same cabin if the requesting selling class was sold out

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.

Will not return Cabin Upsell option for MultiCity/Stopover, open jaw Itineraries, itineraries containing mixed cabins

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)

Supports the below Leisure Fare types (expand for the list)

The service supports the below Leisure Fare types

1. Inclusive Tour
2. Humanitarian
3. Marine (currently disabled)
4. Contact Bulk
5. Private Fare Adult

Expects clients to always pass the fare basis code in OfferPriceRQ

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

Returns an error if the requested Leisure fare is not available

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

Rejects the request and returns an error, if the agent is not eligible to request for leisure fare types

The service rejects the request and returns an error if the agent is not eligible to request for leisure fare types

Will Return Cabin Upsell option for corporate and agents eligible for private fares.

The service will returning Cabin Upsell option for corporate and agents eligible for private fares.

Returns prices in exact decimal value based on the currency

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

Checks if the agent calling the service has the right to create BA bookings

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.

Checks if the requesting Travel Management Company (TMC) is allowed to service the corporate and returns error if it is not allowed

The service checks if the requesting Travel Management Company (TMC) is allowed to service the corporate and returns error if it is not allowed.

Returns responses in the agent’s preferred language

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.

Returns Payment Time Limit (also known as Ticket Time Limit) if applicable

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 in the UK

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.

Returns prepaid excess baggage lead in price for all origin/destination (if applicable)

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.
 

General

The total price returned by the OfferPrice service is the amount to be charged for the flights

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

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

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

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

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

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

Some credit cards may not incur a card surcharge if the customer has chosen to book cabin upsell offer

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

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

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 (Expand for the list)

For short-haul journeys, the below fare products are offered

1. Basic
2. Plus
3. Plus Flex

For long-haul journeys, the below fare products are offered (Expand for the list)

1. For long-haul journeys, the below fare products are offered
   1. Basic
   2. Standard
   3. Standard Flex