Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

User Guidance - Service Input Parameters

Input Parameters

Type

Optional/Mandatory

Request Object

AirShoppingRQ

M

  • <AirShoppingRQ>

  • <Document>

  • <Party>

  • <CoreQuery>

  • <DataLists>

<Document>

Document

<Name>

Name

<ReferenceVersion>

ReferenceVersion

Elements

CityCode

<AirShoppingRQ>

XML Example for the following elements

Code Block
languagexml
<AirShoppingRQ Version="17.2"
xmlns="http://www.iata.org/IATA/EDIST">

Elements

Details

Optional/Mandatory

code

Version

(Attribute)

Specify NDC schema message version. Always pass 17.2

Note: This is a mandatory attribute in NDC schema. The service will not validate what is being passed in this attribute

M

<Document>

XML Example for the following elements

Code Block
<Document>
        <Name>NDC</Name>
        <ReferenceVersion>17.2</ReferenceVersion>
</Document>

Elements

Details

Optional/Mandatory

Code Block

NDC Message Document information

M

Code Block

Document name will be always "NDC"

O

Code Block

It will be NDC version

O

<PointOfSale>

XML Example for the following elements

Code Block
languagexml
<ns:PointOfSale>
      <ns:Location>
                  <ns:CountryCode>IT</ns:CountryCode>
                  <ns:CityCode>ROM</ns:CityCode>
      </ns:Location>
      <ns:RequestTime Zone="CET">2019-01-28T07:01:00</ns:RequestTime>
</ns:PointOfSale>
Code Block

Details

Mandatory/Optional

code

PointOfSale

Point of Sale information.

M

Location

Point of sale location information.

code

O

CountryCode

Country Code

M

Code Block

Airport or City Code

M

code

RequestTime

Point Of Sale Timestamp value

Example: 2017-01-13T13:59:38Z

M

code

O

Zone (Attribute)

Point of Sale timezone

Example : UTC, CET

MO

<OriginDestination>

OriginDestination

<Departure>

Departure

<AirportCode>

AirportCode

<Date>

Date

<AirportCode>

AirportCode

<CalendarDates>

<Party>

XML Example for the following elements

Normal bookings/B2C bookings

Code Block
languagexml
<ns:Party>
	<ns:Sender>
		<ns:AgentUserSender>
			<ns:Name>CHANNEL NAME</ns:Name>
			<ns:AgentUserID>CHANNEL CODE</ns:AgentUserID>
		</ns:AgentUserSender>
	</ns:Sender>
	<ns:Recipient>
		<ns:ORA_Recipient>
			<ns:
AirlineID>V1<
AirlineID>AIRLINE CODE</ns:AirlineID>
			<ns:
Name>Airline
Name>AIRLINE 
Name<
NAME</ns:Name>
		</ns:ORA_Recipient>
	</ns:Recipient>
</ns:Party>

B2B login/travel agent login

Code Block
languagexml
<edis:Party>
    <edis:Sender>
        <edis:AgentUserSender>
            <edis:OtherIDs>
                <edis:OtherID Description = "Booking Channel ID">CHANNEL CODE given by IBS</edis:OtherID>
            </edis:OtherIDs>
            <edis:AgentUserID Owner = "Agency code">Agent id</edis:AgentUserID>
        </edis:AgentUserSender>
    </edis:Sender>
    <edis:Recipient>
        <edis:ORA_Recipient>
            <edis:AirlineID>AIRLINE CODE</edis:AirlineID>
            <edis:Name>AIRLINE NAME</edis:Name>
        </edis:ORA_Recipient>
    </edis:Recipient>
</edis:Party>

Elements

Details

Optional/Mandatory

<Party>Party

Party & Sender Definition

M

Sender

Message Sender information.

M

AgentUserSender

Agent User Sender Details

M

Name

Agency Seller Name

MO

AgentUserID

User ID of the Agent

Info

AgentUserID

In case of B2C bookings, AgentUserID holds the channel code.

Example:

Code Block
<ns:AgentUserID>CHANNELXXX</ns:AgentUserID>

M

Owner (Attribute)

Airline designator or CRS code of the owner/ assigner of the Offer ID, typically used for offer ordering purposes.

Info

Owner (Attribute)

In case of a Travel Agent booking, Owner value will be the Agency Code.

Example:

Code Block
<edis:AgentUserID Owner = "TravelDestiny">TravelAgent1</edis:AgentUserID>

O

OtherIDs

Additional Agency (Seller) identification

Note

In case of Agency Bookings, OtherIDs will be mandatory to specify the Channel Code.

O

OtherID

Other Identifier

M

Description (Attribute)

Other identification description.

Info

Description (Attribute)

