NDC API V_17_2

Introduction

The service availability allows to give the available service for the given order.

Input

Order ID

Http Headers

Key	Value	Required
Content-Type	application/xml	Yes
Accept	/	Yes
Authorization	Bearer {{access_token}}	Yes
Content-Length	<calculated when request is sent>	Yes
Host	<calculated when request is sent>	Yes
User-Agent	PostmanRuntime/7.30.0	Yes
Accept-Encoding	gzip, deflate, br	Yes
Connection	Keep-alive	Yes
DeviceID	String	Yes

Sequence

Endpoints

Test	Live
https://aks-cluster-test.ethiopianairlines.com	https://ndc.ethiopianairlines.com

Special Service Request

		     
			<Document>
				<Name>ETHIOPIAN AIRLINES NDC </Name>
				<ReferenceVersion>1.0</ReferenceVersion>
		   </Document>

Request	Root node of the request schema
Document
Name	Document Name
ReferenceVersion	Reference Version

		     
			    <Party>
        <Sender>
            <TravelAgencySender>
                <Name>Ethiopianairlines TravelAgency</Name>
                <IATA_Number>12121212</IATA_Number>
                <AgencyID Owner="ET">A345345435</AgencyID>
            </TravelAgencySender>
        </Sender>
        <Participants>
            <Participant>
                <AggregatorParticipant SequenceNumber="1">
                    <Name>AAAIT PLC</Name>
                    <AggregatorID>88888888</AggregatorID>
                </AggregatorParticipant>
            </Participant>
        </Participants>
        <Recipient>
            <ORA_Recipient>
                <AirlineID>ET</AirlineID>
                <Name>ETHIOPIAN AIRLINES</Name>
            </ORA_Recipient>
        </Recipient>
    </Party>

Request	Root node of the request schema
Party	Aggregator and OTA information
Sender
TravelAgencySender	Travel agency involved in the request
Name	Travel agency’s official name
IATA_Number	Travel agency’s IATA number
AgencyID	Travel agency’s Agency ID
Participants	List of aggregators involved in the request
Participant
AggregatorParticipant
@SequenceNumber	Unique position in the list e.g. 1, 2, 3
Name	Aggregator’s official name
AggregatorID	Aggregator’s ID
Recipient
ORA_Recipient	Offer responsible airline information
AirlineID	IATA Airline code e.g. ET
Name	Ethiopian Airlines

		     
			    <Query>
        <Order OrderID="{{OrderId}}" Owner="ET"/>
    </Query>

Request	Root node of the request schema
Query
Order
@OrderID
@owner	ET

Special Service Response

		     
			<Document>
				<Name>ETHIOPIAN AIRLINES NDC </Name>
				<ReferenceVersion>1.0</ReferenceVersion>
		   </Document>

Request	Root node of the request schema
Document
Name	Document Name
ReferenceVersion	Reference Version

		     
			      <ALaCarteOffer OfferID="OfferID-1" Owner="ET">
        <ALaCarteOfferItem OfferItemID="OFFERITEM-MAAS-001">
            <Eligibility>
                <PassengerRefs>PAX001 PAX002 </PassengerRefs>
                <SegmentRefs>SEG001 </SegmentRefs>
            </Eligibility>
            <Service ServiceID="SV_MAAS_001">
                <ServiceDefinitionRef>SV_MAAS</ServiceDefinitionRef>
            </Service>
        </ALaCarteOfferItem>
        <ALaCarteOfferItem OfferItemID="OFFERITEM-DEAF-002">
            <Eligibility>
                <PassengerRefs>PAX001 PAX002 </PassengerRefs>
                <SegmentRefs>SEG001 </SegmentRefs>
            </Eligibility>
            <Service ServiceID="SV_DEAF_002">
                <ServiceDefinitionRef>SV_DEAF</ServiceDefinitionRef>
            </Service>
        </ALaCarteOfferItem>

