NDC API capabilities
Capabilities currently supported by our NDC API
Finnair NDC API is based on IATA schema version 18.1 and 21.3.
Features in italic following an asterisk (*) are currently not supported by Finnair NDC API.
Features in bold are currently only supported in NDC API version 21.3.
Offer | |
---|---|
Flights | Send AirlineProfileRQ, receive AirlineProfileRS |
Send AirShoppingRQ, receive AirShoppingRQ | |
Ancillaries | Send ServiceListRQ, receive ServiceListRS |
Send SeatAvailabilityRQ, receive SeatAvailabilityRS | |
Pricing | Send OfferPriceRQ, receive OfferPriceRS |
Order | |
---|---|
Creation | Send OrderCreateRQ, receive OrderViewRS |
Update | Send OrderChangeRQ, receive OrderViewRS |
Display | Send OrderRetrieveRQ, receive OrderViewRS |
Send OrderListRQ, receive OrderListRS | |
* Send OrderHistoryRQ, receive OrderHistoryRS | |
Servicing | Send OrderReshopRQ, receive OrderReshopRS |
Send OrderQuoteRQ, receive OrderQuoteRS | |
Send OrderCancelRQ, receive OrderCancelRS (18.1 only) | |
Send OrderChangeNotifRQ, receive AcknowledgementRS |
Authentication | |
---|---|
Seller recognition | Define market (POS) with Country Code |
Identify aggregator with Aggregator ID | |
Identify direct connect with System ID | |
Identify non-IATA travel agent with TIDS | |
Identify IATA travel agent with IATA Number | |
Delegation flow |
(*) Feature currently not supported by Finnair NDC API.
21.3 specific features marked in bold.
Passengers | |
Passenger types | Create passenger from PTC: ADT, CHD, CNN, INF, YTH, STU, SEA |
Create adult passenger by default | |
Automatically associate infant with adult | |
Manually associate infant with adult | |
Create up to 9 passengers plus 9 infants | |
* Manually re-associate infant to another adult | |
* Create passenger with several PTC | |
* Create group booking | |
* Identify unaccompanied minors | |
Loyalty recognition | Use Frequent Flyer card from Finnair Plus or One World |
Use Frequent Flyer card for mileage accrual | |
Use Frequent Flyer card for price discount | |
Use several Frequent Flyer cards at once | |
Use Corporate ID (Client code) for reporting and for price discount (SSR element) | |
Name elements | Add passenger's title, firstname, lastname |
Add passenger's date of birth | |
Add passenger's gender | |
Truncate name if too long | |
* Add passenger's middle name | |
Contact details (APIs) | Create AP elements from e-mail and phone numbers |
Create APN, CTCE, CTCM elements for notifications | |
Create AB elements for billing | |
Create SSR DOCS containing Passport information | |
Create default SSR DOCS from the DOB only (for secured flights) |
Flights | |
Itinerary types | Shop One Way itinerary |
Shop Round Trip itinerary | |
Shop Open Jaw itinerary | |
Shop Complex itinerary (3-4 bounds) | |
* Shop Open segment | |
Flight types | Search for direct and non-stop flights only |
Propose AY operated flight | |
Propose Codeshare flight | |
Propose direct flight | |
Propose Multi-leg flight | |
Propose Secure flight | |
Identify flights too close to departure time | |
Propose interline itineraries | |
Options | Select one or multiple cabins |
Select different cabins at bound level | |
Select preferred departure time | |
Shop on an up-to 7 days time range (calendar search) | |
Shop directly from flight details | |
Use One Way display (in Shopping and Reshopping) | |
Use Itinerary mode (in Shopping and Reshopping) | |
* Use One Way Combinable mode | |
* Use Dual flow (calendar with upsell) | |
* Select preferred arrival time |
Ancillaries | |
Flows | Shop ancillary in prime booking |
Shop ancillary in post sale | |
Shop ancillary for unticketed order | |
Select one or several ancillaries at once | |
Select one ancillarie several times | |
* Shop ancillary for non-AY operated flight | |
Chargeable services | Select chargeable Seat |
Select exempted Seat (based on fare family or loyalty) | |
Select baggage (prepaid, carry-on, special etc) | |
Select Meal | |
Select Wifi onboard | |
Select Lounge access | |
* Select pack of services | |
Free services | Select free Meal |
Display free baggage allowance (number of piece) | |
Display free baggage allowance (weight) | |
Display free carry-on baggage allowance | |
Catalogue construction | Use Service filing |
Shop for specific segment | |
Shop for specific passenger | |
Highlight service | |
Filter service | |
Order services | |
Display Rich content (images) | |
Display Disclaimers | |
* Shop for specific service type | |
* Display Quota information |
Pricing | |
Pricing | Target specific fares with a Corporate code |
Discount price with Promotion code | |
Automatically select currency based on the market | |
Manually select currency | |
Modify price dynamically (continuous pricing) | |
* Price in loyalty points/ miles | |
Fare types | Return Public fares |
Return Negotiated fares | |
Return Corporate fares | |
Return IT/BT fares | |
Return Campaign fares | |
Return Student fares | |
Return Seat Only fares | |
Return TMC fares | |
Return Visit Home fares | |
Return Marine fares | |
Return Tour Operator fares | |
Return Joing Business fares | |
Upsell offers | Propose best pricing offers |
Propose offers in higher booking class |
Offer content | |
Flight data | Display Secure Flight indicator |
Display flight legs information | |
Display departure and arrival terminal | |
Display bound and flight duration | |
Fare details | Display fare type: public, private, negotiated, corporate |
Display Fare Family branding (fare rules & benefits) | |
Display fare benefits based on requested language | |
Time Limits | Calculate Payment Time Limit (TTL) |
Calculate Offer Validity Time Limit | |
Calculate Price Guarantee Time Limit (TST validity) |
(*) Feature currently not supported by Finnair NDC API.
21.3 specific features marked in bold.
Payment flow | |
---|---|
Form of payment | Pay with BSP Cash (IATA BSP-agents) |
Pay with non-enrolled Credit card | |
Pay with 3DSv2 Credit card | |
Pay with IATA EasyPay (IATA BSP-agents) | |
* Pay with BOP (on CN market) | |
* Pay with several FoP | |
* Pay with Loyalty points/ miles | |
* Pay with ARC Cash | |
Deferred payment | Use deferred payment whatever the FoP |
Calculate Payment Time Limit (TTL) | |
Reprice order (fare and taxes) if TST has expired | |
Reprice taxes (for TO fares only) if TST has expired | |
Reprice order if TST does not match the order | |
Reprice order (OB Fees) if FoP changed | |
Book ancillary on unticketed order | |
* Pay for a part of the order only | |
* Use deferred payment in Servicing flow | |
Reporting/Settlement | Report with 1A-RET to BSP for IATA seller |
Report with 1A -HOT-file to AY for non-IATA seller | |
Report with 1A-SPRF to ARC for US ARC seller | |
Risk Management APIs | Validate agency status with BSP Risk API |
* Validate agency status with ARC Risk API | |
Ticketing failure | Rollback the booking creation (no more inventory held) |
Order content | |
PNR data | Display 1A RecLoc and OrderID |
Display passenger details: names, contacts, loyalty data | |
Display payment information: FoP and associated paid amounts | |
Display active segment | |
Display ancillary (chargeable or free) | |
Display remark | |
Create remarks automatically | |
Display RecLoc for associated order after Split | |
* Display RecLoc for Operating PNR | |
* Display DID, IID, UCI, CPR reference | |
* Display PNR history | |
Ticketing data | Display TTL for un-ticketed order |
Display Tickets number and associated coupons numbers | |
Display EMD number and associated coupons numbers | |
Display price details: base fare, tax total, OB fee | |
Display tax breakdown for flight: amount, country, tax code | |
Display Fare basis code | |
Display Fare endorsement | |
Display Fare calculation | |
Display Void eligibility | |
Display Refund eligibility | |
Display Exchange eligibility | |
Display refund amount | |
Display reporting type indicator: Airline, BSP, ARC | |
Display fare rules | |
Display Fare Family branding (fare rules & benefits) | |
* Display Ticket/EMD history | |
Not returned data | * Display Order conditions |
* Display Order history | |
* Display passenger gender | |
* Display SK elements |
Servicing | |
Search | Search active orders with OrderID |
Search active orders based on 1A PNR RecLoc | |
Search active orders with passenger name | |
Search active orders based on creation office | |
* Search for inactive orders | |
* Search for orders based on flight data | |
Cancel | Cancel un-ticketed order |
Delete itinerary & ancillaries | |
Void | Void ticketed order on the same day before 22:45 GMT time for BSP |
Update Tickets & EMD coupon status to "Voided" & cancel PNR | |
Void order with disrupted flight | |
Limit Void request to order creator (same IATA number & POS) | |
Void split PNR | |
Void orders with ancillaries | |
* Void EMD only | |
Refund | Calculate refund amount, including penalty |
Refund whatever the fare type | |
Fully refund order | |
Partially refund order (some bounds only) | |
Refund partially flown order | |
Refund during void window | |
Refund taxes on an un-refundable ticket | |
Refund order paid with several different FoP | |
* Refund order paid with several currencies | |
* Refund tickets with pax travelling with infant | |
* Refund during void window | |
* Refund order for some passengers only | |
* Refund ticket after check-in | |
* Refund inactive PNR | |
* Refund ancillary | |
Exchange | Add bound |
Remove bound | |
Add ancillaries | |
Change flight date | |
Change routing | |
Change cabin | |
Change both bounds together | |
Change each bound separately | |
Change inbound only when outbound flown | |
Modify order multiple times if journey not started | |
Modify order without issuing a new ticket (revalidation) | |
Reissue whatever the fare type | |
Reissue with different FoP than first issuance | |
Reissue in case of residual value (netting may apply) | |
Diplay Fare Benefits when reshopping | |
Rebook unticketed order | |
* Change fare family | |
* Change bound partially (modify or delete some flights only) | |
* Reshop Secure flight if no SSR DOCS in PNR | |
* Modify inactive PNR | |
* Upgrade with loyalty points/ miles | |
* Exchange ancillary | |
* Full itinerary exchange (O&D) change | |
* Multiple reissue for inbound if outbound is flown | |
PNR update | Add Frequent flyer number |
Update APIS (add/delete) | |
Update contact element (add/delete) | |
* Delete Frequent flyer number | |
* Update passenger (add/delete) | |
* Update name (add/delete) | |
* Update remark (add/delete) | |
* Update ancillary (delete/modify) | |
Split | Create second order with part of the passengers |
Split unticketed order | |
Split order multiple times | |
Automatically reassociate infant to linked adult (no manual choice possible) | |
Automatically reassociate segments, services and tickets/EMD | |
Apply any servicing process after split | |
Keep TTL unchanged for un-ticketed order | |
Involuntary change | Automatically reissue tickets |
Automatically refund tickets | |
Acknowledge new itinerary on order with disrupted flight | |
Exchange order with disrupted flight | |
Notifications (OCN) | Notify after flight number change - code 1 |
Notify after flight retimed - code 2 | |
Notify after flight cancelled - code 3 | |
Notify after ancillary status changed - code 6 | |
Notify after passenger name modified - code 9 | |
Notify after passenger contact details updated - code 11 | |
Notify after OrderItem cancelled - code 13 | |
Notify after flight cancelled by the airline outside of a schedule change situation - code 15 | |
Notify after OrderItem added - code 18 | |
Notify after Frequent flyer information updated - code 19 | |
Notify after Identity document details updated - code 20 | |
Notify after order cancelled due to TTL expiry - code 104 | |
Notify after change requested by passenger - code 112 | |
Notify after passenger no-show at gate - code 113 |
(*) Feature currently not supported by Finnair NDC API.
21.3 specific features marked in bold.