Air Merchandising Offer Availability for Low Cost and API Carriers

Optional Services can be searched for both pre- and post-booking segments. The frequent flyer and IATA, if available, are used to get the correct price for an optional service.

Only easyJet on Airline Content Hub (ACH) supports post-book modifications. Before Optional Services can be added post book, a Universal Record (UR) must exist. If a UR exists, Universal API validates that the carrier supports modification of booking, post book.

Schema

Located in AirReqRsp.xsd:

Request

Follow the process to send an Air Merchandising Offer Availability request.

Note: The Point of Sale for United Airlines must be US.

Include HostReservation if available. If multiple HostReservation attributes are sent in the request, only one Universal Record must exist.

Note: ACH carriers that support post-book modification require HostReservation.

Enter loyalty card and currency information, as necessary.

Loyalty Cards

If a loyalty card is sent for an API carrier, it must be sent in the Air Booking, not the Offer Availability request. API carriers do not use a Loyalty Card if it is sent in the Offer Availability request. If a loyalty card is sent in the Offer Availability request, a warning is returned:

The vendors may not use the loyalty card(s) sent in the request.

If an invalid Loyalty Card is sent in the request, it is ignored an no warning is returned.

United Airlines: If a loyalty card is not included in the booking, UA uses the loyalty card in the Air Merchandising Offer Availability request.

Currency

All carriers do not support all currencies.

Delta Airlines: If an unsupported currency is sent in the initial request for paid seating bookings, the currency is replaced with the default currency (USD), and the transaction is completed in the default currency. A warning is returned: The requested currency is not supported by the adapter

United Airlines: If any currency other than USD is sent in the initial request for paid seating bookings, the currency is replaced with the default currency (USD), and the transaction is completed in the default currency. A warning is returned: The requested currency is not supported by the adapter

Response

The Air Merchandising Offer Availability response returns optional services including additional details within each optional service:

OptionalServiceRules that display the rules for the optional service, including the maximum number of passengers for whom the optional service can be purchased, may also be returned.
Discounted or free seats based on loyalty membership, agency affiliations, etc. Typically, the best price available for any one passenger is also applied to any other passengers in the booking. Responses may vary by carrier.

In OptionalServices/OptionalService/ServiceData, each seat Optional Service is associated with a single booking traveler. This creates one optional service for every booking traveler reference that includes the BookingTravelerRef and AirSegmentRef in one ServiceData element.

Note: When an Air Merchandising Offer Availability request is sent with HostReservation, Universal API returns a non-paid or paid seat Optional Service that was sold previously with OptionalService @ServiceStatus="Fulfilled" in Air v28.0 and greater.

Errors and Warnings

If the LCC does not support modify, then the following error is returned to the client:

Carrier XX does not support changing optional services after the booking. (Where XX is the carrier code).

United Airlines

An error is returned from ACH and passed in the Universal API response if the point of sale is anything other than US.