BaggageList

1.1 Functional Description

version: 2.47

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:

 

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.

The various search parameters are described below:

NAME

DESCRIPTION

FORMAT

ALLOWED VALUES

MANDATORY FOR
PrimaryLangID Specifies preferred language by the agency 2 alphabetic

any


Version

The IATA version of the message

numeric any Schema
<PointOfSale>

Location / CountryCode

Country code

2 alpha

List of countries

NDC Mandatory if toggle feature for market validation is activated.
<Document> Schema

ReferenceVersion

The IATA Schema version.

numeric

any


<Party / Sender / TravelAgencySender> Schema

IATA_Number

Sender IATA or Pseudo IATA number

numeric

7/8 numbers

NDC Mandatory

AgencyID

Agency identification

alphanumeric

any

Schema
Name

Agency Name

alphanumeric any
<Party / Sender / TravelAgencySender / Contacts / Contact> Mandatory for schema if 'Contacts' tag is indicated.
EmailContact / Address Email to contact the Agency alphanumeric any Mandatory for schema if 'EmailContact' tag is indicated.
PhoneContact / Application Agency phone type alphabetic
  • BUSINESS
  • MOBILE

PhoneContact / Number

Attribute

CountryCode

Country code phone number to contact the Agency alphanumeric any
Name / Surname Reference Agency contact surname alphanumeric any Mandatory for schema if 'Name' tag is indicated.
Name / Given Reference Agency contact given alphanumeric any
<Travelers> Schema

Traveler / AnonymousTraveler / PTC

Attribute Passenger Type Code

PaxType (3 alpha)

Passenger Types

Schema

Traveler / AnonymousTraveler / PTC

Attribute

Quantity

Quantity of this kind of passenger type numeric any, from 1 to 9
<ShoppingResponseIDs>  Presale Schema

ResponseID

ResponseID of FlightPrice service

alphanumeric

any

Schema

AssociatedIDs

Offer Items

alphanumeric

any

Schema
<Query / OriginDestination / Flight>  Post-saleSchema
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

Attribute

MetadataKey

Type of currency alphanumeric  any available currency Mandatory for schema if OrderChangeMetadata' tag is indicated. 
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / Decimals Decimals of currency numeric any Mandatory for schema if OrderChangeMetadata' tag is indicated.

 

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

ALLOWED VALUES
<ShoppingResponseIDs>

ResponseID

Id of the response alphabetical Any
<Services>

ServiceID

ID of the baggage service alphabetical Any
Name Name of the baggage service alphabetical Any
Encoding / RFIC / Code RFIC Code number Any
Encoding / Code Code of the service alpha Any
Descriptions / Description / Text Description of the baggage service alphabetical Any
Price / Total Price of the baggage number Any
Associations / Flight / Segment References Segment referentes with format flight number and flight date alphanumerical Any
Associations / Travaler / Traveler References References to every passenger that applies to the service alphanumerical Any
Detail / ServiceItemQuantityRules / Maximum Quantity

Maximun allowed quantity of the service per passenger

If there are several passengers, the maximum general figure is expressed, that is, the one allowed for the passenger with the most services, without necessarily meaning that all others may request that number of services.

number Any
<Datalist>
AnonymousTravelerLista / AnonymousTraveler Anonymous Passenger key alphabetical Any
AnonymousTravelerLista / AnonymousTraveler/ PTC Anonymous Passenger code alphabetical Passenger Types
<CheckedBagAllowanceList / CheckedBagAllowance / PieceAllowance>
ApplicableParty Type of party alphabetical Any
Total / Quantity Quantity of ApplicableParty number number
PieceMeasurements / Quantity Quantity of pieces number number
PieceMeasurements / MaximumWeight / Value Maximum weight for pieces quantity number number
PieceMeasurements / MaximumWeight / UOM
Weight unit
alphabetical Any
PieceMeasurements / PieceDimensionAllowance / DimensionUOM
Unit of measurement
alphabetical Any
PieceMeasurements / PieceDimensionAllowance / MaxLinear
Maximum measure
number number
PieceMeasurements / PieceDimensionAllowance / MinLinear Minimum measure number number
<FlightSegmentList / FlightSegment>

FlightSegment

Attribute

SegmentKey

Flight Segment Code containing FlightId and date alphanumerical Any
<Departure>
AirportCode IATA Airport Code alphabetical Any
Date Departure Date Date yyyy-MM-dd
Time Departure Time Time hh:mm
AirportName Full Airport Name alphabetical Any
Terminal / Name Terminal name or number. Real world name for terminal alphabetical/numerical Any

<Arrival>

AirportCode IATA Airport Code alphabetical Any
Date Departure Date Date yyyy-MM-dd
Time Departure Time Time hh:mm
AirportName Full Airport Name alphabetical Any
ChangeOfDay Shows how many days after departure date flight will arrive. numerical number
Terminal / Name Terminal name or number. Real world name for terminal alphabetical/numerical Any
<MarketingCarrier>
AirlineID IATA airline code alphabetical Airline ID (IB, AA, I2...)
Name Full Airline name. alphabetical Any
FlightNumber The flight number numerical number

<OperatingCarrier>

AirlineID IATA airline code alphabetical Airline ID (IB, AA, I2...)
Name Full Airline name. alphabetical Any
FlightNumber The flight number numerical number
Disclosure / Description / Text Text showing the disclosure alphabetical Any
<Equipment>
AircraftCode Aircraft Code numerical Any
Name Full Aircraft model name alphabetical Any
<FlightDetail (only first segment)>
FlightDuration / Value Time Flight Duration Date PT'hh'H'mm'M
<FlightList>

Flight

Attribute

FlightKey

Id for the flight alphanumerical Any
Journey / Time Time for the journey Date Any
SegmentReferences Id referencing a FlightSegment alphanumerical Any
<OriginDestinationList>

OriginDestinationList

Attribute

OriginDestinationListKey

IATA Code referencing departure city and arrival city alphabetical Any
DepartureCode IATA Code for Departure City alphabetical Any
ArrivalCode IATA Code for Arrival City alphabetical Any
FlightReferences Id Referencing a Flight. alphanumerical Any
<MediaList>

MediaList

Attribute

MediaKey

Id for the Media Item alphabetical Any
MediaLink Http link referring to the Media Item alphanumerical Any

 

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