Saved Successfully.
On this page
Schema Data Model

Request Definition

<DistributionChain>
XML Snippet
Element
Details
DataType
M/O/C
<DistributionChain>
An instance of a distribution channel. That is, the set of organisations involved in the development of the current transaction.
M
//All the APIs should contain the carrier code in one of the ordinals, except AirShopping.

//For Direct agents:

<DistributionChain>
    <DistributionChainLink>
        <ContactInfo>
            <ContactInfoID>Agent</ContactInfoID>
            <EmailAddress>
                <EmailAddressText>agent@test.com</EmailAddressText>
            </EmailAddress>
        </ContactInfo>
        <Ordinal>1</Ordinal>
        <OrgRole>Seller</OrgRole>
        <ParticipatingOrg>
            <Name>Travel Agent</Name>
            <OrgID>IATA_Number</OrgID>
        </ParticipatingOrg>
    </DistributionChainLink>
    <DistributionChainLink>
        <Ordinal>2</Ordinal>
        <OrgRole>Carrier</OrgRole>
        <ParticipatingOrg>
            <Name>VIRGIN ATLANTIC</Name>
            <OrgID>VS</OrgID>
        </ParticipatingOrg>
    </DistributionChainLink>
</DistributionChain>

//For Indirect Agent (Via aggregator):

<DistributionChain>
         <DistributionChainLink>
                  <Ordinal>1</Ordinal>
                  <OrgRole>Seller</OrgRole>
                  <ParticipatingOrg>
                              <Name>TravelAgent_name</Name>
                              <OrgID>IATA_number</OrgID>
                  </ParticipatingOrg>
         </DistributionChainLink>
         <DistributionChainLink>
                  <Ordinal>2</Ordinal>
                  <OrgRole>Distributor</OrgRole>
                  <ParticipatingOrg>
                              <Name>Aggregator_name</Name>
                              <OrgID>TIDS_number</OrgID>
                  </ParticipatingOrg>
         </DistributionChainLink>
             <DistributionChainLink>
                  <Ordinal>3</Ordinal>
                  <OrgRole>Carrier</OrgRole>
                  <ParticipatingOrg>
                        <Name>VIRGIN ATLANTIC</Name>
                        <OrgID>VS</OrgID>
                  </ParticipatingOrg>
             </DistributionChainLink>
</DistributionChain>
<Request>
XML Snippet
Element
Details
DataType
M/O/C
<Request>
AirShoppingRQ request information with O&D and Passenger details.
M
<FlightRelatedCriteria>
Preferred or required criteria for flight filters from the shopping response.
O
<FlightCriteria>
O
<FlightCharacteristicsCriteria>
Flight Characteristics Criteria filter.
O
<CharacteristicsCode>
Currently supported: Direct
Enum
M
<PrefLevel>
Info regarding the preference level of requested flight characteristics code.
M
<PrefLevelCode>
Default value is “Required”
Enum
M
<FlightRequest>
This is the flight request.
M
<FlightRequestOriginDestinationsCriteria>
Contains O&D and date information.
M
<OriginDestCriteria>
Origin and Destination airport/city pair which confines a passenger journey or an aircraft flight
List[1...*]
M
CabinType
List of cabins requested as part of the AirShopping service.
List[1...*]
O
<CabinTypeCode>
Cabin Type Code as defined by PADIS code set 9873
Note:
  1. Accepted ENUM codes: 2, 3, 4, 5 (PADIS 9873)
  2. 2 = Business
  3. 4 = Premium Economy
  4. 5 = Economy
ENUM
M
<PrefLevel>
Information supporting a preference including preference level code Examples: Preferred, Required or Exclude
M
<PrefLevelCode>
Predefined preference level codes.
Note:
  1. Default value is 'Required'
  2. 1. Preferred
  3. 2. Required
  4. 3. Exclude
String
M
<CalendarDateCriteria>
Request for Calendar led search
O
<DaysAfterNumber>
Number of days after the requested departure date
Note:
  1. DaysAfterNumber must be provided for calendar search
Integer
O
<DaysBeforeNumber>
Number of days before the requested departure date.
Note:
  1. DaysBeforeNumber must be provided for calendar search
Integer
O
<DestArrivalCriteria>
Contains the destination arrival time and location information.
M
<IATA_LocationCode>
IATA 3-letter code defining the destination location..
Char(3)
M
<OriginDepCriteria>
Customer's requested Origin departure time and location.
M
<Date>
Customer's requested departure date.
YYYY-MM-DD
M
<IATA_LocationCode>
IATA 3-letter code defining the departing location.
Char(3)
M
<Time>
Requested departure time.
DateTime
O
<TimeAfterDuration>
Time tolerance measured in hours after the requested departure time.
Note:
  1. TimeAfterDuration must be provided if search is based on departure time (i.e Time is provided).
String
O
<TimeBeforeDuration>
Time tolerance measured in hours before the requested departure time.
Note:
  1. TimeBeforeDuration must be provided if search is based on departure time (i.e Time is provided)
String
O
<OfferCriteria>
The advanced Offer Criteria that is part of the AirShopping Request
Note:
  1. Mandatory for VA implementation
M
<FareCriteria>
Specific Fare Criteria associated with the requested fare product.
Note:
  1. Mandatory for VA implementation
