GetExchangeVariants

GetExchangeVariants

Getting flights (exchange variants) with information about the return penalty and the difference in price with the current flight booking.

Request

Format Description
  • BookID - ID of the booking with passengers. Data type - 64-bit integer.
  • Passengers - numbers of passengers whose tickets are needed to be exchanged in the booking. Data type - array.
  • Passengers.Ref - passenger number in the booking. Data type - 32-bit integer.
  • RequestedFlightInfo - similar to the RequestedFlightInfo parameter from the Search request.
  • Involuntary - attribute of the involuntary exchange (optional). Data type - bool.

To exchange a part of the segments, for required flight legs you need to indicate the IDs (RequestedFlightInfo.ODPair.ID) of flight legs from the booking which are needed to be exchanged.

To exchange all segments for a completely new flight, you do not need to indicate any flight leg IDs.

  • Restrictions - similar to the Restrictions parameter from the Search request.
Sample
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://nemo-ibe.com/STL" xmlns:ns2="http://nemo-ibe.com/Avia">
  <SOAP-ENV:Body>
    <ns2:GetExchangeVariants>
      <ns2:Request>
        <ns1:Requisites>
          <stl:AuthToken>token010203D</stl:AuthToken>
        </ns1:Requisites>
        <ns1:UserID>100</ns1:UserID>
        <ns1:RequestBody>
          <ns2:BookID>288467</ns2:BookID>
          <ns2:Passengers>
            <ns1:Ref>1</ns1:Ref>
          </ns2:Passengers>
          <ns2:RequestedFlightInfo>
            <ns2:Direct>false</ns2:Direct>
            <ns2:AroundDates>0</ns2:AroundDates>
            <ns2:ODPairs>
              <ns2:ODPair>
                <ns2:DepatureDateTime>2017-03-10T00:00:00</ns2:DepatureDateTime>
                <ns2:DepaturePoint>
                  <ns2:Code>HEL</ns2:Code>
                  <ns2:IsCity>false</ns2:IsCity>
                </ns2:DepaturePoint>
                <ns2:ArrivalPoint>
                  <ns2:Code>MOW</ns2:Code>
                  <ns2:IsCity>true</ns2:IsCity>
                </ns2:ArrivalPoint>
              </ns2:ODPair>
              <ns2:ODPair>
                <ns2:DepatureDateTime>2017-03-17T00:00:00</ns2:DepatureDateTime>
                <ns2:DepaturePoint>
                  <ns2:Code>MOW</ns2:Code>
                  <ns2:IsCity>true</ns2:IsCity>
                </ns2:DepaturePoint>
                <ns2:ArrivalPoint>
                  <ns2:Code>HEL</ns2:Code>
                  <ns2:IsCity>false</ns2:IsCity>
                </ns2:ArrivalPoint>
              </ns2:ODPair>
            </ns2:ODPairs>
          </ns2:RequestedFlightInfo>
          <ns2:Restrictions>
            <ns2:ClassPreference>
              <ns2:ClassOfService>Business</ns2:ClassOfService>
              <ns2:ClassOfService>PremiumEconomy</ns2:ClassOfService>
              <ns2:ClassOfService>First</ns2:ClassOfService>
            </ns2:ClassPreference>
            <ns2:ResultsGrouping>None</ns2:ResultsGrouping>
            <ns2:SourcePreference>
              <ns2:Source>29782</ns2:Source>
            </ns2:SourcePreference>
          </ns2:Restrictions>
          <ns2:Involuntary>false</ns2:Involuntary>
        </ns1:RequestBody>
      </ns2:Request>
    </ns2:GetExchangeVariants>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response

Format Description
  • PlaneFlights - similar to the PlaneFlights parameter from the Search response.
  • SimpleGroupedFlights - similar to the SimpleGroupedFlights parameter from the Search response.
  • ServicesToRefund - container with infromation about ancillaries. Data type - complex.
  • ServicesToRefund.ID - additional service identifier. Data type - integer.
