1. Disclaimer

This document is confidential and for the sole use of the company to whom it was issued. Any transmission of this document to third parties remains subject to Oman Air (hereinafter referred to as Oman) or TP Connects Technologies LLC (hereinafter referred to as TPConnects) prior approval.

The NDC Standard enhances the capability of communications between airlines and travel agents and brings lower cost, innovation, ease of comparison and interoperability. TPConnects, working with Oman as an NDC service provider, has integrated directly to the airline’s NDC APIs with a b2b reseller platform and Internet Booking Engine for Online Travel Agencies and NDC APIs. Travel Agents using the NDC APIs will be able to access the airlines’ offerings directly including ancillary products and perform after sales service like refund, change of date and flight etc. Moreover, travel agents will have the ability to offer personalized products benefiting the end consumers. With this direct connect integration travel agents will be able to access rich content that includes videos, pictures and personalized preferences as well.

Please note that this document is for information only and does not necessarily imply that Oman will be allowing the reader to access its Application Program Interfaces (API). All information on how to get access to the APIs can be found on support@tpconnects.com

As Oman implements new products and features following International Air transport Associations (IATA) New Distribution Capability (NDC), this document will be updated. Oman will keep its users informed of any significant change to the product, and the latest version of this user guide can always be provided upon request from support@tpconnects.com

In no circumstances shall Oman have any liability for losses (whether direct or indirect) arising from the participation in this trial, implementation or for any inaccuracies, errors in, or omissions from this document.

2. Introduction

Seat Availability verb is called to return a seat map for the selected segment with or without the prices associated to the seats.

The seat map is interactively built, based on the airline’s inventory response. For chargeable seats, an additional chargeable characteristic ‘CH’ is returned in addition to the other seat characteristics defined in the airline’s inventory.

The seat map request polls the airline inventory to retrieve the aircraft cabin configuration, seat rows and columns, and seat characteristics.

The airline designates a set of characteristics for each seat, from a list of industry-standard PADIS codes.

Examples: K = bulkhead, L = legroom, E = exit row.

In addition, seats are designated as either being W for window, 9 for middle seat or A for aisle. Seats are also shown to be occupied, available, or blocked. Blocked seat rows can sometimes be unblocked for preferred agencies or frequent flyers.

Prices are re turned on the seat map for any chargeable seats. The booking of the selected seat will be done further in the flow with Order Create verb.

3. SequenceDiagram

4. Implementation

This section describes the implementation of the input message based on the NDC schema version 18.2.

4.1. Request Parameters

4.1.1. Party

NDC Message/ Transaction Party(s) information.

Field Type	Repetition	Schema Definition	Optional/Mandatory	Description
Party			M	Party Information
Sender	1			Message Sender Information
TravelAgency	1			A private retailer or public service that provides travel and tourism related services to the public on behalf of suppliers such as airline activities.
AgencyId	1	Party/Sender/TravelAgency/AgencyId	M	Unique Agency Seller ID. Example: CTRV
IATANumber	0..1	Party/Sender/TravelAgency/IATANumber	O	IATA-assigned agency number. Example: 98417900
Name	0..1	Party/Sender/TravelAgency/Name	N	Agency name. Example: Carson Travel
PseudoCityID	0..1	Party/Sender/TravelAgency/ PseudoCityID	N	An identifier for a corporate user of a computer reservation system (CRS) or global distribution system (GDS), typically a travel agency. Also known as Office ID.

<iata:Party>

<iata:Sender>

<iata:TravelAgency>

<iata:AgencyID>MCT1234567</iata:AgencyID>

<iata:IATANumber>12345678</iata:IATANumber>

<iata:Name>ABCD TOURISM and TRAVELS</iata:Name>

<iata:PseudoCityID>GCCT</iata:PseudoCityID>

</iata:TravelAgency>

</iata:Sender>

</iata:Party>

4.1.2. CoreRequest

