.. _IATA_OrderListRQ/RS:

*******************
IATA_OrderListRQ/RS
*******************

.. raw:: html

   <h3>Introduction</h3>

The IATA_OrderListRQ/RS message pair can be used to search for Orders, as long as the airline reservation system supports this. It can be done by using an external reference, that has been stored in the Order or by using passenger and flight data.

.. raw:: html

   <h3>General Usage</h3>

The IATA_OrderListRQ can be executed using an external reference or flight- and passenger-related data. If the search was successful, the IATA_OrderListRS contains 1-n found Orders with their Order IDs and a short summary of their data. If the search does not return any results, an error is returned.

Please note, that the IATA_OrderListRS does not load the response data into the cache. If the client wants to execute operations based on the found Orders, the Orders have to be retrieved by using :ref:`IATA_OrderRetrieveRQ`.

.. raw:: html

   <h3>Sample</h3>

.. raw:: html

   <h4>IATA_OrderListRQ</h4>

**Search with external reference**

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

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <IATA_OrderListRQ 
                xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage"
                xmlns:ns2="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes"
                xmlns:ns3="http://www.w3.org/2000/09/xmldsig#">
                <DistributionChain>
                    <ns2:DistributionChainLink>
                        <ns2:Ordinal>1</ns2:Ordinal>
                        <ns2:OrgRole>Seller</ns2:OrgRole>
                        <ns2:ParticipatingOrg>
                            <ns2:OrgID>94021</ns2:OrgID>
                        </ns2:ParticipatingOrg>
                    </ns2:DistributionChainLink>
                </DistributionChain>
                <Request>
                    <ns2:OrderSearchFilterCriteria>
                        <ns2:BookingRefFilterCriteria>
                            <ns2:BookingEntity>
                                <ns2:Org>
                                    <ns2:Name>ABC</ns2:Name>
                                    <ns2:OrgID>ABC</ns2:OrgID>
                                </ns2:Org>
                            </ns2:BookingEntity>
                            <ns2:BookingID>999888777</ns2:BookingID>
                        </ns2:BookingRefFilterCriteria>
                    </ns2:OrderSearchFilterCriteria>
                </Request>
            </IATA_OrderListRQ>

|

**Search with passenger- and flight-data**

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

        .. code-block:: xml

             <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <IATA_OrderListRQ
                xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage"
                xmlns:ns2="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes"
                xmlns:ns3="http://www.w3.org/2000/09/xmldsig#">
                <DistributionChain>
                    <ns2:DistributionChainLink>
                        <ns2:Ordinal>1</ns2:Ordinal>
                        <ns2:OrgRole>Seller</ns2:OrgRole>
                        <ns2:ParticipatingOrg>
                            <ns2:OrgID>94021</ns2:OrgID>
                        </ns2:ParticipatingOrg>
                    </ns2:DistributionChainLink>
                </DistributionChain>
                <Request>
                    <ns2:OrderSearchFilterCriteria>
                        <ns2:FlightFilterCriteria>
                            <ns2:ArrivalFilterCriteria>
                                <ns2:ArrivalDate>2020-01-17</ns2:ArrivalDate>
                                <ns2:StationCode>AYT</ns2:StationCode>
                            </ns2:ArrivalFilterCriteria>
                            <ns2:DepFilterCriteria>
                                <ns2:DepDate>2020-01-10</ns2:DepDate>
                                <ns2:StationCode>FRA</ns2:StationCode>
                            </ns2:DepFilterCriteria>
                        </ns2:FlightFilterCriteria>
                        <ns2:PaxFilterCriteria>
                            <ns2:Individual>
                                <ns2:GivenName>John</ns2:GivenName>
                                <ns2:Surname>Doe</ns2:Surname>
                            </ns2:Individual>
                        </ns2:PaxFilterCriteria>
                    </ns2:OrderSearchFilterCriteria>
                </Request>
            </IATA_OrderListRQ>

|

.. raw:: html

   <h4>IATA_OrderListRS</h4>

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

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <ns2:IATA_OrderListRS xmlns="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersCommonTypes" xmlns:ns2="http://www.iata.org/IATA/2015/EASD/00/IATA_OffersAndOrdersMessage" xmlns:ns3="http://www.w3.org/2000/09/xmldsig#">
                <ns2:Response>
                    <MatchedOrder>
                        <Arrival>
                            <ArrivalDate>2020-01-17</ArrivalDate>
                            <StationCode>AYT</StationCode>
                        </Arrival>
                        <Dep>
                            <DepDate>2020-01-10</DepDate>
                            <StationCode>FRA</StationCode>
                        </Dep>
                        <OrderRefID>123456</OrderRefID>
                        <OrderStatusCode>OPENED</OrderStatusCode>
                        <Paxs>
                            <Pax>
                                <Individual>
                                    <GivenName>John</GivenName>
                                    <Surname>Doe</Surname>
                                </Individual>
                                <PaxID>PX1</PaxID>
                            </Pax>
                        </Paxs>
                    </MatchedOrder>
                    <MatchedOrder>
                        <Arrival>
                            <ArrivalDate>2020-01-17</ArrivalDate>
                            <StationCode>AYT</StationCode>
                        </Arrival>
                        <Dep>
                            <DepDate>2020-01-10</DepDate>
                            <StationCode>FRA</StationCode>
                        </Dep>
                        <OrderRefID>234567</OrderRefID>
                        <OrderStatusCode>CLOSED</OrderStatusCode>
                        <Paxs>
                            <Pax>
                                <Individual>
                                    <GivenName>John</GivenName>
                                    <Surname>Doe</Surname>
                                </Individual>
                                <PaxID>PX1</PaxID>
                            </Pax>
                        </Paxs>
                    </MatchedOrder>
                </ns2:Response>
                <ns2:PayloadAttributes>
                    <Timestamp>2023-10-27T06:42:09.453738051</Timestamp>
                    <TrxID>13118896-b6e0-4b70-8c35-8de83860f5b7</TrxID>
                    <VersionNumber>21.3</VersionNumber>
                </ns2:PayloadAttributes>
            </ns2:IATA_OrderListRS>

|