SeatAvailability

 Our 17.2 version is available for trial in BETA: SeatAvailability Version 17

1.1 Functional Description

version: 2.45 

The SeatAvailability service returns priced seatmaps for the flights in the selected Offer or Order.

Seats can be purchased as part of the Shopping flow following the FlightPrice, or as part of a servicing flow after the initial booking has been made.

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

Functionality:

SeatAvailability.zip message examples

Functionality Use

Pre-Sale

The pre-sale seat availability service allows us to see the price and availability of seats for flights before the creation of the Order. In this way, we can select those seats services that we want to include when creating the Order.
Post-Sale The post-sale seat availability service allows us to see the price and availability of seats for flights after the creation of the Order. In this way, we can select those seats services that we want to add to a previously created order

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

The elements are:

  • Traveler: contains the passangers references the seat service can be applied for.

Example of validation of the currency we sell with the point of sale currency.

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

  • 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 will return the seat availability for the ordered flight.

There are various search parameter for this endpoint.

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


<ShoppingRespondeID> Presale

ResponseID

ResponseID of FlightPrice service

alphanumeric

any

Schema

AssociatedIDs

Offer Items

alphanumeric


Schema

<ShoppingRespondeID> Post-sale

OrderID

Order ID with mandatory attribute Owner

alphanumeric

any

Schema

AssociatedIDs

Offer Items

alphanumeric

the order id of an existing order which has been created, paid and ticketed Schema
<MetaData>Add
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / MetadataKey Type of currency Alphabetical Any available currency Mandatory for schema if 'Metadata' tag is indicated
Other / OtherMetadata / CurrencyMetadatas / CurrencyMetadata / Decimals Decimals of currency Numeric Decimals currency should have Mandatory for schema if 'MetadataKey' tag is indicated

1.3 Response Body

NAME 

DESCRIPTION 

FORMAT 

Nullable 

<ShoppingResponseID>

ResponseID

Id of the response

alphabetical

False

<Flights>

OriginDestinationReference

IATA standard reference for Origin Destination. (OriDestDate)

alphabetical

False

FlightSegmentReferences

IATA standard reference for flight

alphabetical

False

Code

Code of the cabin

numerical

False

Definition

Code definition of the cabin

alphabetical

False

<Cabin/SeatDisplay>

Columns  Column name alphabetical False
Rows / First  Cabin's first row numerical False
Rows / Last  Cabin's last row numerical False
Component / Locations / Location / Row / position  One location row position of a Component numerical True
Component / Locations / Location / Column / position  One location column position of a Component numerical True
Component / Type / Code  Description code of the Component alphabetical True

<Services/Service>

ServiceID

ID of the baggage service

alphabetical

False

Name

Name of the baggage service

alphabetical

False

RFIC / Code

RFIC Code

number

False

Code

Code of the service

alpha

False

Description / Text

Description of the baggage service

alphabetical

False

Price

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.

alphanumerical

False

<DataList>

AnonymousTraveler

Anonymous Passenger key

alphabetical

False

PTC

Anonymous Passeger Code

alphabetical

False

FlightSegmentList/FlightSegment

SegmentKey

Flight Segment Code containing FlightId and date

alphanumerical

False

Departure

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

Arrival

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

MarketingCarrier

AirlineID

IATA airline code

alphabetical

False

Name

Full Airline name.

alphabetical

False

FlightNumber

The flight number

numerical

False

OperatingCarrier

AirlineID

IATA airline code

alphabetical

False

Name

Full Airline name.

alphabetical

False

FlightNumber

The flight number

numerical

False

Disclosure/Text

Text showing the disclosure

alphabetical

False

Equipment

AircraftCode

Aircraft Code



Name

Full Aircraft model name



FlightDetail (only first segment)Add
FlightDuration / Value Time Flight Duration Date False

FlightList

Flight/FlightKey

Id for the flight

alphanumerical

False

Journey/Time

Time for the journey

Date

False

SegmentReferences

Id referencing a FlightSegment

alphanumerical

False

OriginDestinationList

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 List

ListKey

Id for the Media Item

alphabetical

False

MediaLink

Http link referring to the Media Item

alphanumerical

False

SeatList


