ExchangeTicket

ExchangeTicket

The ticket exchange

ExchangeTicket_2_2

The latest request version, the differences are only in the response in the ancillary services block from Book_2_2 request.

Request

Format Description
  • BookID - ID of the booking with passengers. Data type - 64-bit integer.
  • FlightID - ID of the flight on which the exchange will take place. Data type - string.
  • Passengers - numbers of passengers in the booking whose tickets are required to be exchanged. Data type - array.
  • Passengers.Ref - passenger number in the booking. Data type - 32-bit integer.
  • AutoRefundForEmdA - flag for automatic return of additional services. Works only for Amadeus and MixvelPlatform. Data type - boolean.
Sample
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:avia="http://ws-ibe.com/Avia" xmlns:stl="http://ws-ibe.com/STL" xmlns:stl1="http://websky.travel/STL" xmlns:avia1="http://websky.travel/Avia" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soapenv:Header/>
   <soapenv:Body>
      <avia:ExchangeTicket_2_2>
         <avia:Request>
            <stl:Requisites>
               <stl:AuthToken>token</stl:AuthToken>
            </stl:Requisites>
            <stl:UserID>11111</stl:UserID>
            <stl:RequestType>P</stl:RequestType>
            <stl:RequestBody>
               <avia:BookID>22222</avia:BookID>
               <avia:FlightID>1100016795000001</avia:FlightID>
               <avia:Passengers>
                  <stl:Ref>1</stl:Ref>
               </avia:Passengers>
               <avia:AutoRefundForEmdA>false</avia:AutoRefundForEmdA>
               <avia:DataItems xsi:nil="true"/>
               <avia:Traveller xsi:nil="true"/>
            </stl:RequestBody>
         </avia:Request>
      </avia:ExchangeTicket_2_2>
   </soapenv:Body>
</soapenv:Envelope>

Response

If there is a partial exchange, the booking will be divided into two: the first (with the old ID) will contain passengers whose tickets are not exchanged; The second booking (with a new ID) will contain passengers whose tickets are exchanged.

Format Description
  • BookIDWithNotExchangedTickets - ID of the booking with passengers whose tickets have not been exchanged. Data type - 64-bit integer.
  • BookWithExchangedTickets - booking with passengers whose tickets have been exchanged.
