AirFrance KLM - FlightPrice This document describes the AirFrance KLM FlightPrice Service Document Version: 1.0 Document Status: Approved Date of last Update: 10/30/2017 Document Location: https://developer.airfranceklm.com/ Revision History Date Version Summary of Changes 27.10.2017 1.0 Document 1 st release Distribution Name Department Code Role Linked Documents Document Filename Version Location TABLE OF CONTENTS 1. Overview... 1 2. Invocation... 2 2.1. OrderCreateRQ... Error! Bookmark not defined. 2.2. OrderViewRS... Error! Bookmark not defined. 3. Process Steps... 5 4. Business Rules... 5 4.1. Parties... Error! Bookmark not defined. 4.1.1. Sender... Error! Bookmark not defined. 4.1.2. Participant... Error! Bookmark not defined. 4.1.3. Recipient... Error! Bookmark not defined. 4.2. Order Response... Error! Bookmark not defined. 4.2.1. Order definition... Error! Bookmark not defined. 4.2.2. Definition of AF or KL order... Error! Bookmark not defined. 4.2.3. Order item definition... Error! Bookmark not defined. 4.3. Payment Time Limit... Error! Bookmark not defined. 4.3.1. Definition... Error! Bookmark not defined. 4.3.2. Rule... Error! Bookmark not defined. 4.4. Cabins... 7 4.5. Credit Cards... Error! Bookmark not defined. Document : BSD SOA Business Service Description.doc Page: ii
4.6. Corporates... 7 4.6.1. Rules... 7 4.6.2. Corporate ID (OIN) verification... Error! Bookmark not defined. 4.6.3. Corporate Bookings... Error! Bookmark not defined. 4.7. Payment Options... Error! Bookmark not defined. 5. Business Exceptions... 7 5.1. Mandatory fields... 7 5.2. Travel agency information... 7 5.3. Offer time limit exceeded... Error! Bookmark not defined. 6. Policies... 8 Document : BSD SOA Business Service Description.doc Page: iii
1. Overview Goal: AFKL flight price message corresponds to the IATA NDC FlightPrice schema version 17.1. The Flight Price enables the agent to confirm an offer within the offer time limit. The agent selects one offer amongst the list of offers proving in the first shopping request. In response, he receives an offer confirmation, with all details: final price, tax breakdown, fare conditions. Result(s): When called the service returns a detailed and final offer. However, offer price is not guaranteed as credit card surcharges may be applied at order time. SCOPE IN Scope equals to global/shopping scope : One way, round trip, 1 to 9 passengers, ADT, CHD, INF, AF and KL marketing flights, Public and Corporate fares, only flights, no ancillaries. Request : Offer ID Results: One offer with : - Offer ID/Offer Items ID - Final price and tax breakdown - Flights Details - Fare conditions - Number of flying blue miles that could be earned with this offer SCOPE Coming Soon Ancillaries Seats and Bags. Youth/senior Abonnés (subscribers cards) SCOPE To be planned Private fares Rich Content Multi City (Open Jaw, Stop) HOP marketing flights UM Interaction Type: Request/Reply Pre-Condition(s): An offer has been selected by the seller from the shopping reply provided. Post-Condition(s): N/A Page: 1
Support Process 1. If any issues are encountered on the services, the third party support will do a 1 st analysis to exclude a problem on third party side 2. If the issue comes from AFKL, the third party support will raise an incident ticket to AFKL support. 3. AFKL wil analyse and resolve the issue and revert to the Third Party 2. Invocation This service is triggered by a request received from an external actor (travel agency, aggregator etc.). 2.1. FlightPriceRQ M = Mandatory; O = Optional; C = Conditional Business Information Description M/O Remark/Example Sender : travel agency Agency name Name of the travel agency M Example: Tour Travel Type Type of agency O Example: TA, OTA, TMC IATA number M Example: 67890890 Pseudo-city Pseudo city code of the travel agency M Example: PARMM11LL Agency ID ID of the travel agency M This field is mandatory in the NDC grammar, M but AFKL will not use it. Recommendation is to put the IATA number in this field. Agency contact information M N/A for OTA Contact details Email or phone contact of the agent M Example: Test@Test.nl Participants NDC Enabled System Participant is the party through who the message will pass O Name Name of the enabled system participant M Must be decided between the third party and AFKL System ID Unique external system ID M Must be decided between the third party and AFKL. Aggregator participant C Needed if aggregator in the transaction Name Name of the aggregator M Example: Travel Fusion Aggregator ID Unique external ID of the aggregator M Example: TF C Must be decided between the third party and AFKL. Must be decided between the third party and AFKL. Page: 2
Recipient Is the airline which receives the request M ORA Recipient Offer Responsible Airline who receives the request M AF or KL Name Name of the airline O Example: Air France or KLM Airline ID IATA code of the airline M Possible Values : AF or KL Query Offer ID Reference of the offer M Ex: Alphanumeric 36 characters: a9f2e740-94ca-46fe-b737-607f0fb69f24 2.2. FlightPriceRS M = Mandatory; O = Optional; C = Conditional Business Information Description M/O Remark/Example Warning Additional fees can apply for bookings paid credit card M Final price offer proposition can vary with cc surcharges. Offer ID Reference of the offer M Ex: Alphanumeric 36 characters: Validating carrier The offer has been validated by one specific carrier a9f2e740-94ca-46fe-b737-607f0fb69f24 M Possible Values : AF or KL Offer expiration time The offer is valid until a specific date and time M Ex: 2017-10-25 11:29:24 Offer item ID Reference of the offer item M Ex: ecbe6f27-942d-44a9 aac2-3f617bc9587c Total price Total price of the offer M Example : 100EUR Base amount Price without tax M Example: 90EUR Tax detail Tax total + tax breakdown M Example: 10EUR + 2, 8EUR Miles Miles to be earned with this offer M Example: 20326 MILES Fare Detail Fare Basis Code Code of the fare basis C Example: HFM0FR Corporate Fare If the offer is a corporate offer C Possible values: true or false Contract Corporate ID C Example: CHANEL C Origin & Destination City code or airport code of origin and M Page: 3
destination Total Journey Total journey duration between origin and destination M Example: P0Y0M0DT2H5M0.000S Segment information (list) Details of the segment referenced in the order item Same information is provided for each departure/arrival segment of inbound/outbound Airport Code Code of the airport M Example: CDG Date and time Date and time of the flight segment M Example: 2017-08-17-12:15 Change of day C If applicable at landing (+1) Terminal Airport Terminal O Example: 2F Cabin Mapping between AFKL and IATA code provided below M Example: C - BUSINESS Marketing flight Flight number and carrier code M Example: AF1264 Operating carrier Carrier operating M Example: DL Equipment Aircraft Code M Example: 318 Ticket Conditions Conditions associated to each segments M Same information Checked Baggage allowance Quantity of checked baggage allowed on this segment M is provided for each segment Example: 1 PC Advance purchase Condition of advance purchase C Example: P0Y2M0DT0H0M0.000S Advance stay Condition of minimum and maximum stay C Example: 6 months Cancellation/Change Condition of cancellation or change of the order C Application Allowed before or after departure C Possible values: PDE (prior to departure) or ADE (after departure) Penalties Penalties to pay if cancellation or change applied C Example: 150EUR No Show Possibility to board on another flight C Example: NOS Price Class M For each segment Fare Basis Code Coding reference of the fare basis M Example: YFFYUR Class of service Booking class and cabin information M Code Booking class M Example: Y Marketing Name Cabin code and marketing name of the cabin fare selected Passengers Type of passengers M M Example: M > ECONOMY FULL FLEX Mapping between IATA cabin code and AFKL cabin code is provided below Page: 4
Type Typology of the passenger M Ex: ADT 3. Process Steps The FlightPrice service can be used in the following sequence of services: - AirShoppingRQ/RS - FlightPriceRQ/RS - Optional - OrderCreateRQ/OrderViewRS - AirDocIssueRQ/OrderViewRS 4. Business Rules 4.1. Parties 4.1.1. Sender The Sender must be the travel agent requesting for the offer. 4.1.2. Participant The Participant is either the party through which the NDC message (aggregator or NDC enabled system) or the party on behalf which the request is done (a corporate). 4.1.3. Recipient The Recipient is the party receiving the NDC message. It is either Air France or KLM. 4.2. Sender authentication When a shopping request is received, NDC application has to authenticate the seller. The seller has to be referenced and allowed to use NDC application by AFKL. 4.3. Flight scope Only AF and KL marketed flights are priced. 4.4. Passengers scope 4.4.1. Number of passenger Our service only supports from 1 to 9 passengers. Groups are out of scope. 4.4.2. Typology of passenger Typology of passengers in scope are the following: Adults (ADT) Children (CHD) Infants (INF) Page: 5
4.5. Offer 4.5.1. Scope An offer is a requested flight journey and the passengers associated to this journey. No ancillaries are yet provided in an offer. 4.5.2. Rule An offer differs from another offer with its price or/and the combination of flights offered in the offer. 4.5.3. Example of an Offer 4.6. Offer item 4.6.1. Definition An offer item is included in an offer and each offer item is unique. An offer item is associated to one or multiple passengers consuming the exact same services at the same fare. 4.6.2. Example Offer / Offer item OFFER A - Offer item A1: 2 adults, CDG-JFK, 1250 - Offer item A2: 1 flying blue adult, CDG-JFK, 500 In the example provided, the difference is at the fare level. The passengers are sharing the same itinerary but not at the same price. Page: 6
4.7. Cabins Mapping between IATA and AFKL cabin codes. IATA code AIR FRANCE KLM AFKL code 1 First Business F/C 2 Business Business C 3 Economy Economy M 4 Premium Economy Economy W/M 5 Economy Economy M 6 Economy Economy M 7 All : not available All : not available N/A 4.8. Corporates 4.8.1. Rules For a client to benefit from its corporate negotiated fares, it needs to send its corporate ID (OIN) at shopping request. If this corporate ID is sent, the corporate fare selected is applied and displayed at offer confirmation. 4.9. Fare conditions Following fare conditions are provided at offer confirmation: - Checked baggage allowance in terms of number of pieces. - Advance purchase and stay conditions. Minimum and maximum stay conditions can be provided either in terms of duration or days of week included. - Cancellation and change conditions: if it allowed before or after departure and if penalties are applied. - Possibility to board or not on another flight. 5. Business Exceptions 5.1. Mandatory fields If one of the mandatory elements are not provided in the request, an error message should be sent to the consumer. 5.2. Travel agency information If IATA of the travel agency sender does not exist in our NDC agency database, an error message «Incorrect agency information» is sent. Also FlightPrice must be called by the same agency having called the AirShopping. 5.3. All error codes List of all the functional return codes returned by the Software Service: Page: 7
Code Error message (ShortText) Description 911 Internal error (unknown internal technical error) 293 ERROR_NOT_FOUND_IN_DATABASE 486 ERROR_CODE_UNKNOWNFLIGHT_CATALOGUE 911 ERROR_INCOHERENT_TAX_BREAKDOWN 6. Policies Business Criticality <Sensitive > Business Volume < xxx > Business Use <7/24> Information classification according AF/KL Security office Availability 3 Critical Downtime cannot exceed 4 hours (impact > 1M) 2 Sensitive / Significant Downtime may exceed 4 hours but is less than a maximum defined in the GOA General Operating Agreement or specified in chapter 6. 1 - Normal Best effort (impact < 10 K) Confidentiality Integrity Specification of additional availability requirements 3 Secret Information whose unauthorized disclosure (even within the organization) would cause serious damage to the interests of AFKL 2 Confidential Information whose unauthorized disclosure (even within the organization) would cause significant harm to the interests of AFKL) 1 Internal use only Information whose unauthorized disclosure, particularly outside of AFKL, would be inappropriate and inconvenient 0 Unrestricted Public domain information which requires no special protection measures As well as the above classifications it is possible to make use of the following qualifiers: Under Embargo The information is to be put and remain at a certain classification level until a predetermined date. At that time the embargo is lifted and the information will revert to a lower classification. Both classifications and the date of change should be indicated Personal The information is intended for an individual and may contain sensitive personal information and should therefore be treated as Addressee only. Access is limited therefore to the person for whom the information is intended. Specification of additional confidentiality requirements 3 high No loss of integrity is tolerated and corrective measures are in place to prevent any change to the original state of the information 2 medium Loss of integrity would significantly damage AFKL interests and corrective measures are in place to restore to the original state within a predetermined amount of time 1 low Loss of integrity should be logged Page: 8
Accountability Interface Variant Specification of additional integrity requirements 3 High Authentication and access to the information must be logged and preserved for a fixed period. Non-adherence of these constraints would cause serious harm to the interests of AFKL 2 medium Access to the information must be logged and preserved for a fixed period 1 low Access to the information need not be logged Specification of additional accountability requirements Specification of requirements for additional variation in interface Page: 9