Developer s Guide. to Kronos Airways NDC Platform

Transcription

1 Developer s Guide to Kronos Airways NDC Platform

2

3 Welcome to Kronos Airways C9

4 An airline flying in Europe and offering seats and services.

5 Executive Summary Airline travel market challenges have favored the inauguration of a new electronic communication schema that will introduce the retailing spirit in the distribution of air products to corporations, leisure and business travelers. Since 2012, IATA has being leading a collaborative industry initiative to define a novel XML-based schema - the New Distribution Capability (NDC) - for promoting product differentiation and time-tomarket, access to full and rich air content and finally, transparent shopping experience. KRONOS Airways (C9) is a newly established virtual airline, modelled on JR Technologies' proven NDC platform. It opened its wings on August 31st, 2015 employing a fleet of various contemporary aircraft such as the Embraer 190 & 195, Airbus A319, A320 & A321, Boeing 737 and Canadair Regional Jet 900. KRONOS operates in Northwestern Europe serving 13 destinations and offering services as advance seat selection, excess baggage, inflight entertainment, lounge pass and meal. We're proud to be one of the first NDC-enabled airlines and we want to share our enthusiasm with any developer wishing to experience the emerging distribution era. So, we welcome you to connect to our platform and search for our available flights or services, order the ones you prefer and should you change your mind, modify or cancel you order. Welcome onboard & enjoy the flight! Ioannis SKIAS, C.E.O.

6 Kronos Airways serves 13 destinations in Europe and Middle East. ARN - Stockholm BCN - Barcelona CDG - Charles De Gaulles DXB - Dubai FRA - Frankfurt LHR - London Heathrow MUC - Munich PRG - Prague RIX - Riga TXL - Berlin Tegel SFO San Francisco SFO - San Francisco DUB - Dublin IAD Dulles International Airport IAD - Washington D D

7 ARN Stockholm RIX Riga DUB Dublin LHR London Heathrow FRA Frankfurt TXL Berlin PRG Prague CDG Charles De Gaulles MUC Munich BCN Barcelona DXB Dubai 07

8 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Inflight Wi-Fi Short Description Stay connected using any Wi-Fi enabled device Long Description Want to get some work done, catch up with friends or simply surf the web? Whether your trip is for business or pleasure, we'll keep you connected while onboard your flight Name Lounge pass Business Short Description Long Description Escape the crowds and find a quiet space to work or relax Pre-book a space in an airport lounge and lap up the luxury for up to three hours before you fly Business

9 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Advanced seat selection Short Description A convenient option that lets you reserve your preferred seat Long Description Like the window seat? Prefer the aisle? Select your preferred seat on Kronos operated flights+ after making a booking. Seat Selection is complimentary for customers who are Gold Frequent Flyers Name Premium Seating Business Short Description Take advantage of the Premium cabin to rest,read or work Long Description Our Premium seat ensures you receive more of the following: Space: A large and relaxing seat area and wide, leather armrests offer 40% more space than the cabin. Privacy: The seat reclines within a fixed area to ensure the comfort of all passengers, preserving your personal space throughout your flight. Comfort: The seat adapts perfectly to the contours of your body. For your comfort, the seat is equipped with: adjustable head and leg rests, an adjustable footrest, several convenient storage spaces for your personal items Flight Duration > 90 min

10 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Vegetarian Meal Short Description Vegetarian meal flavoured with spices from Indian sub-continent 1012 Long Description Name It may contain: Vegetables, fruit, dairy products, spices and aromas associated with the Indian sub-continent. The meal could be mildly spiced. Does not contain: Meat, poultry, fish, seafood, and eggs. Standard Meal Flight Duration > 120 min Short Description Vegetarian Oriental Meal 1016 Long Description Typically cooked in Chinese style, this meal does not contain meat, seafood, egg and dairy products. Does not contain: Meat, poultry, fish, seafood, and eggs. Flight Duration > 120 min

11 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Standard Meal Short Description This is a non-strict vegetarian meal Long Description Prepared in Western style, which can include eggs and dairy products but eliminates all meats and seafood Name Low-Carb meal Flight Duration > 120 min Business Short Description Long Description For passengers with special dietary requirements as Low-Carb Ingredients rich in starch and carbohydrates in any form will be avoided in the preparation of this meal. However, traces of carbohydrates may be present in some of the dish components Flight Duration > 120 min Business

12 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Diabetic Meal Short Description Sugar is not used in the preparation of this meal Long Description This is a diabetic meal that contains minimal sugar content with an equal balance of proteins, fats, fibre, and complex carbohydrates Name Lactose-free meal Flight Duration > 120 min Business Short Description Long Description This meal is for customers who are lactose-intolerant. This meal excludes foods which contain milk, dry milk solids, casein, cheese, cream, butter, lactose and margarine. It may contain: Meat, fish, pasta, rice, potatoes, vegetables, and fruit. Does not contain: Milk, yoghurt, cheese, croissants, soft rolls, ice cream, sherbet, pudding, and all other dairy products Flight Duration > 120 min

