This service returns priced availability for each flight for the requested origin and destination, date and cabin. The service also returns priced availability for higher cabins (normally the next two). For example, if availability is requested for Economy, the service will return priced availability for Economy, Premium Economy and Business (assuming these cabins are offered on the route requested).
The service also returns brand attributes for each cabin for which availability is returned.
Interface Design
This web service is called with the following inputs:
The output data this service returns include:
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: AirShopping17_2_V1
LIVE | PRE-LIVE | BETA |
---|---|---|
https://api.ba.com/selling-distribution/AirShopping/17.2/V1 | https://test.api.ba.com/selling-distribution/AirShopping/17.2/V1 | https://test.api.ba.com/selling-distribution/sandbox/AirShopping/17.2/V1 |
WSDL
https://test.api.ba.com/selling-distribution/AirShopping/17.2/V1?WSDL
Please update your WSDL to point to the correct endpoint.
Paste this URL into the SOAP address location.
Example:
<service name= "AirShoppingDistributionAdapter" >
<port name= "AirShoppingDistributionAdapterSoap11" binding= "tns:AirShoppingDistributionAdapterSoap11" >
<soap:address location= "[Paste the Test URL here]" />
</port>
</service> |
The service returns priced availability for the requested cabin and (up to) the next 2 higher cabins, if applicable. Example: If the requested cabin is “Economy”, the AirShopping response returns OfferGroup for “Economy”,” Premium Economy” and “Business” cabins as well
The service returns brand attributes only when the OfferGroup contains flights that are both BA operated and marketed. For connection journeys and journeys that involve Codeshare flights (BA marketed and other carrier operated) brand attributes will not be returned
The service returns availability for the nearest day (if applicable) when there is no availability or the flight is not operating on the requested date.
The service will return prices in the currency of the agent’s country provided that currency is accepted by the BSP (Billing and Settlement Plan). For countries that support more than one currency, the service will return in the currency that is accepted by the BSP for IATA Accredited agents, and the currency accepted by ba.com for other retailers. For example, Mexico supports both USD and MXN but the service returns the price in MXN for IATA accredited agents, as MXN is what is accepted by the BSP. Other retailers will receive a price in USD.
The service returns flights based on British Airways carrier preferred availability.
The service returns the lowest available Adult, Young Adult, Child and Infant prices.
The service returns airline offers sorted by Total Price in an ascending order. This will mean that the Airline Offer will get more expensive as you work through the response.
Clients will be able to request any of the below Leisure Fare types
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 returns calendar recommendation if at least one O&D contains DaysBefore and DaysAfter attributes with non-zero value
The service expects clients to always pass the fare basis code in OfferPriceRQ in order to quote the correct fare product for the itinerary even if the request is for a non-Economy cabin:- In AirShoppingRS, fare basis code is returned for each offer for each passenger type. If the client were to select one of the offers and proceed with OfferPriceRQ then it is expected that the fare basis code for the offer is provided in OfferPriceRQ
The service expects clients to always pass the fare basis code in OfferPriceRQ in order to quote the correct fare product for the itinerary even if the request is for a non-Economy cabin:- In AirShoppingRS, fare basis code is returned for each offer for each passenger type. If the client were to select one of the offers and proceed with OfferPriceRQ then it is expected that the fare basis code for the offer is provided in OfferPriceRQ
The service 'negotiated’ fare offers if ‘negotiated’ fares are requested, ‘non-negotiated’ fare offers if ‘non-negotiated’ fares are requested, either ‘negotiated’ or ‘non-negotiated’ fare offer if both ‘negotiated and non-negotiated’ fares are requested and ‘cheapest of negotiated and non-negotiated’ fare offers if no fare type is requested.
Leisure fare type takes the preference to return the offers even if other fare types like ‘Negotiated’ and/or ‘Non-Negotiated’ fare types in the request along with leisure fare type