Examples

Owned by Timothy Ling
Last updated: Mar 19, 2024 by Alvaro Chaparro
9 min read

 

 

 

In this page you will find full end-to-end flows of various user-case examples covering most, if not all, of the scenarios and functionalities offered through our NDC API.

Each version has a downloadable file containing a complete set of all the user cases.

In addition each individual user case can also be downloaded using the link in the column title (UC1, UC2, etc…)

17.2v2 - Branded Fares

The User Cases 2,3,4 & 5 will be available as soon as the functionality is developed in this version.

A complete set of all the available User Cases for 17.2v2 can be downloaded here.

 

NDC EXAMPLES


Use Cases and Specific Criteria

 

 

* = common to all messages

UC1 - Flow includes Ancillaries pre-sale and post-sale purchase, for Order paid with Cash, with Cheapest fare and Frequent Flyer passengers. Followed by cancellation/refund of unused segments.

UC2 - Flow includes voluntary flight change for all passengers and some flights, paid in Cash, for an unpaid Order with passengers with Special Needs. Followed by cancellation/void of all segments.

UC3 - Flow includes voluntary flight change for some passengers and all flights, paid in Cash, for an unpaid Order with Private Leisure fares and Resident & Large Family discount. Followed by OrderList service and cancellation/void of all segments.

UC4 - Flow includes voluntary flight change, paid in Cash, for all passengers and all flights, for an Order with Private Leisure fares and OnBusiness passengers, originally paid with credit card, using 3DS v1.

"UC5 - Flow includes voluntary flight change, paid with credit card, for some passengers and all flights, for Order paid with Voucher, with Cheapest fare in cabin and Resident & Large Family discount. Followed by cancellation/void of all segments for passenger not modified."

UC6 - Flow includes Ancillaries pre-sale, for Order paid with Credit card, with Resident discount and Service Fee. Followed by Ancillaries post-sale purchase, paid with Credit card using 3DS v2, voluntary changes for passenger contact information and cancellation/refund of all segments.

UC7 - Flow includes cancelling some passengers from an Order created with Cheapest fare and External Reference, paid with Cash & Voucher, and followed by a passenger name correction.

Order and Ancillaries paid with Cash.
Ancillaries Pre&Post Sale.
Corporate.
Round Trip.
3 ADT.
Cheapest fares.
Origin/Destination Keys.
Other PassengerIDs.
Frequent Flyer IB & OAL.
Add another Frequent Flyer.
Cancellation of unused with refund.

Order on hold.
Seller IATA.
Multicity.
2 ADT 1 INF.
PE Market & Fiscal ID (RUC).
Special Needs.
Voluntary flight change all passengers some flights.
Order paid in Cash.
Cancellation of all with void.

Order on hold.
Seller IATA & 2 Aggregators.
Round Trip.
2 ADT 1 CHD 1 INF.
Resident & Large Family discount.
Private Leisure Fares.
Special Needs.
Voluntary flight change some passengers all flights.
Order paid in Cash.
Cancellation of all with void.
OrderList.

Order paid with Credit card 3DS v1.
Seller IATA.
Round Trip with indirect flights.
2 ADT 1 INF.
Private Leisure Fares.
OnBusiness
Voluntary flight changes all passengers all flights, paid in Cash.

Order paid with Voucher.
Seller IATA.
Round Trip.
2 ADT 1 CHD 1 INF.
Cheapest fare by Cabin type.
Resident & Large Family discount.
Voluntary flight changes some passengers all flights, paid with Credit Card.
Cancellation of all with void for passenger not modified.

Order and Ancillaries Pre Sale paid with Credit Card.
Pseudo IATA & Aggregator.
Round Trip.
2 ADT 2 CHD 1 INF.
Resident discount.
Service Fee.
Ancillaries Post Sale paid with Credit Card 3DS v2.
Update Passenger Contact Information.
Cancellation of all with refund.

Order paid with Cash & Voucher.
Corporate & Aggregator.
Round Trip with indirect flights.
2 ADT 2 CHD.
US Market.
Cheapest fares.
External Reference Remark.
Cancel some passengers.
Passenger Name Correction.

