Auto Exchange and Refund

• API Information
• Sample Request
• Sample Response

Please note that this service is restricted to SabreSonicRes-based airline customers.

API Information

Target Audience

Sabre Airline Solutions

Current Version

1.5.4

Authentication

Session Token

Service Action Code

AERRQ

The Automated Exchanges and Refunds ( AER) web service prices exchanges and refunds, prices itineraries based on varying degrees of manual pricing criteria, retains the pricing result and/or fulfills the exchange or refund. Additional related functions include irregular operations such as involuntary reroute, schedule change and no coupon situations. For a Sabre hosted carrier, these functions are based in whole or in part on the information stored in the Virtual Coupon Record ( VCR) electronic ticketing database, the manually provided ticket information (if no electronic record is available), the itinerary in the Agent Assembly Area ( AAA), the fares filed in the Sabre GDS, the historical fare information and related CAT31 rules as filed with Sabre, the tables configured in the Sabre GDS such as the options table and the form number table and any override parameters that are part of the XML request. AER relies on the binary security token obtained on a prior call to SessionCreateRQ.

The AER web service uses the AER package in TPF to complete AER transactions. Generally, a transaction is priced and retained and if the price satisfies the customer, the transaction is then fulfilled. Depending on whether an exchange is requested or a refund is requested and whether the result requires additional money to be collected or a refund to be issued, different documents are generated (eg electronic ticket, refund receipt, voucher, etc.). When issuing a ticket, AER updates the AAA with the TE line for electronic tickets. When retaining a price, AER updates the AAA with the price quote record. Exchange pricing and fulfillment requires the AAA to contain the new itinerary. This may be accomplished outside of the AER web service. Refunds and exchanges require a document to exchange. Electronic documents may be referred to by document number. Manual documents require data entered in the XML request. Manual pricing requests require a AAA with new itinerary data.

The response to pricing requests include the ticketing data (if exchanging or refunding) as well as the pricing result data including the comparison data. Messages that would have come from TPF AER are also included in the response. Fulfillment request responses include the new document number as well as the pricing data. Data in the XML is limited to what's provided in the TPF data transmission record. The XML contains most of the TPF data transmission record fields.

For Ticketing to provide support to a carrier when using Ticketing web services such as MISCServicesRQ and AERRQ, the carrier needs to provide access credentials almost identical to what the carrier will use to access the web service. The ID should be robotic, contain a non-expiring password, be able to issue tickets and be present in RES (production), CERT (certification) and TSTS (integration). Recommended, but not required: ID should be created inactive in RES; ID should be given duty code Cross of Lorraine.

The ID will be used in the automated regression test suite and will be used when researching questions and problems. Once Ticketing receives the ID, Ticketing will request allocation of a TAM pool and the associated ICE security attributes for accessing the web service.

Sample Request

  <AER_RQ
   version="1.5.4"
     xmlns="http://services.sabre.com/ticketing/aer/1.0">
   <AERDetails>
    <Transaction
      Action="Exchange">
     <SubAction
      Retain="true">
      <BrandCode
      brandCarrier="JJ">YF</BrandCode>
      </SubAction>/>
    </Transaction>
    <ExchDoc>
     <Number
      PlatingCarrier="957">2162898422</Number>
     <Type/>
    </ExchDoc>
    <NewDoc>
     <Passenger
      AccountCode="ALL25" negotiatedFaresOnly="true">
      <TravelerRefNumber>1.1</TravelerRefNumber>
     </Passenger>
    </NewDoc>
   </AERDetails>
  </AER_RQ>

