KIU_AirAvailRQ/RS

Owned by Natalia Pacheco (Deactivated)
Last updated: Oct 28, 2022 by Diego Almeyra (Unlicensed)
7 min read

Objetivo del Método:


Obtener disponibilidad desde KIURES para uno o varios destinos específicos con fecha determinada.

Indice de Contenido

KIU_AirAvailRQ


Ejemplos de Requests:

KIU_AirAvailRQ One Way
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirAvailRQ EchoToken="1" TimeStamp="2012-04-20T15:45:07-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us" DirectFlightsOnly="false" MaxResponses="5">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR" />
    </POS>
    <SpecificFlightInfo>
        <Airline Code="XX" />
    </SpecificFlightInfo>
    <OriginDestinationInformation>
        <DepartureDateTime>2016-08-09</DepartureDateTime>
        <OriginLocation LocationCode="AEP" />
        <DestinationLocation LocationCode="COR" />
    </OriginDestinationInformation>
    <TravelPreferences MaxStopsQuantity="2">
        <CabinPref Cabin="Economy" />
    </TravelPreferences>
    <TravelerInfoSummary>
        <AirTravelerAvail>
            <PassengerTypeQuantity Code="ADT" Quantity="1" />
            <PassengerTypeQuantity Code="CNN" Quantity="1" />
        </AirTravelerAvail>
    </TravelerInfoSummary>
</KIU_AirAvailRQ>



KIU_AirAvailRQ Round Trip
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirAvailRQ EchoToken="1" TimeStamp="2012-04-20T15:45:07-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us" DirectFlightsOnly="false" MaxResponses="5">
   <POS>
      <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR" />
   </POS>
   <SpecificFlightInfo>
      <Airline Code="XX" />
   </SpecificFlightInfo>
   <OriginDestinationInformation>
      <DepartureDateTime>2016-08-9</DepartureDateTime>
      <OriginLocation LocationCode="AEP" />
      <DestinationLocation LocationCode="COR" />
   </OriginDestinationInformation>
   <OriginDestinationInformation>
      <DepartureDateTime>2016-08-12</DepartureDateTime>
      <OriginLocation LocationCode="COR" />
      <DestinationLocation LocationCode="AEP" />
   </OriginDestinationInformation>
   <TravelPreferences MaxStopsQuantity="4">
      <CabinPref Cabin="Economy" />
   </TravelPreferences>
   <TravelerInfoSummary>
      <AirTravelerAvail>
         <PassengerTypeQuantity Code="ADT" Quantity="1" />
      </AirTravelerAvail>
   </TravelerInfoSummary>
</KIU_AirAvailRQ>

Elementos del mensaje KIU_AirAvailRQ:


  • DirectFlightsOnly: [true|false]. Indica si debe mostrar solo vuelos directos.
  • MaxResponses: Entero positivo [1... 50]. Cantidad de opciones máximas a devolver en la respuesta. Si el parámetro no se especifica, el valor por defecto es 10.
  • POS: Elemento que agrupa la información del Punto de Venta desde el cual se realiza la petición.
    • Source: Contenedor de los datos del Punto de Venta o POS.
    • AgentSine: Alfanumérico [9]. Identificador del agente que realiza la petición.
    • TerminalID: Alfanumérico [10]. Código identificador del dispositivo desde el que se realiza la petición.
    • ISOCountry:  Alfabético [2]. Código ISO del país desde donde se realiza la petición.
  • SpecificFlightInfo: Elemento optativo para indicar que los resultados devueltos deben corresponder a un único carrier.
    • Airline: Elemento que contiene a la aerolínea por la cual filtrar los resultados.
    • Code: Código IATA de la aerolínea/carrier.
  • OriginDestinationInformation: Origen y destino para los cuales se solicita la disponibilidad. En el caso de peticiones de itinerarios round trip o con más de un destino, este elemento debe repetirse íntegramente, modificando la fecha y par origen-destino en cada instancia.
    • DepartureDateTime: Fecha ISO. Fecha de partida.
    • OriginLocation: Lugar de origen.
    • LocationCode: Alfabético [3]. Código IATA de aeropuerto.
    • DestinationLocation: Lugar de destino.
    • LocationCode: Alfabético [3]. Código IATA de aeropuerto.
  • TravelPreferences: Indica las preferencias del usuario sobre las opciones a mostrar.
  • MaxStopsQuantity: Entero [0... 4]. Indica la cantidad máxima de paradas intermedias que deben tener los vuelos a mostrar.
    • CabinPref: Indica las preferencias del usuario sobre la cabina.
    • Cabin: [Business|Cockpit|Economy|First|PremiumBusiness|PremiumEconomy|Suite]. Cabina seleccionada para el vuelo.
  • TravelerInfoSummary: Información de pasajeros.
    • AirTravelerAvail: Tipos y cantidad de pasajeros.
      • PassengerTypeQuantity: Cantidad de pasajeros para un tipo determinado.
      • Quantity: Entero [0... 9]. Cantidad de pasajeros.
      • Code: Alfabético [3]. Código que indica el tipo de pasajero: Infante que no ocupa asiento (INF, desde 0 a 2 años no cumplidos), Niño (CNN, desde los 2 a los 12 años no cumplidos), Adulto (ADT, de 12 años en adelante).




