NDC API V_17_2

Introduction

Enables to reshop for an order after getting success response from order retrieve

Input

Order ID / PNR
segments for reshop
Old segments to be deleted

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

OrderReshop 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>
        <OrderID>{{OrderId}}</OrderID>
        <Reshop>
            <OrderServicing>
                <Add>
                    <FlightQuery>
                        <OriginDestinations>
                            <OriginDestination>
                                <Departure>
                                    <AirportCode>ADD</AirportCode>
                                    <Date>2022-11-19</Date>
                                </Departure>
                                <Arrival>
                                    <AirportCode>DXB</AirportCode>
                                </Arrival>
                            </OriginDestination>
                        </OriginDestinations>
                    </FlightQuery>
                </Add>
                <Delete>
                    <OrderItem OrderItemID="ORDERITEM001">
                        <ServiceRetainRequestIDs>SEG_ADDDXB_001</ServiceRetainRequestIDs>
                    </OrderItem>
                </Delete>
            </OrderServicing>
        </Reshop>
    </Query>

Request	Root node of the request schema
Query
OrderID	PNR e.g. NBHGFS
Reshop
OrderServicing
Add
FlightQuery	reshope flight query
OriginDestinations
OriginDestination
Departure	onward flight
AirportCode	e.g. ADD
Date	departure date
Arrival
AirportCode	Arrival airport code
Delete
OrderItem OrderItemID	order item id e.g. ORDERITEM001
ServiceRetainRequestIDs	segment to be deleted- e.g. SEG_ADDDXB_001

OrderReshop 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

		     
			    <ShoppingResponseID>
        <ResponseID>LWJQNMJOZK2ZMSB</ResponseID>
    </ShoppingResponseID>
 
		 .

Request	Root node of the request schema
Shopping Response
ResponseID	Response ID of the reshop request request e.g. LWJQNMJOZK2ZMSB

		     
			        <ReshopOffers>
            <ReshopOffer OfferID="OFFERFLT001" Owner="ET">
                <TimeLimits>
                    <OfferExpiration Timestamp="2023-01-10T06:10:53.6547978Z" />
                </TimeLimits>
                <AddOfferItem OfferItemID="OFFERITEM-2297164893">
                    <Service ServiceID="SV_FLT001">
                        <PassengerRefs>PAX001 PAX002</PassengerRefs>
                        <ServiceRef>SD_EF</ServiceRef>
                        <FlightRefs>FLT001</FlightRefs>
                    </Service>
                    <ReshopDifferential>
                        <NewOfferItem>
                            <Total>
                                <Amount Code="USD">200.00</Amount>
                            </Total>
                            <Taxes>
                                <Total Code="USD">-148.00</Total>
                            </Taxes>
                        </NewOfferItem>
                        <PenaltyAmount>
                            <Total>
                                <Amount Code="USD">0</Amount>
                            </Total>
                        </PenaltyAmount>
                        <ReshopDue>
                            <ByPassenger>
                                <Total>
                                    <Amount Code="USD">84.00</Amount>
                                </Total>
                            </ByPassenger>
                        </ReshopDue>
                    </ReshopDifferential>
                </AddOfferItem>
            </ReshopOffer>
		</ReshopOffers>

Request	Root node of the request schema
ReshopOffers	Offers collection
ReshopOffer	ReshopOffer with id e.g. OFFERFLT001
@OfferID	e.g. OFFERFLT001
@owner	e.g. ET
TimeLimits	Offer Expiration
OfferExpiration	Offer Expiration time stamps
@Timestamp	e.g. 2023-01-10T06:10:53.6547978Z
AddOfferItem
@OfferItemID	e.g. OFFERITEM-2297164893
Service	ServiceID="SV_FLT001"
PassengerRefs	e.g. PAX001
ServiceRef	SD_EF
FlightRefs	FLT001
ReshopDifferential
NewOfferItem
Total	total price
Amount
@Code	Currency code
Taxes
Total	Tax value
@Code	Currency code
Penalty amount	penalty amount
Total
Amount	total amount
@Code	Currency code
ReshopDue
ByPassenger	by passenger
Total
Amount	total amount
@Code	Currency 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>

</Departure>

</Terminal>

</Arrival>

</MarketingCarrier>

</OperatingCarrier>

</Equipment>

<MarketingName>ECONOMY</MarketingName>

<FareBasisCode>YOWET</FareBasisCode>

</ClassOfService>

</FlightDuration>

</FlightDetail>

</FlightSegment>

</FlightSegmentList>

<SegmentReferences OnPoint="ADD" OffPoint="DXB">SEG_ADDDXB_001</SegmentReferences>

</Flight>

</OriginDestination>

</OriginDestinationList>

<Text>ECONOMY FLEX</Text>

</Description>

</Descriptions>

</ServiceDefinition>

</ServiceDefinitionList>

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

</Departure>

</Terminal>

</Arrival>

</MarketingCarrier>

</OperatingCarrier>

</Equipment>

<MarketingName>ECONOMY</MarketingName>

<FareBasisCode>YOWET</FareBasisCode>

</ClassOfService>

</FlightDuration>

</FlightDetail>

</FlightSegment>

</FlightSegmentList>

<SegmentReferences OnPoint="ADD" OffPoint="DXB">SEG_ADDDXB_001</SegmentReferences>

</Flight>

</OriginDestination>

</OriginDestinationList>

<Text>ECONOMY FLEX</Text>

</Description>

</Descriptions>

</ServiceDefinition>

</ServiceDefinitionList>

Request	Root node of the request schema
FlightSegmentList
FlightSegment
FlightSegment
@SegmentKey	e.g. SEG_ADDDXB_001
Departure
@AirportCode	departure airport code e.g. ADD
@Date	departure date e.g. 2023-03-19
@Time	departure time e.g. 02:55
Terminal	First name
@Name
MarketingCarrier
@AirlineID	e.g. ET
FlightNumber	e.g. 600
OperatingCarrier	e.g. ET
AirlineID	e.g. ET
FlightNumber	e.g. 600
Equipment
AircraftCode	E.g. B777
ClassOfService
Code	E.g. C - class
MarketingName	Business
FareBasisCode	e.g. NMBCV
FlightDetail
FlightDuration
@Value	PT4H10M
FlightSegmentList
FlightList
Flight
@FlightKey	e.g.FLT001
SegmentReferences
@OnPoint	e.g. ADD
@OffPoint	e.g. DXB
@SegmentReference	e.g. SEG_ADDDXB_001
OriginDestinationList
OriginDestination
DepartureCode	e.g. ADD
ArrivalCode	E.g. DXB
FlightReferences	FLT001 FLT002 FLT003
ServiceDefinitionList
ServiceDefinition
@ServiceDefinitionID	SD_EF
@Name	EF
Descriptions
Description
@Text	Economy Felx

XML Sample

Reques and Response	Sample Link
Order Reshop Request	View / Download
Order Reshop Response	View / Download

Erorr Response Description

Error responses

Erorr Code	Error Code Text
400	Page not found
200	Success response
0	Error

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

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