Field Type	Repetition	Schema Definition	Optional/Mandatory	Comments
CoreRequest	0..1		N	Core Service List request including choice of Journey information, Offer, or Order references.
PaxSegment	1..n	PaxSegment/PaxSegment	Y	Transportation of a passenger on a Dated Operating Segment.
Arrival	1	PaxSegment/Arrival	Y	The action or process of arriving of a transport vehicle in any place or location.
AircraftScheduledDateTime	0..1	PaxSegment /Arrival/ AircraftScheduledDateTime	N	The Scheduled Date and Time of Arrival of the aircraft at the terminal or departure gate at an airport.
StationName	0..1	PaxSegment /Arrival/ IATALocationCode	N	Name of the station. E.g. George Bush Intercontinental Airport
CabinType	1	PaxSegment/CabinType	N	Type of compartment of an aircraft, offering specific services (e.g. business class, economy).
CabinTypeCode	0..1	PaxSegment/CabinType/ CabinTypeCode	N	Cabin Type Code as defined by PADIS codeset (e.g. 1, 2, 3, etc.)
CabinTypeName	0..1	PaxSegment/ CabinType/ CabinTypeName	N	Name given to a cabin compartment (e.g. Business, First, Economy).
Dep	1	PaxSegment/Dep	Y	The action or process of leaving of a transport vehicle from any place or location
AircraftScheduledDateTime		PaxSegment/Dep/ AircraftScheduledDateTime		The Scheduled Date and Time of Departure of the aircraft at the terminal or departure gate at an airport.
IATALocationCode		PaxSegment/Dep/ IATALocationCode		IATA defined code identifying a city or station.
StationName		PaxSegment/Dep/StationName		Name of the station. E.g. George Bush Intercontinental Airport
Duration				Total segment time including the combined air time and connection times of any legs.
MarketingCarrierInfo	1	PaxSegment/ MarketingCarrierInfo	Y	The commercial designation under which a Dated Operating Segment can be booked, either under the operating carrier’s designator or that of another carrier (codeshare).
CarrierDesigCode	1	PaxSegment/ MarketingCarrierInfo/ CarrierDesigCode	Y	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.
CarrierName		PaxSegment/ MarketingCarrierInfo/ CarrierName		Commercial name of the carrier.
MarketingCarrierFlightNumberText	1	PaxSegment/ MarketingCarrierInfo/ MarketingCarrierFlightNumberText	Y	The numerical designation of a flight as it is marketed by a carrier.
OperatingCarrierInfo	0..1	PaxSegment/ OperatingCarrierInfo	N	An operation between board point and any subsequent off point within the same flight designator. Could be one or more legs. Could also be used for other transport vehicles such as train or bus etc.
CarrierDesigCode	0..1	PaxSegment/ OperatingCarrierInfo/ CarrierDesigCode	N	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.
CarrierName		PaxSegment/ OperatingCarrierInfo/ CarrierName		Commercial name of the carrier.
PaxSegmentID	1	PaxSegment/PaxSegmentID	Y	Uniquely identifies a Passenger Segment within the context of one message.

<iata:CoreRequest>

<iata:PaxSegment>

<iata:Arrival>

<iata:AircraftScheduledDateTime>2019-02-15T09:50:00.000</iata:AircraftScheduledDateTime>

<iata:IATALocationCode>DXB</iata:IATALocationCode>

<iata:StationName>Dubai</iata:StationName>

</iata:Arrival>

<iata:CabinType>

<iata:CabinTypeCode>L</iata:CabinTypeCode>

<iata:CabinTypeName>ECONOMY CLASSIC</iata:CabinTypeName>

</iata:CabinType>

<iata:Dep>

<iata:AircraftScheduledDateTime>2019-02-15T08:45:00.000</iata:AircraftScheduledDateTime>

<iata:IATALocationCode>MCT</iata:IATALocationCode>

<iata:StationName>Muscat</iata:StationName>

</iata:Dep>

<iata:Duration>PT1H5M</iata:Duration>

<iata:MarketingCarrierInfo>

<iata:CarrierDesigCode>WY</iata:CarrierDesigCode>

<iata:CarrierName>ABCair</iata:CarrierName>

<iata:MarketingCarrierFlightNumberText>0608</iata:MarketingCarrierFlightNumberText>

</iata:MarketingCarrierInfo>

<iata:OperatingCarrierInfo>

<iata:CarrierDesigCode>WY</iata:CarrierDesigCode>

<iata:CarrierName>OA</iata:CarrierName>

</iata:OperatingCarrierInfo>

