.. _IATA_Acknowledgement:

********************
IATA_Acknowledgement
********************

.. raw:: html

   <h3>Introduction</h3>

The IATA_Acknowledgement represents a response in which the API either confirms or declines a job from a request.
The response normally does not contain any informative content (beside of a possible error message).

.. raw:: html

   <h3>General Usage</h3>

The main usage for IATA_Acknowledgement is to respond to a request. This can be either a successful response or a response containing an error that the requested job has failed. For more information please have a look at the below samples.
The element "StatusCode" can have various values, in our API the following Values are used:

- OK
- ERROR
- PARTLY


For more detailed information about the status codes, please have a look at :ref:`Deliver-Booking`

.. raw:: html

   <h3>Samples</h3>

.. raw:: html

   <h4>IATA_Acknowledgement OK</h4>

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

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Acknowledgement xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_Acknowledgement">
                <MessageDoc>
                    <RefVersionNumber>1</RefVersionNumber>
                </MessageDoc>
                <Notification>
                    <StatusCode>OK</StatusCode>
                </Notification>
            </Acknowledgement>

|

.. raw:: html

   <h4>IATA_Acknowledgement ERROR</h4>

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

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Acknowledgement xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_Acknowledgement">
                <MessageDoc>
                    <RefVersionNumber>1</RefVersionNumber>
                </MessageDoc>
                <Notification>
                    <StatusCode>ERROR</StatusCode>
                    <StatusMessageText>order couldn't be created because ***</StatusMessageText>
                </Notification>
            </Acknowledgement>

|

.. raw:: html

   <h4>IATA_Acknowledgement PARTLY</h4>

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

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <Acknowledgement xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_Acknowledgement">
                <MessageDoc>
                    <RefVersionNumber>1</RefVersionNumber>
                </MessageDoc>
                <Notification>
                    <StatusCode>PARTLY</StatusCode>
                    <StatusMessageText>ancillary *** could not be booked</StatusMessageText>
                </Notification>
            </Acknowledgement>

|