Saved Successfully.
On this page
 

Overview

The AirShopping service returns a list of priced availability offers (combination of available flights and fares) for the requested Origin and Destination, Date and Cabin/Branded code.


NDC Schema: IATA AirShoppingRQ/RS v21.3.

 

In Scope

Request
  • One Way, Return, Multi-city/Open-Jaw Trip Search
  • City and Airport code
  • Specific date (not a range)
  • Cabin/ Brand for the Itinerary
  • Pax Type - Adult (ADT), Child (CHD), Infant (INF), Young Adult (GBE)
  • Multiple Passengers (Min 1 ADT, Max 9)
  • Calendar Search
  • Departure Time
  • Direct Flight

Response
  • VS Operated and Marketing flights (Code Share Partners)
  • Only Flight Offers - without ancillaries/Alacarte offers
  • Published Branded Fares + Private/Discounted Fares
  • Baggage Allowance
  • Change and Cancel Fare Rules
  • Calendar Offers
   

Endpoints

Sandbox Environment

This is a complete replica of production and a test environment where developers can build against our NDC APIs and validate their code for build of new features, ahead of certification and go-live. This environment should also be used for debugging

Preview Environment

This environment will have the same capability features as Sandbox but in addition we may deploy breaking changes or new features in advance of release to Sandbox and Production in order to give developers early visibility.

Sandbox Environment URL
https://ndcdeveloper.virginatlantic.com/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/AirShopping
Preview Environment URL
https://ndcdeveloper.virginatlantic.com/preview/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/AirShopping

 

Business Rules

 
Number of Pax

Supports only from 1 to 9 passengers. Request needs at least 1 x ADT Pax. Number of Infants cannot be greater than Adult passengers. Groups are out of scope.

 
Passenger Type

Supported Passenger Type Codes (PTC) are following:

PTC Code [ENUM] Name Age PaxID
ADT Adult 16 years or over ADULT_1
CHD Child 2 to 12 years CHILD_1
GBE Young Adult 12 to 16 years YOUNG_1
INF Infant Less than 2 years INFANT_1

Uniquely request PaxID based on PTC (refer PaxID column).
Service cannot be called for Unaccompanied Minor [PTC: CHD, GBE] for travelling alone
 
Cabin Code

Multiple Cabin codes can be requested (warning[s] returned for unknown codes) In the response Brand names will be returned for the Itinerary

Cabin Code [ENUM] Supported? VS Brand Name
1 NO Not Applicable - Will return error
2 YES Upper Class (Business)
3 NO Not Applicable - Will return error
4 YES Premium Economy (Comfort Plus)
5 YES Economy
6 NO Not Applicable - Will return error
7 NO Not Applicable - Will return error
 
Service Taxonomy Code

Service Taxonomy Code designate the Specification associated with a Fare Product

Specification Service Taxonomy Code
Checked Baggage 13EC
IncludeInd=TRUE
Preferred Seat 189C
IncludeInd=TRUE
 
Fare Criteria
Fare Type Code Fare Rules
730 Fares with no penalties
731 Fares with penalties
 
ID <-> RefID Syntax/Format

ID <-> RefID attribute request/response formats are shown as follows:

ID RefID Syntax Example
PaxJourneyID PaxJourneyRefID "JOUR"+<number counter> JOUR1
PaxSegmentID PaxSegmentRefID "SEG"+<number counter> SEG1
PaxID PaxRefID Refer PaxID based on PTC ADULT_1
PriceClassID PriceClassRefID "PC"+<number counter> PC1
ServiceID ServiceRefID "SV"+<number counter> SV1
BaggageAllowanceID BaggageAllowanceRefID "BAGA"+<number counter> BAGA1
 
Currency (PoC)

Currency is returned based on Point of Sale (Agent location). For IATA agents currency will be as per BSP.

 
Offer

An Offer differs from another Offer(s) with its price or/ and combinations of flights Unique generated OfferID is returned, with a validity of 20 minutes.

 
OfferItem

One or more OfferItem(s) are included in an Offer and each OfferItem is unique. OfferItem is per PTC (with Variation of Price, taxes)

 
Return/ Multi City (Open-Jaw)

Service for both/all bounds will return with the same Brand/Fare Family. For example: OutBound: Economy Light, expect InBound also to be Economy Light. The service rejects request and returns error. The service for certain requested Origin & Destination(s) might only return Direct/Non-Stop or limited Branded fares - Flight Offer(s) for the Itinerary. Maximum 6 Origin and Destination can be requested

 
Party Authentication

The service checks if the agent calling the service has the rights. If the agent does not have such authority, then the service will not process and will return an error.

 
Calendar Search

  • 1. Calendar search is not supported for multi city shopping requests (i.e requests containing more than 2 O&Ds). A warning message is returned in AirShoppingRS without PriceCalendar offers if calendar search was requested for multi city itineraries
  • 2. Calendar search cannot be combined with departure time and direct flight search requests
  • 3. Calendar offers will be returned for 3 days before the requested date and 3 days after the requested date i.e. Only 7/7 calendar is supported
 

Loading...

Loading...