ServiceList 19.2

Attachments

Introduction

This service provides Travel Agents with the ability to get ancillary services catalogue (paid and free) applicable to the PNR. It returns a list of all applicable ancillary, decryption, media data, marketing UI labels and price details. To add ancillaries to the PNR use OrderChange 19.2 service.

ServiceList Webservice

This service returns the ancillary catalogue.

Limitations (This list is not exhaustive)

Variety of available ancillary services in the catalogue is limited by the Airline's business rules;
Meals purchase is allowed: 12h before departure from IEV, 40h before departure from CAI and 36h before departure from other airports.

This web service is called with the following inputs:

OrderID
Currency
Language

The output data this service include:

ResponseID
List of applicable services and for each service
- Service name
- Service description
- Price
- Passenger reference
- Flight association
- Maximum quantity
- Media link

Flight detail
Passenger details
Error message if something went wrong during ServiceListRQ/RS

Access

In order to access API, you will need to pass the following two headers for each call.

Authentication and authorization stand on the protocol layer using basic HTTP authentication. Given username and password with separator “:” MUST be base64-encoded and passed as HTTP header “Authorization”. This header is mandatory for all requests. For example, if "TestLogin" set as the username and "TestPass" set as the password, then the field's value are base64-encoding of TestLogin: TestPass, or QWxhZGRpbjpPcGVuU2VzYW1l. Then the Authorization header will appear as Authorization: Basic QWxhZGRpbjpPcGVuU2VzYW1l

Header 'Content-Type: text/xml'
Message structure: <soapenv:Envelope><soapenv:Body> Message... </soapenv:Body></soapenv:Envelope>

ServiceListRQ structure

ServiceListRQ by OrderId

<IATA_ServiceListRQ xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ NDC/19_2_schemas/IATA_ServiceListRQ.xsd">
	<MessageDoc>
        <RefVersionNumber>19.2</RefVersionNumber>
    </MessageDoc>
	<Party>
		<Sender>
			<TravelAgency>
				<AgencyID>TA123</AgencyID>
				<Name>TravelAgent</Name>
				<PseudoCityID>IEVPS28ND</PseudoCityID>
			</TravelAgency>
		</Sender>
	</Party>
	<Request>
		<CoreRequest>
			<Order>
				<OrderID>e375647a-27f4-4dd7-a671-a6591be12457</OrderID>
				<OwnerCode>PS</OwnerCode>
			</Order>
		</CoreRequest>
		<ResponseParameters>
			<CurParameter>
				<RequestedCurCode>EUR</RequestedCurCode>
			</CurParameter>
			<LangUsage>
				<LangCode>UA</LangCode>
			</LangUsage>
		</ResponseParameters>
	</Request>
</IATA_ServiceListRQ>

ServiceListRQ fields description

M = Mandatory; O = Optional; C = Conditional

Field name	Description	M/O/C	Example
ServiceListRQ	The ServiceList transaction set returns a list of all applicable ancillary services that meet request qualifiers and flights. The message also returns multi-media content at the message level and media references at the individual service level.	M O	<IATA_ServiceListRQ xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRQ NDC/19_2_schemas/IATA_ServiceListRQ.xsd">
↳ MessageDoc	NDC Message Document information.	M
↳ RefVersionNumber	Service Version.	M	<RefVersionNumber>19.2</RefVersionNumber>
↳ Party	NDC Message/ Transaction Party(s) information. Note that information about parties is intended for business use, it is not intended for transaction authentication and routing of the message.	M
↳ Sender	Information related to the party sending this message.	M
↳ TravelAgency	SELLER: Travel Agency	M
↳ AgencyID	Unique Agency Seller ID. Example: TA123	M	<AgencyID>TA123</AgencyID>
↳ Name	Agency name. Example: Carson Travel	M	<Name>TravelAgent</Name>
↳ PseudoCityID	Travel Agent's Office ID.	M	<PseudoCityID>IEVPS28ND</PseudoCityID>
↳ Request	ServiceList request information.	M
↳ CoreRequest	Core Service List request including choice of Journey information, Offer, or Order references.	M
↳ Order	A uniquely identified record of the agreement of one party with another to receive products and services under specified terms and conditions.	M
↳ OrderID	Carrier assigned ID which uniquely identifies a specific Order across several messages.	M	<OrderID>e375647a-27f4-4dd7-a671-a6591be12457</OrderID>
↳ OwnerCode	Airline code assigned to a carrier. IATA-defined 2-character code.	M	<OwnerCode>PS</OwnerCode>
↳ ResponseParameters	Information related to how shopping results should be returned in the response.	M
↳ CurParameter	Requested search processing and results in currency information.	M
↳ RequestedCurCode	Currency Code as per ISO 4217.	M	<RequestedCurCode>EUR</RequestedCurCode>
↳ LangUsage	Language Code representation.	O
↳ LangCode	Language Code representation. Supports ISO 639-1 (two alpha character). Supported languages: Chinese ZH Czech CS English EN Finnish FI French FR German DE Greek EL Hebrew HE Italian IT Lithuanian LT Polish PL Russian RU Spanish ES Swedish SV Turkish TR Ukrainian UK	M	<LangCode>UA</LangCode>