AirShopping

Sender Corporate .*
Market ES .*
2 ADT .*
Round Trip.
Cheapest.
Other Origin/Destination Keys.
Different PassengerIDs.

Sender Real IATA. *
Market PE. *
2 ADT 1 INF. *
Multicity.

-

Sender Real IATA. *
Market ES .*
2 ADT 1 INF. *
Round Trip (Indirect Flight).
Private Fare.

Sender Real IATA. *
Market ES. *
2 ADT 1 CHD 1 INF .*
Round Trip.
Cheapest by Cabin Type.
Resident & Large Family Discounts.

-

-

OfferPrice

Direct Fare

-

-

Sender Real  IATA & 2 Aggregators. *
Market ES. *
2 ADT 1 CHD 1 INF. *
Round Trip.
Private Fare.
Resident & Large Family Discount.
All Special Needs.

-

-

Sender Pseudo IATA & Aggregator .*
Market ES. *
2 ADT 2 CHD 1 INF. *
Round Trip.
Resident Discount.

Sender Corporate & Aggregator. *
Market US. *
2 ADT 2 CHD .*
Round Trip (Indirect Flight).

Get Fare

Select Offer from AirShoppingRS.

Frequent Flyer IB & OAL.

Select Offer from AirShoppingRS.

Special Need BLND.

-

Select Offer from AirShoppingRS.

Select Offer from AirShoppingRS.

-

-

SeatAvailability

Pre-Sale

Select Offer from OfferPriceRS.

-

-

-

-

Select Offer from OfferPriceRS.

-

Post-Sale

Select Order from OrderViewRS.

-

-

-

-

Select Order from OrderViewRS.

-

ServiceList

Pre-Sale

Select Offer from OfferPriceRS.

-

-

-

-

Select Offer from OfferPriceRS.

-

Post-Sale

Select Order from OrderViewRS.

-

-

-

-

Select Order from OrderViewRS.

-

OrderCreate

Select Offer from OfferPriceRS and Ancillaries from SeatAvailabilityRS/ServiceListRS.

Payment Cash.
Frequent Flyer IB & OAL.
Ancillaries.

Select Offer from OfferPriceRS.

No Payment.
Special Needs.
Fiscal ID.

Select Offer from OfferPriceRS.

No Payment.
Resident & Large Family Discounts.
Special Needs.

Select Offer from OfferPriceRS.

Payment CC 3DS v1.
OnBusiness

Select Offer from OfferPriceRS.

Payment Voucher.
Resident & Large Family Discounts.

Select Offer from OfferPriceRS.

Payment CC.
Service Fee.
Resident Discount.

Select Offer from OfferPriceRS.

Payment Cash & Voucher.
External Reference Remark.

OrderRetrieve

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS of OrderCreate/OrderChange.

Search by PNR & Surname.
Search by OrderID.

Select Order from OrderViewRS.

Search by PNR.
Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

OrderReshop

New Flight Availability

-

Select Order & OrderItems from OrderViewRS.

Availability for First Flight.
Change for All Passengers.

Select Order & OrderItems from OrderViewRS.

Availability for All Flights.
Change for 1ADT & 1CHD
Cheapest.

Select Order & OrderItems from OrderViewRS.

Availability for All Flights.
Change for All Passengers.
Private Fare.

Select Order & OrderItems from OrderViewRS.

Availability for All Flights.
Change for 1ADT & 1CHD.
Specific Cabin Type.

-

-

Fare Reprice

-

Select Offer from OrderReshopRS.

Change for All Passengers.

Select Offer from OrderReshopRS.

Change for 1ADT & 1CHD.

Select Offer from OrderReshopRS.

Change for All Passengers.

Select Offer from OrderReshopRS.

Change for 1ADT & 1CHD.

-

-

Retarify

-

-

Select Order from OrderViewRS.

Retarify  for 1ADT & 1INF.

-

-

-

-

Delete Passenger

-

-

-

-

-

-

Select Order & OrderItems from OrderViewRS.

Delete Some Passengers.

Cancel Order

Select Order & OrderItems from OrderViewRS.

Refund for All Passengers.

