OrderCancel

Our latest version OrderCancel 17.2

1.1 Functional Description

v - 2.38 

The Order Cancel API allows an existing Order to be cancelled. Any refundable fare and taxes will be refunded.

Functionality:

OrderCancel.zip message examples

(2.23) Validation of the currency we sell with the point of sale currency. This information will be optional.

    
    <Metadata>
        <Other>
            <OtherMetadata>
                <CurrencyMetadatas>
                    <CurrencyMetadata MetadataKey="EUR">
                    <Decimals>2</Decimals>
                    </CurrencyMetadata>
                </CurrencyMetadatas>
            </OtherMetadata>
        </Other>
    </Metadata>
        

EndPoints:

1.2 Request Body

NAME DESCRIPTION FORMAT ALLOWED VALUES MANDATORY FOR
PrimaryLangIDD Two character ISO Language Code, for the agent’s preferred language. This is for error messages and some other data such as legal waivers 2 alpha
  • EN
  • ES

Version The IATA version of the message numeric any Schema

<PointOfSale>

CountryCode

Country code

2 alpha

List of countries

If toggle feature for market validation is activated.

<Document>                                                                                                                                                                                                                                              Schema

ReferenceVersion

The IATA Schema version.

numeric

any


<Party>                                                                                                                                                                                                                                                      Schema

Sender / IATA_Number

Sender unique identifier such as:

IATA number (if you have one)

TIDs number (recommended if you do not have an IATA)

Pseudo IATA(assigned by Iberia)

7 numeric

7 numbers

NDC Mandatory

Sender / AgencyID

Name of the Sender / Agency

alphanumeric

any

Schema

Participant / AggregatorID

Participant / Aggregator unique identifier:

IATA number (if you have one)

TIDs number (recommended if you do not have an IATA)

Pseudo IATA(assigned by Iberia)

7 numeric

7 numbers

Mandatory for schema if 'Participants' tag is indicated.
<Expected Refund Amount>


 
Total Total amount of the expected refund Numeric any Mandatory for schema if "Expected Refund Amount" tag is indicated
<Query> Order by OrderID


Schema
OrderID OrderID alphanumeric any
<Query> Order by Locator and Surname


Schema
ID Order's locator alphanumeric any Schema
Airline ID Airline ID 2 alpha any Schema

1.3 Response Body

NAME 

DESCRIPTION 

FORMAT 

Nullable 

OrderCancelProcessing / Marketing Messages / Marketing Message / Text

Additional text for asociated services

alphabetical

False

Order Reference

Order reference

alphanumeric

False

1.4 Error messages

NDC Standard allow errors and warnings to be returned inside an 200 OK response. Errors returned with 200 OK will always be controlled errors result of external limitations as "Max accepted non-infant passengers is 9".

The following codes are enclosed in the response returned with a 200 OK.

HTTP STATUS CODE

EXAMPLE MESSAGE ERROR

REASON

144 Invalid Requestor Identification Invalid agency
74T Reembolso por cancelación no permitido Issued ticket
74T Refund cancel not allowed Incorrect Expected Refund Amount
915 No action - processing host cannot support function Private Fares Error
486 Changes have been made to the reservation from outside of NDC. Sorry we can’t process the request. Reserve modificated outside NDC.
396 Refund request for tickets not issued. Please check the information entered and if the issue persists get in touch with us. Refund request for tickets not issued.
486 The reserve has been cancelled. The reserve to be cancelled is already in this status.