BaggageList

1.1 Functional Description

version: 2.38

The BaggageList API returns a catalogue of baggage items for the selected Offer or Order.

Bags can be purchased as part of the Shopping flow following the FlightPrice, or as part of a servicing flow after the initial Order has been created.

However, Bags cannot be pre-booked/purchased unless the Order has been paid for in full and ticketed.

Functionality:

BaggageList.zip message examples

Functionality Use

Pre-Sale      

The pre-sale baggage availability service allows us to see the price for bags for a flight before the creation of the Order, In this way we can select those baggage services that we want to include when creating the Order.

Post-Sale     
The post-sale baggage availability service allows us to see the price for bags for a flight after the creation of the Order, In this way, we can select those baggage services that we want to add to a previously created Order.

(version: 2.30) In the Service element of the BaggageList response, there is now more information returned regarding the baggage service.

  • Traveler: contains the passengers’ references the baggage service can be applied to.
  • Detail: it’s the maximum quantity of baggages selectable for the service.

(version: 2.23) Example validation of the currency we sell with the point of sale currency. This information will be optional.

    
    <Metadata>
        <Other>
            <OtherMetadata>
                <CurrencyMetadatas>
                    <CurrencyMetadata MetadataKey="EUR">
                    <Decimals>2</Decimals>
                    </CurrencyMetadata>
                </CurrencyMetadatas>
            </OtherMetadata>
        </Other>
    </Metadata>
        

EndPoint:

1.2 Request Body

We provide two different methods to request the baggage list:

  • Presale: Needs a previous AirShopping for returning an offer and a price breakdown.
  • Post-sale: Needs a previously created and full paid Order. Including extra data it will return the baggage catalogue for the ordered flight.

Add = New

NAME

DESCRIPTION

FORMAT

ALLOWED VALUES

MANDATORY FOR

PrimaryLangID

Two character ISO Language Code, for the agent’s preferred language. This is for error messages and some other data such as legal waivers.

2 alpha

  • EN
  • ES

Version

The IATA version of the message

numeric

any

Schema

<PointOfSale>

CountryCode

Country code

2 alpha

List of countries

If toggle feature for market validation is activated.

<Document>

ReferenceVersion

The IATA Schema version.

numeric

any


<Party>

Sender / IATA_Number

Sender unique identifier such as:

IATA number (if you have one)

TIDs number (recommended if you do not have an IATA)

Pseudo IATA(assigned by Iberia)

7 numeric

7 numbers

NDC Mandatory

Sender / AgencyID

Name of the Sender / Agency

alphanumeric

any

Schema

Participant / AggregatorID

Participant / Aggregator unique identifier (Mandatory if you have an indirect connection):

IATA number (if you have one)

TIDs number (recommended if you do not have an IATA)

Pseudo IATA(assigned by Iberia)

7 numeric

7 numbers

Mandatory for schema if 'Participants' tag is indicated.

<Traverlers>

TravelerCount

Attribute PaxType

  • TravelerCount (numeric)
  • PaxType (3 alpha)

any

Schema
<ShoppingRespondeIDs> Presale
ResponseID

ResponseID of FlightPrice service

alphanumeric

any

Schema

AssociatedIDs

Offer Items

alphanumeric

any

Schema
<Query / OriginDestination / Flight> Post-sale 
Departure / AirportCode IATA 3 character code for the departure city/airport/station

3 alpha

the departure point listed in the order Schema
Departure / Date Date of flight departure

Date(yyyy-MM-dd)

the date of flight listed in the order Schema
Arrival / AirportCode IATA 3 character code for the arrival city/airport/station 3 alpha the arrival point listed in the order Schema
MarketingCarrier / AirlineID IATA airline code 2 alpha the airline id listed in the order Schema
MarketingCarrier / FlightNumber The flight number 4 numbers the flight number listed in the order Schema
<Qualifiers> Post-sale
Qualifier / Existing Order Qualifier / Order Keys / OrderID

Order ID with mandatory attribute Owner

alphanumeric the order id of an existing order which has been created, paid and ticketed Schema
Qualifier / Existing Order Qualifier / Traveler References Passenger IDs alphanumeric one or more of the passengers listed in the order Schema

<MetaData>

Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / MetadataKey

Type of currency Alphabetical Any available currency Mandatory for schema if OrderChangeMetadata' tag is indicated.
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / Decimals Decimals of currency Numeric Decimals currency should have Mandatory for schema if OrderChangeMetadata' tag is indicated.

1.3 Response Body

The response filters by currency in both pre-sale and post-sale methods. In case the currency does not match with:

  • Pre-sale: with the currency in the offer.
  • Post-sale: with the currency in the order.

