OrderCancel operation

The order cancel method allows to cancel/void an order in the airline system. The order reshop method must be called before to retrieve potential cancellation fee.


Table of contents

  1. Release notes
  2. Mandatory HTTP header
  3. OrderCancelRQ
  4. OrderCancelRS
  5. Samples

Release notes

VersionNotes
1.0Initial version.

Mandatory HTTP header

  • AuthToken: token value retrieved from login response

OrderCancelRQ

ElementDescriptionOptional/Mandatory
PartyMust contain agency ID as senderMandatory
PayloadAttributesVersion + CorrelationID (to group log messages)Optional
RequestThe request element detailed belowMandatory

Request

ElementDescriptionOptional/Mandatory
OrderThe order detailed belowMandatory

Order

ElementDescriptionOptional/Mandatory
OrderIDID of the order to cancelMandatory

OrderCancelRS

ElementDescriptionOptional/Mandatory
ResponseThe response element detailed belowMandatory
PayloadAttributesSame as requested + timestampMandatory

Response

ElementDescriptionOptional/Mandatory
ChangeFeesThe cancel fee detailed belowMandatory
OrderRefIDThe order ID (same as requested)Mandatory
WarningsList of warnings returned by providerOptional

ChangeFees

ElementDescriptionOptional/Mandatory
PriceThe cancellation fee amountMandatory
TypeCodeType “Cancellation”Mandatory

Samples

OrderCancelRQ
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<IATA_OrderCancelRQ xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_OrderCancelRQ">
    <Party>
        <Sender>
            <TravelAgency>
                <AgencyID>agency1234</AgencyID>
            </TravelAgency>
        </Sender>
    </Party>
    <PayloadAttributes>
        <CorrelationID>c3421ac5-96cd-3aed-b40b-aca63b056173</CorrelationID>
        <VersionNumber>19.2</VersionNumber>
    </PayloadAttributes>
    <Request>
        <Order>
            <OrderID>544759</OrderID>
        </Order>
    </Request>
</IATA_OrderCancelRQ>
OrderCancelRS
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<IATA_OrderCancelRS xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_OrderCancelRS">
    <Response>
        <ChangeFees>
            <CancelFeeInd>true</CancelFeeInd>
            <PenaltyID>PNL1</PenaltyID>
            <Price>
                <TotalAmount>0</TotalAmount>
            </Price>
            <TypeCode>Cancellation</TypeCode>
        </ChangeFees>
        <OrderRefID>544759</OrderRefID>
    </Response>
    <PayloadAttributes>
        <CorrelationID>c3421ac5-96cd-3aed-b40b-aca63b056173</CorrelationID>
        <Timestamp>2021-02-04T10:28:03.006+01:00</Timestamp>
        <VersionNumber>19.2</VersionNumber>
    </PayloadAttributes>
</IATA_OrderCancelRS>