13 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Muslim Meal Short Description *Halal* meal prepared according to Islamic principles. Long Description Does not contain: Pork, alcohol or any haram ingredients Name Kosher meal Flight Duration > 120 min Business Short Description Long Description Prepared by kosher caterers under rabbinical supervision May also incorporate fresh fruit or sealed items, such as individually packaged bagels that meet kosher laws. Special Kosher for Passover meals are supplied during Passover Flight Duration > 90 min Business

14 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name Snack Short Description Enjoy a wide selection of complimentary snacks and beverages. Long Description Beverage options and product availability may vary by flight Name 1st Bag Flight Duration > 120 min Short Description Long Description Plan ahead to save time and money on all your baggage needs Do not get caught out at the airport. The 1st Bag is free for Gold passengers. The 1st Bag is free for Platinum passengers 1023 Business

15 Flight id Details Service Name Routes Fare Seasonality Characteristics Cabin rules FQTV Cost Image Service Name 2nd Bag Short Description Plan ahead to save time and money on all your baggage needs Long Description Do not get caught out at the airport. The 2nd Bag is free for Gold passengers. The 2nd Bag is free for Platinum passengers Name 3d Bag Business Short Description Long Description Do not get caught out at the airport. Plan ahead to save time and money on all your baggage needs FQTV No LEVEL Business

16 Additional services Advance Seat selection Excess Baggage Inflight entertainment Lounge Pass Meal Special Meals Diabetic Meal Lactose-free Meal Muslim Meal Kosher Meal These services can be always available or subject to conditions like routes, cabin, frequent flyer tier, seasonality. 16

17 Supported Airplane types Seat maps &

18 E95 Embraer 195 A C D F LEGEND Business Exit Wing

19 E90 Embraer 190 A C D F LEGEND Business Exit Wing 19

20 CRJ 900 Canadair Regional Jet 900 A C D F LEGEND Business Exit Wing

21 A F B E C D 321 Airbus A321 Business Exit Wing LEGEND 21

22 320 Airbus A320 LEGEND Business Exit Wing C B A D E F 22

23 32A Airbus A320 (sharklets) C B A D E F LEGEND Business Exit Wing 23

24 319 Airbus A319 LEGEND Business Exit Wing C B A D E F 24

25 733 Boeing (Passenger) C B A D E F LEGEND Business Exit Wing 25

26 735 Boeing (Passenger) LEGEND Business Exit Wing C B A D E F 26

27 Supported NDC messages (v16.2/17.2) functionalities &

28 Airshopping - OneWay, RoundTrip, Multiple Passenger Type, Cabin Type and Calendar Search FlightPrice [OfferPrice(17.2)] OneWay, RoundTrip SeatAvailability OrderCreate - OneWay, RoundTrip, Multiple Passenger Type, Cabin Type ServiceList ServicePrice OrderList OrderRetrieve OrderView ItineraryReshop [OrderReshop(17.2)] Add Passenger, Add Service OrderChange - Add Passenger, Add Service OrderCancel 28

29 AirShoppingRQ - One Way 1Adult 1Child Description The AirShopping transaction set supports both demanding and flexible shopping experiences for anonymous or personalized shopping. Thecombination of functionally - rich attribute and affinity shopping support date range or specific month (calendar) shopping as an example. The response returns offers which may include branded offers or itinerary-priced offers with or without ancillary services. AirShoppingRQ - Round Trip 2 Adults Description The AirShopping transaction set supports both demanding and flexible shopping experiences for anonymous or personalized shopping. Thecombination of functionally - rich attribute and affinity shopping support date range or specific month (calendar) shopping as an example. The response returns offers which may include branded offers or itinerary-priced offers with or without ancillary services. AirShoppingRQ - Round Trip 2 Adults Description The AirShopping transaction set supports both demanding and flexible shopping experiences for anonymous or personalized shopping. Thecombination of functionally - rich attribute and affinity shopping support date range or specific month (calendar) shopping as an example. The response returns offers which may include branded offers or itinerary-priced offers with or without ancillary services. AirShoppingRQ - Interline Description AirShoppingRQ has now suppor t for Interline s h o p p i n g i n c l u d i n g ancillaries. Interline use case is implemented between the two Airlines Kronos and Athena. 26