KIU_AirAvailRS

Ejemplos de Responses

KIU_AirAvailRS One Way
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirAvailRS EchoToken="1" TimeStamp="2016-07-26T14:17:11+00:00" Target="Production" Version="3.0" SequenceNmbr="1">
    <Success />
    <OriginDestinationInformation>
        <DepartureDateTime>2016-08-09</DepartureDateTime>
        <OriginLocation>AEP</OriginLocation>
        <DestinationLocation>COR</DestinationLocation>
        <OriginDestinationOptions>
            <OriginDestinationOption>
                <FlightSegment DepartureDateTime="2016-08-09 18:01:00" ArrivalDateTime="2016-08-09 19:00:00" StopQuantity="0" FlightNumber="9665" JourneyDuration="00:59:00">
                    <DepartureAirport LocationCode="AEP" />
                    <ArrivalAirport LocationCode="COR" />
                    <Equipment AirEquipType="SF3" />
                    <MarketingAirline CompanyShortName="XX" />
                    <Meal MealCode="-" />
                    <MarketingCabin CabinType="Economy" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="Y" ResBookDesigQuantity="9" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="B" ResBookDesigQuantity="9" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="H" ResBookDesigQuantity="9" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="K" ResBookDesigQuantity="9" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="M" ResBookDesigQuantity="9" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="N" ResBookDesigQuantity="9" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="L" ResBookDesigQuantity="L" RPH="1" />
                    <BookingClassAvail ResBookDesigCode="X" ResBookDesigQuantity="9" RPH="1" />
                </FlightSegment>
            </OriginDestinationOption>
        </OriginDestinationOptions>
    </OriginDestinationInformation>
</KIU_AirAvailRS>


Ejemplo Response MultiCity

KIU_AirAvailRS Multi city
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirAvailRS EchoToken="1" TimeStamp="2016-07-26T14:22:07+00:00" Target="Production" Version="3.0" SequenceNmbr="1">
	<Success/>
	<OriginDestinationInformation>
		<DepartureDateTime>2016-08-9</DepartureDateTime>
		<OriginLocation>AEP</OriginLocation>
		<DestinationLocation>COR</DestinationLocation>
		<OriginDestinationOptions>
			<OriginDestinationOption>
				<FlightSegment DepartureDateTime="2016-08-09 18:01:00" ArrivalDateTime="2016-08-09 19:00:00" StopQuantity="0" FlightNumber="9665" JourneyDuration="00:59:00">
					<DepartureAirport LocationCode="AEP"/>
					<ArrivalAirport LocationCode="COR"/>
					<Equipment AirEquipType="SF3" />
					<MarketingAirline CompanyShortName="XX"/>
					<Meal MealCode="-"/>
					<MarketingCabin CabinType="Economy" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="Y" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="B" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="H" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="K" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="M" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="N" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="L" ResBookDesigQuantity="L" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="X" ResBookDesigQuantity="9" RPH="1"/>
				</FlightSegment>
			</OriginDestinationOption>
		</OriginDestinationOptions>
	</OriginDestinationInformation>
	<OriginDestinationInformation>
		<DepartureDateTime>2016-08-12</DepartureDateTime>
		<OriginLocation>COR</OriginLocation>
		<DestinationLocation>AEP</DestinationLocation>
		<OriginDestinationOptions>
			<OriginDestinationOption>
				<FlightSegment DepartureDateTime="2016-08-12 08:00:00" ArrivalDateTime="2016-08-12 09:00:00" StopQuantity="0" FlightNumber="9664" JourneyDuration="01:00:00">
					<DepartureAirport LocationCode="COR"/>
					<ArrivalAirport LocationCode="AEP"/>
					<Equipment AirEquipType="DC9" />
					<MarketingAirline CompanyShortName="XX"/>
					<Meal MealCode="B"/>
					<MarketingCabin CabinType="Economy" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="Y" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="B" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="H" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="T" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="O" ResBookDesigQuantity="9" RPH="1"/>
					<BookingClassAvail ResBookDesigCode="V" ResBookDesigQuantity="9" RPH="1"/>
				</FlightSegment>
			</OriginDestinationOption>
		</OriginDestinationOptions>
	</OriginDestinationInformation>
</KIU_AirAvailRS>

