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

SPORT Product

Within the permitted baggage allowance, it is allowed to include Sports equipment. The type of Sports baggage (in addition to the 23kg bag) must be requested during the booking process, being also possible its inclusion in Post-Sale scenarios.

Presently, the purchase of this product is available in instant purchase scenarios and On-Hold flows.

The inclusion of any of the Sport baggages shown in the table below (only applicable to this specific Private Fare type) can be carried out:

  1. Through the OrderCreate, during the booking process or instant purchase scenarios.

  2. Through the OrderChange in Post-Sale scenarios.

Both options are later explained and illustrated with examples.

Please, note that this Sport product includes sporting equipment (Surf, Scuba, and Fishing) that cannot be purchased as an Ancillary. Although the InstructionsList codes are similar to those also used when purchasing Sporting Equipment Ancillaries, this is a separate private product, which can coexist with the purchase of Sporting Equipment Ancillaries. It is necessary to include the type of Sports baggage up to 72 hours before the scheduled departure flight.

These equipments must be assinged to a single passenger of the Order, as well as being included in every single segment of the same Origin-Destination. e.g.: Origin = Madrid (MAD), Destination= New York (JFK), with Stopover = London (LHR), baggages must be included in two segments at once (MAD to LHR, LHR to JFK). In round-trip cases, baggages are included following the same criteria (which is including them at the beginning of the process or later).

This is done by including the type of Sports equipment to be carried in the InstructionsList section within the DataLists, using the following codes:

Sports Equipment

Code to be used

BIKE

BAGGAGE/SP/0EC

SKII

BAGGAGE/SP/0DD

GOLF

BAGGAGE/SP/0D4

SURF

BAGGAGE/SP/0D8

SCUB

BAGGAGE/SP/0EE

FISH

BAGGAGE/SP/0D6

The information regarding the details is included in the message response, later displayed in the following examples.

AirShoppingRQ

The AirShoppingRQ contains the same FarePreferences type code as in our Private Fare Types table.

<Preference>
	<FarePreferences>
		<Types>
			<Type PreferencesContext="SPORT">758</Type>
		</Types>
	</FarePreferences>
	<FlightPreferences>
		<...>
</Preference>

AirShoppingRS and OfferPriceRS

In the response, the Sport private product requested is returned in the DescriptionList and FareList.

<DescriptionList>
	<Description ObjectKey="SPORT">
		<Text>SPORT</Text>
	</Description>
</DescriptionList>
<...>
	<FareList>
		<FareGroup refs="SPORT" ListKey="VDNNANM4">
			<Fare>
				<FareCode>758</FareCode>
			</Fare>
			<FareBasisCode>
				<Code>VDNNANM4</Code>
			</FareBasisCode>
		</FareGroup>
	</FareList>

OrderCreateRQ

The way Sport baggages are included is through the InstructionsList section, which can also be carried out within instant purchase and On-Hold scenarios.

As shown in the following example, the ADULT_01 is requesting to carry Fishing equipment (BAGGAGE/SP/0D6) and Surfing equipment(BAGGAGE/SP/0D8). This is due to the fact that this passenger is also associated to an Infant passenger type, in which case it is allowed to carry two Sports equipments within the permitted baggage allowance of the Sport product.

Note: It is not possible to include Sports equipment for the Infant passenger type. You will find an example of the Warning returned in Scenario 5 of our Warning & Error Messages page.

<InstructionsList>
	<Instruction ListKey="Instruction_01">
		<FreeFormTextInstruction refs="ADULT_01 IB310320231008 IB044220231008 IB044720231015 IB310620231015">
			<Remark>BAGGAGE/SP/0D6</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="Instruction_02">
		<FreeFormTextInstruction refs="ADULT_02 IB310320231008 IB044220231008 IB044720231015 IB310620231015">
			<Remark>BAGGAGE/SP/0EC</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="Instruction_03">
		<FreeFormTextInstruction refs="ADULT_01 IB310320231008 IB044220231008 IB044720231015 IB310620231015">
			<Remark>BAGGAGE/SP/0D8</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

OrderViewRS

Being the Sport baggage correctly included in our system, the response will return the correct structure along with the status of that request.

Within the InstructionsList we return the equipment requested as part of the Sport private baggage allowance. Please, note that the status “NN“ is appended indicating that the carriage of this equipment has been requested and is pending confirmation.

As in the previous example, here we can see the same type of passenger, ADULT_01, carrying two Sport baggages.