NAME 

DESCRIPTION 

FORMAT 

Nullable 

<ShoppingResponseIDs>

ResponseID

Id of the response

alphabetical

False

<Services>

ServiceID

ID of the baggage service

alphabetical

False

Name

Name of the baggage service

alphabetical

False

Encoding / RFIC / Code

RFIC Code

number

False

Encoding / Code

Code of the service

alpha

False

Description / Text

Description of the baggage service

alphabetical

False

Price/Total

Price of the baggage

number

False

Associations/Traveler/TravelerReferences Traveler elegible to use this product. alphanumerical False
Associations/Flight/FlightSegment Flights elegible to book this product in. alpanumerical False
Details/ServiceItemQuantityRules/MaximumQuantity Maximum baggages booked by passenger number False

<Datalist>Add

AnonymousTraveler Anonymous Passenger key alphabetical False
PTC Anonymous Passenger code alphabetical False
CheckedBagAllowanceList / CheckedBagAllowance / PieceAllowance
ApplicableParty Type of party alphabetical False
Total Quantity Quantity of ApplicableParty number False
PieceMeasurements / Quantity Quantity of pieces number False
PieceMeasurements / MaximumWeight / Value Maximum weight for pieces quantity number False
PieceMeasurements / MaximumWeight / UOM Weight unit alphabetical False
PieceMeasurements / PieceDimensionAllowance / DimensionUOM Unit of measurement alphabetical False
PieceMeasurements / PieceDimensionAllowance / MaxLinear Maximum measure number False
PieceMeasurements / PieceDimensionAllowance / MinLinear Minimum measure number False
FlightSegmentList / FlightSegment
SegmentKey Flight Segment Code containing FlightId and date alphanumerical False
DepartureAdd
AirportCode
IATA Airport Code alphabetical False
Date
Departure Date Date False
Time
Departure Time Time False
AirportName
Full Airport Name alphabetical False
Terminal/Name
Terminal name or number. Real world name for terminal alphabetical/numerical False
ArrivalAdd      
AirportCode  IATA Airport Code alphabetical False
Date Departure Date Date False
Time Departure Time
Time False
AirportName Full Airport Name alphabetical False
ChangeOfDay Shows how many days after departure date flight will arrive. numerical False
Terminal/Name Terminal name or number. Real world name for terminal alphabetical/numerical False
MarketingCarrierAdd
AirlineID IATA airline code alphabetical False
Name Full Airline name alphabetical False
FlightNumber The flight number numerical False
OperatingCarrierAdd
AirlineID IATA airline code alphabetical False
Name Full Airline name alphabetical False
FlightNumber The flight number numerical False
Disclosure/Description/Text Text showing the disclosure alphabetical False
EquipmentAdd
AircraftCode Aircraft Code numerica False
Name Full Aircraft model name alphabetical False
FlightDetail (only first segment)Add
FlightDuration / Value Time Flight Duration
Date False
FlightListAdd
Flight / FlightKey Id for the flight alphanumerical False
Journey / Time Time for the journey
Date False
SegmentReferences Id referencing a FlightSegment
alphanumerical False
OriginDestinationListAdd
OriginDestinationKey IATA Code referencing departure city and arrival city alphabetical False
DepartureCode IATA Code for Departure City alphabetical False
ArrivalCode IATA Code for Arrival City alphabetical False
FlightReferences Id Referencing a Flight alphanumerical False
Media ListAdd
ListKey Id for the Media Item alphabetical False
MediaLink Http link referring to the Media Item alphanumerical False

1.4 Error messages

 

NDC Standard allow errors and warnings to be returned inside an 200 OK response. Errors returned with 200 OK will always be controlled errors result of external limitations as "Max accepted non-infant passengers is 9".

BaggageList Presale

HTTP STATUS CODE

EXAMPLE MESSAGE ERROR

REASON

795 ShoppingResponseID invalid: incorrect or out-of-date Shopping Response Invalid
396 Invalid ticket/document coupon status Order without tickets
396 Invalid ticket/document coupon status Order with some ticket in status distinct of OPEN FOR USE
396 Invalid ticket/document coupon status Order with some ticket reissued

 

BaggageList Post-Sale

HTTP STATUS CODE

EXAMPLE MESSAGE ERROR

REASON

795 ShoppingResponseID invalid: incorrect or out-of-date Shopping Response Invalid
396 Invalid ticket/document coupon status Order without tickets
396 Invalid ticket/document coupon status Order with some ticket in status distinct of OPEN FOR USE
396 Invalid ticket/document coupon status Order with some ticket reissued