Elementos del mensaje KIU_AirAvailRS:


  • OriginDestinationInformation: Origen y destino para el que se devuelve la disponibilidad. Si se solicita más de un origen y destino en la llamada original, este elemento se repite.
    • DepartureDateTime: Fecha ISO. Fecha de partida.
    • OriginLocation: Lugar de origen.
    • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
    • DestinationLocation: Lugar de destino.
    • LocationCode Alfabético [3]. Codigo IATA de aeropuerto.
    • OriginDestinationOptions: Contenedor para las opciones de cada segmento de vuelo.
      • OriginDestinationOption: Opciones para el segmento de vuelo específco.
        • FlightSegment: Información acerca del segmento de vuelo. En los casos de vuelos no directos, este elemento se repite para cada tramo.
        • DepartureDateTime: Fecha ISO de partida del vuelo.
        • ArrivalDateTime: Fecha ISO de llegada del vuelo.
        • StopQuantity: Cantidad de paradas del vuelo.
        • FlightNumber: Alfanumérico [4]. Número identificatorio del vuelo.
        • JourneyDuration: Duración del vuelo.
          • DepartureAirport: Aeropuerto de origen.
          • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
          • ArrivalAirport: Aeropuerto de destino.
          • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
          • Equipment: Tipo de equipamiento aeronáutico.
          • AirEquipType: Alfanumérico [3]. Código IATA del modelo de la aeronave.
          • MarketingAirline: Aerolínea de venta.
          • CompanyShortName: Alfabético [1... 32]. Nombre de la aerolínea.
          • Meal: Servicio de comida.
          • MealCode: Alfabético con caracteres especiales [1... 3] [BSDHLRCMPFO-]. Un código de hasta tres caracteres o un guión medio que simboliza los servicios de comida disponibles para la clase de reserva: Desayuno (B, Breakfast), Refrigerio (S, Snack), Cena (D, Dinner), Comida Caliente (H, Hot Meal), Almuerzo (L, Lunch), Refrescos (R, Refreshments), Alcohol de Cortesía (C, Complimentary liquor), Comida (M, Meal), Alcohol disponible para la venta (P, Liquor for Purchase), Comida disponible para la venta (F, Food for Purchase), Comida Fría (O, Cold Meal), Sin servicio de comida (-).
          • BookingClassAvail: Códigos de reserva disponibles para el segmento de vuelo.
          • ResBookDesigCode: Alfabético [1]. Código de clase.
          • ResBookDesigQuantity: Entero [0... 9|R|L]. Cantidad de asientos disponibles para la clase correspondiente. Dependiendo de la configuración y estado del avión, una clase puede devolver los valores “R” (en requerimiento) y “L” (en lista de espera). Se recomienda no mostrar estos últimos dos valores vía web y asumir que la clase no tiene asientos disponibles.


Posibles mensajes de error:

 

Código

Mensaje

Explicación

10016

There is a discrepancy between the DirectFlightsOnly and MaxStopsQuantity parameters.

La combinación de valores de los parámetros es ilógica: o bien se envió el atributo DirectFlightsOnly en “true” y el atributo MaxStopsQuantity en un valor distinto de 0, o se envió DirectFlightsOnly en “false” y MaxStopsQuantity en 0.

10035

The date must not be in the past or over 330 days in the future.

La fecha de salida del vuelo no debe ser en el pasado, o más allá de los siguientes 330 días al momento de efectuar la consulta de disponibilidad.

11003

Error at parameter Cabin.

El valor del atributo Cabin del elemento CabinPref no corresponde con ninguna de las opciones descritas.

11004

Error at parameter Age Qualifying Code.

El valor del atributo Code del elemento  PassengerTypeQuantity no corresponde con ninguna de las opciones descritas.

11005

Error at parameter DepartureDateTime.

El valor del elemento DepartureDateTime no es una fecha ISO válida.

11006

Error at parameter OriginLocation.

El valor del atributo LocationCode del elemento OriginLocation no se corresponde con el formato descripto (alfabético en mayúsculas de tres caracteres).

11007

Error at parameter DestinationLocation.

El valor del atributo LocationCode del elemento DestinationLocation no se corresponde con el formato descripto (alfabético en mayúsculas de tres caracteres).

11009

Error at parameter DirectFlightsOnly.

El valor del atributo DirectFlightsOnly no se corresponde con el formato descripto (true/false).

11016

Error at parameter Quantity.

El valor del atributo Quantity del elemento  PassengerTypeQuantity no es un entero positivo.

11017

Error at parameter ISOCountry.

El valor del atributo ISOCountry del elemento Source no se corresponde con el formato descrito (alfabético en mayúsculas de dos caracteres).

11038

Error at parameter MaxResponses.

El valor del atributo MaxResponses no se corresponde con el formato descrito (número entero entre 1 y 20 inclusive).

11043

Error at parameter Carrier.

El valor del atributo Code del elemento Airline no se corresponde con el formato descrito (alfanumérico en mayúsculas de 2 caracteres).

11047

Error at parameter MaxStopsQuantity.

El valor del atributo MaxStopsQuantity no se corresponde con el formato descrito (número entero entre 0 y 4 inclusive

11194Origin Destination Information has reached limit (Max 10).La cantidad de elementos OriginDestinationInformation llegó a su límite máximo de 10, debiendo declarar hasta 10 elementos y no más.


Volver al índice