30 FlightPriceRQ [OfferPriceRQ(17.2)] - One Way 1 Adult 1 Child Description The FlightPrice transaction set may return two different sets of content. Based on request attributes, the response may initially provide additional à la carte ancillary services that are applicable and available for the selected offer. If no ancillary services are available, the message returns a final pricing. If ancillary services are available, the modified pricing request includes selected services and returns a final pricing that includes service(s) selection. FlightPriceRQ [OfferPriceRQ(17.2)] - Round Trip 2 Adults Description The FlightPrice transaction set may return two different sets of content. Based on request attributes, the response may initially provide additional à la carte ancillary services that are applicable and available for the selected offer. If no ancillary services are available, the message returns a final pricing. If ancillary services are available, the modified pricing request includes selected services and returns a final pricing that includes service(s) selection. OrderCreateRQ - One Way 1 Adult 1 Child Description Request specified inventory to be held (returns a reference to the held inventory) or request an order to be created (returns complete view of the Order) or request additions to order data elements (e.g. add frequent flyer data) OrderListRQ Description Retrieve a list of Orders by one or more search criteria. ServiceListRQ Description The ServiceList transaction set returns a list of all applicable ancillary services that meet request qualifiers and flights. The message supports shopping for additional a la carte services to complement any selected offer, as well as shopping for specialty service items not generally included in an initial offer but rather based on service search filters, e.g. sports equipment specialty baggage and unaccompanied minor fees. The message also returns multi-media content at both the message and individual service levels identified in the offer. 30

31 ItinReshopRQ [OrderReshopRQ(17.2)] - Add Passenger Description Used to pass new shopping requests to an airline to replace existing specified order items in an Order or for new shopping requests to add to an existing Order. Airline responds with product offers within the context of the existing Order. Here it is used for requesting offers for a new Passengers with the intention to add him in an existing Order. ItinReshopRQ [OrderReshopRQ(17.2)] - Update Segment Description Used to pass new shopping requests to an airline to replace existing specified order items in an Order or for new shopping requests to add to an existing Order. Airline responds with product offers within the context of the existing Order. Here is is used to replace an existing segment. OrderChangeRQ - Add segment Description Request modifications to an Order by specifying which order items to delete or change and what to change them to. The updated view of the Order is returned. New Segment is added to an existing order. OrderChangeRQ - Add Service Description Request modifications to an Order by specifying which order items to delete or change and what to change them to. The updated view of the Order is returned. New Service is added to an existing Order. OrderChangeRQ - Remove Segment Description Request modifications to an Order by specifying which order items to delete or change and what to change them to. The updated view of the Order is returned. Segment is removed from an existing Order. 31

32 OrderChangeRQ - Remove Service Description Request specified inventory to be held (returns a reference to the held inventory) or request an order to be created (returns complete view of the Order) or request additions to order data elements (e.g. add frequent flyer data). OrderCancelRQ Description Cancel specified order, returns confirmation of cancellation. SeatAvailabilityRQ Description The SeatAvailability transaction set returns data on all seats associated with a selected flight. It may indicate which seats are already selected, and which are still available. It also returns data on fees for seats. This data may be used to construct seat maps. 32

33 NDC Developer Portal Documentation &

34 Connect using Postman For a quick experimentation with the Kronos NDC gateway platform you may use the Postman RESTFull client or any other relevant tool to create and send HTTP POST requests to the API: Put as HTTP headers the content type of the message and your Authorization key required by the API along with your NDC RQ message, as follows: Ÿ Ÿ Ÿ An HTTP header with Content-Type: application/xml is required An HTTP header with a valid Authorization-Key: vsh6he647b35sxxxxxxxxxxxx. API key is provided on demand by JR Technologies including working samples and a postman collection A raw body including a valid NDC RQ (i.e. AirShoppingRQ). You may use any of the samples given in this brochure

35

36 F.A.Q. 1. What is the Kronos API? Kronos is a fictitious airline. The provided API is an implementation of an NDC gateway which is capable of supporting the exchange of NDC 16.2 messages. 2. What are the differences between Kronos and Athena APIs? Both APIs are identical and support the exchange of NDC 16.2 messages. The only difference relies on data (e.g. flight numbers, timetable). 3. Which connection method should I use? Depends on your needs and your application. For example, you may use Postman for a quick test of your RQ/RS messages, while you can use Netbeans when you start implementing your solution. 4. I don t have an API key. Should I pay for it? No, the API key is provided for free. Follow the instructions on register and request for an API key. 5. Are there any examples of the API use? IATA provides a detail guide on how to build your own applications consuming Kronos APIs. 6. Does the API have usage limits? Yes, there is a limit on API requests for each API key. The limit is the maximum number of 5000 request per day per API key and a limit of 3 requests per second. 7. How do I monitor my quota usage? IATA developers account provides a dashboard through which you can monitor the usage of your API key and the requests. 8. What happens if I exceed the usage limits? If you exceed the usage limits of a given API key, the API will return an error message. 9. Is there a frontend for the airline's NDC gateway? NDC defines an xml-schema that standardizes the communication. As such, the frontend does not need to be coupled with the backend and therefore any developer has the freedom to design and implement a UI to access the airline s gateway as long as it produces and consumes valid NDC messages. 10. I have a question/problem. Who should I contact? Contact IATA s support team on ndchackathon@iata.org 36

37

38 All the material contained in this Booklet is copyright of International Air Transport Association (IATA). Do not copy or reproduce it.