Versions Compared

Old Version 3

changes.mady.by.user Valentina Maio

Saved on

compared with

New Version 4

changes.mady.by.user Alvaro Chaparro

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
minLevel1
maxLevel7

Ancillaries Errors and Warnings

This page contains examples of the Errors and Warnings that can be returned by our API when purchasing Ancillaries.

...

In the event of several Warnings referencing the same Ancillary/Service. they will be grouped together.

ServiceList Pre-Sale Flow

Scenario 1 - Invalid ServiceFilter Group Code

ServiceListRQ sample

The ServiceFilter introduced is incorrect:

ServiceListRS sample

The returned error is:

Code Block
languagexml
<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>AF</GroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
Code Block
languagexml
<Errors>
	<Error ShortText="NDC_DIST_1014" Code="486">Service Filter is not valid</Error>
</Errors>

ServiceListRQ sample

Mixing valid and invalid ServiceFilter GroupCodes:

ServiceListRS sample

The invalid ServiceFilter returns the following warning:

Code Block
languagexml
<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>TS</GroupCode>
			<SubGroupCode>PX</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
Code Block
languagexml
<Warnings>
	<Warning ShortText="NDC_DIST_SL_1001" Code="486">Some Service Filter is not valid</Warning>
</Warnings>

While the Offers from the valid ServiceFilter are returned:

Code Block
languagexml
<...>
<ALaCarteOfferItem OfferItemID="ALACARTE_BAGGAGE_IB01ae986c86524700b68b81b4d9c1780e_02">
	<Eligibility>
		<PassengerRefs>ADULT_01</PassengerRefs>
		<SegmentRefs>IB044020231120</SegmentRefs>
	</Eligibility>
	<UnitPriceDetail>
		<TotalAmount>
			<SimpleCurrencyPrice Code="EUR">26.00</SimpleCurrencyPrice>
		</TotalAmount>
		<BaseAmount Code="EUR">26.00</BaseAmount>
		<Taxes>
			<Total Code="EUR">0.00</Total>
		</Taxes>
	</UnitPriceDetail>
	<Service ServiceID="BAG_SERVICE_361fa5a8-6fa1-4041-b600-da3f9395303a">
		<ServiceDefinitionRef>BAGSERVICE-15-2</ServiceDefinitionRef>
	</Service>
</ALaCarteOfferItem>
<...>

Scenario 2 - Pre-Sale Flow mix of Services available and not available

ServiceListRQ sample

Mixing available and not available Services:

ServiceListRS sample

The non available ServiceFilter returns the following warning:

Code Block
languagexml
<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
			<SubGroupCode>SP</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
Code Block
languagexml
<Warnings>
	<Warning ShortText="NDC_DIST_SL_1001" Code="486">Some Service Filter is not valid</Warning>
</Warnings>

While the Offers from the available ServiceFilter are returned:

Code Block
languagexml
<...>
<ALaCarteOfferItem OfferItemID="ALACARTE_BAGGAGE_IBcf5b7f0932a44b38aa088e159c500382_10">
	<Eligibility>
		<PassengerRefs>ADULT_01</PassengerRefs>
		<SegmentRefs>IB043820231008</SegmentRefs>
	</Eligibility>
	<UnitPriceDetail>
		<TotalAmount>
			<SimpleCurrencyPrice Code="EUR">56.00</SimpleCurrencyPrice>
		</TotalAmount>
		<BaseAmount Code="EUR">56.00</BaseAmount>
		<Taxes>
			<Total Code="EUR">0.00</Total>
		</Taxes>
	</UnitPriceDetail>
	<Service ServiceID="BAG_SERVICE_14d8d4f4-f85d-46ed-9241-50fb4f88d124">
		<ServiceDefinitionRef>BAGSERVICE-23-2</ServiceDefinitionRef>
	</Service>
</ALaCarteOfferItem>
<...>

ServiceList Post-Sale Flow

Scenario 1 - Inclusion of ServiceFilter (Not available in Post-Sale Flow)

ServiceListRQ sample

ServiceFilter parameters are not valid for Post-Sale:

ServiceListRS sample

The returned error is:

Code Block
languagexml
<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
Code Block
languagexml
<Errors>
	<Error ShortText="NDC_DIST_1015" Code="486">Service Filter not available</Error>