Sample Response

  <AER_RS
   timeStamp="2018-07-31T16:55:23"
   transactionIdentifier="DJTTZ2H2-1533036323282-9-aer" version="1.5.4"
     xmlns="http://services.sabre.com/ticketing/aer/1.0">
   <AERDetails>
    <Transaction
     Action="Exchange" NonFlight="false" PNR="IJWOTE">
     <Host
      Country="22" Currency="CLP" DecimalPlaces="0"/>
     <AAA
      Currency="CLP" DecimalPlaces="0"/>
     <Agent LNIATA="000000"
      Type="Ticket"/>
     <SubAction
     Retain="true"/>
    </Transaction>
    <ExchDoc
     AirlineVendorID="JJ" CRS="JJ" TourNum="ITUV8A4DA0">
     <Number
      CheckDigit="5" PlatingCarrier="957">2162898422</Number>
     <Type
      Database="true" Flight="true" Form="TKT"
       SubType="N"/>
     <Point>
      <Issue Date="2018-07-31"
      Time="06:12:00">
       <Location>
        <LocationCode>REV</LocationCode>
        <CountryCode>US</CountryCode>
       </Location>
      </Issue>
      <Sale>
       <LocationCode>REV</LocationCode>
       <CountryCode>US</CountryCode>
      </Sale>
      <Ticket>
       <LocationCode>REV</LocationCode>
       <CountryCode>US</CountryCode>
      </Ticket>
     </Point>
     <Passenger
      PassengerTypeCode="ADT">
      <PersonName>
       <GivenName>LIS</GivenName>
       <Surname>ALJENDRO</Surname>
      </PersonName>
     </Passenger>
     <Coupons
      Booklet="1" Flown="U" Transaction="X">
      <FlightSegment
       bookingCode="M"
        status="1">
       <FlightNumber>600</FlightNumber>
       <OperatingFlightNumber>600</OperatingFlightNumber>
       <MarketingAirline
        name="LATAM AIRLINES GR">LA</MarketingAirline>
       <OperatingAirline
         name="LATAM AIRLINES GR">LA</OperatingAirline>
       <Departure>
        <Airport
         name="SANTIAGO      SCL">SCL</Airport>
        <DateTime>2018-08-23T09:00:00</DateTime>
       </Departure>
       <Arrival>
        <Airport
       name="LOS ANGELES">LAX</Airport>
        <Time>19:00:00</Time>
       </Arrival>
      </FlightSegment>
      <PlusUp
       Amount="25000" Code="Q"/>
      <FareInfo CalcCode="05"
       FareBasisCode="MLELEH6B/DD00"
        FareComponent="1">
       <TicketDesignatorCode>DD00</TicketDesignatorCode>
       <Break
        Currency="NUC" Point="true"/>
       <NotValid
        After="2018-08-23" Before="2018-08-23"/>
       <Base
        Amount="35000" DecimalPlaces="2"/>
       <Rules Governed="LA"
        Number="523N" Tarrif="864"
       Vendor="ATP"/>
      </FareInfo>
      <Class PNR="M"
       TKT="OK"/>
      <Baggage Amount="02"
      Type="P"/>
     </Coupons>
     <Coupons Booklet="2"
      Connection="O" Flown="U" Transaction="X">
      <FlightSegment
       bookingCode="M"
        status="1">
       <FlightNumber>601</FlightNumber>
       <OperatingFlightNumber>601</OperatingFlightNumber>
       <MarketingAirline
        name="LATAM AIRLINES GR">LA</MarketingAirline>
       <OperatingAirline
         name="LATAM AIRLINES GR">LA</OperatingAirline>
       <Departure>
        <Airport
         name="LOS ANGELES">LAX</Airport>
        <DateTime>2018-09-13T21:30:00</DateTime>
       </Departure>
       <Arrival>
        <Airport
       name="SANTIAGO      SCL">SCL</Airport>
        <Time>14:50:00</Time>
       </Arrival>
      </FlightSegment>
      <PlusUp
       Amount="25000" Code="Q"/>
      <FareInfo CalcCode="06"
       FareBasisCode="MLELEH6B/DD00"
        FareComponent="2">
       <TicketDesignatorCode>DD00</TicketDesignatorCode>
       <Break
        Currency="NUC" Point="true"/>
       <NotValid
        After="2018-09-13" Before="2018-09-13"/>
       <Base
        Amount="35000" DecimalPlaces="2"/>
       <Rules Governed="LA"
        Number="523N" Tarrif="864"
       Vendor="ATP"/>
      </FareInfo>
      <Class PNR="M"
       TKT="OK"/>
      <Baggage Amount="02"
       Type="P"/>
     </Coupons>
     <Fare>
      <BaseFare
       CurrencyCode="USD" DecimalPlaces="2" Rate="1.000000000"
       Raw="1200.00">1200.00</BaseFare>
      <NUC Amount="1200.00"
       DecimalPlaces="2"/>
      <EquivFare>0</EquivFare>
      <TotalFare
       CurrencyCode="USD" DecimalPlaces="2"
       Raw="1293.31">1293.31</TotalFare>
      <UnstructuredFareCalc>SCL LA LAX Q250.00 350.00LA SCL Q250.00 350.00NUC1200.00END ROE1.00 XFLAX4.5</UnstructuredFareCalc>
      <NonRefundableFare
       CurrencyCode="USD" DecimalPlaces="2"
        Raw="1200.00">1200.00</NonRefundableFare>
      <AERTaxes>
       <Tax
        Amount="36.60" CurrencyCode="USD" DecimalPlaces="2" Raw="36.60"
        TaxCode="US2"/>
       <Tax Amount="5.60" CurrencyCode="USD"
        DecimalPlaces="2" Paid="P" Raw="5.60" TaxCode="AY"/>
       <Tax
        Amount="5.65" CurrencyCode="USD" DecimalPlaces="2" Raw="5.65"
        TaxCode="YC"/>
       <Tax Amount="7.00" CurrencyCode="USD"
        DecimalPlaces="2" Paid="P" Raw="7.00"
        TaxCode="XY2"/>
       <Tax Amount="3.96" CurrencyCode="USD"
        DecimalPlaces="2" Raw="3.96" TaxCode="XA"/>
       <Tax
        Amount="30.00" CurrencyCode="USD" DecimalPlaces="2" Raw="30.00"
        TaxCode="ZQ"/>
       <Tax Amount="4.50" CurrencyCode="USD"
        DecimalPlaces="2" Raw="4.50" TaxCode="XF"/>
       <Bucket1
        Amount="36.60" DecimalPlaces="2" Raw="36.60"
        TaxCode="US"/>
       <Bucket2 Amount="5.60" DecimalPlaces="2"
        Raw="5.60" TaxCode="AY"/>
       <Bucket3 Amount="51.11"
        DecimalPlaces="2" Raw="51.11"
        TaxCode="XT"/>
       <PsgrFacilityCharge Amount="4.50"
        CurrencyCode="USD" DecimalPlaces="2" Location="LAX"
       Raw="4.50"/>
      </AERTaxes>
      <Modifiers
       appliedDiscount="false"
       appliedTicketDesignator="false"/>
     </Fare>
     <Pay>
      <Cash/>
      <PaymentAmount
       CurrencyCode="USD"
     DecimalPlaces="2">1293.31</PaymentAmount>
     </Pay>
    </ExchDoc>
    <NewDoc
     OverrideValCarrier="LA" Purchase="2018-07-31"
      Tour="UV8A4DA0">
      <!-- Account code is being returned -->
     <Passenger AccountCode="ALL25"
      CorporateID="false"
       PassengerTypeCode="ADT">
      <PersonName>
       <GivenName>LIS</GivenName>
       <Surname>ALJENDRO</Surname>
      </PersonName>
      <TravelerRefNumber
      surnameRefNumber="1">1.1</TravelerRefNumber>
     </Passenger>
     <Reissue>
      <LocationCode>SCL</LocationCode>
      <CountryCode>CL</CountryCode>
     </Reissue>
     <PointOfSale>
      <LocationCode>REV</LocationCode>
      <CountryCode>US</CountryCode>
     </PointOfSale>
     <PointOfTicket>
      <LocationCode>REV</LocationCode>
      <CountryCode>US</CountryCode>
     </PointOfTicket>
     <Entitlement
      Booking="2018-07-31T06:10:00" Flown="U"
       StatusCode="HK">
      <FlightSegment bookingCode="M"
        e_TicketEligibility="Eligible">
       <FlightNumber>600</FlightNumber>
       <OperatingFlightNumber>600</OperatingFlightNumber>
       <MarketingAirline
        name="LATAM AIRLINES GROUP">LA</MarketingAirline>
       <OperatingAirline
        name="LATAM AIRLINES GROUP">LA</OperatingAirline>
       <Departure
        Connection="O" Currency="CLP"
         DecimalPlaces="0">
        <Airport country="CL"
        name="SANTIAGO      SCL">SCL</Airport>
        <DateTime>2018-08-23T00:00:00</DateTime>
       </Departure>
       <Arrival
        Connection="O" Currency="USD"
         DecimalPlaces="2">
        <Airport country="US"
        name="LOS ANGELES">LAX</Airport>
        <DateTime>2018-08-23T00:00:00</DateTime>
       </Arrival>
       <PNR
        ID="4" Number="1"/>
      </FlightSegment>
      <PlusUp
       Amount="25000" Code="Q"/>
      <FareInfo
       FareBasisCode="MLELEH6B/DD00" GlobalIndicatorCode="WH"
        SideTrip="0">
       <TicketDesignatorCode>DD00</TicketDesignatorCode>
       <Break
        Point="true"/>
       <Component Amount="35000"
        FareBasis="MLELEH6B/DD00" GlobalDirection="WH" Index="1"
         TKTDesignator="DD00">
        <Indicators
         RoundTrip="true"/>
        <MarketCharged City1="SCL"
         City2="LAX"/>
        <GoverningCXR
        Joint1="LA"/>
       </Component>
       <NotValid
        After="2018-08-23" Before="2018-08-23"/>
       <Base
        Amount="35000"
       DecimalPlaces="2"/>
       <BrandDescription>ECONOMY FREEDOM</BrandDescription>
       <BrandCode 
       ProgramCode="EYO" ProgramDescription="Default" brandCarrier="JJ">YF</BrandCode>
      </FareInfo>
      <Class
       PNR="M"/>
      <Baggage Amount="02"
      Type="P"/>
     </Entitlement>
     <Entitlement
      Booking="2018-07-31T06:11:00" Flown="U"
       StatusCode="HK">
      <FlightSegment bookingCode="M"
        e_TicketEligibility="Eligible">
       <FlightNumber>601</FlightNumber>
       <OperatingFlightNumber>601</OperatingFlightNumber>
       <MarketingAirline
        name="LATAM AIRLINES GROUP">LA</MarketingAirline>
       <OperatingAirline
        name="LATAM AIRLINES GROUP">LA</OperatingAirline>
       <Departure
        Connection="O" Currency="USD"
         DecimalPlaces="2">
        <Airport country="US"
        name="LOS ANGELES">LAX</Airport>
        <DateTime>2018-09-13T00:00:00</DateTime>
       </Departure>
       <Arrival
        Connection="O" Currency="CLP"
         DecimalPlaces="0">
        <Airport country="CL"
        name="SANTIAGO      SCL">SCL</Airport>
        <DateTime>2018-09-14T00:00:00</DateTime>
       </Arrival>
       <PNR
        ID="2" Number="2"/>
      </FlightSegment>
      <PlusUp
       Amount="25000" Code="Q"/>
      <FareInfo
       FareBasisCode="MLELEH6B/DD00" GlobalIndicatorCode="WH"
        SideTrip="0">
       <TicketDesignatorCode>DD00</TicketDesignatorCode>
       <Break
        Point="true"/>
       <Component Amount="35000"
        FareBasis="MLELEH6B/DD00" GlobalDirection="WH" Index="2"
         TKTDesignator="DD00">
        <Indicators
         RoundTrip="true"/>
        <MarketCharged City1="LAX"
         City2="SCL"/>
        <GoverningCXR
        Joint1="LA"/>
       </Component>
       <NotValid
        After="2018-09-13" Before="2018-09-13"/>
       <Base
        Amount="35000"
       DecimalPlaces="2"/>
      </FareInfo>
      <Class
       PNR="M"/>
      <Baggage Amount="02"
      Type="P"/>
     </Entitlement>
     <Fare ExchPrice="false"
      ExchReissuePriceTypeDate="2018-07-31"
      ExchReissuePriceTypeTime="07:12:00" ReissuePrice="true"
       cat31or33="true">
      <BaseFare CurrencyCode="USD"
       DecimalPlaces="2"
       Raw="1200.00">1200.00</BaseFare>
      <EquivFare>0</EquivFare>
      <Fees
       Usage="N"/>
      <TotalFare CurrencyCode="USD" DecimalPlaces="2"
       Raw="1293.31">1293.31</TotalFare>
      <UnstructuredFareCalc
        Currency="NUC">SCL LA LAX Q250.00 350.00LA SCL Q250.00 350.00NUC1200.00END ROE1.00 XFLAX4.5</UnstructuredFareCalc>
      <AERTaxes>
       <Tax
        Amount="30.00" CurrencyCode="USD" DecimalPlaces="2" Raw="30.00"
        TaxCode="ZQ"/>
       <Tax Amount="36.60" CurrencyCode="USD"
        DecimalPlaces="2" Raw="36.60" TaxCode="US2"/>
       <Tax
        Amount="5.65" CurrencyCode="USD" DecimalPlaces="2" Raw="5.65"
        TaxCode="YC"/>
       <Tax Amount="7.00" CurrencyCode="USD"
        DecimalPlaces="2" Raw="7.00" TaxCode="XY2"
        TaxExemptInd="true"/>
       <Tax Amount="3.96"
        CurrencyCode="USD" DecimalPlaces="2" Raw="3.96" TaxCode="XA"
        TaxExemptInd="true"/>
       <Tax Amount="5.60"
        CurrencyCode="USD" DecimalPlaces="2" Raw="5.60" TaxCode="AY"
        TaxExemptInd="true"/>
       <Tax Amount="4.50"
        CurrencyCode="USD" DecimalPlaces="2" Raw="4.50"
        TaxCode="XF"/>
       <Bucket1 Amount="30.00" DecimalPlaces="2"
        Raw="30.00" TaxCode="ZQ"/>
       <Bucket2 Amount="36.60"
        DecimalPlaces="2" Raw="36.60" TaxCode="US"/>
       <Bucket3
        Amount="26.71" DecimalPlaces="2" Raw="26.71"
        TaxCode="XT"/>
       <PsgrFacilityCharge Amount="4.50"
        CurrencyCode="USD" Location="LAX"
       Raw="4.50"/>
      </AERTaxes>
      <Modifiers
       appliedDiscount="false"
      appliedTicketDesignator="true"/>
     </Fare>
     <BaggageDisclosure>BAG ALLOWANCE     -SCLLAX-02P/LA/EACH PIECE UP TO 50 POUNDS/23 KILOGRAMS BAG ALLOWANCE     -LAXSCL-02P/LA/EACH PIECE UP TO 50 POUNDS/23 KILOGRAMS CARRY ON ALLOWANCE SCLLAX LAXSCL-01P/08KG/LA 01/UP TO 18 POUNDS/8 KILOGRAMS AND UP TO 45 LINEAR INCHES/115 L INEAR CENTIMETERS CARRY ON CHARGES SCLLAX LAXSCL-LA-CARRY ON FEES UNKNOWN-CONTACT CARRIER ADDITIONAL ALLOWANCES AND/OR DISCOUNTS MAY APPLY DEPENDING ON FLYER-SPECIFIC FACTORS /E.G. FREQUENT FLYER STATUS/MILITARY/ CREDIT CARD FORM OF PAYMENT/EARLY PURCHASE OVER INTERNET,ETC./</BaggageDisclosure>
    </NewDoc>
    <Comparison>
     <Summary
      CurrencyType="E"
        ticketUse="true">
      <Differences>
       <Base
        Raw="0.00">0.00</Base>
       <TotalTax CurrencyCode="USD"
        DecimalPlaces="2" Raw="0.00">0.00</TotalTax>
       <SubTotal
        CurrencyCode="USD" DecimalPlaces="2"
        Raw="0.00">0.00</SubTotal>
       <GrandTotal CurrencyCode="USD"
        DecimalPlaces="2"
        Raw="0.00">0.00</GrandTotal>
      </Differences>
      <Fees>
       <Fee
        CurrencyCode="USD" FeeCode="CHG" Raw="N/A" Usage="N"
      waiverSource="AGENT">0</Fee>
      </Fees>
     </Summary>
     <Summary
        CurrencyType="R">
      <Differences>
       <Base
        Raw="0.00">0.00</Base>
       <CurrencyFare CurrencyCode="CLP"
        DecimalPlaces="0" Raw="0">0</CurrencyFare>
       <TotalTax
        CurrencyCode="CLP" Raw="0">0</TotalTax>
       <SubTotal
        CurrencyCode="CLP" DecimalPlaces="0"
        Raw="0">0</SubTotal>
       <GrandTotal CurrencyCode="CLP"
        DecimalPlaces="0"
        Raw="0">0</GrandTotal>
      </Differences>
      <Fees>
       <Fee
        CurrencyCode="CLP" FeeCode="CHG" Raw="N/A" Usage="N"
     waiverSource="AGENT">0</Fee>
      </Fees>
     </Summary>
    </Comparison>
    <Message
     Type="D">LAST DATE TO PURCHASE 03AUG18 - 1346</Message>
    <Message
     Type="D">TRANSACTION RETAINED</Message>
    <Message
     Type="S">USD1200.00 NONREFUNDABLE</Message>
    <Message
     Type="S">NONREF/CHG FEE APPLIES</Message>
    <Message
     Type="W">PRIVATE FARE APPLIED - CHECK RULES FOR CORRECT TICKETING</Message>
    <Message Type="W">VALIDATING CARRIER SPECIFIED - LA</Message>
   </AERDetails>
  </AER_RS>

If you are a Sabre customer currently using Sabre APIs in production, access  Resources