Request	Root node of the request schema
ALaCarteOffer
@OfferID	OfferID-1
@Owner	e.g. ET
@Eligibility
PassengerRefs	PAX001 PAX002
SegmentRefs	SEG001
Service
@ServiceID	SV_MAAS_001
ServiceDefinitionRef	SV_MAAS - service code

		     
			<DataLists>
            <PassengerList>
                <Passenger PassengerID="PAX001">
                    <PTC>ADT</PTC>
                    <Individual>
                        <Birthdate>1988-06-10</Birthdate>
                        <Gender>Female</Gender>
                        <GivenName>JANE MRS</GivenName>
                        <Surname>SMITH</Surname>
                    </Individual>
                    <IdentityDocument>
                        <IdentityDocumentNumber>543000123</IdentityDocumentNumber>
                        <IdentityDocumentType>F</IdentityDocumentType>
                        <IssuingCountryCode>US</IssuingCountryCode>
                        <CitizenshipCountryCode>US</CitizenshipCountryCode>
                        <ExpiryDate>2022-01-16</ExpiryDate>
                        <Birthdate>1988-06-10</Birthdate>
                        <Birthplace>US</Birthplace>
                    </IdentityDocument>
                    <ContactInfoRef>CONTACT_PAX_1</ContactInfoRef>
                </Passenger>
                <Passenger PassengerID="PAX002">
                    <PTC>ADT</PTC>
                    <Individual>
                        <Birthdate>2019-06-10</Birthdate>
                        <Gender>Female</Gender>
                        <GivenName>SAWI MRS</GivenName>
                        <Surname>SAWALE</Surname>
                    </Individual>
                    <IdentityDocument>
                        <IdentityDocumentNumber>543000123</IdentityDocumentNumber>
                        <IdentityDocumentType>F</IdentityDocumentType>
                        <IssuingCountryCode>US</IssuingCountryCode>
                        <CitizenshipCountryCode>US</CitizenshipCountryCode>
                        <ExpiryDate>2022-01-16</ExpiryDate>
                        <Birthdate>2019-06-10</Birthdate>
                        <Birthplace>US</Birthplace>
                    </IdentityDocument>
                    <ContactInfoRef>CONTACT_PAX_2</ContactInfoRef>
                </Passenger>
            </PassengerList>
            <ContactList>
                <ContactInformation ContactID="CONTACT_PAX_1">
                    <ContactProvided>
                        <Phone>
                            <Label>HOME</Label>
                            <CountryDialingCode>IAD</CountryDialingCode>
                            <PhoneNumber>944123456</PhoneNumber>
                        </Phone>
                    </ContactProvided>
                    <ContactProvided>
                        <EmailAddress>
                            <EmailAddressValue>JANE@MAIL.COM</EmailAddressValue>
                        </EmailAddress>
                    </ContactProvided>
                </ContactInformation>
                <ContactInformation ContactID="CONTACT_PAX_2">
                    <ContactProvided>
                        <Phone>
                            <Label>HOME</Label>
                            <CountryDialingCode>IAD</CountryDialingCode>
                            <PhoneNumber>944123456</PhoneNumber>
                        </Phone>
                    </ContactProvided>
                    <ContactProvided>
                        <EmailAddress>
                            <EmailAddressValue>JANE@MAIL.COM</EmailAddressValue>
                        </EmailAddress>
                    </ContactProvided>
                </ContactInformation>
            </ContactList>
            <FlightSegmentList>
                <FlightSegment SegmentKey="SEG_ADDIAD_001">
                    <Departure>
                        <AirportCode>ADD</AirportCode>
                        <Date>2023-03-20</Date>
                        <Time>09:00</Time>
                        <Terminal />
                    </Departure>
                    <Arrival>
                        <AirportCode>IAD</AirportCode>
                        <Date>2023-03-20</Date>
                        <Time>19:25</Time>
                        <Terminal />
                    </Arrival>
                    <MarketingCarrier>
                        <AirlineID>ET</AirlineID>
                        <FlightNumber>0516</FlightNumber>
                    </MarketingCarrier>
                    <OperatingCarrier>
                        <AirlineID>ET</AirlineID>
                        <FlightNumber>0516</FlightNumber>
                    </OperatingCarrier>
                    <Equipment>
                        <AircraftCode>788</AircraftCode>
                    </Equipment>
                    <ClassOfService>
                        <Code>D</Code>
                        <MarketingName>BUSINESS</MarketingName>
                        <FareBasisCode>DEYJ0WET</FareBasisCode>
                    </ClassOfService>
                    <FlightDetail>
                        <FlightDistance>
                            <Value>7929</Value>
                            <UOM>Miles</UOM>
                        </FlightDistance>
                        <FlightDuration>
                            <Value>PT16H10M</Value>
                        </FlightDuration>
                    </FlightDetail>
                </FlightSegment>
            </FlightSegmentList>
            <FlightList>
                <Flight FlightKey="FLT001">
                    <SegmentReferences OnPoint="ADD" OffPoint="WAS">SEG_ADDIAD_001</SegmentReferences>
                </Flight>
            </FlightList>
            <OriginDestinationList>
                <OriginDestination>
                    <DepartureCode UOM="Miles">ADD</DepartureCode>
                    <ArrivalCode UOM="Miles">WAS</ArrivalCode>
                    <FlightReferences>FLT001</FlightReferences>
                </OriginDestination>
            </OriginDestinationList>
            <InstructionsList>
                <Instruction ListKey="RULE_ADD_WAS">
                    <FreeFormTextInstruction>
                        <Remark>NOTE - THE FOLLOWING TEXT IS INFORMATIONAL AND NOT</Remark>
	      </FreeFormTextInstruction>
                </Instruction>
            </InstructionsList>
            <ServiceDefinitionList>
                <ServiceDefinition ServiceDefinitionID="SV_CX" Owner="ET">
                    <Name>CX</Name>
                    <Descriptions>
                        <Description>
                            <Text>CLOUD 9 RESTRICTED</Text>
                        </Description>
                    </Descriptions>
                </ServiceDefinition>
            </ServiceDefinitionList>
            <SeatDefinitionList />
        </DataLists>