In case of a Travel Agent Booking, Description value will be “Booking Channel ID”

M

Recipient

Named Message Recipient.

M

ORA_Recipient

SUPPLIER: ORA (Offer Originating Airline)

Recipient.

M

AirlineID

Airline ID

M

Name

Airline Name

MO

<CoreQuery>

XML Example for the following elements

Code Block
languagexml
  <ns:CoreQuery>
               <ns:OriginDestinations>
              
        <ns:OriginDestination>
                 
            <ns:Departure>
                     <ns
                <ns:AirportCode>AYT</ns:AirportCode>
                    
                <ns:Date>2019-07-05</ns:Date>
                 
            </ns:Departure>
                             <ns:Arrival>
                    
                <ns:AirportCode>FRA</ns:AirportCode>
                 
            </ns:Arrival>
                  <ns
            <ns:CalendarDates DaysBefore="0" DaysAfter="0"/>
              
        </ns:OriginDestination>
                       <</ns:OriginDestinations>
        
</ns:CoreQuery>

Elements

Details

Optional/Mandatory

code

CoreQuery

<CoreQuery>

Start of AirShopping Query

M

code

OriginDestinations

<OriginDestinations>

Origin and destination (O&D) details

M

Code Block

This must be repeated for each O&D. If the request is for EDI-AMS return then this must be repeated twice one for EDI-AMS and one for AMS-EDI

M

code

OriginDestinationKey

(attribute)

This is the unique key to be used when requesting any preference at Origin-Destination level

O

Code Block

Departure airport/city details

M

Code Block

Accepts both airport code (LHR) and city code (LON)

M

Code Block

Departure date

Example: 2015-08-14

M

Code Block
 
Code Block
<Arrival>

Arrival

Arrival airport/city details

M

Code Block

Accepts both airport code (LHR) and city code (LON)

M

Code Block

Date

Arrival date

Example: 2016-08-14

O

CalendarDates

Indicates Calendar search date.

Calendar recommendation will only be returned if the client specifies calendar search dates in the request

O

code

DaysAfter

(Attribute)

The number of days after the requested date

Example: 3

Calendar recommendation will be returned for the number of days specified after the requested date

O

code

DaysBefore

(Attribute)

The number of days before the requested date

Example: 3

Calendar recommendation will be returned for the number of days specified before the requested date

O

<Preference>

Elements

Details

Optional/Mandatory

code

Preference

<Preference>

Fare and cabin preference can be specified here

O

FarePreferences

Specify fare preference.

O

XML Example for the following elements

Code Block
<FarePreferences>

Specify fare preference.

O

languagexml
<ns:Preference>
<ns:FarePreferences>
    <ns:Types>
        <ns:Type>SUNECO</ns:Type>
    </ns:Types>
</ns:FarePreferences>
</ns:Preference>

CabinPreferences

Specify Cabin preference code.

O

XML Example for the following elements

Code Block
languagexml
<ns:Preference>
<ns:CabinPreferences>
    <ns:CabinType>
        <ns:Code>4</ns:Code>
    </ns:CabinType>
</ns:CabinPreferences>
</ns:Preference>

<DataLists>

XML

Elements

Details

Optional/Mandatory

Code Block
<PassengerList>
Code Block
<PassengerList>
List of all passengers with Passenger type code (PTC)

PassengerList

Passenger data list definition/details.

M

XML Example for the following elements

Code Block
languagexml
<ns:PassengerList>
    <ns:Passenger PassengerID = "V1_PAX.1">
        <ns:PTC>ADT</ns:PTC>
    </ns:Passenger>
    <ns:Passenger PassengerID = "V1_PAX.2">
        <ns:PTC>ADT</ns:PTC>
    </ns:Passenger>
    <ns:Passenger PassengerID = "V1_PAX.3">
        <ns:PTC>CHD</ns:PTC>
    </ns:Passenger>
    <ns:Passenger PassengerID = "V1_PAX.4">
        <ns:PTC>INF</ns:PTC>
    </ns:Passenger>
</ns:PassengerList>
Code Block

<ns:Passenger PassengerID = "V1_PAX.1">

Passenger

Any person except members of the crew carried or to be carried with the consent of the carrier, on board of any transport vehicle such as aircraft, train, bus, ship.

 

M

 

Code Block
<ns:Passenger PassengerID = "V1_PAX.1">

PassengerID (Attribute)

 

 

Uniquely identifies a Passenger within the context of one message.

Example:

V1_PAX.1, V1_PAX.2 ,V1_PAX.3

M

 

Code Block
<ns:PTC>INF</ns:PTC>

PTC

Type code applying to the Passenger which typically drives pricing.

Example: ADT, CHD, INF

OM