<iata:PaxSegmentID>SEG1</iata:PaxSegmentID>

</iata:PaxSegment>

</iata:CoreRequest>

4.1.3. Shopping Response

Field Type	Repetition	Schema Definition	Optional/Mandatory	Comments
ShoppingResponse	0..1			Shopping session (message response) ID.
OwnerCode	0..1	ShoppingResponse/OwnerCode	N	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.
ShoppingResponseID	1	ShoppingResponse/ShoppingResponseID	Y	Unique shopping session response ID.

<iata:ShoppingResponse>

<iata:OwnerCode>WY</iata:OwnerCode>

<iata:ShoppingResponseID>8f3120e5-b7d5-421a-874c-481bac77e024</iata:ShoppingResponseID>

</iata:ShoppingResponse>

4.2. Response

4.2.1. DataLists

4.2.1.1. BaggageAllowanceList

Field Type	Repetition	Schema Definition	Optional/Mandatory	Description
BaggageAllowanceList		DataLists/ BaggageAllowanceList		Baggage allowance data list definition
BaggageAllowance		DataLists/ BaggageAllowanceList/ BaggageAllowance		The amount of checked or carry-on luggage the airline will allow per passenger.
BaggageAllowanceID		DataLists/ BaggageAllowanceList/ BaggageAllowance/ BaggageAllowanceID		Unique identifier of this Baggage Allowance.
TypeCode		DataLists/ BaggageAllowanceList/ BaggageAllowance/TypeCode		Type of Baggage Allowance. E.g. Checked or CarryOn.
WeightAllowance		DataLists/ BaggageAllowanceList/ BaggageAllowance/ WeightAllowance		Baggage weight allowance with application information.
MaximumWeightMeasure		DataLists/ BaggageAllowanceList/ BaggageAllowance/ WeightAllowance/ MaximumWeightMeasure		Maximum weight value and unit of measure. Example: 50

<iata:BaggageAllowanceList>

<iata:BaggageAllowance>

<iata:BaggageAllowanceID>BAGA</iata:BaggageAllowanceID>

<iata:TypeCode>Checked</iata:TypeCode>

<iata:WeightAllowance>

<iata:MaximumWeightMeasure UnitCode=”KG”>30</iata:MaximumWeightMeasure>

</iata:WeightAllowance>

</iata:BaggageAllowance>

</iata:BaggageAllowanceList>

4.2.1.2. FareList

Field Type	Repetition	Schema Definition	Optional/Mandatory	Description
FareList	0..1	DataLists/FareList		Fare List definition
FareGroup		DataLists/FareList/FareGroup	Y
FareCode		DataLists/FareList/FareGroup/ FareCode	Y	Fare Type Code. Examples: 70J, Published Fares 70K, Dynamic Discounted Fares 749, Negotiated Fares 756, One Way Fare 758, Private Fares Encoding Scheme: PADIS codeset element 9910 – Fare Qualifier
FareDetail	0..n	DataLists/FareList/FareGroup/ FareDetail	N	The amount charged by the carrier for the carriage of a passenger and his allowable free baggage.
FareComponent	0..n	DataLists/FareList/FareGroup/ FareDetail/FareComponent	N	A portion of an itinerary between two consecutive fare construction points. If the journey has only one fare component, the points of origin and destination are the only fare construction points
CabinType	0..1	DataLists/FareList/FareGroup/ FareDetail/FareComponent/ CabinType	N	Type of compartment of an aircraft, offering specific services (e.g. business class, economy).
CabinTypeCode	0..1	DataLists/FareList/FareGroup/ FareDetail/FareComponent/ CabinType/CabinTypeCode	N	Cabin Type Code as defined by PADIS codeset (e.g. 1, 2, 3, etc.)
FareBasisCode	0..1	DataLists/FareList/FareGroup/ FareDetail/FareComponent/ FareBasisCode	N	Fare basis code. Example: Y26
FarePriceType	1	DataLists/FareList/FareGroup/ FareDetail/FarePriceType	Y	The type of fair price applied to a Fare Detail (e.g. filed amount, net amount, or a sell amount).
FarePriceTypeCode	1..3	DataLists/FareList/FareGroup/ FareDetail/FarePriceType/ FarePriceTypeCode	Y	Indicates if the fare price provided is a filed amount, net amount, or a sell amount.
Price	1	DataLists/FareList/FareGroup/ FareDetail/FarePriceType/Price	Y	The amount of money expected, required, or given in payment for something.
BaseAmount	0..1	DataLists/FareList/FareGroup/ FareDetail/FarePriceType/Price/ BaseAmount	N	Total Base Fare Amount. Example: 200000
FareGroupID	1	DataLists/FareList/FareGroup/ FareGroupID	Y	Unique identifier for this Fare Group.

