KIU_AirOfferListRQ/KIU_AirGetOfferListRS

Owned by Natalia Pacheco (Deactivated)
Last updated: Sept 10, 2019 by Gerardo Nizetich (Deactivated)
9 min read

Indice de contenido:


Objetivo:

El método ofrece la posibilidad de obtener el listado de servicios adicionales (ancillaries) con su correspondiente valor, sobre una reserva creada. En base a cada segmento que compone la reserva se obtiene la lista de ítems agrupados por grupo o familia de ancillaries. 



KIU_AirOfferListRQ :


KIU_AirOfferListRQ - Modelo de request
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirOfferListRQ Version="1.0" PrimaryLangID="EN-us" EchoToken="1" SequenceNmbr="1" Target="Testing" TimeStamp="2017-11-11T09:00:00" MaxOfferQty="20">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX817" ISOCountry="AR" ISOCurrency="USD"/>       
    </POS>
    <RequestCriterion>
        <ConfirmedBookingInfo>
            <BookingReferenceID Type="14" ID="TDRGSE"/>
            <AirItinerary>
              <OriginDestinationOptions>
                  <OriginDestinationOption>
                      <FlightSegment DepartureDateTime="2017-09-29T09:00:00" FlightNumber="060" RPH="1" >
                          <DepartureAirport LocationCode="LHR"/>
                          <ArrivalAirport LocationCode="MAD"/>
                          <MarketingAirline Code="XX"/>
                      </FlightSegment>
                  </OriginDestinationOption>
              </OriginDestinationOptions>  
            </AirItinerary>
            <Traveler>
                <PassengerTypeQuantity Code="ADT" Quantity="1"/>
            </Traveler>
        </ConfirmedBookingInfo>
    </RequestCriterion>
</KIU_AirOfferListRQ>


Elementos del mensaje:

  • RequestCriterion: Elemento contenedor del requerimiento.
    • ConfirmedBooking: Elemento que contiene los detalles de la reserva para la cual se requiere la lista de ancillaries asociados.
      • BookingReferenceID: Elemento. Opcional.Contiene la identificación de la reserva para el sistema. 
    • AirItinerary: Elemento. Requerido. Agrupa todos los segmentos de vuelo para el itinerario solicitado.
      • OriginDestinationOptions: Contenedor para las opciones de cada segmento de vuelo.
        • OriginDestinationOption: Opciones para el segmento de vuelo específico.
          • FlightSegment: Información acerca del segmento de vuelo. En caso 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.
            • FlightNumber: Alfanumérico [4]. Número identificatorio del vuelo.
            • ResBookDesigCode: Alfabético [1]. Código designador de la reserva.
            • DepartureAirport: Aeropuerto de origen.
              • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
              • ArrivalAirport: Aeropuerto de destino.
                • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
                • MarketingAirline: Aerolínea de venta.
                  • Code: Alfanumérico [2]. Código identificador de la aerolínea de venta.

    • Traveler: Elemento que agrupa la información de/los pasajeros involucrados en la reserva. 

      ATENCION! Este elemento contiene otros dos elementos, que son tipo CHOICE (significa si se declara uno o el otro, no se puede ambos). PassengerTypeQuantity o AirTraveler cuando el pasajero sea determinado.


      • PassengerTypeQuantity: Elemento que contiene la información de cantidad por tipo de pasajero. 
        • Code: Mandatorio. Declara el tipo de pasajero (ADT: Adulto, CNN: Menor, INF: Infante).
        • Quantity: Mandatorio. Entero no negativo. Cantidad de pasajeros correspondientes al tipo.
      • AirTraveler: Elemento que contiene la información de cada pasajero con su respectivo detalle.
        • PersonName: Elemento que agrupa la información acerca del nombre completo de la persona a nombre de la cual se efectúa la reserva.
          • NamePrefix: [MR|MRS|MSS|JR]. Optativo. Prefijo honorífico del pasajero. Se utiliza en los casos en los que dos o más pasajeros comparten exactamente el mismo nombre completo, para diferenciarlos.
          • GivenName: Alfabético [63]. Mandatorio. Nombre.
          • MiddleName: Alfabético [63]. Optativo. Segundo nombre.
          • Surname: Alfabético [63]. Mandatorio. Apellido.
        • TravelerRefNumber: Referencia única de la persona asignada por el sistema que genera el pedido. Usado como referencia entre segmentos de datos.
          • RPH: Entero. Número de referencia único del pasajero dentro de la reserva.

