Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Current »

Ancillaries Errors and Warnings

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

The texts are returned in Spanish or English, which is the default language. Localization of the text can be undertaken by the Seller/Aggregator based on the Short-text code.

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

 

Given the inclusion of new Ancillaries in the ServiceList, (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 will be returned for each failed Service.

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:

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>AF</GroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
<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:

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

While the Offers from the valid ServiceFilter are returned:

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

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

While the Offers from the available ServiceFilter are returned:

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

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:

<Parameters>
	<ServiceFilters>
		<ServiceFilter>
			<GroupCode>BG</GroupCode>
		</ServiceFilter>
	</ServiceFilters>
</Parameters>
<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:

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

 

SeatAvailability Flow

Scenario 1

Error message displayed due to non-availability of Seats:

SeatAvailabilityRS sample

Non-availability of Seats. The returned error is:

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

 

Unpaid / On Hold

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

Unpaid Orders

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.

OrderChange Payment error response example

You have tried to paid for seats that are no longer booked. The returned error is:

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

SeatAvailabilityRS sample

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

SeatAvailabilityRS sample

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

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

Error Codes

  • No labels