</Errors>

ServiceListRQ sample

Purchase of Bags in a Post-Sale scenario:

ServiceListRS sample

The returned error is:

Code Block
languagexml
<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>TS</GroupCode>
			<SubGroupCode>PR</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
Code Block
languagexml
<Warnings>
	<Warning ShortText="PRI_AVAIL_ERR_0021" Code="486">PRIORITY_BOARDING: Offers of optional services not available. Continue your purchase with the selected flights.</Warning>
	<Warning ShortText="PRI_AVAIL_ERR_0004" Code="486">PRIORITY_BOARDING: Already included in selected fare. Please continue with your reservation. Segment: IB043220231025</Warning>
	<Warning ShortText="PRI_AVAIL_ERR_0004" Code="486">PRIORITY_BOARDING: Already included in selected fare. Please continue with your reservation. Segment: IB044720231105</Warning>
</Warnings>

SeatAvailability Flow

Scenario 1

Error message displayed due to non-availability of Seats:

SeatAvailabilityRS sample

Non-availability of Seats. The returned error is:

Code Block
languagexml
<Errors>
  <Error ShortText="NDC_DIST_1006" Code="486">Seap map not available</Error>
</Errors>

Unpaid / On-Hold

Unpaid Orders

In Unpaid Orders (flight tickets yet to be issued):

SeatAvailabilityRS sample

Purchase of Seats in a Post-Sale scenario. The returned error is:

Code Block
languagexml
<Errors>
	<Error ShortText="NDC_DIST_1007" Code="486">Request not available for unticketed orders</Error>
</Errors>

Example of OrderCreate triying to reserve an ancilliary without payment timelimit.

OrderCreateRQ sample

Purchase of Bags in an On-Hold scenario and in the Pre-Sale Flow:

OrderCreateRS sample

The returned error is:

Code Block
languagexml
<Order>
	<Offer OfferID="IB624be5fa7967426aa0a51b9ba7b6bc61OC" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNjgyNjg2NjAwMzM1LTNGU05h">
		<OfferItem OfferItemID="IB624be5fa7967426aa0a51b9ba7b6bc61OC_01">
			<PassengerRefs>ADULT_01 ADULT_02 ADULT_03</PassengerRefs>
		</OfferItem>
	</Offer>
	<Offer OfferID="ALACARTE_IB7fbdd9f52ec9420f8a032ae80cae01fa" Owner="IB" ResponseID="Qm9va2luZ0BHVy0xNjgyNjg2NjAwMzM1LTNGU05h">
		<OfferItem OfferItemID="ALACARTE_BAGGAGE_IB7fbdd9f52ec9420f8a032ae80cae01fa_17">
			<PassengerRefs>ADULT_01</PassengerRefs>
		</OfferItem>
		<OfferItem OfferItemID="ALACARTE_BAGGAGE_IB7fbdd9f52ec9420f8a032ae80cae01fa_17">
			<PassengerRefs>ADULT_02</PassengerRefs>
		</OfferItem>
		<OfferItem OfferItemID="ALACARTE_BAGGAGE_IB7fbdd9f52ec9420f8a032ae80cae01fa_17">
			<PassengerRefs>ADULT_03</PassengerRefs>
		</OfferItem>
		<OfferItem OfferItemID="ALACARTE_BAGGAGE_IB7fbdd9f52ec9420f8a032ae80cae01fa_41">
			<PassengerRefs>ADULT_01</PassengerRefs>
		</OfferItem>
		<OfferItem OfferItemID="ALACARTE_BAGGAGE_IB7fbdd9f52ec9420f8a032ae80cae01fa_41">
			<PassengerRefs>ADULT_02</PassengerRefs>
		</OfferItem>
		<OfferItem OfferItemID="ALACARTE_BAGGAGE_IB7fbdd9f52ec9420f8a032ae80cae01fa_41">
			<PassengerRefs>ADULT_03</PassengerRefs>
		</OfferItem>
	</Offer>
</Order>
Code Block
languagexml
<Errors>
	<Error ShortText="NDC_DIST_2013" Code="486">Additional services only available with instant purchase</Error>
</Errors>

For further information about all kind of error messages, please go to the following link:

...