Request	Root node of the request schema
PassengerList	List of passengers
Passenger
@PassengerID	Unique passenger identifier e.g. PAX001
PTC	Passenger type e.g. ADT, CHD, INF
Individual
Birthdate	Format YYYY-MM-DD
Gender	Male, Female
NameTitle	MR, MRS, MS, MISS, MASTER, DR, PROF, AMB, SIR
GivenName	First name
MiddleName	Middle Name
Surname	Last name or Family name
LoyaltyProgramAccount
AccountNumber	e.g. Shebamiles number
IdentityDocument
IdentityDocumentNumber	passport number
IdentityDocumentType	F - Passport
IssuingCountryCode	2 letter country code of passport e.g. ET, GB
CitizenshipCountryCode	2 letter country code of nationality e.g. ET
IssueDate	Format YYYY-MM-DD
ExpireDate	Format YYYY-MM-DD
Birthdate	Format YYYY-MM-DD
Birthplace	2 letter country code of birth e.g. ET
ContactInfoRef	Reference to passenger contact information in ContactList
ContactList
ContactInformation
@ContactID	Unique contact ID e.g. CONTACT001
ContactType	PRIMARY PAYMENT – used if passenger is paying
PostalAddress	Address information
Label	Type of address e.g. HOME, WORK
Street	Street 1 0-9 a-z A-Z Maximum of 30 characters
PostalCode	Postal or zip code
CityName	e.g. Addis Ababa
CountrySubdivisionName	State or Region e.g. Oromia, Texas
CountryName	2 letter country code of address e.g. ET
ContactProvided	Collection of either emails or phone. Use separate nodes for emails and phones.
EmailAddress
Label	HOME or WORK
EmailAddressValue	e.g. john.doe@mail.com
Phone
Label	MOBILE, WORK
CountryDialingCode	Country code without + e.g. 251, 92
PhoneNumber	Number without country code
Individual	Required when the Payment.Payer node is set
GivenName
MiddleName
Surname

<Name>Meet and Assist</Name>

<Text>helps travellers to skip long airport queues and forget the hassles of airport complicated formalities, by offering personal assistants, fast track services, airport lounge access, buggy service, porter service, and more</Text>

</Description>

</Descriptions>

</ServiceItemQuantityRules>

</Detail>

</ServiceDefinition>

<Name>Deaf Passenger</Name>

<Text>Passenger have difficulty of hearing or deaf.</Text>

</Description>

</Descriptions>

</ServiceItemQuantityRules>

</Detail>

</ServiceDefinition>

<Name>Wheelchair for Ramp</Name>

<Text>Wheelchair assistance required; passenger can walk short distance up or down stairs.</Text>

</Description>

</Descriptions>

</ServiceItemQuantityRules>

</Detail>

</ServiceDefinition>

EThelps travelers to skip long airport queues and forget the hassles of airport complicated formalities, by offering personal assistants, fast track services, airport lounge access, buggy service, porter service, and more

Request	Root node of the request schema
ServiceDefinitionList	the definition for service code
ServiceDefinition
@ServiceDefinitionID	SV_MAAS
@owner
@Name	Meet and assist - Maas
Descriptions
Description	description of the service
@Text
ServiceItemQuantityRules	applicable rules
MaximumQuantity	allowable maximum request e.g. 1

XML Sample

Request and Response	Update traveldoc xml
Service List Request	Click to download
Service List Response	Click to download

Connect to Ethiopian NDC platform today!

NDC API V_17_2

Airshopping

OfferPrice

OrderCreate

Order Retrieve

AirDocIssue (Ticketing)

Order Reshop

Order Change

Refund Order Reshop

Refund Order cancel

Order Retrieve

Order Retrieve

Void Ticket

Order Retrieve

Air Cancel

Order Rule

Add/Update Loyalty Number

Order Reprice

Add/update identity doc

Seat Availability

Seat Select

Service Availability

Service Select

Meal Availabilities

Meal Selects

Introduction

About us

Terms and Conditions

Ethiopian App

Social Media

Subscribe

Best Airline in Africa for seven years in a row

Best Business Class in Africa for six years in a row

Best Economy Class in Africa for six years in a row

Best Economy Class OnBoard Catering in Africa

Connect to Ethiopian NDC platform today!

NDC API V_17_2

Booking

Order Exchange

Order Refund

Order Void

Order Cancel

Order Manage

Manage Seat

Special service

Meal Manage

FAQs

Support

Introduction

XML Sample

XML Sample

XML Sample

XML Sample

XML Sample

XML Sample

XML Sample

Ethiopian App

Social Media

Subscribe

Best Economy Class in Africa for six years in a row

Best Economy Class OnBoard Catering in Africa