Select Order & OrderItems from OrderViewRS.

Refund for All Passengers.

Select Order & OrderItems from OrderViewRS.

Refund for Some Passengers.

-

-

Select Order & OrderItems from OrderViewRS.

Refund for All Passengers.

-

OrderChange

Payment

-

Select Order from OrderViewRS.

Payment Cash.
Fiscal ID.

Select Order from OrderViewRS.

Change for 1ADT & 1CHD.
Change for 1ADT & 1INF.
Payment Cash.

-

-

-

-

Add Ancillaries

Select Order from OrderViewRS and Ancillaries from SeatAvailabilityRS/ServiceListRS.

Payment Cash.
Ancillaries.

-

-

-

-

Select Order from OrderViewRS and Ancillaries from SeatAvailabilityRS/ServiceListRS.

Payment CC 3DS v2.
Ancillaries.

-

Update Passenger Info

Select Order from OrderViewRS.

Add Frequent Flyer IB.

-

-

-

-

Select Order from OrderViewRS.

Add Mail & Phone.
Update Phone.
Delete Phone.

Select Order from OrderViewRS.

Name Correction.

Voluntary Changes

-

Select Offer  from OrderReshopRS.

Change for All Passengers.
No Payment.

Select Offer from OrderReshopRS.

Change for 1ADT & 1CHD.
No Payment.

Select Offer  from OrderReshopRS.

Change for All Passengers.
Payment Cash.

Select Offer  from OrderReshopRS.

Change for 1ADT & 1CHD.
Payment CC.
Resident & Large Family Discounts.

-

-

Delete Passengers

-

-

-

-

-

-

Select Offer  from OrderReshopRS.

Delete Some Passengers.

Partially Used Refund

Select refund Offer from OrderReshopRS.

Refund unused for All Passengers.

-

-

-

-

-

-

OrderCancel

-

Select Order from OrderViewRS.

Query by OrderID.
Cancel all on same day.

Select Order from OrderViewRS.

Query by PNR.
Cancel all on same day.

-

Select Order from OrderViewRS.

Query by OrderID.
Cancel all for passenger not modified, on same day.

Select Order from OrderViewRS.

Query by OrderID.
Cancel all on next day.

-

OrderList

-

-

-

-

-

-

-

17.2v1 - Non Branded Fares

A complete set of all the available User Cases for 17.2v1 can be downloaded here.

 

NDC EXAMPLES


Use Cases and Specific Criteria

 

 

* = common to all messages

UC1 - Flow includes Ancillaries pre-sale and post-sale purchase, for Order paid with Cash, with Cheapest fare and Frequent Flyer passengers. Followed by cancellation/refund of unused segments.

UC2 - Flow includes voluntary flight change for all passengers and some flights, paid in Cash, for an unpaid Order with passengers with Special Needs. Followed by cancellation/void of all segments.

UC3 - Flow includes voluntary flight change for some passengers and all flights, paid in Cash, for an unpaid Order with Private Leisure fares and Resident & Large Family discount. Followed by OrderList service and cancellation/void of all segments.

UC4 - Flow includes voluntary flight change, paid in Cash, for all passengers and all flights, for an Order with Private Leisure fares and OnBusiness passengers, originally paid with credit card, using 3DS v1.

UC5 - Flow includes voluntary flight change, paid with credit card, for some passengers and all flights, for Order paid with Voucher, with Cheapest fare in cabin and Resident & Large Family discount. Followed by cancellation/void of all segments for passenger not modified.

UC6 - Flow includes Ancillaries pre-sale, for Order paid with Credit card, with Resident discount and Service Fee. Followed by Ancillaries post-sale purchase, paid with Credit card using 3DS v2, voluntary changes for passenger contact information and cancellation/refund of all segments.

UC7 - Flow includes cancelling some passengers from an Order created with Cheapest fare and External Reference, paid with Cash & Voucher, and followed by a passenger name correction.

Order and Ancillaries paid with Cash.
Ancillaries Pre&Post Sale.
Corporate.
Round Trip.
3 ADT.
Cheapest fares.
Origin/Destination Keys.
Other PassengerIDs.
Frequent Flyer IB & OAL.
Add another Frequent Flyer.
Cancellation of unused with refund.

