Objetivo

En esta sección, se pueden encontrar las preguntas frecuentes sobre la implementación y uso de KIU_AirShopping. 

Preguntas Frecuentes

• Qué tipo de viajes soporta KIU_AirShopping?
  En la versión 1.0, KIU_AirShopping soporta solamente rutas One Way y Round Trip. Las mismas se determinan por Origen-Destino/DepartureDate y opcionalmente ReturnDate, que funciona como indicador de retorno de la ruta declarada.
  
  
• Puedo utilizar KIU_AirShopping sin configurar FareFamilies?
  No, KIU_AirShopping está directamente relacionado con la configuración de grupos tarifarios.
  
  
• Qué es un FareFamily?
  Esta funcionalidad le permite a los carriers agrupar las tarifas con condiciones similares dentro de un grupo tarifario, priorizando el orden de despliegue dentro de cada familia. Por ejemplo, las tarifas más económicas y con más restricciones de aplicabilidad, se pueden agrupar dentro del grupo "Promo" y así sucesivamente. 
  
  
• Como obtengo/construyo una opción a mostrar en base a shopping?
  Dependiendo la forma en que se quiera desplegar desde un cliente, tomando como parámetro la siguiente respuesta de shopping y con un formato tipo tabla:

            Se crea la siguiente tabla donde:

• • • FamilyName = Columna.
    • AirItineraryPriced=Filas.

      • Ej:

        	<FamilyName Order="1">SUPERPROMO</FamilyName>	<FamilyName Order="2">PROMO</FamilyName>	<FamilyName Order="3">FLEXI</FamilyName>
        <AirItineraryPriced OptionID="1">
        <AirItineraryPriced OptionID="2">
        <AirItineraryPriced OptionID="3">
        <AirItineraryPriced OptionID="4">
        <AirItineraryPriced OptionID="1">

        
        

        
        

        
        

• Como identifico una opción cotizada?
  Dentro de la respuesta, el elemento complejo <AirPricedItineraries> contiene 1 o una lista de opciones cotizadas para el origen-Destino/Fecha solicitado. Primero se debe identificar cuales son los componentes de cada opción descritos de la siguiente manera: 
  
  
  
  • OptionID : Es un atributo que le asigna un orden a la opción para realizar referencias/Asociaciones dentro del mensaje XML de respuesta. 
  • JourneyInformation: Es un elemento complejo, contenedor que describe los componentes del itinerario de acuerdo al request que esta respondiendo.
    
    
    
    • AirItinerary: Describe la ruta aérea de acuerdo al pedido generado. Se identifica el origen, destino y fecha.
  • FareInfo: Es un elemento complejo, contenedor de los detalles de tarifas de la opción cotizada.
    
    
    
    • FareFamily: Es un elemento que contiene la información de la FareFamily usada para la cotización.
      • OriginDestRPH: Es un identificador interno que se usa para hacer referencia/Asociación a un o varios segmentos que componen el itinerario aéreo de acuerdo a la ruta solicitada y que se detallan en el elemento <AirItinInformation>.
      • FareBasisCodes: Es un elemento complejo que contiene una o una lista de FareBasisCode aplicados en la cotización de la opción detallada. 
        
        
        
        • FareBasisCode: Elemento que contiene la descripción de base de tarifa aplicada en la cotización. cada una de las tarifas. Nombre de la tarifa. 
          • FareBaseID: Atributo. Número de orden de la base de tarifa para realizar referencia/asociaciones intrínsecas del método. En este caso se asocia a un elemento dentro de la lista de <AirItinInformation>. Se asocia puntualmente a 1 o mas segmentos aéreos.
          • Cabin: Atributo. Nombre de la cabina de aplicación de la tarifa. 
          • IDFare: Atributo. ID de la tarifa para el sistema KIURES, en base a este dato, se puede obtener las reglas de la tarifa puntual a través del método KIU_AirRulesRQ (Ver manual de referencia para mas detalles).
          • RBD: Atributo. Corresponde a la clase de reserva que aplica la base de tarifa. 
            
            
  • AirItinTotalFare: Elemento que contiene la informacion de totales de la opción. Estos valores expresan la suma total de todos los items y todos los pasajeros. Es el total global.
    
    
    • BaseFare: Elemento que contiene el valor de la tarifa aplicada por todos los pasajeros indistintamente su tipo en la moneda de publicación de la tarifa en el sistema.
      • CurrCode: Atributo que determina la moneda del monto informado. 
    • EquivFare: Elemento que contiene el valor cotizado en la moneda de despliegue. 
      • CurrCode: Atributo que determina la moneda del monto informado. 
    • TotalTax: Elemento que contiene el total de tasas/impuestos. 
    • TotalFee: Elemento que contiene el total de fees aplicados.
    • TotalFare: Elemento que contiene el total de la oferta para la ruta /fecha/tipo y cantidad de pasajeros requeridos. Este es el monto a desplegar de la opción (en caso que se muestre del lado del cliente el total con tasas impuestos x total de pasajeros).
      
      
  • PTC_BreakDowns: Elemento que contiene el detalle de cotización por tipo de pasajero individual.
    
    
    • PTC_BreakDown: Elemento que contiene el detalle por tipo de pasajero. 
      • PTC: Elemento que describe el tipo de pasajero del detalle.
      • Quantity: Elemento que detalla la cantidad de instancias del tipo de pasajero descrito.
      • FareInfo: Elemento complejo que contiene el detalle de tarifa para el tipo de tipo de pasajero. (Los montos se expresan singularmente, por 1 item).
        
        • BaseFare: Elemento, monto de la tarifa cotizada para el tipo de pasajero. 
          • CurrCode: Atributo. Infiere a la moneda de publicación de la tarifa cotizada. 
        • EquivAmount: Elemento, monto de la tarifa cotizada de acuerdo a la moneda de compra/Despliegue. 
          • CurrCode: Atributo. Infiere a la moneda de compra o despliegue.

          
          

          Nota: En este elemento también se encuentra la información de sobre cargos que se aplican sobre la tarifa puntualmente, por ejemplos los cargos Q. Ver manual de referencia del método.

          
          

          
          

          
          

        • Taxes: Elemento que contiene el detalle de impuestos/tasas para el tipo de pasajero. 
          
          

          • Tax: El elemento contiene la descripción de cada impuesto/tasas.
            • Code: Código del impuesto
            • Amount: Monto del impuesto. 

