Offer Management - NDC API Offer Features & Capabilities

Technical Documentation

Offer Management

NDC API Offer Features & Capabilities

Last Updated: 16 Dec 2021 14:14

Introduction

British Airways offers industry leading selling capabilities via its NDC APIs. This page will provide an overview about all capabilities and supported functionality. Associated API flows are below for each function. Each API should be called in turn passing details taken from the previous call into the next API call, details can be found on the individual API call details pages.

Supported fare products

Published Fares
Corporate Fares
Tour Operator Deferred
Tour Operator Semi-Deferred
Contract Bulk
Private Fare Adult
Marine
Humanitarian

NDC offer storage overview

In British Airways NDC APIs, we offer to ways to shop for offers:

Short Sell
Long Sell

The preferred approach to shop for offers is by using short sell functionality, information of which can be found below:

OfferStorage

Instant purchase payment options

We accept the following form of payments via our NDC API's

Debit Cards
Credit Cards
IATA BSP Special Cash
ARC Special Cash
3D Secure 1.0
3D Secure 2.0
E-Vouchers for flights
Residual Value Vouchers for flights

Information to help make better choices

Fare Labels for Leisure Fares / Negotiated and Non-Negotiated fares

Agents are able to shop for Offers based on Fare type preference (Negotiated, Non-Negotiated, Leisure) by passing it in the AirShopping request. AirShopping will return Offers based on the Fare type requested, if available for the Agent. Agents then make a booking by choosing an appropriate Fare returned in Offer.

Change and Cancellation Fare Rules

BA has introduced a new PADIS code, 70G to enable TMCs to uniquely shop for and identify corporate fares. This will be a new way for customers to request corporate fares and will be available in Short Sell of the BA 17.2 APIs only.

Cabin Upsell offer

BA will enable product upsell at offer price within cabin e.g. From a fare without a bag to a fare with a bag. This will be for all agents

Industry Standard Cabin Names

BA will be standardising cabin names across all APIs to make it easier for developers to identify cabins relating to different offers, especially where there are multiple airline carriers.

British Airways NDC Offer Management Overview - Flows

Shop for Flights

Airshopping

OfferPrice

OrderCreate

The AirShopping API can be called using any combination of the below filters:

Calendar led pricing
Shopping by cabin class
Shopping for cheapest or flexible offers
Shopping by Departure and Arrival times
Shopping for direct flights
Shopping by Ticketing Time Limit
Shopping by maximum connecting time
Shopping by aircraft type
Shop for Negotiated / Non-Negotiated fares or both
Shop for fares with or without cabin baggage allowance in Economy class

Capability not yet supported:

Redemption availability
Non-flight (hotel) availability
Maximum 6 Origin and Destination can be requested
Calendar offers are not supported for Origin and Destination greater than two
Baggage allowance (currently only be supported for all routes operated by BA and codeshare flights).
Cannot be called for Group availability (more than 9 passengers)
Cannot be called for Unaccompanied Minor (children travelling alone, up to age 15)

Shop for Flights with Prime Sale Baggage

During prime sale booking flow you can also add additional baggage to any offer using the below API flow:

Shop for Flights with Prime Sale Seating

During prime sale booking flow you can also complete seat selection for both paid and free seating by using the below API flow.

note: paid seats are cheaper during prime sale and will cost more if adding a paid seat to an already created order
note: only can call Seatavailability once as OrderCreate only accepts 1 ResponseId for the selected seats

Shop for Flights with Prime Sale Seating and Additional Baggage

During prime sale booking flow you can also add seating and additional baggage by following the below API flow. Offer details must be selected and passed to OrderCreate.