<iata:FareList>

<iata:FareGroup>

<iata:FareCode>L</iata:FareCode>

<iata:FareDetail>

<iata:FareComponent>

<iata:CabinType>

<iata:CabinTypeCode>L</iata:CabinTypeCode>

</iata:CabinType>

<iata:FareBasisCode>LVEOWOM</iata:FareBasisCode>

</iata:FareComponent>

<iata:FarePriceType>

<iata:FarePriceTypeCode>L</iata:FarePriceTypeCode>

<iata:Price>

<iata:BaseAmount CurCode=”OMR”>27</iata:BaseAmount>

</iata:Price>

</iata:FarePriceType>

</iata:FareDetail>

<iata:FareGroupID>LVEOWOM</iata:FareGroupID>

</iata:FareGroup>

</iata:FareList>

4.2.1.3. OrginDestList

Field Type	Repetition	Schema Definition	Optional/Mandatory	Description
DataLists	0..1		N	Data List definition for this message.
OriginDestList	1..n	DataLists/OriginDestList	N	Origin Destination data list definition.
OriginDest	1..n	DataLists/OriginDestList/ OriginDest		The Origin and Destination airport/city pair which confines a passenger journey or an aircraft flight.
DestCode	1	DataLists/OriginDestList/ OriginDest/DestCode	Y	IATA defined code identifying a city or station.
OriginCode	1	DataLists/OriginDestList/ OriginDest/OriginCode	Y	IATA defined code identifying a city or station.
OriginDestID	0..1	DataLists/OriginDestList/ OriginDest/OriginDestID	N	Uniquely identifies an Origin Destination within the context of one message.

<iata:OriginDestList>

<iata:OriginDest>

<iata:DestCode>DXB</iata:DestCode>

<iata:OriginCode>MCT</iata:OriginCode>

<iata:OriginDestID>MCTDXB</iata:OriginDestID>

</iata:OriginDest>

</iata:OriginDestList>

4.2.1.4. PaxList

Field Type	Repetition	Schema Definition	Optional/Mandatory	Description
PaxList	0..1	DataLists/PaxList		Passenger data list definition.
Pax	1..n	DataLists/PaxList/Pax	Y	Any person except members of the crew carried or to be carried with the consent of the carrier, on board of any transport vehicle such as aircraft, train, bus, ship. Holds the attributes specific to a one booking, from shopping to f
PaxID	1	DataLists/PaxList/Pax/PaxID	Y	Uniquely identifies a Passenger within the context of one message.
PTC	1..n	DataLists/PaxList/Pax/PTC	N	Type code applying to the Passenger which typically drives pricing (e.g. ADT, CHD, etc).

<iata:PaxList>

<iata:Pax>

<iata:PaxID>PAX1</iata:PaxID>

<iata:PTC>ADT</iata:PTC>

</iata:Pax>

</iata:PaxList>

4.2.1.5. PaxSegmentList

