...
Table of Contents |
---|
SPORT Product |
---|
Within the permitted baggage allowance (seehttps://www.iberia.com/es/luggage/allowance-in-hold/#!/baggages-search:~:text=some%20exceptions.-,Additional%20baggage,-If%20you%20need), it is allowed to include Sports equipment. The type of Sports baggage (in addition to the 15kg, 23kg bagand 35kg bags) must be requested during the booking process and always within the permitted baggage allowance, being also possible its inclusion in Post-Sale scenarios.
Presently, the purchase of this product is available in instant purchase scenarios and On-Hold on hold flows.
The types of Sports baggage allowed are inclusion of any of the Sport baggages shown in the table below . Please, note that this Sport product includes sporting equipment (Surf, Scuba, and Fishing) that cannot be purchased as an Ancillary(only applicable to this specific Private Fare type) can be carried out:
Through the OrderCreate, during the booking process or instant purchase scenarios.
Through the OrderChange in Post-Sale scenarios.
Both options are later explained and illustrated with examples.
Although the InstructionList 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 by segment and passenger, which can be done up to 72 hours before the scheduled departure flight.
These equipments must be assigned 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 baggage equipment to be carried in the InstructionList InstructionsList section within the DataLists, using the following codes:
Sports Equipment | Code to be used |
---|---|
BIKE | BAGGAGE/SP/0EC |
FISH | BAGGAGE/SP/ |
0D6 | |
GOLF | BAGGAGE/SP/0D4 |
SCUB | BAGGAGE/SP/ |
0EE |
SKII | BAGGAGE/SP/ |
0DD |
SURF | BAGGAGE/SP/ |
0D8 |
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.
Code Block | ||
---|---|---|
| ||
<Preference> <FarePreferences> <Types> <Type PreferencesContext="SPORT">758</Type> </Types> </FarePreferences> <FlightPreferences> <...> </Preference> |
AirShoppingRS and OfferPriceRS |
In the response, the Sport equipment private product requested is returned in the DescriptionList
and FareList
.
Code Block | ||
---|---|---|
| ||
<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 this product can be requested Sport baggages are included is through the the InstructionsList
section, and it which can also be carried out within instant purchase and On-Hold 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 request include Sports equipment for the Infant passenger type. You will find an example of the Warning returned in such cases in Scenario 5 of our Warning & Error Messages page.
Code Block | ||
---|---|---|
| ||
<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 product baggage correctly requested included in our systemssystem, 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 product 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 Sports baggageSport baggages.
Code Block | ||
---|---|---|
| ||
<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 one of two different 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 product equipment has not been correctly requestedincluded, a Warning will be returned. Please, visit our Warnings Warning & Error Messages page of the Sport product to learn more about the warning scenarios this new 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 theOrderID
for which we are adding new baggages. Please note that thePassengerServicing
, 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 8of 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.
Code Block | ||
---|---|---|
| ||
<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
):
Code Block | ||
---|---|---|
| ||
<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>
</InstructionsList>
</DataLists> |
Note1: if any Sport baggage is included in the InstructionsList
of 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.
...