Shop: Shop For or with Ancillaries [SHPANC]

Guidance for Schema Version:

21.3

Definition of Capability

Airline

This capability allows the Airline to provide a list of available services based on Flight details and defined dates. The airline may consider additional qualifiers and context in the process of calculating the resulting offers.

Seller

This capability allows the Seller to request from an Airline a set of Services based on:

• OfferId

• OrderId

• Flight Details, passenger type and defined dates (PaxSegment)

The Seller may provide additional qualifiers and context which the Airline may consider in the content of the resulting offer(s).

NOTE: System Providers will use the above definition that pertains to their customers for Capabilities Verification.

Links to EASD Implementation Guidance

Capability: Shop for ancillaries: https://guides.developer.iata.org/v213/docs/capshp03-shop-for-ancillaries

Related Concepts, Capabilities and Worked Examples:

• Concepts: Offers & Orders: https://guides.developer.iata.org/v213/docs/offers-orders-1

• Capabilities: Offers & Orders: https://guides.developer.iata.org/v213/docs/shop and https://guides.developer.iata.org/v213/docs/order

• Worked Examples: Offers & Orders: https://guides.developer.iata.org/v213/docs/offers-orders-use-cases

NOTE: Retailing Capabilities Verification Guidance will align to the published EASD Implementation Guidance at all times. From time to time when new guidance is published this will be updated and supersede any Retailing Capabilities Verification Guidance listed below.

Retailing Capabilities Verification Guidance

Ancillary services can be provided in several steps of a shopping process, depending on an Airline’s implementation and message flow. Ancillaries are presented either as:

• an integral part of each offer being constructed

  • /IATA_AirShoppingRS/Response/OffersGroup/CarrierOffers/Offer/OfferItem

• or as 'A-La-Carte” Offer Items, which can be later selected and merged into an existing Offer

  • /IATA_AirShoppingRS/Response/OffersGroup/CarrierOffers/ALaCarteOffer/OfferItem

Ancillaries within regular Offer structures are not required to be mandatory (using the Mandatory indicator). This means the total price at the Offer level would not include these optional Offer Items. If set to mandatory (as would typically be the case with the flights within the Offer), the total price would reflect them and any other mandatory Offer Item within the Offer. Each optional ancillary Offer Item is, however, priced, which would later allow the Seller to calculate the payable amount of the mandatory items, as well as the optional ancillaries they select through OrderCreateRQ (or optionally OfferPriceRQ, if this step is required prior to Order creation).

Airlines can construct ancillary Offer Items directly via AirShoppingRQ/RS (and OrderReshopRQ/RS, in case of servicing), or separate them into the ancillary-specific message pair ServiceListRQ/ServiceListRS, depending on their implementation. Seat-related ancillaries, typically presented through the SeatAvailabilityRQ/RS message pair, are technically also A-La-Carte ancillary services which need to be selected in later steps of the shopping process and combined with their counterpart flight-related Offers (through OfferPriceRQ or OrderCreateRQ).

Airline

Demonstrate construction of ancillary Offer Items for seats and bags.

Seller

Request ancillary services and present ancillaries on front end.

NOTE: For all versions prior to that listed above (generally the most recent), the verification will be based on the guidance available for that version. In the case that no guidance is available, verification will be at IATA’s discretion.