ServiceListRS structure

ServiceListRS Meal+Bags+Transit Flights

<IATA_ServiceListRS xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRS ../NDC/19_2_schemas/IATA_ServiceListRS.xsd">
	<Response>
		<ALaCarteOffer>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG1</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX2</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b4e8</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL1</ServiceDefinitionRefID>
					<ServiceID>MEAL1_PAX2_SEG1</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG2</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX2</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b4ec</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL5</ServiceDefinitionRefID>
					<ServiceID>MEAL5_PAX2_SEG2</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG3</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX2</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b4f0</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL9</ServiceDefinitionRefID>
					<ServiceID>MEAL9_PAX2_SEG3</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG4</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX2</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b4f4</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL13</ServiceDefinitionRefID>
					<ServiceID>MEAL13_PAX2_SEG4</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG1</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX1</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b4f8</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL17</ServiceDefinitionRefID>
					<ServiceID>MEAL17_PAX1_SEG1</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG2</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX1</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b4fc</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL21</ServiceDefinitionRefID>
					<ServiceID>MEAL21_PAX1_SEG2</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG3</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX1</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b500</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL25</ServiceDefinitionRefID>
					<ServiceID>MEAL25_PAX1_SEG3</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxSegmentRefID>SEG4</PaxSegmentRefID>
					</FlightAssociations>
					<PaxRefID>PAX1</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryMeal:5fb7a2fb94c4f42cbee7b504</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>MEAL29</ServiceDefinitionRefID>
					<ServiceID>MEAL29_PAX1_SEG4</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">200.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxJourneyRefID>FL1</PaxJourneyRefID>
					</FlightAssociations>
					<PaxRefID>PAX2</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryLuggage:5fb7a2f894c4f42cbee7b4dd</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>BAGGAGE1</ServiceDefinitionRefID>
					<ServiceID>BAGGAGE1_PAX2_FL1</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">499.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxJourneyRefID>FL2</PaxJourneyRefID>
					</FlightAssociations>
					<PaxRefID>PAX2</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryLuggage:5fb7a2f894c4f42cbee7b4e0</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>BAGGAGE3</ServiceDefinitionRefID>
					<ServiceID>BAGGAGE3_PAX2_FL2</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">499.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxJourneyRefID>FL1</PaxJourneyRefID>
					</FlightAssociations>
					<PaxRefID>PAX1</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryLuggage:5fb7a2f894c4f42cbee7b4e3</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>BAGGAGE5</ServiceDefinitionRefID>
					<ServiceID>BAGGAGE5_PAX1_FL1</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">499.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<ALaCarteOfferItem>
				<Eligibility>
					<FlightAssociations>
						<PaxJourneyRefID>FL2</PaxJourneyRefID>
					</FlightAssociations>
					<PaxRefID>PAX1</PaxRefID>
				</Eligibility>
				<OfferItemID>AncillaryLuggage:5fb7a2f894c4f42cbee7b4e6</OfferItemID>
				<Service>
					<ServiceDefinitionRefID>BAGGAGE7</ServiceDefinitionRefID>
					<ServiceID>BAGGAGE7_PAX1_FL2</ServiceID>
				</Service>
				<UnitPrice>
					<TotalAmount CurCode="UAH">499.00</TotalAmount>
				</UnitPrice>
			</ALaCarteOfferItem>
			<OfferExpirationTimeLimitDateTime>2020-11-20T13:20:31.859+02:00</OfferExpirationTimeLimitDateTime>
			<OfferID>bd9ff707-b880-4212-8500-8a4560b17998</OfferID>
			<OwnerCode>PS</OwnerCode>
		</ALaCarteOffer>
		<DataLists>
			<OriginDestList>
				<OriginDest>
					<DestCode>CDG</DestCode>
					<OriginCode>ODS</OriginCode>
					<OriginDestID>OD1</OriginDestID>
					<PaxJourneyRefID>FL1</PaxJourneyRefID>
				</OriginDest>
				<OriginDest>
					<DestCode>ODS</DestCode>
					<OriginCode>CDG</OriginCode>
					<OriginDestID>OD2</OriginDestID>
					<PaxJourneyRefID>FL2</PaxJourneyRefID>
				</OriginDest>
			</OriginDestList>
			<PaxJourneyList>
				<PaxJourney>
					<Duration>P0Y0M0DT6H10M0.000S</Duration>
					<PaxJourneyID>FL1</PaxJourneyID>
					<PaxSegmentRefID>SEG1</PaxSegmentRefID>
					<PaxSegmentRefID>SEG2</PaxSegmentRefID>
				</PaxJourney>
				<PaxJourney>
					<Duration>P0Y0M0DT6H10M0.000S</Duration>
					<PaxJourneyID>FL2</PaxJourneyID>
					<PaxSegmentRefID>SEG3</PaxSegmentRefID>
					<PaxSegmentRefID>SEG4</PaxSegmentRefID>
				</PaxJourney>
			</PaxJourneyList>
			<PaxList>
				<Pax>
					<Individual>
						<Birthdate>1980-09-25</Birthdate>
						<GenderCode>M</GenderCode>
						<GivenName>ZERO</GivenName>
						<Surname>TRAVELLER</Surname>
						<TitleName>Mrs</TitleName>
					</Individual>
					<PaxID>PAX1</PaxID>
					<PTC>ADT</PTC>
				</Pax>
				<Pax>
					<Individual>
						<Birthdate>2015-09-25</Birthdate>
						<GenderCode>M</GenderCode>
						<GivenName>ONE</GivenName>
						<Surname>TRAVELLER</Surname>
						<TitleName>Mrs</TitleName>
					</Individual>
					<PaxID>PAX2</PaxID>
					<PTC>CHD</PTC>
				</Pax>
			</PaxList>
			<PaxSegmentList>
				<PaxSegment>
					<Arrival>
						<AircraftScheduledDateTime>2021-03-16T08:00:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>KBP</IATA_LocationCode>
						<TerminalName>D</TerminalName>
					</Arrival>
					<DatedOperatingLeg>
						<Arrival>
							<IATA_LocationCode>KBP</IATA_LocationCode>
						</Arrival>
						<CarrierAircraftType>
							<CarrierAircraftTypeCode>737</CarrierAircraftTypeCode>
						</CarrierAircraftType>
						<DatedOperatingLegID>LG1</DatedOperatingLegID>
						<Dep>
							<IATA_LocationCode>ODS</IATA_LocationCode>
						</Dep>
					</DatedOperatingLeg>
					<Dep>
						<AircraftScheduledDateTime>2021-03-16T07:00:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>ODS</IATA_LocationCode>
					</Dep>
					<Duration>P0Y0M0DT1H0M0.000S</Duration>
					<MarketingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<MarketingCarrierFlightNumberText>56</MarketingCarrierFlightNumberText>
					</MarketingCarrierInfo>
					<OperatingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<OperatingCarrierFlightNumberText>56</OperatingCarrierFlightNumberText>
					</OperatingCarrierInfo>
					<PaxSegmentID>SEG1</PaxSegmentID>
				</PaxSegment>
				<PaxSegment>
					<Arrival>
						<AircraftScheduledDateTime>2021-03-16T12:10:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>CDG</IATA_LocationCode>
						<TerminalName>2D</TerminalName>
					</Arrival>
					<DatedOperatingLeg>
						<Arrival>
							<IATA_LocationCode>CDG</IATA_LocationCode>
						</Arrival>
						<CarrierAircraftType>
							<CarrierAircraftTypeCode>737</CarrierAircraftTypeCode>
						</CarrierAircraftType>
						<DatedOperatingLegID>LG2</DatedOperatingLegID>
						<Dep>
							<IATA_LocationCode>KBP</IATA_LocationCode>
						</Dep>
					</DatedOperatingLeg>
					<Dep>
						<AircraftScheduledDateTime>2021-03-16T09:45:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>KBP</IATA_LocationCode>
						<TerminalName>D</TerminalName>
					</Dep>
					<Duration>P0Y0M0DT3H25M0.000S</Duration>
					<MarketingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<MarketingCarrierFlightNumberText>127</MarketingCarrierFlightNumberText>
					</MarketingCarrierInfo>
					<OperatingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<OperatingCarrierFlightNumberText>127</OperatingCarrierFlightNumberText>
					</OperatingCarrierInfo>
					<PaxSegmentID>SEG2</PaxSegmentID>
				</PaxSegment>
				<PaxSegment>
					<Arrival>
						<AircraftScheduledDateTime>2021-03-21T17:35:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>KBP</IATA_LocationCode>
						<TerminalName>D</TerminalName>
					</Arrival>
					<DatedOperatingLeg>
						<Arrival>
							<IATA_LocationCode>KBP</IATA_LocationCode>
						</Arrival>
						<CarrierAircraftType>
							<CarrierAircraftTypeCode>737</CarrierAircraftTypeCode>
						</CarrierAircraftType>
						<DatedOperatingLegID>LG3</DatedOperatingLegID>
						<Dep>
							<IATA_LocationCode>CDG</IATA_LocationCode>
						</Dep>
					</DatedOperatingLeg>
					<Dep>
						<AircraftScheduledDateTime>2021-03-21T13:20:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>CDG</IATA_LocationCode>
						<TerminalName>2D</TerminalName>
					</Dep>
					<Duration>P0Y0M0DT3H15M0.000S</Duration>
					<MarketingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<MarketingCarrierFlightNumberText>128</MarketingCarrierFlightNumberText>
					</MarketingCarrierInfo>
					<OperatingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<OperatingCarrierFlightNumberText>128</OperatingCarrierFlightNumberText>
					</OperatingCarrierInfo>
					<PaxSegmentID>SEG3</PaxSegmentID>
				</PaxSegment>
				<PaxSegment>
					<Arrival>
						<AircraftScheduledDateTime>2021-03-21T20:30:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>ODS</IATA_LocationCode>
					</Arrival>
					<DatedOperatingLeg>
						<Arrival>
							<IATA_LocationCode>ODS</IATA_LocationCode>
						</Arrival>
						<CarrierAircraftType>
							<CarrierAircraftTypeCode>E95</CarrierAircraftTypeCode>
						</CarrierAircraftType>
						<DatedOperatingLegID>LG4</DatedOperatingLegID>
						<Dep>
							<IATA_LocationCode>KBP</IATA_LocationCode>
						</Dep>
					</DatedOperatingLeg>
					<Dep>
						<AircraftScheduledDateTime>2021-03-21T19:30:00.000</AircraftScheduledDateTime>
						<IATA_LocationCode>KBP</IATA_LocationCode>
						<TerminalName>D</TerminalName>
					</Dep>
					<Duration>P0Y0M0DT1H0M0.000S</Duration>
					<MarketingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<MarketingCarrierFlightNumberText>55</MarketingCarrierFlightNumberText>
					</MarketingCarrierInfo>
					<OperatingCarrierInfo>
						<CarrierDesigCode>PS</CarrierDesigCode>
						<OperatingCarrierFlightNumberText>55</OperatingCarrierFlightNumberText>
					</OperatingCarrierInfo>
					<PaxSegmentID>SEG4</PaxSegmentID>
				</PaxSegment>
			</PaxSegmentList>
			<ServiceDefinitionList>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL1</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL5</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL9</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL13</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL17</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL21</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL25</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<Desc>
						<DescText>Healthy breakfast consists of oatmeal porridge. And for a good mood: croissant with jam.</DescText>
						<URL>/resources/img/5f34cfa7f07b32689508c869</URL>
					</Desc>
					<Desc>
						<DescText>Category: MEAL</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: SALAD</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: HOT_OFFER</DescText>
					</Desc>
					<Name>Oatmeal</Name>
					<ServiceCode>BFML</ServiceCode>
					<ServiceDefinitionID>MEAL29</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<BookingInstructions>
						<SpecialService>
							<Qty>1</Qty>
						</SpecialService>
					</BookingInstructions>
					<Desc>
						<DescText>No surprises at the airport! Buy now additional piece of hand luggage and save your time at the airport</DescText>
						<URL>/resources/img/5c25b6ed640d94535ab7d6f9</URL>
					</Desc>
					<Desc>
						<DescText>Category: BAGGAGE</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: BAG</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: BESTSELLER</DescText>
					</Desc>
					<Name>Additional Cabin Baggage – up to 5 kg, 40х30х10 cm</Name>
					<ServiceCode>CBAG</ServiceCode>
					<ServiceDefinitionID>BAGGAGE1</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<BookingInstructions>
						<SpecialService>
							<Qty>1</Qty>
						</SpecialService>
					</BookingInstructions>
					<Desc>
						<DescText>No surprises at the airport! Buy now additional piece of hand luggage and save your time at the airport</DescText>
						<URL>/resources/img/5c25b6ed640d94535ab7d6f9</URL>
					</Desc>
					<Desc>
						<DescText>Category: BAGGAGE</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: BAG</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: BESTSELLER</DescText>
					</Desc>
					<Name>Additional Cabin Baggage – up to 5 kg, 40х30х10 cm</Name>
					<ServiceCode>CBAG</ServiceCode>
					<ServiceDefinitionID>BAGGAGE3</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<BookingInstructions>
						<SpecialService>
							<Qty>1</Qty>
						</SpecialService>
					</BookingInstructions>
					<Desc>
						<DescText>No surprises at the airport! Buy now additional piece of hand luggage and save your time at the airport</DescText>
						<URL>/resources/img/5c25b6ed640d94535ab7d6f9</URL>
					</Desc>
					<Desc>
						<DescText>Category: BAGGAGE</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: BAG</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: BESTSELLER</DescText>
					</Desc>
					<Name>Additional Cabin Baggage – up to 5 kg, 40х30х10 cm</Name>
					<ServiceCode>CBAG</ServiceCode>
					<ServiceDefinitionID>BAGGAGE5</ServiceDefinitionID>
				</ServiceDefinition>
				<ServiceDefinition>
					<BookingInstructions>
						<SpecialService>
							<Qty>1</Qty>
						</SpecialService>
					</BookingInstructions>
					<Desc>
						<DescText>No surprises at the airport! Buy now additional piece of hand luggage and save your time at the airport</DescText>
						<URL>/resources/img/5c25b6ed640d94535ab7d6f9</URL>
					</Desc>
					<Desc>
						<DescText>Category: BAGGAGE</DescText>
					</Desc>
					<Desc>
						<DescText>Sub-Category: BAG</DescText>
					</Desc>
					<Desc>
						<DescText>Marketing UI: BESTSELLER</DescText>
					</Desc>
					<Name>Additional Cabin Baggage – up to 5 kg, 40х30х10 cm</Name>
					<ServiceCode>CBAG</ServiceCode>
					<ServiceDefinitionID>BAGGAGE7</ServiceDefinitionID>
				</ServiceDefinition>
			</ServiceDefinitionList>
		</DataLists>
		<ShoppingResponse>
			<ShoppingResponseRefID>20c4b873-eccb-4d16-8125-6e42b3b4f479</ShoppingResponseRefID>
		</ShoppingResponse>
	</Response>