Order on hold.
Seller IATA.
Multicity.
2 ADT 1 INF.
PE Market & Fiscal ID (RUC).
Special Needs.
Voluntary flight change all passengers some flights.
Order paid in Cash.
Cancellation of all with void.

Order on hold.
Seller IATA & 2 Aggregators.
Round Trip.
2 ADT 1 CHD 1 INF.
Resident & Large Family discount.
Private Leisure Fares.
Special Needs.
Voluntary flight change some passengers all flights.
Order paid in Cash.
Cancellation of all with void.
OrderList.

Order paid with Credit card 3DS v1.
Seller IATA.
Round Trip with indirect flights.
2 ADT 1 INF.
Private Leisure Fares.
OnBusiness
Voluntary flight changes all passengers all flights, paid in Cash.

Order paid with Voucher.
Seller IATA.
Round Trip.
2 ADT 1 CHD 1 INF.
Cheapest fare by Cabin type.
Resident & Large Family discount.
Voluntary flight changes some passengers all flights, paid with Credit Card.
Cancellation of all with void for passenger not modified.

Order and Ancillaries Pre Sale paid with Credit Card.
Pseudo IATA & Aggregator.
Round Trip.
2 ADT 2 CHD 1 INF.
Resident discount.
Service Fee.
Ancillaries Post Sale paid with Credit Card 3DS v2.
Update Passenger Contact Information.
Cancellation of all with refund.

Order paid with Cash & Voucher.
Corporate & Aggregator.
Round Trip with indirect flights.
2 ADT 2 CHD.
US Market.
Cheapest fares.
External Reference Remark.
Cancel some passengers.
Passenger Name Correction.

AirShopping

Sender Corporate .*
Market ES .*
2 ADT .*
Round Trip.
Cheapest.
Other Origin/Destination Keys.
Different PassengerIDs.

Sender Real IATA. *
Market PE. *
2 ADT 1 INF. *
Multicity.

-

Sender Real IATA. *
Market ES .*
2 ADT 1 INF. *
Round Trip (Indirect Flight).
Private Fare.

Sender Real IATA. *
Market ES. *
2 ADT 1 CHD 1 INF .*
Round Trip.
Cheapest by Cabin Type.
Resident & Large Family Discounts.

-

-

OfferPrice

Direct Fare

-

-

Sender Real  IATA & 2 Aggregators. *
Market ES. *
2 ADT 1 CHD 1 INF. *
Round Trip.
Private Fare.
Resident & Large Family Discount.
All Special Needs.

-

-

Sender Pseudo IATA & Aggregator .*
Market ES. *
2 ADT 2 CHD 1 INF. *
Round Trip.
Resident Discount.

Sender Corporate & Aggregator. *
Market US. *
2 ADT 2 CHD .*
Round Trip (Indirect Flight).

Get Fare

Select Offer from AirShoppingRS.

Frequent Flyer IB & OAL.

Select Offer from AirShoppingRS.

Special Need BLND.

-

Select Offer from AirShoppingRS.

Select Offer from AirShoppingRS.

-

-

SeatAvailability

Pre-Sale

Select Offer from OfferPriceRS.

-

-

-

-

Select Offer from OfferPriceRS.

-

Post-Sale

Select Order from OrderViewRS.

-

-

-

-

Select Order from OrderViewRS.

-

ServiceList

Pre-Sale

Select Offer from OfferPriceRS.

-

-

-

-

Select Offer from OfferPriceRS.

-

Post-Sale

Select Order from OrderViewRS.

-

-

-

-

Select Order from OrderViewRS.

-

OrderCreate

Select Offer from OfferPriceRS and Ancillaries from SeatAvailabilityRS/ServiceListRS.

Payment Cash.
Frequent Flyer IB & OAL.
Ancillaries.

Select Offer from OfferPriceRS.

No Payment.
Special Needs.
Fiscal ID.

Select Offer from OfferPriceRS.

No Payment.
Resident & Large Family Discounts.
Special Needs.

Select Offer from OfferPriceRS.