M
<FareSubTypeCode>
This is mandatory if FareTypeCode is either 758 or 70G.
Note:
  1. Allowed values are as follows:
  2. SEAT ONLY
  3. MARINE/CRUISE
  4. VFR
  5. CHARITY
  6. TOUR OPERATOR
  7. SME
  8. STUDENT
  9. CORPORATE
Alphanumeric
C
<FareTypeCode>
Virgin Atlantic accepts the following codes from IATA PADIS codeset 9910 (Fare Qualifier). This is mandatory for VA implementation.
Note:
  1. PADIS Fare Qualifier Set:
  2. 730 - Fares with no penalties
  3. 731 - Fares with penalties
  4. 758 – Private Fare
  5. 70G – Corporate Fare
  6. 70J – Published Fare
Alphanumeric
M
<PrefLevel>
Preference level of requested Fare Criteria.
M
<PrefLevelCode>
Default value in "Required"
String
M
<ProgramCriteria>
Release V2
A negotiated program identifier ( e.g. CLID, Corporate codes)
O
<ProgramOwner>
Release V2
Program Owner Information
M
<Org>
Release V2
Organisation detail
M
<Name>
Release V2
Corporate Name
String
M
<OrgID>
Release V2
Corporate ID (CLID)
String
M
<ServiceCriteria>
Optional Services expected to be returned in the Offer.
O
<IncludeInd>
Indicates that the taxonomy specification should be included when search for a Fare product
Boolean
O
<TaxonomyCode>
Service Taxonomy code that designates the specification that should be associated with the requested Fare Product.
Note:
  1. Accepted Taxonomy codes are:
  2. 1. 13EC
  3. 2. 189C
  4. Where 13EC = Checked Bag and 189C = Preferred Seat
Alphanumeric
O
<ResponseParameters>
Release: 140425-01
This refers to the enhancement to enable agents (IATA/TIDS) to specify the currency in which the shopping can be made.
Note:
  1. In certain markets, multiple currencies may be used. In these cases, the agent can specify the desired currency via AirShoppingRQ. Once a purchase is made in a specific currency, all subsequent transactions must be conducted in the same currency. To ensure compliance, checks and validations are in place within OrderCreate and OrderChange.
Alphanumeric
O
<CurParameter>
Release: 140425-01
Indicate the currency in which the shopping can be made.
Alphanumeric
O
<CurCode>
Release: 140425-01
Currency Code as per ISO 4217
Char(3)
M
<Request>
        <FlightRequest xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <FlightRequestOriginDestinationsCriteria>
                <OriginDestCriteria>
                    <CabinType>
                        <CabinTypeCode>2</CabinTypeCode>
                        <PrefLevel>
                            <PrefLevelCode>Required</PrefLevelCode>
                        </PrefLevel>
                    </CabinType>
                    <DestArrivalCriteria>
                        <IATA_LocationCode>JNB</IATA_LocationCode>
                    </DestArrivalCriteria>
                    <OriginDepCriteria>
                        <Date>2026-04-29</Date>
                        <IATA_LocationCode>LHR</IATA_LocationCode>
                    </OriginDepCriteria>
                </OriginDestCriteria>
                <OriginDestCriteria>
                    <CabinType>
                        <CabinTypeCode>2</CabinTypeCode>
                        <PrefLevel>
                            <PrefLevelCode>Required</PrefLevelCode>
                        </PrefLevel>
                    </CabinType>
                    <DestArrivalCriteria>
                        <IATA_LocationCode>LHR</IATA_LocationCode>
                    </DestArrivalCriteria>
                    <OriginDepCriteria>
                        <Date>2026-05-06</Date>
                        <IATA_LocationCode>JNB</IATA_LocationCode>
                    </OriginDepCriteria>
                </OriginDestCriteria>
            </FlightRequestOriginDestinationsCriteria>
        </FlightRequest>
        <OfferCriteria xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <FareCriteria>
                <FareSubTypeCode>Charity</FareSubTypeCode>
                <FareTypeCode>758</FareTypeCode>
                <PrefLevel>
                    <PrefLevelCode>Required</PrefLevelCode>
                </PrefLevel>
            </FareCriteria>
            </ProgramCriteria>
        </OfferCriteria>
        <PaxList xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <Pax>
                <PaxID>ADULT_1</PaxID>
                <PTC>ADT</PTC>
            </Pax>
        </PaxList>
    </Request>

<DataLists>
XML Snippet
Element
Details
DataType
M/O/C
<PaxList>
Travellers in the shopping transaction.
Note:
  1. 1 to 9 paxs are supported.
O
<Request>
 ... 
 <PaxList>
    <Pax>
      <PaxID>ADULT_1</PaxID>
      <PTC>ADT</PTC>
    </Pax>
    <Pax>
      <PaxID>ADULT_2</PaxID>
      <PTC>ADT</PTC>
    </Pax>
    <Pax>
      <PaxID>CHILD_1</PaxID>
      <PTC>CHD</PTC>
    </Pax>
    <Pax>
      <PaxID>YOUTH_1</PaxID>
      <PTC>GBE</PTC>
    </Pax>
    <Pax>
      <PaxID>INFANT_1</PaxID>
      <PTC>INF</PTC>
    </Pax>
    <Pax>
      <PaxID>INFANT_2</PaxID>
      <PTC>INF</PTC>
    </Pax>
  </PaxList>
  ...
</Request>