Field Type	Repetition	Schema Definition	Optional/Mandatory	Comments
PaxSegmentList	0..1	DataLists/PaxSegmentList	N	Segment data list definition.
PaxSegment	1..n	PaxSegmentList/ PaxSegment	Y	Transportation of a passenger on a Dated Operating Segment.
Arrival	1	PaxSegmentList/ PaxSegment /Arrival	Y	The action or process of arriving of a transport vehicle in any place or location.
AircraftScheduledDateTime	0..1	PaxSegmentList/ PaxSegment /Arrival/ AircraftScheduledDateTime	N	The Scheduled Date and Time of Arrival of the aircraft at the terminal or departure gate at an airport.
IATALocationCode	0..1	PaxSegmentList/ PaxSegment /Arrival/ IATALocationCode	N	IATA defined code identifying a city or station.
StationName	0..1	PaxSegmentList/ PaxSegment /Arrival/ StationName	N	Name of the station. E.g. George Bush Intercontinental Airport
CabinType	0..1	PaxSegmentList/ PaxSegment/CabinType	N	Type of compartment of an aircraft, offering specific services (e.g. business class, economy).
CabinTypeCode	0..1	PaxSegmentList/ PaxSegment/CabinType/ CabinTypeCode	N	Cabin Type Code as defined by PADIS codeset (e.g. 1, 2, 3, etc.)
CabinTypeName	0..1	PaxSegmentList/ PaxSegment/CabinType/ CabinTypeName	N	Name given to a cabin compartment (e.g. Business, First, Economy).
Dep	1	PaxSegmentList/ PaxSegment/Dep	Y	The action or process of leaving of a transport vehicle from any place or location.
AircraftScheduledDateTime	0..1	PaxSegmentList/ PaxSegment/Dep/ AircraftScheduledDateTime	N	The Scheduled Date and Time of Departure of the aircraft at the terminal or departure gate at an airport.
IATALocationCode	0..1	PaxSegmentList/ PaxSegment/Dep/ IATALocationCode	N	IATA defined code identifying a city or station.
StationName	0..1	PaxSegmentList/ PaxSegment/Dep/ StationName	N	Name of the station. E.g. George Bush Intercontinental Airport
Duration	0..1	PaxSegmentList/ PaxSegment/Duration	N	Total segment time including the combined air time and connection times of any legs.
MarketingCarrierInfo	1	PaxSegmentList/ PaxSegment/ MarketingCarrierInfo	Y	The commercial designation under which a Dated Operating Segment can be booked, either under the operating carrier’s designator or that of another carrier (codeshare).
CarrierDesigCode	1	PaxSegmentList/ PaxSegment/ MarketingCarrierInfo/ CarrierDesigCode	Y	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.
CarrierName	0..1	PaxSegmentList/ PaxSegment/ MarketingCarrierInfo/ CarrierName	N	Commercial name of the carrier.
MarketingCarrierFlightNumberText	1	PaxSegmentList/ PaxSegment/ MarketingCarrierInfo/ MarketingCarrierFlightNumberText	Y	The numerical designation of a flight as it is marketed by a carrier.
OperatingCarrierInfo	0..1	PaxSegmentList/ PaxSegment/ OperatingCarrierInfo	N	An operation between board point and any subsequent off point within the same flight designator. Could be one or more legs.
CarrierDesigCode	1	PaxSegmentList/ PaxSegment/ OperatingCarrierInfo/ CarrierDesigCode	N	Airline code assigned to a carrier. Either ICAO-defined 3-character code or IATA-defined 2-character code.
CarrierName	0..1	PaxSegmentList/ PaxSegment/ OperatingCarrierInfo/ CarrierName	N	Commercial name of the carrier.
PaxSegmentID	1	PaxSegmentList/ PaxSegment/PaxSegmentID	Y	Uniquely identifies a Passenger Segment within the context of one message.

<iata:PaxSegmentList>

<iata:PaxSegment>

<iata:Arrival>

<iata:AircraftScheduledDateTime>2019-01-10T03:10:00</iata:AircraftScheduledDateTime>

<iata:IATALocationCode>DXB</iata:IATALocationCode>

<iata:StationName>Dubai</iata:StationName>

</iata:Arrival>

<iata:CabinType>

<iata:CabinTypeCode>Y</iata:CabinTypeCode>

<iata:CabinTypeName>Economy</iata:CabinTypeName>

</iata:CabinType>

<iata:Dep>

<iata:AircraftScheduledDateTime>2019-01-10T01:50:00</iata:AircraftScheduledDateTime>

<iata:IATALocationCode>MCT</iata:IATALocationCode>

<iata:StationName>Muscat</iata:StationName>

</iata:Dep>

<iata:Duration>PT1H20M</iata:Duration>

<iata:MarketingCarrierInfo>

<iata:CarrierDesigCode>WY</iata:CarrierDesigCode>

<iata:CarrierName>OmanAir</iata:CarrierName>