Payment CC 3DS v1.
OnBusiness

Select Offer from OfferPriceRS.

Payment Voucher.
Resident & Large Family Discounts.

Select Offer from OfferPriceRS.

Payment CC.
Service Fee.
Resident Discount.

Select Offer from OfferPriceRS.

Payment Cash & Voucher.
External Reference Remark.

OrderRetrieve

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS of OrderCreate/OrderChange.

Search by PNR & Surname.
Search by OrderID.

Select Order from OrderViewRS.

Search by PNR.
Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

Select Order from OrderViewRS.

Search by OrderID.

OrderReshop

New Flight Availability

-

Select Order & OrderItems from OrderViewRS.

Availability for First Flight.
Change for All Passengers.

Select Order & OrderItems from OrderViewRS.

Availability for All Flights.
Change for 1ADT & 1CHD
Cheapest.

Select Order & OrderItems from OrderViewRS.

Availability for All Flights.
Change for All Passengers.
Private Fare.

Select Order & OrderItems from OrderViewRS.

Availability for All Flights.
Change for 1ADT & 1CHD.
Specific Cabin Type.

-

-

Fare Reprice

-

Select Offer from OrderReshopRS.

Change for All Passengers.

Select Offer from OrderReshopRS.

Change for 1ADT & 1CHD.

Select Offer from OrderReshopRS.

Change for All Passengers.

Select Offer from OrderReshopRS.

Change for 1ADT & 1CHD.

-

-

Retarify

-

-

Select Order from OrderViewRS.

Retarify  for 1ADT & 1INF.

-

-

-

-

Delete Passenger

-

-

-

-

-

-

Select Order & OrderItems from OrderViewRS.

Delete Some Passengers.

Cancel Order

Select Order & OrderItems from OrderViewRS.

Refund for All Passengers.

Select Order & OrderItems from OrderViewRS.

Refund for All Passengers.

Select Order & OrderItems from OrderViewRS.

Refund for Some Passengers.

-

-

Select Order & OrderItems from OrderViewRS.

Refund for All Passengers.

-

OrderChange

Payment

-

Select Order from OrderViewRS.

Payment Cash.
Fiscal ID.

Select Order from OrderViewRS.

Change for 1ADT & 1CHD.
Change for 1ADT & 1INF.
Payment Cash.

-

-

-

-

Add Ancillaries

Select Order from OrderViewRS and Ancillaries from SeatAvailabilityRS/ServiceListRS.

Payment Cash.
Ancillaries.

-

-

-

-

Select Order from OrderViewRS and Ancillaries from SeatAvailabilityRS/ServiceListRS.

Payment CC 3DS v2.
Ancillaries.

-

Update Passenger Info

Select Order from OrderViewRS.

Add Frequent Flyer IB.

-

-

-

-

Select Order from OrderViewRS.

Add Mail & Phone.
Update Phone.
Delete Phone.

Select Order from OrderViewRS.

Name Correction.

Voluntary Changes

-

Select Offer  from OrderReshopRS.

Change for All Passengers.
No Payment.

Select Offer from OrderReshopRS.

Change for 1ADT & 1CHD.
No Payment.

Select Offer  from OrderReshopRS.

Change for All Passengers.
Payment Cash.

Select Offer  from OrderReshopRS.

Change for 1ADT & 1CHD.
Payment CC.
Resident & Large Family Discounts.

-

-

Delete Passengers

-

-

-

-

-

-

Select Offer  from OrderReshopRS.

Delete Some Passengers.

Partially Used Refund

Select refund Offer from OrderReshopRS.

Refund unused for All Passengers.

-

-

-

-

-

-

OrderCancel

-

Select Order from OrderViewRS.

Query by OrderID.
Cancel all on same day.

Select Order from OrderViewRS.

Query by PNR.
Cancel all on same day.

-

Select Order from OrderViewRS.

Query by OrderID.
Cancel all for passenger not modified, on same day.

Select Order from OrderViewRS.

Query by OrderID.
Cancel all on next day.

-

OrderList

-

-

Sender Real  IATA & 2 Aggregators.
Market ES.
Query by Created Date.

-

-

-

-

 

Â