Seats/Refs Id of the Seat alphanumerical False
Location / Column Refers to the column of the plane character False
Location / Row / Number Refers to the row of the plane numerical False
Location / Characteristics / Characteristic / Code Code for the characteristic of the seat numerical False

1.4 Seat Codes

CODEDESCRIPTION
1 Restricted seat - General 
2 Leg rest available 
3 Individual video screen - Choice of movies
4 Not a window seat 
5 Not an aisle seat 
6 Near galley seat 
7 Near toilet seat 
8 No seat at this location 
9 Center seat (not window, not aisle)
10 Seat designated for RBD "A" 
11 Seat designated for RBD "B" 70
12 Seat designated for RBD "C"
13 Seat designated for RBD "D"
14 Seat designated for RBD "F"
15 Seat designated for RBD "H"
16 Seat designated for RBD "J"
17 Seat designated for RBD "K"
18 Seat designated for RBD "L"
19 Seat designated for RBD "M"
20 Seat designated for RBD "P"
21 Seat designated for RBD "Q"
22 Seat designated for RBD "R"
23 Seat designated for RBD "S"
24 Seat designated for RBD "T"
25 Seat designated for RBD "V"
26 Seat designated for RBD "W"
27 Seat designated for RBD "Y"
28 Not fitted 
A Aisle seat 
AA All available aisle seats
AB Seat adjacent to bar
AC Seat adjacent to - closet
AG Seat adjacent to galley
AJ Adjacent aisle seats
AL Seat adjacent to lavatory
AM Individual movie screen - No choice of movie selection
AR No seat - airphone
AS Individual airphone
AT Seat adjacent to table
AU Seat adjacent to stairs to upper deck
AV Only available seats
AW All available window seats
B Seat with bassinet facility
BA No seat - bar
BK Blocked Seat for preferred passenger in adjacent seat
C Crew seat 
CC Center section seat(s)
CH Chargeable seat
CL No seat - closet
CS Conditional seat-contact airline
D No seat - exit door
DE Deporte
E Exit and emergency exit
EA Not on exit seat
EC Electronic connection for lap top or FAX machine
EK Economy comfort seat
EX No seat - emergency Exit
F Added seat 
FC Front of cabin class/compartment
G Seat at forward end of cabin
GF General facility
GN No seat - galley
GR Group seat - offered to travellers belonging to a group
H Seat with facilities for handicapped/incapacitated passenger
I Seat suitable for adult with an infant
IA Inside aisle seats
IE Seat not suitable for child
J Rear facing seat
K Bulkhead seat
KA Bulkhead seat with movie screen
KN Bulkhead, no seat 71
L Leg space seat
LA No seat – lavatory
LB Rear facing lie flat seat
LE Left facing lie flat seat more left angle
LF Lie flat seat
LG No seat - luggage storage
LH Restricted seat - offered on long-haul segments
LL Left facing lie flat seat
LR Right facing lie flat seat
LS

Left side of aircraft

LT Right facing lie flat seat more right angle
M Seat without a movie view
MA Medically OK to travel
MS Middle seat
N No smoking seat
O Preferential seat
OW Overwing seat(s)
P Extra seat for comfort - arm rest can be raised
PC Pet cabin 
Q Seat in a quiet zone
RS Right side of aircraft
S Smoking seat
SC Skycouch 
SO No seat - storage space
ST No seat - stairs to upper deck
T Rear/Tail section of aircraft
TA No seat - table
U Seat suitable for unaccompanied minors
UP Upper deck 
V Seat to be left vacant or offered last
W Window seat 
WA Window and aisle together
X No facility seat (indifferent seat)
Z Buffer zone seat
1A Seat not allowed for infant
1B Seat not allowed for medical
1C Seat not allowed for unaccompanied minor
1D Restricted recline seat
1M Seat with movie view
1W Window seat without window
3A Individual video screen - No choice of movie
3B Individual video screen-Choice of movies, games, information, etc
6A In front of galley seat
6B Behind galley seat
7A In front of toilet seat
7B Behind toilet seat
70 Individual video screen - services unspecified
71 No seat --access to handicapped lavatory
72 Undesirable seat

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

HTTP STATUS CODE

EXAMPLE MESSAGE ERROR

REASON

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