Overview
The ServiceList API returns applicable and available services for each flight segment on a priced Offer (result of OfferPriceRS), or ticketed booking.
NDC Schema: IATA ServiceListRQ and ServiceListRS v21.3
Pre-condition(s)
- A (specific) Priced Offer has been selected by the sender from OfferPriceRS (previous shopping reply)
- An Order created by a NDC agent
- OfferPrice response OfferID(s) is valid for 20 minutes, ServiceList request must be triggered within the time-limit.
- Requestors (Travel Agency, Meta-Search, and TMC) must have an agreement with Virgin Atlantic
In Scope
Request
-
A Priced Offer ID from OfferPriceRS
-
An Order ID from already created Order via NDC
Response
-
List of Service Offered on VS Operated flights
-
Details of each of the services
Out of Scope
- Flight specific services
- Passenger specific services
- Paid services
- Services available through other Carriers
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/ServiceList
https://ndcdeveloper.virginatlantic.com/preview/SalesAndRevenueManagement/OrderShopping/OfferManagement/v1/ServiceList
Business Rules
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
SegmentRefs |
"SEG"+<number counter> |
SEG1 |
| PaxID |
PaxRefID
PassengerRefs |
Refer PaxID based on PTC |
ADULT_1 |
| ServiceID |
ServiceRefID |
"SV"+<number counter> |
SV1 |
Offer
The requested OfferID must be from the previous OfferPrice response within the time-limit of the OfferPriceRS (valid for 20 minutes).
The requested OrderID must be created via NDC by an authorised NDC agent.
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.
Error Scenario
An error will be returned if all flight segments in the Priced Offer, or NDC Order are operated by partner carriers. An Error will also be returned if all the VS flight segments in the NDC Order have already flown.
Feedback for this page? How was your experience? Please click
here