Image Modified

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

...

Errors and Warnings will always be shown in the applicable response message(ServiceListRS, SeatAvailabilityRS).

Given the inclusion of new Ancillaries in the ServiceList, (at the moment, only available in the Pre-Sale and on hold flow), the handling of errors and warnings has undergone changes in the following scenarios:

• If Offers are returned for only some of the requested Services, warnings also will be included for those Services which are not available.

• If all of the requested Services fail, an Error wil will be returned for each failed Service.

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

Scenario 1 - Invalid ServiceFilter Group Code

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>AF</GroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>

<Errors>
	<Error ShortText="NDC_DIST_1014" Code="486">Service Filter is not valid</Error>
</Errors>

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>TS</GroupCode>
			<SubGroupCode>PX</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>

<Warnings>
	<Warning ShortText="NDC_DIST_SL_1001" Code="486">Some Service Filter is not valid</Warning>
</Warnings>

<...>
<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

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
			<SubGroupCode>SP</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>

<Warnings>
	<Warning ShortText="NDC_DIST_SL_1001" Code="486">Some Service Filter is not valid</Warning>
</Warnings>

<...>
<ALaCarteOfferItem OfferItemID="ALACARTE_

SPEQUIPMENT_

IBe28d6d416b76474c90fe4371da43b132_

06">
	<Eligibility>
		<PassengerRefs>ADULT_01</PassengerRefs>
		

<SegmentRefs>IB684520231213</SegmentRefs>
	</Eligibility>
	<UnitPriceDetail>
		<TotalAmount>
			<SimpleCurrencyPrice Code="EUR"

>390.00</SimpleCurrencyPrice>
		</TotalAmount>
		<BaseAmount Code="EUR"

>390.00</BaseAmount>
		<Taxes>
			<Total Code="EUR">0.00</Total>
		</Taxes>
	</UnitPriceDetail>
	<Service ServiceID="

SPE_SERVICE_

826aa018-

036a-

43b5-

8331-

575dff5a62ce">
		

<ServiceDefinitionRef>SPESERVICE-

GOLF_EQUIPMENT-

3</ServiceDefinitionRef>
	</Service>
</ALaCarteOfferItem>
<...>

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

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>

<Errors>
	<Error ShortText="NDC_DIST_1015" Code="486">Service Filter not available</Error>
</Errors>

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
		<ServiceFilter>
			<GroupCode>TS</GroupCode>
			<SubGroupCode>PR</SubGroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>

<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>

Scenario 1

Error message displayed due to non-availability of Seats:

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

The following are the errors that you may encounter when trying to book and pay for ancillaries.

Unpaid Orders

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

SeatAvailabilityRS sample

...

The following is the error return if you try to pay for an order (with flights and seats) where the seat has been cancelled. In this case you need to retrieve the order (which will be returned only with the services that are not cancelled and can be pay for) before sending the OrderChange Payment.

<Errors>
  

  <Error ShortText="NDC_DIST_AOH_

0001" Code="486"

>Some services have been cancelled. Please retrieve the Order before paying.</Error>
</Errors>

The following error is returned when you try to book seats in an Unpaid Order (flight tickets yet to be issued). The Order with the flights and any confirmed ancillaries must be paid for and issued first, and then the seats can be added to the Order and paid for.

<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>

<Errors>
	<Error ShortText="NDC_DIST_

1007" Code="486"

>Request 

not available 

for 

unticketed 

orders</Error>
</Errors>

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

...