KIU_AirGetOfferListRS:


KIU_AirOfferListRS
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirGetOfferRS EchoToken="1" TimeStamp="2017-08-30T18:29:47+00:00" Target="Testing" Version="3.0" SequenceNmbr="1">
    <Success />
    <AirItineraryInfo DirectionInd="OneWay" AirItineraryRPH="0">
        <OriginDestinationOptions>
            <OriginDestinationOption TravelPurpose="0">
                <FlightSegment FlightNumber="60" DepartureDateTime="2017-09-29T09:00:00" StopQuantity="0" RPH="1">
                    <DepartureAirport LocationCode="LHR" />
                    <ArrivalAirport LocationCode="MAD" />
                    <MarketingAirline CompanyShortName="LINEAS AEREAS XX" Code="XX" />
                </FlightSegment>
            </OriginDestinationOption>
        </OriginDestinationOptions>
    </AirItineraryInfo>
    <Traveler>
        <PassengerTypeQuantity Code="ADT" Quantity="1" />
    </Traveler>
    <PriceStructure TicketingCountryCode="AR" PricingCurrency="GBP" DisplayCurrency="USD" DecimalPlaces="2" />
    <PricedOffer>
        <ServiceFamily FamilyCode="BG" FamilyName="BAGGAGE">
            <ItemOffer Code="PDBG" PTC="ADT" Description="PRE PAID BAGGAGE" SegmentRPH="1" Carrier="XX" BookMode="SSR">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>32.27</PriceOffer>
                </ItemPriced>
            </ItemOffer>
            <ItemOffer Code="PBGF" PTC="ADT" Description="1ST ADDITIONAL BAG" SegmentRPH="1" Carrier="XX" BookMode="SSR">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>38.73</PriceOffer>
                </ItemPriced>
            </ItemOffer>
            <ItemOffer Code="PBGS" PTC="ADT" Description="2ND ADDITIONAL BAG" SegmentRPH="1" Carrier="XX" BookMode="SSR">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>45.18</PriceOffer>
                </ItemPriced>
            </ItemOffer>
            <ItemOffer Code="PBGT" PTC="ADT" Description="THIRD ADDITIONAL BAGGAGE" SegmentRPH="1" Carrier="XX" BookMode="SSR">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>51.64</PriceOffer>
                </ItemPriced>
            </ItemOffer>
        </ServiceFamily>
        <ServiceFamily FamilyCode="LG" FamilyName="LOUNGE">
            <ItemOffer Code="PDLG" PTC="ADT" Description="LOUNGE ACCESS" SegmentRPH="1" Carrier="XX" BookMode="SSR">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>64.55</PriceOffer>
                </ItemPriced>
            </ItemOffer>
        </ServiceFamily>
        <ServiceFamily FamilyCode="SA" FamilyName="PRE RESERVED SEAT">
            <ItemOffer Code="STPD" PTC="ADT" Description="BASIC SEAT" SegmentRPH="1" Carrier="XX" BookMode="SEA">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>12.91</PriceOffer>
                </ItemPriced>
            </ItemOffer>
            <ItemOffer Code="STPR" PTC="ADT" Description="PREMIUM SEAT" SegmentRPH="1" Carrier="XX" BookMode="SEA">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>25.82</PriceOffer>
                </ItemPriced>
            </ItemOffer>
            <ItemOffer Code="STXL" PTC="ADT" Description="PREMIUM SEAT" SegmentRPH="1" Carrier="XX" BookMode="SEA">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>38.73</PriceOffer>
                </ItemPriced>
            </ItemOffer>
            <ItemOffer Code="STEX" PTC="ADT" Description="PREMIUM SEAT" SegmentRPH="1" Carrier="XX" BookMode="SEA">
                <ItemPriced CurrencyCode="USD" DecimalPlaces="2">
                    <PriceOffer>45.18</PriceOffer>
                </ItemPriced>
            </ItemOffer>
        </ServiceFamily>
    </PricedOffer>
</KIU_AirGetOfferRS>

