ServiceList 17.2
Functional Description - Release 2024.04
ServiceList API returns a catalogue of Ancillary items for the selected Offer or Order. Today this includes Bags, Sport equipment and Priority Boarding.
Ancillaries can be purchased as part of the Shopping flow following the OfferPrice, or as part of a servicing flow after the initial Order has been created and paid for.
ServiceList also returns Special Needs services for the selected offer. Today this includes:
BLND (Blind Passenger)
DEAF (Deaf Passenger)
WCHR (Wheelchair for ramp)
WCHS (Wheelchair for steps)
DPNA (Disabled Passenger Needs Assistance)
Note: If you request Special Needs in ServiceList, any Special Needs services requested in a previous OfferPrice will be overwritten, and you must refer to those returned in the ServiceListRS.
NEW Bags can now be booked in the presale flow (in OrderCreate) with payment, or held without payment together with the unpaid flights. A specific PaymentTimeLimit may be returned for the bags, unless they require instant payment, in which case the entire Order must be paid for in the OrderCreate. An Order on hold must be paid for in full (all OrderItems) using the OrderChange - Payment.
Maintaining backward compatibility, bags of 23kg can be purchased in both Presale and Servicing flows, for this no ServiceFilter/GroupCode needs to be sent in the ServiceListRQ message, (which today is needed to see bags of 15kg and 32kg).
However, the other Ancillaries (Priority Boarding and Sport Equipment) cannot be pre-booked/purchased unless the Order has been paid for in full and ticketed, and therefore cannot be added to an unpaid Order. Orders must first be paid and issued and then Ancillaries can be added in a servicing flow.
Validated Iberia Plus information passed and validated in a previous OfferPrice, or validated and stored in a previously created Order will be used for any Ancillaries, applying any tier advantages applicable.
Servicing operations for corporate will only validate that travel agency indicated in the request is the same as generated the order. If corporateID is present in the request, it will only be checked when the order has been generated with corporateID.
Ancillary services will only be returned for IB, I2, YW and LV operated flights.
Whenever servicing an existing Order, an OrderRetrieve should always be done before using this service. This ensures you have the latest version of the Order, which could have changed.
Examples of messages with complete flows can be downloaded from here.