<InstructionsList>
	<Instruction ListKey="INSTRUCTION_01">
		<FreeFormTextInstruction refs="ADULT_01 IB310320231008 IB044220231008 IB044720231015 IB310620231015">
			<Remark>BAGGAGE/SP/0D6/NN</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="INSTRUCTION_02">
		<FreeFormTextInstruction refs="ADULT_02 IB310320231008 IB044220231008 IB044720231015 IB310620231015">
			<Remark>BAGGAGE/SP/0EC/NN</Remark>
		</FreeFormTextInstruction>
	</Instruction>
	<Instruction ListKey="INSTRUCTION_03">
		<FreeFormTextInstruction refs="ADULT_01 IB310320231008 IB044220231008 IB044720231015 IB310620231015">
			<Remark>BAGGAGE/SP/0D8/NN</Remark>
		</FreeFormTextInstruction>
	</Instruction>
</InstructionsList>

Once the request for Sport equipment has been processed, you may see the following status codes returned:

  • HK = Confirmed

In the case where the request for Sport equipment has been rejected, it will not be included in the InstructionsList in the OrderViewRS.

If the Sport equipment has not been correctly included, a Warning will be returned. Please, visit our Warning & Error Messages page of the Sport product to learn more about the warning scenarios this functionality includes.

OrderChange

Being the Order correctly created, in a Post-Sale scenario we can add up more Sport equipment. It is not permitted to remove or modify any previously included Sport baggage. Please, note that it can only be included passenger by passenger.

In case there are two passengers, the Sport baggage can be included for each passenger at a time.

As when carrying out the inclusion through the OrderCreateRQ, the Infant passenger type cannot be assinged Sport baggages. You will find an example of the Error returned in Scenario 7 (Post-Sale scenarios) of our Warning & Error Messages page.

The way we include the Sport baggage in the OrderChange is through:

  • Query element, where we reference the OrderID for which we are adding new baggages. Please note that the PassengerServicing, where the Passenger’s reference for whom the Sport baggages is assigned must be included, is compulsory and failing to include it will return an Error, as shown in Scenario 8 of our Warning and Error Messages page.

  • The InstructionsList, following the same process as in the OrderCreate. Below, we illusrtrate how it is included.

Note: In an Order where all Sport equipments fail to be added, an error will be returned. In cases where one ore more are correctly included, the correct one is returned along with a Warning indicating which ones are incorrect.

<Query>
	<OrderID>IBc5fff8618da84b8ba191c6cf2291d520OC</OrderID>
	<PassengerServicing>
		<New PassengerID="ADULT_01">
			<ActionType>Add</ActionType>
		</New>
	</PassengerServicing>
</Query>

Within the FlightSegmentList element, where the FlightSegment SegmentKey code will match the Instructions elements within the InstructionsList.

The ADULT_01 is adding one Bike equipment (BAGGAGE/SP/0EC):

<DataLists>
	<PassengerList>
		<Passenger PassengerID="ADULT_01">
			<...>
			</...>
		</Passenger>
		<Passenger PassengerID="ADULT_02">
			<...>
				</...>
		</Passenger>
	</PassengerList>
	<ContactList>
		<...>
				</...>
	</ContactList>
	<FlightSegmentList>
		<FlightSegment SegmentKey="IB043820231229">
			<...>
						</...>
		</FlightSegment>
		<FlightSegment SegmentKey="IB044720240106">
			<...>
							</...>
		</FlightSegment>
		<FlightSegment SegmentKey="IB394820240121">
			<...>
								</...>
		</FlightSegment>
	</FlightSegmentList>
	<InstructionsList>
		<Instruction ListKey="Instruction_1">
			<FreeFormTextInstruction refs="ADULT_01 IB043820231229 IB044720240106 IB394820240121">
				<Remark>BAGGAGE/SP/0EC</Remark>
			</FreeFormTextInstruction>
		</Instruction>
		<Instruction ListKey="Instruction_2">
			<FreeFormTextInstruction refs="ADULT_02 IB043820231229 IB044720240106 IB394820240121">
				<Remark>BAGGAGE/SP/0EC</Remark>
			</FreeFormTextInstruction>
		</Instruction>
	</InstructionsList>
</DataLists>

Note1: if any Sport baggage is included in the InstructionsListof the OrderCreateRQ and also added in the InstructionsList of the OrderChange, an error will be returned as shown in the first example of Scenario 6 in our Warning & Error Messages page.

Examples of messages with complete flows can be downloaded from here.

  • No labels