.. _IATA_OrderChangeRQ:

******************
IATA_OrderChangeRQ
******************

.. raw:: html

   <h3>Introduction</h3>

The IATA_OrderChangeRQ is the main message used for:

#. Adding an infinitive number of new OfferItems (flights and/or ASR/SSR) to an existing booking (use case example: outbound flight for booking with 2 passenger should be added to a booking.)
#. Deletion of a maximum of one OrderItem* (use case example: outbound flight for booking with 1 passenger should be deleted from a booking.)
#. Change of flight data if only one passenger included in booking and just one flight segment involved (use case example: 1 OrderItem must be cancelled and a new OfferItem beeing added.)

It can be used to inquire changes in a pricing step as well as actually changing the booking.

The response to this message is always an :ref:`IATA_OrderViewRS`.

(* If more than 1 OrderItem is to be removed in a transaction, the :ref:`IATA_OrderReshopRQ` must be used for this.)

.. raw:: html

   <h3>General Usage</h3>

The IATA_OrderChangeRQ can be used in two ways. In both ways the request look exactly identical, so the same generated request can be re-used for both transactions.

.. raw:: html

   <h4>Inquiry</h4>

If the request is sent to the endpoint "/order/changeInquiry", it is used in a pricing step without actually changing the booking.

The response to this request will be an IATA_OrderViewRS, that contains a view on how the booking would look like, if the desired changes were applied.

This can be used to get a final price for the desired changes, as well as possible rebooking fees.

**The booking has not been changed at this point!**

.. raw:: html

   <h4>Update</h4>

If the request is sent to the endpoint "/order/change", the changes are actually applied.

All requested items will be booked and all items, that are marked for deletion, are cancelled.

.. raw:: html

   <h3>Sample</h3>

.. raw:: html

   <h4>IATA_OrderChangeRQ</h4>

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

        .. code-block:: xml

            <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
            <IATA_OrderChangeRQ xmlns="http://www.iata.org/IATA/2015/00/2019.2/IATA_OrderChangeRQ">
              <Party>
                <Sender>
                  <EnabledSystem>
                    <SystemID>12345</SystemID>
                  </EnabledSystem>
                </Sender>
              </Party>
              <POS>2</POS>
              <Request>
                <ChangeOrder>
                  <UpdateOrderItem>
                    <AcceptOffer>
                      <SelectedOffer>
                        <OfferRefID>OF279f1cc1-7a2c-11ea-838f-410131f4e93a</OfferRefID>
                        <OwnerCode>NA</OwnerCode>
                        <SelectedOfferItem>
                          <OfferItemRefID>OFI279f1cc1-7a2c-11ea-838f-410131f4e93a1</OfferItemRefID>
                          <PaxRefID>PX1</PaxRefID>
                        </SelectedOfferItem>
                      </SelectedOffer>
                    </AcceptOffer>
                  </UpdateOrderItem>
                </ChangeOrder>
                <DataLists>
                  <ContactInfoList>
                    <ContactInfo>
                      <ContactInfoID>C1</ContactInfoID>
                      <ContactPurposeText>Primary</ContactPurposeText>
                      <EmailAddress>
                        <EmailAddressText>email@domain.com</EmailAddressText>
                      </EmailAddress>
                      <Individual>
                        <GivenName>JOHN</GivenName>
                        <IndividualID>IN1</IndividualID>
                        <MiddleName>ALEX</MiddleName>
                        <Surname>DOE</Surname>
                        <TitleName>MR</TitleName>
                      </Individual>
                      <Phone>
                        <CountryDialingCode>+49</CountryDialingCode>
                        <PhoneNumber>11111111</PhoneNumber>
                      </Phone>
                      <PostalAddress>
                        <CityName>CITY</CityName>
                        <CountryCode>DE</CountryCode>
                        <PostalCode>12345</PostalCode>
                        <StreetText>STREET 1</StreetText>
                      </PostalAddress>
                    </ContactInfo>
                  </ContactInfoList>
                  <PaxList>
                    <Pax>
                      <Individual>
                        <GenderCode>M</GenderCode>
                        <GivenName>TEST</GivenName>
                        <IndividualID>IN1</IndividualID>
                        <Surname>TESTER</Surname>
                        <TitleName>MR</TitleName>
                      </Individual>
                      <PaxID>PX1</PaxID>
                      <PTC>ADT</PTC>
                    </Pax>
                  </PaxList>
                </DataLists>
                <Order>
                  <OrderID>1234567</OrderID>
                  <OwnerCode>NA</OwnerCode>
                </Order>
              </Request>
            </IATA_OrderChangeRQ>

|