<iata:MarketingCarrierFlightNumberText>603</iata:MarketingCarrierFlightNumberText>

</iata:MarketingCarrierInfo>

<iata:OperatingCarrierInfo>

<iata:CarrierDesigCode>WY</iata:CarrierDesigCode>

<iata:CarrierName>OA</iata:CarrierName>

</iata:OperatingCarrierInfo>

<iata:PaxSegmentID>SEG1</iata:PaxSegmentID>

</iata:PaxSegment>

</iata:PaxSegmentList>

4.2.1.6. PriceClassList

Field Type	Repetition	Schema Definition	Optional/Mandatory	Comments
PriceClassList	0..1	DataLists/PriceClassList	N	Price Class data list definition.
PriceClass	1..n	PriceClassList/PriceClass	Y	A price point within a particular Cabin Type (sometimes referred to as ‘Fare Families’).
CabinType	0..n	PriceClassList/PriceClass/ CabinType	N	Type of compartment of an aircraft, offering specific services (e.g. business class, economy).
CabinTypeName	0..1	PriceClassList/PriceClass/ CabinType/ CabinTypeName	N	Name given to a cabin compartment (e.g. Business, First, Economy).
Code	0..1	PriceClassList/PriceClass/Code	N	Price class code. Example: 1, ABC
Desc	0..n	PriceClassList/PriceClass/Desc	N	An account or representation of the certain or major aspects, characteristics, or features of a person, object, or event.
DescText	0..1	PriceClassList/PriceClass/Desc/DescText	N	Description text value.
Name	1	PriceClassList/PriceClass/Name	Y	Price class name. Example: SUPERSAVER
PriceClassID	0..1	PriceClassList/PriceClass/ PriceClassID	N	Uniquely Identifies a Price Class within the context of one message.

<iata:PriceClassList>

<iata:PriceClass>

<iata:CabinType>

<iata:CabinTypeName>Economy</iata:CabinTypeName>

</iata:CabinType>

<iata:Code>Y</iata:Code>

<iata:Desc>

<iata:DescText>Economy</iata:DescText>

</iata:Desc>

<iata:Name>Saver Economy</iata:Name>

<iata:PriceClassID>1</iata:PriceClassID>

</iata:PriceClass>

</iata:PriceClassList>

4.3. SeatMap

4.3.1. CabinCompartment

Field Type	Repetition	Schema Definition	Optional/Mandatory	Comments
SeatMap	1..n	Response/SeatMap	Y	Returns a list of cabins and the seats within in. This information can be used by the Seller to render a graphical Seat Map.
CabinCompartment	1..n	SeatMap/ CabinCompartment	Y	A physical aircraft compartment where passenger seats are installed, classified by a given Cabin Type.
CabinType	0	SeatMap/ CabinCompartment/ CabinType	N	Type of compartment of an aircraft, offering specific services (e.g. business class, economy).
CabinTypeCode	0..1	SeatMap/ CabinCompartment/ CabinType/CabinTypeCode	N	Cabin Type Code as defined by PADIS codeset (e.g. 1, 2, 3, etc.)
CabinTypeName	0..1	SeatMap/ CabinCompartment/ CabinType/ CabinTypeName	N	Name given to a cabin compartment (e.g. Business, First, Economy).
SeatRow	0..n	SeatMap/ CabinCompartment/ SeatRow	N	Row of passenger seats located in the cabin.
RowNumber	1	SeatMap/ CabinCompartment/ SeatRow/RowNumber	Y	Ordinal number identifying a seat row in an aircraft.
Seat	1..n	SeatMap/ CabinCompartment/ SeatRow/Seat	Y	A sitting place for a passenger located in the cabin.
ColumnID	1	SeatMap/ CabinCompartment/ SeatRow/Seat/ColumnID	Y	Alphabetic character identifying a seat within a row.
PaxSegmentRefID	1	SeatMap/ PaxSegmentRefID	Y	References a Passenger Segment ID from this message or from wiithin the SeatAvailability request.

<iata:SeatMap>

<iata:CabinCompartment>

<iata:CabinType>

<iata:CabinTypeCode>L</iata:CabinTypeCode>

<iata:CabinTypeName>Economy</iata:CabinTypeName>

</iata:CabinType>

<iata:SeatRow>