Overview
The OrderQuote API returns a detailed fare, fare rules and tax breakdown for the requested reshop offer along with Upsell Offer(s), if available.
It returns 'No Change' in Price when repricing an unticketed order, as currently VS guarantees price at time of booking for 3 days until the order is ticketed.
NDC Schema: OrderQuote RQ & OrderReshop RS v 21.3
Pre-condition(s)
- Requestors (Travel Agency, Meta-Search, TMC) must have an agreement with Virgin Atlantic
- The Requestor must have already created Booking via NDC Channel
- A valid Order Reshop result along with Reshop offers should have been obtained by calling Order Reshop
- A valid Order that is not yet ticketed to reprice an unticketed order
In Scope
Request
-
An Offer ID with OfferItemID(s) and Pax Info
-
Pax Type - Adult (ADT), Child (CHD), Infant (INF), and Young Adult (GBE)
-
Multiple Passengers. (1 to 9 ADT)
-
OrderID for an unticketed order
Response
-
VS Operated and Marketing flights (Code Share Partners)
-
Priced Offer with detailed fare and tax breakdown
-
Higher Upsell Offer(s), if available
-
Baggage Allowance
-
Change and Cancel fare rules
-
Booked Order Change Fee Info
-
Price Differential Info
-
No Change Price Indicator for Unticketed Order
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.
https://ndcdeveloper.virginatlantic.com/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/OrderQuote
https://ndcdeveloper.virginatlantic.com/preview/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/OrderQuote
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
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, PassengerRefs |
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 |
Offer
The requested OfferID must be from the previous Order Reshop response otherwise an error will be returned.
Order Reshop response OfferID(s) is valid for 20 minutes, within the time-limit OrderQuote request must be triggered otherwise the offer will be deleted from the system and an error will be returned upon requesting this offer
Requested Offer
During OrderQuote, if the price changes for the requested offer, then the API will return a new OfferID and OfferItemIDs along with a warning message advising the seller that there has been a price change. Seller can select this new OfferID and call OrderChange to process the change if they are happy with the price. The Offer expiry time limit for this new offer will be 20 mins.
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)
Upsell Offer(s)
In addition to returning the details for the requested offer (under RequotedOffer section in the response), the API also returns one or more upsell offers, if applicable. The upsell offers are returned under ReshopOffers section. Upsell offers will return the next higher fare products with the same cabin as that of the requested offer plus all available fare products in the next available cabins e.g., if the requested offer is “Economy Classic” then upsell offers will return 'Economy Classic Flex', 'Economy Delight', 'Economy Delight Flex', 'Premium', 'Premium Flex', 'Upper' and 'Upper Flex'.
Upsell offer(s) is returned with detailed fare and tax breakdown per PTC along with fare rules/ Penalty details. If the seller were to choose an Upsell offer, then they have all information to construct OrderChangeRQ and amend the booking.
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.
Feedback for this page? How was your experience? Please click
here