Sample
<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <ExchangeTicketResponse xmlns="http://ws-ibe.com/Avia">
      <ExchangeTicketResult xmlns:a="http://ws-ibe.com/STL" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:RequestID>11111111111</a:RequestID>
        <a:ResponseBody>
          <BookWithExchangedTickets>
            <a:ID>22222</a:ID>
            <a:OwnerID>30712</a:OwnerID>
            <a:DateInfo>
              <a:Created>2017-08-31 12:17:02 +02:00</a:Created>
              <a:LastUpdate>2017-08-31 14:06:21 +02:00</a:LastUpdate>
              <a:Ticketed>2017-08-31 12:25:06 +02:00</a:Ticketed>
            </a:DateInfo>
            <a:PossibleActions>
              <a:Action>Get</a:Action>
              <a:Action>Update</a:Action>
              <a:Action>GetHistory</a:Action>
              <a:Action>Modify</a:Action>
              <a:Action>Void</a:Action>
              <a:Action>GetPNRTerminalView</a:Action>
              <a:Action>Exchange</a:Action>
              <a:Action>Refund</a:Action>
              <a:Action>ReleaseSeat</a:Action>
            </a:PossibleActions>
            <a:Travellers>
              <a:Traveller>
                <a:ID>1</a:ID>
                <a:IDInPNR>2</a:IDInPNR>
                <a:Type>ADT</a:Type>
                <a:NamePrefix>MR</a:NamePrefix>
                <a:Name>ALEX</a:Name>
                <a:LastName>BROWN</a:LastName>
                <a:DateOfBirth>19.02.1954</a:DateOfBirth>
                <a:Nationality>DE</a:Nationality>
                <a:Gender>M</a:Gender>
              </a:Traveller>
            </a:Travellers>
            <a:Services>
              <a:Service i:type="a:FlightService">
                <a:ID>0</a:ID>
                <a:SupplierID>ABCDEF</a:SupplierID>
                <a:Status>Ticketed</a:Status>
                <a:SubStatus/>
                <a:Type>Regular</a:Type>
                <a:DirectionType>RT</a:DirectionType>
                <a:Segments>
                  <a:FlightSegment>
                    <a:ID>0</a:ID>
                    <a:DepatureAirport>
                      <a:Code>BCN</a:Code>
                      <a:UTC>5</a:UTC>
                    </a:DepatureAirport>
                    <a:ArrivalAirport>
                      <a:Code>CDG</a:Code>
                      <a:CityCode>PAR</a:CityCode>
                      <a:UTC>2</a:UTC>
                    </a:ArrivalAirport>
                    <a:DepatureDateTime>2017-09-04T07:35:00</a:DepatureDateTime>
                    <a:ArrivalDateTime>2017-09-04T07:55:00</a:ArrivalDateTime>
                    <a:FlightNumber>6754</a:FlightNumber>
                    <a:AircraftType>73H</a:AircraftType>
                    <a:OperatingAirline>BA</a:OperatingAirline>
                    <a:MarketingAirline>BA</a:MarketingAirline>
                    <a:ETicket>true</a:ETicket>
                    <a:BookingClassCode>N</a:BookingClassCode>
                    <a:Status>Confirmed</a:Status>
                    <a:StatusCode>HK</a:StatusCode>
                    <a:SupplierRef>ABDCEF</a:SupplierRef>
                    <a:RequestedSegment>0</a:RequestedSegment>
                  </a:FlightSegment>
                  <a:FlightSegment>
                    <a:ID>1</a:ID>
                    <a:DepatureAirport>
                      <a:Code>CDG</a:Code>
                      <a:CityCode>PAR</a:CityCode>
                      <a:UTC>5</a:UTC>
                    </a:DepatureAirport>
                    <a:ArrivalAirport>
                      <a:Code>BCN</a:Code>
                      <a:UTC>2</a:UTC>
                    </a:ArrivalAirport>
                    <a:DepatureDateTime>2017-09-12T01:00:00</a:DepatureDateTime>
                    <a:ArrivalDateTime>2017-09-12T05:05:00</a:ArrivalDateTime>
                    <a:FlightNumber>1244</a:FlightNumber>
                    <a:AircraftType>32A</a:AircraftType>
                    <a:OperatingAirline>BA</a:OperatingAirline>
                    <a:MarketingAirline>BA</a:MarketingAirline>
                    <a:ETicket>true</a:ETicket>
                    <a:BookingClassCode>N</a:BookingClassCode>
                    <a:Status>Confirmed</a:Status>
                    <a:StatusCode>HK</a:StatusCode>
                    <a:SupplierRef>ABCFEF</a:SupplierRef>
                    <a:RequestedSegment>1</a:RequestedSegment>
                  </a:FlightSegment>
                </a:Segments>
              </a:Service>
            </a:Services>
            <a:ProcessingServices>
              <a:Service>
                <a:ID>1</a:ID>
                <a:Type>Exchange</a:Type>
                <a:Status>Executed</a:Status>
                <a:AdditionalInfo>REISSUE;TAXPENF</a:AdditionalInfo>
              </a:Service>
            </a:ProcessingServices>
            <a:Price>
              <a:TotalPrice>
                <a:Amount>125</a:Amount>
                <a:Currency>EUR</a:Currency>
              </a:TotalPrice>
              <a:PriceBreakdown>
                <a:PricePart>
                  <a:ServiceRef>
                    <a:Ref>0</a:Ref>
                  </a:ServiceRef>
                  <a:TotalPrice>
                    <a:Amount>105</a:Amount>
                    <a:Currency>EUR</a:Currency>
                  </a:TotalPrice>
                  <a:ValidatingCompany>ZZ</a:ValidatingCompany>
                  <a:Refundable>Refundable</a:Refundable>
                  <a:PassengerTypePriceBreakdown>
                    <a:PassengerTypePrice>
                      <a:TravellerRef>
                        <a:Ref>1</a:Ref>
                      </a:TravellerRef>
                      <a:PricingType>ADT</a:PricingType>
                      <a:BaseFare>
                        <a:Amount>72</a:Amount>
                        <a:Currency>EUR</a:Currency>
                      </a:BaseFare>
                      <a:EquiveFare>
                        <a:Amount>72</a:Amount>
                        <a:Currency>EUR</a:Currency>
                      </a:EquiveFare>
                      <a:TotalFare>
                        <a:Amount>105</a:Amount>
                        <a:Currency>EUR</a:Currency>
                      </a:TotalFare>
                      <a:Taxes>
                        <a:Tax>
                          <a:Amount>17</a:Amount>
                          <a:Currency>EUR</a:Currency>
                          <a:TaxCode>RI</a:TaxCode>
                          <a:Type>PD</a:Type>
                        </a:Tax>
                        <a:Tax>
                          <a:Amount>10</a:Amount>
                          <a:Currency>EUR</a:Currency>
                          <a:TaxCode>RI</a:TaxCode>
                          <a:Type>PD</a:Type>
                        </a:Tax>
                        <a:Tax>
                          <a:Amount>300</a:Amount>
                          <a:Currency>EUR</a:Currency>
                          <a:TaxCode>YQ</a:TaxCode>
                          <a:Type>PD</a:Type>
                        </a:Tax>
                      </a:Taxes>
                      <a:Tariffs>
                        <a:Tariff i:type="a:AirTariff">
                          <a:Code>NVUR</a:Code>
                          <a:Type>Public</a:Type>
                          <a:ClassOfService>Economy</a:ClassOfService>
                          <a:BookingClassCode>N</a:BookingClassCode>
                          <a:SegmentID>0</a:SegmentID>
                          <a:FreeBaggage>
                            <a:Value>1</a:Value>
                            <a:Measure>Pieces</a:Measure>
                          </a:FreeBaggage>
                          <a:FareFamilyDescID>0</a:FareFamilyDescID>
                          <a:FareFamilyCode>ES</a:FareFamilyCode>
                        </a:Tariff>
                        <a:Tariff i:type="a:AirTariff">
                          <a:Code>NVUR</a:Code>
                          <a:Type>Public</a:Type>
                          <a:ClassOfService>Economy</a:ClassOfService>
                          <a:BookingClassCode>N</a:BookingClassCode>
                          <a:SegmentID>1</a:SegmentID>
                          <a:FreeBaggage>
                            <a:Value>1</a:Value>
                            <a:Measure>Pieces</a:Measure>
                          </a:FreeBaggage>
                          <a:FareFamilyDescID>0</a:FareFamilyDescID>
                          <a:FareFamilyCode>ES</a:FareFamilyCode>
                        </a:Tariff>
                      </a:Tariffs>
                      <a:FareCalc>Text</a:FareCalc>
                    </a:PassengerTypePrice>
                  </a:PassengerTypePriceBreakdown>
                </a:PricePart>
                <a:PricePart>
                  <a:ServiceRef>
                    <a:Ref>1</a:Ref>
                  </a:ServiceRef>
                  <a:TotalPrice>
                    <a:Amount>200</a:Amount>
                    <a:Currency>EUR</a:Currency>
                  </a:TotalPrice>
                  <a:Refundable>Unknown</a:Refundable>
                </a:PricePart>
              </a:PriceBreakdown>
              <a:FareFamiliesDescriptions />
            </a:Price>
            <a:DataItems>
              <a:DataItem>
                <a:ID>0</a:ID>
                <a:Type>SourceInfo</a:Type>
                <a:SourceInfo>
                  <a:ID>386632</a:ID>
                  <a:BookingSupplierAgencyID>AAZZCC</a:BookingSupplierAgencyID>
                  <a:TicketingSupplierAgencyID>AAZZCC</a:TicketingSupplierAgencyID>
                  <a:Supplier>Amadeus</a:Supplier>
                  <a:Environment>PROD</a:Environment>
                </a:SourceInfo>
              </a:DataItem>
              <a:DataItem>
                <a:ID>1</a:ID>
                <a:Type>TL</a:Type>
                <a:TimeLimits>
                  <a:EffectiveTimeLimit>2017-09-01 23:59:00 +02:00</a:EffectiveTimeLimit>
                  <a:PriceTimeLimit>2017-09-01 23:59:00 +02:00</a:PriceTimeLimit>
                  <a:AgencyTimeLimit>2017-09-01 23:57:00 +02:00</a:AgencyTimeLimit>
                </a:TimeLimits>
              </a:DataItem>
              <a:DataItem>
                <a:ID>2</a:ID>
                <a:TravellerRef>
                  <a:Ref>1</a:Ref>
                </a:TravellerRef>
                <a:Type>ED</a:Type>
                <a:ElectronicDocument>
                  <a:Number>5555707903620</a:Number>
                  <a:Status>Active</a:Status>
                  <a:ServiceType>Flight</a:ServiceType>
                  <a:VATBreakdown>
                    <a:Tariff>
                      <a:Amount>65.363636363636</a:Amount>
                      <a:Currency>EUR</a:Currency>
                    </a:Tariff>
                    <a:Taxes>
                      <a:Amount>27.727272727273</a:Amount>
                      <a:Currency>EUR</a:Currency>
                    </a:Taxes>
                    <a:Total>
                      <a:Amount>92.090909090909</a:Amount>
                      <a:Currency>EUR</a:Currency>
                    </a:Total>
                  </a:VATBreakdown>
                </a:ElectronicDocument>
              </a:DataItem>
              <a:DataItem>
                <a:ID>3</a:ID>
                <a:TravellerRef>
                  <a:Ref>1</a:Ref>
                </a:TravellerRef>
                <a:Type>IDDocument</a:Type>
                <a:Document>
                  <a:Type>InternationalPassport</a:Type>
                  <a:Number>C8W83EEE1</a:Number>
                  <a:IssueCountryCode>DE</a:IssueCountryCode>
                  <a:ElapsedTime>31.08.2022</a:ElapsedTime>
                  <a:AddedAsDOCS>true</a:AddedAsDOCS>
                </a:Document>
              </a:DataItem>
            </a:DataItems>
          </BookWithExchangedTickets>
        </a:ResponseBody>
      </ExchangeTicketResult>
    </ExchangeTicketResponse>
  </s:Body>
</s:Envelope>