• • • • FeesAmount: Elemento, Describe los fees aplicados en la cotización.
        • Fee: Elemento que describe cada fee aplicado
          • Code: Código del Fee.
          • Amount: Monto del fee.

• • • • TotalFare: Elemento que contiene el valor total de la cotización para el tipo de pasajero descrito. El valor es la suma de los ítems por 1 sola instancia, sin tomar en consideración la cantidad. 

• • AirItinInformation: Elemento complejo que contiene los detalles de los segmentos aéreos que componen el itinerario. 
    
    
    
    • OriginDestinationInfo: Elemento complejo que contiene el o los segmentos aéreos que se requieren para llegar del origen al destino solicitado en el request. 
      • ID: Atributo. ID de referencia del objeto para asociaciones internas. 
      • OriginDestRPH: ID de referencia para asociar al componente de FareFamily. Los segmentos descritos están regulados por las familias tarifarías detallado en la opción. 
      • FlighSegment: Elemento complejo que contiene los detalles de 1 segmento aéreo.
        • FareBaseID: Atributo. ID de referencia que se asocia con el elemento FareBaseCode. Determina que el presente segmento se asocia con la tarifa detallada en el elemento. 
        • SegmentNbr: Elemento. Orden lógico de los segmentos dentro del itinerario aéreo para llegar desde el punto de origen al destino.
        • CarrierCode: Elemento. Código de carrier transportador. 
        • FlightNbr: Elemento. Número de vuelo. 
        • RBD: Elemento. Código de la clase de reserva de acuerdo a la tarifa aplicada. 
        • Posting: Elemento. Cantidad de disponibilidad remanente en la clase. El valor debe ser superior a la cantidad de lugares requeridos entre Adultos y Menores (Ocupan asiento), en caso de no contar con disponibilidad suficiente, retornará 0.Esto permite que el cliente pueda agregar una característica a desplegar en el front-end cuando el valor sea 0 (Agotado, No disponible o filtrarlo).
        • DepartureDate: Elemento. Fecha de partida del segmento. 
        • DepartureAirport: Elemento. Código del aeropuerto de partida. 
        • ArrivalAirport: Elemento. Código del aeropuerto de arribo del segmento. (no necesariamente destino final. Por ej. el caso del primer segmento de vuelos en conexión.)
        • DepartureTime: Elemento. Hora de salida del segmento desde el origen.
        • ArrivalTime: Elemento. Hora de arribo estimada del segmento. 
        • ChangeDayInd: Elemento. Indicador de cambio de día, entero. (1 = 1 Día; 2= 2Días; etc).
        • Stops: Elemento. Entero. Cantidad de paradas que realiza el vuelo entre el DepartureAirport y ArrivalAirport. (Siempre se habla del mismo FlightNumber).
        • ElapsedTime: Elemento. Duración del vuelo.