</IATA_ServiceListRS>

ServiceListRS fields description

M = Mandatory; O = Optional; C = Conditional

Field name	Description	M/O/C	Example
ServiceListRS	The ServiceList transaction set returns a list of all applicable ancillary services that meet request qualifiers and flights. The message also returns multi-media content at the message level and media references at the individual service level.	M	<IATA_ServiceListRS xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.iata.org/IATA/2015/00/2019.2/IATA_ServiceListRS NDC/19_2_schemas/IATA_ServiceListRS.xsd">
↳ Error	Error(s) that prevented the message from processing.	C
↳ Code	The code corresponding to the processing error as defined by PADIS 9321.	M	<Code>911</Code>
↳ DescText	Free text description of the provided error.	M	<DescText>Unable to process - system error / Invalid query</DescText>
↳ Response	ServiceList response information.	C
↳ ALaCarteOffer	A proposal to sell a specific set of products or Services under specific conditions, for a certain price. Can be the response to a shopping request.
↳ ALaCarteOfferItem		M
↳ Eligibility	Refers to the Passengers, Price class or segments for which this offer item is eligible.	M
↳ FlightAssociations	Eligiibility of this offer item to the following segments or journeys.	O
↳ PaxSegmentRefID	Reference to the journeys for which this Offer Item can be provided.	C	<PaxSegmentRefID>SEG1</PaxSegmentRefID>
↳ PaxJourneyRefID	Reference to the flight segments on which this Offer Item can be provided.	C	<PaxJourneyRefID>FL2</PaxJourneyRefID>
↳ PaxRefID	Reference to the passengers who are elibigle for this Offer Item	O	<PaxRefID>PAX1</PaxRefID>
↳ OfferItemID	Uniquely Identifies an Offer within the context of one message.	M	`<OfferItemID>AncillaryMeal:5d4ab6ed2af7106e20430bfd</OfferItemID>`
↳ Service	The instance of a specific flight or Service Definition as it has been offered (and eventually ordered and consumed) in the context of a specific Offer and/or Order.	M
↳ ServiceDefinitionRefID	Reference to a service definition.	M	<ServiceDefinitionRefID>MEAL1</ServiceDefinitionRefID>
↳ ServiceID	Uniquely Identifies a Service within the context of one message.	M	<ServiceID>MEAL1_PAX1_SEG2</ServiceID>
↳ UnitPrice	The amount of money expected, required, or given in payment for something.	M
↳ TotalAmount	Total monetary price amount, including all tax, surcharge, and fee amounts. Attribute: Currency code	O	<TotalAmount CurCode="EUR">19.47</TotalAmount>
↳ OfferExpirationTimeLimitDateTime	The length of time an offer will persist in an airline offer management system for use in subsequent transactions. Upon expiry, the expectation is that the offer is no longer retrievable and the shopping process must begin again.	M	<OfferExpirationTimeLimitDateTime>2020-09-21T15:05:50</OfferExpirationTimeLimitDateTime>
↳ OfferID	Carrier assigned ID which uniquely identifies a specific Offer across several messages.	M	<OfferID>5d4ab6ed2af7106e20430bfd</OfferID>
↳ OwnerCode	Airline code assigned to a carrier.	M	<OwnerCode>PS</OwnerCode>
↳ DataLists	Data List definition for this message.	O
↳ OriginDestList	Origin Destination data list definition.	O
↳ OriginDest	The Origin and Destination airport/city pair which confines a passenger journey or an aircraft flight.	M
↳ DestCode	IATA defined code identifying a city or station.	M	<DestCode>KBP</DestCode>
↳ OriginCode	IATA defined code identifying a city or station.	M	<OriginCode>DXB</OriginCode>
↳ OriginDestID	Uniquely identifies an Origin Destination within the context of one message.	O	<OriginDestID>OD1</OriginDestID>
↳ PaxJourneyRefID	Uniquely identifies a Passenger Journey within the context of one message.	O	<PaxJourneyRefID>FL1</PaxJourneyRefID>
↳ PaxJourneyList	Journey data list definition.	O
↳ PaxJourney	A collection of segments which satisfies transportation of a passenger for a given origin and destination.	M
↳ Duration	Total journey time including the combined air time and connection times. In case of stopover, this may or may not include stopover durations.	O	<Duration>P0Y0M0DT5H10M0.000S</Duration>
↳ PaxJourneyID	Uniquely identifies a Passenger Journey within the context of one message.	O	<PaxJourneyID>FL1</PaxJourneyID>
↳ PaxSegmentRefID	Reference to a Passenger Segment ID within this message.	M	<PaxSegmentRefID>SEG1</PaxSegmentRefID>
↳ PaxList	Passenger data list definition.	O
↳ Pax	Any person except members of the crew carried or to be carried with the consent of the carrier, on board of any transport vehicle such as aircraft, train, bus, ship. Holds the attributes specific to one booking, from shopping to fulfilment.	M
↳ IdentityDoc	Any document which may be used to identify a person or verify aspects of a person's personal identity.	O
↳ CitizenshipCountryCode	ISO Country Code	O	<CitizenshipCountryCode>UA</CitizenshipCountryCode>
↳ ExpiryDate	The date the identity document expires.	O	<ExpiryDate>2021-11-07</ExpiryDate>
↳ IdentityDocID	Uniquely identifies the document from all other identity documents issued by the state or organization.	M	<IdentityDocID>ABC7891</IdentityDocID>
↳ IdentityDocTypeCode	The type of passenger document.	M	<IdentityDocTypeCode>PT</IdentityDocTypeCode>
↳ IssuingCountryCode	ISO Country Code	O	<IssuingCountryCode>UA</IssuingCountryCode>
↳ Individual	A single human being as distinct from a group, class, or family.	O
↳ Birthdate	The date on which an individual was born.	O	<Birthdate>1980-09-25</Birthdate>
↳ GenderCode	Gender of the individual (M, F, or X for unspecified).	O	<GenderCode>M</GenderCode>
↳ GivenName	Individual's first or given name.	O	<GivenName>ONE</GivenName>
↳ Surname	Individual's family name, last name.	M	<Surname>TRAVELLER</Surname>
↳ TitleName	A word such as Mr., Mrs., Miss or Dr that is used before an individual's name to indicate the gender, profession or marital status.	O	<TitleName>Mrs</TitleName>
↳ LoyaltyProgramAccount	An account set up for a customer within a rewards program which holds funds on behalf of that customer.	O
↳ AccountNumber	Loyalty Program account number.	O	<AccountNumber>2342342555</AccountNumber>
↳ LoyaltyProgram	A rewards program offered by a company to customers who frequently make purchases, which may give a customer advanced access to new products, special sales coupons or free merchandise.	M
↳ ProgramCode	Loyalty Program ID Supported codes: PC - Panorama Club PCC - Panorama Club Corporate	O	<ProgramCode>PC</ProgramCode>
↳ PaxID	Uniquely identifies a Passenger within the context of one message.	M	<PaxID>PAX1</PaxID>
↳ PaxRefID	Reference to a Passenger ID within this message, associating an infant on lap to this adult Passenger.	O	<PaxRefID>PAX2</PaxRefID>
↳ PTC	Type code applying to the Passenger which typically drives pricing.		<PTC>ADT</PTC>
↳ PaxSegmentList	Segment data list definition.	O
↳ PaxSegment	Transportation of a passenger on a Dated Operating Segment.	M
↳ Arrival	The action or process of arriving of a transport vehicle in any place or location.	M
↳ AircraftScheduledDateTime	The Scheduled Date and Time of Arrival of the aircraft at the terminal or departure gate at an airport.	O	<AircraftScheduledDateTime>2020-11-18T08:05:00</AircraftScheduledDateTime>
↳ IATA_LocationCode	IATA defined code identifying a city or station.	O	<IATA_LocationCode>DXB</IATA_LocationCode>
↳ TerminalName	The name of the terminal.	O	<TerminalName>D</TerminalName>
↳ DatedOperatingLeg	The nonstop operation of a transport vehicle between the departure station and the arrival station. Can be used for aircrafts as well as other transport vehicles such as train or bus etc.	O
↳ Arrival	The action or process of arriving of a transport vehicle in any place or location.	M
↳ IATA_LocationCode	IATA defined code identifying a city or station.	O	<IATA_LocationCode>WAW</IATA_LocationCode>
↳ CarrierAircraftType	Carrier defined internal grouping of aircrafts with the same form, function and specification.	O
↳ CarrierAircraftTypeCode	Internal code used by a carrier to identify the type of aircraft.	O	<CarrierAircraftTypeCode>737</CarrierAircraftTypeCode>
↳ DatedOperatingLegID	Uniquely identifies a leg within the context of one message.	O	<DatedOperatingLegID>LG1</DatedOperatingLegID>
↳ Dep	The action or process of leaving of a transport vehicle from any place or location.	M
↳ IATA_LocationCode	IATA defined code identifying a city or station.		<IATA_LocationCode>KBP</IATA_LocationCode>
↳ Dep	The action or process of leaving of a transport vehicle from any place or location.	M
↳ AircraftScheduledDateTime	The Scheduled Date and Time of Arrival of the aircraft at the terminal or departure gate at an airport.	O	<AircraftScheduledDateTime>2020-11-18T04:05:00</AircraftScheduledDateTime>
↳ IATA_LocationCode	IATA defined code identifying a city or station.	O	<IATA_LocationCode>KBP</IATA_LocationCode>
↳ TerminalName	The name of the terminal.	O	<TerminalName>F</TerminalName>
↳ Duration	Total segment time including the combined air time and connection times of any legs.	O	<Duration>P0Y0M0DT5H10M0.000S</Duration>
↳ MarketingCarrierInfo	The commercial designation under which a Dated Operating Segment can be booked, either under the operating carrier's designator or that of another carrier (codeshare).	M
↳ CarrierDesigCode	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.	M	<CarrierDesigCode>PS</CarrierDesigCode>
↳ MarketingCarrierFlightNumberText	The numerical designation of a flight as it is marketed by a carrier.	M	<MarketingCarrierFlightNumberText>374</MarketingCarrierFlightNumberText>
↳ OperatingCarrierInfo	An operation between board point and any subsequent off point within the same flight designator. Could be one or more legs. Could also be used for other transport vehicles such as train or bus etc.	O
↳ CarrierDesigCode	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.	O	<CarrierDesigCode>PS</CarrierDesigCode>
↳ PaxSegmentID	Uniquely identifies a Passenger Segment within the context of one message.		<PaxSegmentID>SEG1</PaxSegmentID>
↳ ServiceDefinitionList	Service Definition data list definition.	O
↳ ServiceDefinition	Description and characteristics of a non-flight product or service that can be separately sold and delivered. E.g. bag, seat, meal on a flight.	M
↳ BookingInstructions	Optional service booking instructions to include SSR, OSI and upgrade Method.	O
↳ SpecialService	Special service information	M
↳ Qty	The MAXIMUM Quantity of the Service Item that may be ordered. In case parameter was exceeded an error will be returned	M	<Qty>1</Qty>
↳ Desc	An account or representation of the certain or major aspects, characteristics, or features of a person, object, or event.	M
↳ DescText	Description text value. In this section available information about service category, sub-category, service description and marketing UI such as bestsellers, hot offers, etc.	O	<DescText>Baggage included in fare</DescText>
↳ URL	URL to media content	O	<URL>/resources/img/59b157fd3aee351d3e7fbd9b</URL>
↳ Name	Service name.	M	<Name>Cosmopolite Lunch</Name>
↳ ServiceCode	Airline specific service code which can be associated with the Reason for Issuance Sub Code.	O	<ServiceCode>ABAG</ServiceCode>
↳ ServiceDefinitionID	Uniquely Identifies a Service Definition within the context of one message.	M	<ServiceDefinitionID>MEAL1</ServiceDefinitionID>
↳ ShoppingResponse		M
↳ ShoppingResponseRefID		M	<ShoppingResponseRefID>f37f7bae-c5ed-40db-a661-4539c73c05df</ShoppingResponseRefID>

ServiceList Error/Validation Checks

Click here to expand...

PADIS Error Code	PADIS Error Text	Use Cases
System errors
911	Unable to process - system error / Invalid query	Invalid query
486	Unknown	The equivalent of -1 error
304	System Temporarily unavailable	The system is not available/HOST problem
916	EDIFACT version not supported	Not supported NDC service version.
Agent authorization errors
368	Not authorized	Wrong agent authentication key. Agent is inactive
79A	Invalid office identification	OID is missing or incorrect
Query errors
729	Invalid currency code	Currency is not supported by the System
306	Invalid language code	Language is not supported by the System
405	No Service Between Requested Cities/Airports for Parameters	Airport/City code does not exist or missing
76H	Unable to process the requested option	Invalid cabin parameter or parameter not supported
912	Incomplete message - data missing in query	In case inconsistent query