Order Change

This allows the seller/aggregator to change the order. This accepts a reshop Offer for full cancellation of paid orders; for unpaid orders, only the Order information needs to be specified. NDC Gateway then responds with an IATA_OrderViewRS containing the updated Order.

Access flight booking options through IATA’s NDC standards for enhanced distribution.

POST: v21.3/OrderChange

Header Type Header Value
Sample RQ Header HTTP Method POST
URL v21.3/OrderChange
HTTP Version HTTP/1.1
Content Type Application/Xml; Charset=Utf-8
Host client.ndc.navitaire.com
Content Length 2101
Expect 100-continue
Accept-Encoding gzip, deflate
Connection Keep Alive
Sample RS Header HTTP Version & Status Code HTTP/1.1 200 OK
Content-Type Application/Xml; Charset=Utf-8
Cache-Control Private
Content-Encoding gzip
Vary Accept Encoding
Accept application/xml
XML Request Response Error And Error Handling Work Flow FAQ

Below is an example of an XML snippet

Order Change Request

Below is a sample XML request of the Aviation APIs:

<IATA_OrderChangeRQ xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage">
    <DistributionChain>
        <DistributionChainLink xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <Ordinal>1</Ordinal>
            <OrgRole>Seller</OrgRole>
            <ParticipatingOrg>
                <OrgID>{{OrgID}}</OrgID>
            </ParticipatingOrg>
        </DistributionChainLink>
    </DistributionChain>
    <PayloadAttributes>
        <VersionNumber xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">21.3</VersionNumber>
    </PayloadAttributes>
    <Request>
        <ChangeOrderChoice xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <AcceptSelectedQuotedOfferList>
                <SelectedPricedOffer>
                    <OfferRefID>id-6438c818-62cb-439a-a53e-906c3a9b8e5f</OfferRefID>
                    <OwnerCode>6E</OwnerCode>
                    <SelectedOfferItem>
                        <OfferItemRefID>id-6671b93d-801e-47fb-aef2-535870182f82</OfferItemRefID>
                        <PaxRefID>A653262579</PaxRefID>
                    </SelectedOfferItem>
                </SelectedPricedOffer>
            </AcceptSelectedQuotedOfferList>
        </ChangeOrderChoice>
        <Order xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <OrderID>GQ365C</OrderID>
            <OwnerCode>6E</OwnerCode>
        </Order>
        <PaymentFunctions xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <PaymentProcessingDetails>
                <Amount CurCode="INR">4793.00</Amount>
                <PaymentMethod>
                    <SettlementPlan>
                        <IATA_Number>1</IATA_Number>
                        <PaymentTypeCode>AGT</PaymentTypeCode>
                    </SettlementPlan>
                </PaymentMethod>
            </PaymentProcessingDetails>
        </PaymentFunctions>
    </Request>
</IATA_OrderChangeRQ>

Order Change Response

Below is a sample XML response of the Aviation APIs:

<IATA_OrderViewRS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage">
    <Response>
        <DataLists xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes">
            <BaggageAllowanceList>
                <BaggageAllowance>
                    <ApplicablePartyText>Traveler</ApplicablePartyText>
                    <BaggageAllowanceID>bag01719913658</BaggageAllowanceID>
                    <TypeCode>Checked</TypeCode>
                    <WeightAllowance>
                        <MaximumWeightMeasure>15</MaximumWeightMeasure>
                        <WeightUnitOfMeasurement>KGM</WeightUnitOfMeasurement>
                    </WeightAllowance>
                </BaggageAllowance>
            </BaggageAllowanceList>
            ... (rest of your XML here, truncated for brevity) ...
    </PaymentFunctions>
</IATA_OrderViewRS>
Error Description Resolution
OF4017 Sell Failure. Ensure the OfferItemID and OfferID used are correct and from a recent OfferPriceRS.
OF4019
  • Payment Validation Error.
  • GivenName/Surname is required in Payer/PayerName/IndividualName.
    		•  Validate XML against the NDC schema (especially for payment-related elements)
    OF4020 Error encountered on booking commit. Double-check the endpoint URL or resource ID for accuracy.
    OF4025 Payment requires 3-D Secure processing but is not supported in application. Retry the request after some time. If the issue persists, contact the support team.

    Flow of Order Change

    Below is the Order Change flow diagram.

    AuthToken
    ↓
    OrderRetrieve
    ↓
    OfferReshop
    ↓
    OrderQoute
    ↓
    OrderChange
    ↓
    End

    Need help? Check FAQs

    What is an NDC Order Change?

    An NDC Order Change refers to the modification of an existing flight order booked via the NDC channel. This could include changes to the itinerary, passenger details, ancillary services, or fare adjustments.

    How do I request a change?

    Changes can be requested via the OrderChangeRQ message in the NDC API. Ensure the original Order ID and relevant passenger/segment details are included in the request.

    Is it possible to cancel and rebook instead of changing?

    Yes, but this depends on the fare conditions. In some cases, it may be more cost-effective to cancel and rebook. Always check fare rules before proceeding.