IATA_OrderChangeRQ

Introduction

The IATA_OrderChangeRQ is the main message used for:

  1. 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.)

  2. Deletion of a maximum of one OrderItem* (use case example: outbound flight for booking with 1 passenger should be deleted from a booking.)

  3. 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 IATA_OrderViewRS.

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

General Usage

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.

Inquiry

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!

Credit Card Fee

If a order change inquiry needs to be done by adding CC fee, the tag “OrderChangeParameters” must be present. If the tag “OrderChangeParameters” is not present, no CC fee will be added.

Currently only SunExpress supports this feature!

Request Order Change Parameters Part

<OrderChangeParameters>
                        <Remark>
                                <RemarkText>PAYMENT_CCFEE_BIN:::123456</RemarkText>
                        </Remark>
                        <Remark>
                                <RemarkText>PAYMENT_CCFEE_BRAND:::MC</RemarkText>
                        </Remark>
</OrderChangeParameters>

Response Fee Part

<Fee>
        <Amount CurCode="EUR">5.80</Amount>
        <DescText>Credit card fee</DescText>
        <DesigText>SURCHARGE</DesigText>
</Fee>

Update

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.

Sample

IATA_OrderChangeRQ

Show/Hide Request

<?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>