.. _IATA_OrderCancelRQ/RS:

*********************
IATA_OrderCancelRQ/RS
*********************

.. raw:: html

   <h3>Introduction</h3>

The IATA_OrderCancelRQ/RS message pair is the simpliest way to cancel a booking. It does not require any previous preparation.

.. raw:: html

   <h3>General Usage</h3>

To cancel a booking using IATA_OrderCancelRQ, the client does not have to retrieve the booking beforehand or perform any other kind of previous action.
However, it is recommended to include a pricing step to the cancellation workflow, to show possible cancellation fees (see also :ref:`Cancel-booking-using-IATA_OrderCancelRQ`).

The request only needs the OrderID as a parameter, the response also only contains the OrderID or an error, if the cancellation failed.

.. raw:: html

   <h3>Sample</h3>

.. raw:: html

   <h4>IATA_OrderCancelRQ</h4>

.. toggle-header::
    :header: **Show/Hide Request**

        .. code-block:: xml

            <?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>
                        <EnabledSystem>
                            <SystemID>12345</SystemID>
                        </EnabledSystem>
                    </Sender>
                </Party>
                <Request>
                    <Order>
                        <OrderID>1234567</OrderID>
                        <OwnerCode>ZZ</OwnerCode>
                    </Order>
                </Request>
            </IATA_OrderCancelRQ>

|

.. raw:: html

   <h4>IATA_OrderCancelRS</h4>

**Success**

.. toggle-header::
    :header: **Show/Hide Response**

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <IATA_OrderCancelRS xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_OrderCancelRS">
                <Response>
                    <OrderRefID>123456</OrderRefID>
                </Response>
               <PayloadAttributes>
                  <Timestamp TimeZoneCode="UTC">2020-04-09T06:24:16.814</Timestamp>
                  <VersionNumber>19.2</VersionNumber>
               </PayloadAttributes>
            </IATA_OrderCancelRS>

|

**Failure**

.. toggle-header::
    :header: **Show/Hide Response**

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <IATA_OrderCancelRS
                xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_OrderCancelRS">
                <Error>
                    <Code>1000</Code>
                    <DescText>order could not be cancelled</DescText>
                </Error>
               <PayloadAttributes>
                  <Timestamp TimeZoneCode="UTC">2020-04-09T06:24:16.814</Timestamp>
                  <VersionNumber>19.2</VersionNumber>
               </PayloadAttributes>
            </IATA_OrderCancelRS>

|