Elementos del mensaje:

  • Success: Elemento que contiene la información de la comunicación.
    • Warnings: Elemento contenedor de advertencias referentes a la transacción
      • Warning: Elemento que contiene la descripción del advertencia.
        • Code: Código de la advertencia. 
    • AirItineraryInfo: Elemento que contiene la información del itinerario de la reserva.
      • DirectionInd: Atributo. Contiene el identificador de tipo de itinerario (OneWay or RoundTrip).
      • AirItineraryRPH: Atributo. Entero Positivo. ID de referencia interna. 
      • 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.
            • FlightNumber: Alfanumérico [4]. Número identificatorio del vuelo.
            • ResBookDesigCode: Alfabético [1]. Código designador de la reserva.
            • DepartureAirport: Aerpuerto de origen.
              • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
            • ArrivalAirport: Aeropuerto de destino.
              • LocationCode: Alfabético [3]. Codigo IATA de aeropuerto.
            • MarketingAirline: Aerolínea de venta.
              • Code: Alfanumérico [2]. Código identificador de la aerolínea de venta.
    • Traveler: Elemento que contiene la información de los pasajeros que componen la reserva.
      • PassengerTypeQuantity: Elemento que contiene la información de cantidad por tipo de pasajero. 
        • Code: Declara el tipo de pasajero que contiene la reserva (ADT: Adulto, CNN: Menor, INF: Infante).
        • Quantity: Entero no negativo. Cantidad de pasajeros correspondientes al tipo.

ATENCION! Este elemento contiene otros dos elementos, que son tipo CHOICE. significa o se declara el uno o el otro, no se puede ambos

      • AirTraveler: Contenedor para la información de cada pasajero.
          • PassengerTypeCode: Alfabético [3]. Código que indica el tipo de pasajero: Infante que no ocupa asiento (INF, desde 0 a 2 años no cunplidos), Niño (CNN, desde los 2 a los 12 años no cumplidos), Adulto (ADT, de 12 años en adelante), Grupo (GRP).
          • BirthDate: Fecha ISO. Fecha de nacimiento del pasajero.
          • PersonName: Elemento que agrupa la información acerca del nombre completo del pasajero.
            • NamePrefix: Prefijo honorífico del pasajero.
            • GivenName: Alfabético. Nombre.
            • MiddleName: Alfabético. Segundo nombre.
            • Surname: Alfabético. Apellido.
        • TravelerRefNumber: Referencia única del pasajero asignada por el sistema que genera el pedido. Usado como referencia entre segmentos de datos.
          • RPH: Entero. Número de referencia único del pasajero dentro de la reserva.
    • PriceStructure: Elemento que contiene la información específica de calificadores de precio aplicados a la cotización de los ítems.
      • TicketingCountryCode: Código ISO de país de donde proviene el request y que se usa para aplicar las reglas de ticketing. 
      • DisplayCurrency: Código ISO de moneda en el cuál se expresan los montos. 
      • PricingCurrency: Código ISO de moneda en el que se encuentra el monto del servicio cargado. 
      • DecimalPlaces: Cantidad de decimales aplicados. 

    • PricedOffer: Elemento contenedor de la lista de Ancillaries agrupados por familia y asociados a segmentos.
      • ServiceFamily: Elemento repetitivo que informa la familia o grupo al que pertenece cada servicio listado.
        • FamilyCode: Código alfanumérico 2, que informa el código de grupo de servicios asociados. 
        • FamilyName: Nombre marketing de la familia o grupo de servicios
        • ItemOffer: Elemento repetitivo que contiene la información individual de cada servicio ofrecido para la familia de referencia. 
          • Code: Código del servicio. RFISC.
          • Description: Descripción Marketing del servicio. 
          • SegmentRPH: Referencia interna al segmento donde se ofrece el servicio.
          • Carrier: Opcional. Código ISO de línea aérea que ofrece el servicio.
          • BookMode: Enum. (SEA/SSR). Indica de qué manera se reserva el servicio (SEA: Seat, se reserva automáticamente con el comando de reserva de asientos. SSR: Se reserva a través de un SSR Request).
            • PricedOffer: Elemento que contiene el monto del servicio.
            • Taxes: Optativo. Elemento que contiene la lista de tasas e impuestos aplicables al servicio.
              • Tax: Elemento individual que contiene la informacion de tasa o impuesto.
                • TaxCode: Código de tasa o impuesto.
                • TaxAmount: Monto del impuesto.


Volver al indice