Sample
<?xml version="1.0"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Body>
    <GetExchangeVariantsResponse xmlns="http://nemo-ibe.com/Avia">
      <GetExchangeVariantsResult xmlns:a="http://nemo-ibe.com/STL" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:RequestID>1138603714</a:RequestID>
        <a:ResponseBody>
          <PlaneFlights>
            <Flight>
              <a:ID>1138603714000000</a:ID>
              <SourceID>29782</SourceID>
              <TypeInfo>
                <Type>Regular</Type>
                <DirectionType>OW</DirectionType>
              </TypeInfo>
              <Segments>
                <Segment>
                  <a:ID>1</a:ID>
                  <DepAirp>
                    <AirportCode>HEL</AirportCode>
                    <CityCode>HEL</CityCode>
                    <UTC>2</UTC>
                    <Terminal>2</Terminal>
                  </DepAirp>
                  <ArrAirp>
                    <AirportCode>SVO</AirportCode>
                    <CityCode>MOW</CityCode>
                    <UTC>3</UTC>
                    <Terminal>D</Terminal>
                  </ArrAirp>
                  <FlightNumber>6843</FlightNumber>
                  <OpAirline>SU</OpAirline>
                  <MarkAirline>AY</MarkAirline>
                  <AircraftType>320</AircraftType>
                  <DepDateTime>2017-03-10T21:10:00</DepDateTime>
                  <ArrDateTime>2017-03-10T23:45:00</ArrDateTime>
                  <BookingClass>
                    <BaseClass>Business</BaseClass>
                    <BookingClassCode>I</BookingClassCode>
                    <FreeSeatCount>9</FreeSeatCount>
                  </BookingClass>
                  <ETicket>true</ETicket>
                  <RequestedSegment>0</RequestedSegment>
                </Segment>
                <Segment>
                  <a:ID>2</a:ID>
                  <DepAirp>
                    <AirportCode>SVO</AirportCode>
                    <CityCode>MOW</CityCode>
                    <UTC>3</UTC>
                    <Terminal>D</Terminal>
                  </DepAirp>
                  <ArrAirp>
                    <AirportCode>HEL</AirportCode>
                    <CityCode>HEL</CityCode>
                    <UTC>2</UTC>
                    <Terminal>2</Terminal>
                  </ArrAirp>
                  <FlightNumber>154</FlightNumber>
                  <OpAirline>AY</OpAirline>
                  <MarkAirline>AY</MarkAirline>
                  <AircraftType>319</AircraftType>
                  <DepDateTime>2017-03-17T12:50:00</DepDateTime>
                  <ArrDateTime>2017-03-17T13:30:00</ArrDateTime>
                  <BookingClass>
                    <BaseClass>Business</BaseClass>
                    <BookingClassCode>I</BookingClassCode>
                    <FreeSeatCount>8</FreeSeatCount>
                  </BookingClass>
                  <ETicket>true</ETicket>
                  <RequestedSegment>1</RequestedSegment>
                </Segment>
              </Segments>
              <PriceInfo>
                <Price>
                  <a:ID>1</a:ID>
                  <ValidatingCompany>AY</ValidatingCompany>
                  <Refundable>Refundable</Refundable>
                  <PrivateFareInd>false</PrivateFareInd>
                  <TicketTimeLimit>2017-03-10T22:10:00</TicketTimeLimit>
                  <PassengerFares>
                    <PassengerFare>
                      <Type>ADT</Type>
                      <Quantity>1</Quantity>
                      <BaseFare>
                        <a:Amount>256997</a:Amount>
                        <a:Currency>KZT</a:Currency>
                      </BaseFare>
                      <EquiveFare>
                        <a:Amount>256997</a:Amount>
                        <a:Currency>KZT</a:Currency>
                      </EquiveFare>
                      <TotalFare>
                        <a:Amount>302686</a:Amount>
                        <a:Currency>KZT</a:Currency>
                      </TotalFare>
                      <Taxes>
                        <Tax>
                          <a:Amount>45689</a:Amount>
                          <a:Currency>KZT</a:Currency>
                          <TaxCode>XT</TaxCode>
                        </Tax>
                      </Taxes>
                      <Tariffs>
                        <Tariff>
                          <Code>IBU2FI</Code>
                          <Type>Public</Type>
                          <SegNum>1</SegNum>
                        </Tariff>
                        <Tariff>
                          <Code>IBU2FI</Code>
                          <Type>Public</Type>
                          <SegNum>2</SegNum>
                        </Tariff>
                      </Tariffs>
                      <ExchangePriceInfo>
                        <AirlinePenalty>
                          <a:Amount>0</a:Amount>
                          <a:Currency>KZT</a:Currency>
                        </AirlinePenalty>
                        <FlightPriceDifference>
                          <a:Amount>0</a:Amount>
                          <a:Currency>KZT</a:Currency>
                        </FlightPriceDifference>
                      </ExchangePriceInfo>
                    </PassengerFare>
                  </PassengerFares>
                </Price>
              </PriceInfo>
            </Flight>
            <Flight>
              <a:ID>1138603714000001</a:ID>
              <SourceID>29782</SourceID>
              <TypeInfo>
                <Type>Regular</Type>
                <DirectionType>OW</DirectionType>
              </TypeInfo>
              <Segments>
                <Segment>
                  <a:ID>1</a:ID>
                  <DepAirp>
                    <AirportCode>HEL</AirportCode>
                    <CityCode>HEL</CityCode>
                    <UTC>2</UTC>
                    <Terminal>2</Terminal>
                  </DepAirp>
                  <ArrAirp>
                    <AirportCode>SVO</AirportCode>
                    <CityCode>MOW</CityCode>
                    <UTC>3</UTC>
                    <Terminal>D</Terminal>
                  </ArrAirp>
                  <FlightNumber>6839</FlightNumber>
                  <OpAirline>SU</OpAirline>
                  <MarkAirline>AY</MarkAirline>
                  <AircraftType>320</AircraftType>
                  <DepDateTime>2017-03-10T12:25:00</DepDateTime>
                  <ArrDateTime>2017-03-10T15:05:00</ArrDateTime>
                  <BookingClass>
                    <BaseClass>Business</BaseClass>
                    <BookingClassCode>I</BookingClassCode>
                    <FreeSeatCount>9</FreeSeatCount>
                  </BookingClass>
                  <ETicket>true</ETicket>
                  <RequestedSegment>0</RequestedSegment>
                </Segment>
                <Segment>
                  <a:ID>2</a:ID>
                  <DepAirp>
                    <AirportCode>SVO</AirportCode>
                    <CityCode>MOW</CityCode>
                    <UTC>3</UTC>
                    <Terminal>D</Terminal>
                  </DepAirp>
                  <ArrAirp>
                    <AirportCode>HEL</AirportCode>
                    <CityCode>HEL</CityCode>
                    <UTC>2</UTC>
                    <Terminal>2</Terminal>
                  </ArrAirp>
                  <FlightNumber>154</FlightNumber>
                  <OpAirline>AY</OpAirline>
                  <MarkAirline>AY</MarkAirline>
                  <AircraftType>319</AircraftType>
                  <DepDateTime>2017-03-17T12:50:00</DepDateTime>
                  <ArrDateTime>2017-03-17T13:30:00</ArrDateTime>
                  <BookingClass>
                    <BaseClass>Business</BaseClass>
                    <BookingClassCode>I</BookingClassCode>
                    <FreeSeatCount>8</FreeSeatCount>
                  </BookingClass>
                  <ETicket>true</ETicket>
                  <RequestedSegment>1</RequestedSegment>
                </Segment>
              </Segments>
              <PriceInfo>
                <Price>
                  <a:ID>1</a:ID>
                  <ValidatingCompany>AY</ValidatingCompany>
                  <Refundable>Refundable</Refundable>
                  <PrivateFareInd>false</PrivateFareInd>
                  <TicketTimeLimit>2017-03-10T13:25:00</TicketTimeLimit>
                  <PassengerFares>
                    <PassengerFare>
                      <Type>ADT</Type>
                      <Quantity>1</Quantity>
                      <BaseFare>
                        <a:Amount>256997</a:Amount>
                        <a:Currency>KZT</a:Currency>
                      </BaseFare>
                      <EquiveFare>
                        <a:Amount>256997</a:Amount>
                        <a:Currency>KZT</a:Currency>
                      </EquiveFare>
                      <TotalFare>
                        <a:Amount>302686</a:Amount>
                        <a:Currency>KZT</a:Currency>
                      </TotalFare>
                      <Taxes>
                        <Tax>
                          <a:Amount>45689</a:Amount>
                          <a:Currency>KZT</a:Currency>
                          <TaxCode>XT</TaxCode>
                        </Tax>
                      </Taxes>
                      <Tariffs>
                        <Tariff>
                          <Code>IBU2FI</Code>
                          <Type>Public</Type>
                          <SegNum>1</SegNum>
                        </Tariff>
                        <Tariff>
                          <Code>IBU2FI</Code>
                          <Type>Public</Type>
                          <SegNum>2</SegNum>
                        </Tariff>
                      </Tariffs>
                      <ExchangePriceInfo>
                        <AirlinePenalty>
                          <a:Amount>0</a:Amount>
                          <a:Currency>KZT</a:Currency>
                        </AirlinePenalty>
                        <FlightPriceDifference>
                          <a:Amount>0</a:Amount>
                          <a:Currency>KZT</a:Currency>
                        </FlightPriceDifference>
                      </ExchangePriceInfo>
                    </PassengerFare>
                  </PassengerFares>
                </Price>
              </PriceInfo>
            </Flight>
          </PlaneFlights>
        </a:ResponseBody>
      </GetExchangeVariantsResult>
    </GetExchangeVariantsResponse>
  </s:Body>
</s:Envelope>