KIU_AirDemandTicketRQ/RS

INDICE DE CONTENIDOS

Objetivo

Permite al usuario:

Emitir una reserva
Emitir una reserva con forma de pago Exchange

KIU_AirDemandTicketRQ

Ejemplos:

KIU_AirDemandTicket - Tarjeta de Crédito

<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRQ EchoToken="1" TimeStamp="2012-04-25T12:45:57-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR" ISOCurrency="ARS">
            <RequestorID Type="5" />
            <BookingChannel Type="1" />
        </Source>
    </POS>
    <DemandTicketDetail TourCode="">
        <BookingReferenceID ID="EKVXLW">
            <CompanyName Code="XX" />
        </BookingReferenceID>
        <TPA_Extension>
           <ValidatingCarrier Code="V5"/>
        </TPA_Extension>
        <PaymentInfo PaymentType="5">
            <CreditCardInfo CardType="1" CardCode="IK" CardNumber="0123456789012345" SeriesCode="123" ExpireDate="1212" ApprovalCode="1234567"/>
            <ValueAddedTax VAT="" />
        </PaymentInfo>
        <Endorsement Info="THIS TICKET IS NONREFUNDABLE" />
    </DemandTicketDetail>
</KIU_AirDemandTicketRQ>

KIU_AirDemandTicket - Cuenta Corriente

<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRQ EchoToken="1" TimeStamp="2012-04-25T12:45:57-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
   <POS>
      <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR" ISOCurrency="ARS">
         <RequestorID Type="5" />
         <BookingChannel Type="1" />
      </Source>
   </POS>
   <DemandTicketDetail TourCode="">
      <BookingReferenceID ID="EKVXLW">
         <CompanyName Code="XX" />
      </BookingReferenceID>
      <PaymentInfo PaymentType="34" InvoiceCode="ACME">
         <ValueAddedTax VAT="" />
      </PaymentInfo>
      <Endorsement Info="THIS TICKET IS NONREFUNDABLE" />
   </DemandTicketDetail>
</KIU_AirDemandTicketRQ>

KIU_AirDemandTicket - Pago Miscelaneo

 <?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRQ EchoToken="1" TimeStamp="2012-04-25T12:45:57-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
   <POS>
      <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR" ISOCurrency="ARS">
         <RequestorID Type="5" />
         <BookingChannel Type="1" />
      </Source>
   </POS>
   <DemandTicketDetail TourCode="">
      <BookingReferenceID ID="EKVXLW">
         <CompanyName Code="XX" />
      </BookingReferenceID>
      <PaymentInfo PaymentType="37" MiscellaneousCode="PP" Text="PAGO CON PAYPAL">
         <ValueAddedTax VAT="" />
      </PaymentInfo>
      <Endorsement Info="THIS TICKET IS NONREFUNDABLE" />
   </DemandTicketDetail>
</KIU_AirDemandTicketRQ>

KIU_AirDemandTicket - Pago C/Cheque

<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRQ EchoToken="1" TimeStamp="2012-04-25T12:45:57-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
   <POS>
      <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX412" ISOCountry="AR" ISOCurrency="ARS">
         <RequestorID Type="5" />
         <BookingChannel Type="1" />
      </Source>
   </POS>
   <DemandTicketDetail TourCode="">
      <BookingReferenceID ID="AJPRVO">
         <CompanyName Code="XX" />
      </BookingReferenceID>
      <PaymentInfo PaymentType="7">
         <Check CheckNumber="123456789" />
         <ValueAddedTax VAT="" />
      </PaymentInfo>
      <Endorsement Info="THIS TICKET IS NONREFUNDABLE" />
   </DemandTicketDetail>
</KIU_AirDemandTicketRQ>

KIU_AirDemandTicketRQ - Exchange + Tarjeta

<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRQ EchoToken="1" TimeStamp="2012-04-25T12:45:57-03:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us" Type="Exchange">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" ISOCountry="AR" ISOCurrency="ARS">
            <RequestorID Type="5" />
            <BookingChannel Type="1" />
        </Source>
    </POS>
    <DemandTicketDetail TourCode="">
        <BookingReferenceID ID="XCGLNI">
            <CompanyName Code="XX" />
        </BookingReferenceID>
        <PaymentInfo PaymentType="39" TicketNumber="9990220005407" CouponList="1" Amount="1601.52" PassengerRPH="1"></PaymentInfo>
        <PaymentInfo PaymentType="5">
            <CreditCardInfo CardType="1" CardCode="TN" CardNumber="4242424242424242" SeriesCode="123" ExpireDate="1216" ExtendedPaymentCode="1" ApprovalCode="1234567"/>
            <ValueAddedTax VAT="" />
        </PaymentInfo>
        <Endorsement Info="THIS TICKET IS NONREFUNDABLE" />
    </DemandTicketDetail>
</KIU_AirDemandTicketRQ>

Elementos del Mensaje KIU_AirDemandTicketRQ

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: Código ISO del país donde se originó la petición.
  - ISOCurrency: Código ISO de la moneda en la que se efectuará la emisión del ticket.
  - RequestorID: Elemento identificador de la entidad que genera el pedido.
    - Type: Código OTA del tipo de entidad, listado en la OpenTravel Code List Unique ID Type.
  - BookingChannel: Especificación del canal de reserva.
    - Type: Código OTA del canal de reserva, listado en la OpenTravel Code List Booking Channel Type. En caso de Exchange se solicita el valor 'Exchange'.
DemandTicketDetail: Elemento que contiene la información necesaria para que el agente emisor del ticket pueda emitirlo.
- TourCode: Alfanumérico [16]. Código generalmente utilizado por agencias de turismo para la venta de paquetes.
- BookingReferenceID: Listado de los RPH del segmento de vuelo asociados con un identificador de referencia específico de la reserva.
  - ID: Alfabético [6]. Identificador único de la reserva asignado por el sistema.
  - CompanyName: Contenedor de identificación de la aerolínea.
    - Code: Código OTA de la aerolínea.
  - TPA_Extension: Agregado estándar al método de acuerdo al estándar OTA.
    - - ValidatingCarrier: Opcional - Linea aérea validador de Boleto
        Code: Código OTA de la aerolínea
- Commission: Optativo. Elemento utilizado para especificar una comisión a cobrar sobre el precio de venta.
  - Percent: Decimal. Porcentaje a cobrar sobre el precio de la reserva.
  - CapAmount: Decimal. Monto máximo a cobrar como comisión (si el porcentaje especificado supera el monto especificado en este atributo, se cobra efectivamente el CapAmount).

PaymentInfo: Elemento que contiene la información necesaria para que el agente emisor del ticket pueda emitirlo.
- PaymentType: Código OTA de la forma de pago, listado en la OpenTravel Code List Payment Type (1: Cash, 5: Credit Card, 6: Debit Card, 7: Cheque (Solo para exchange) 34: Invoice, 37: Miscellaneous, 39: Exchange Ticket *).
- InvoiceCode: Alfanumérico. Código de la cuenta corporativa del cliente, en caso de elegir como forma de pago débito de cuenta corporativa (34: Invoice).
- Check: Elemento que contiene el numero del cheque. (solo exchange).
  - CheckNumber: Alfanumérico. Numero de cheque.
  - CreditCardInfo: Optativo. Información acerca de la tarjeta de crédito, cuando ese es el método de pago elegido.
    - CardType: Código OTA del tipo de tarjeta, listado en la OpenTravel Code List Card Type (1: credit, 2: debit).
    - CardCode: Alfabético [2]. Código de la entidad emisora de la tarjeta de crédito.
    - CardNumber: Entero [16]. Número de la tarjeta de crédito.
    - SeriesCode: Entero. Dígitos de verificación de la tarjeta de crédito.
    - ExpireDate: Entero [4]. Fecha de vencimiento de la tarjeta, como figura en la misma.
    - ApprovalCode: Entero [6]. Número de aprobación de transacción por parte de la entidad crediticia.
  - Text: Alfanumérico con caracteres especiales [99]. Optativo. Incluido sólo cuando se utiliza el medio de pago misceláneo para especificar el significado del mismo.
  - ValueAddedTax: contenedor para el Impuesto al Valor Agregado.
    - VAT: Decimal. Monto del Impuesto al Valor Agregado.

* En caso de PaymentType:39 (Exchange)

TicketNumber: Número de ticket a reemitir.
CouponList: Entero. Lista de cupones separados por espacio (“ ”).
Amount: Decimal. Importe obtenido desde KIU_AirPriceRS (atributo TotalFare Amount, obtenido al ejecutar KIU_AirPriceRQ con Type="Exchange"), el cual corresponde a la diferencia a abonar.
PassengerRPH: Entero. Número de referencia único del pasajero dentro de la reserva.

Endorsement: Optativo. Comentario acerca de cualquier restricción que aplique al caso, para el entendimiento entre el pasajero y la aerolínea. Por defecto, las emisiones llevan un texto de endoso pre-configurado vía la terminal críptica KIU RES. Si se envía el elemento Endorsement, ese texto es reemplazado por el valor del atributo Info.
- Info: Alfanumérico con caracteres especiales [127]. Especifica la información acerca de la aprobación del ticket.

Volver al índice

KIU_AirDemandTicketRS

Ejemplos:

KIU_AirDemandTicketRS

<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRS EchoToken="1" TimeStamp="2016-08-03T18:59:56+00:00" Target="Production" Version="3.0" SequenceNmbr="1">
    <Success />
    <BookingReferenceID ID="XCGLNI">
        <CompanyName Code="XX" />
    </BookingReferenceID>
    <TicketItemInfo TicketNumber="9990220005407" Type="eTicket" ItemNumber="0" TotalAmount="1629.25" CommissionAmount="0.00" PaymentType="5">
        <PassengerName>
            <GivenName>ANTONIO PCD</GivenName>
            <Surname>VERA</Surname>
        </PassengerName>
    </TicketItemInfo>
</KIU_AirDemandTicketRS>

KIU_AirDemandTicketRS - Exchange

<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirDemandTicketRS EchoToken="1" TimeStamp="2016-08-03T19:05:04+00:00" Target="Production" Version="3.0" SequenceNmbr="1">
    <Success />
    <BookingReferenceID ID="XCGLNI">
        <CompanyName Code="XX" />
    </BookingReferenceID>
    <TicketItemInfo TicketNumber="9990220005408" Type="eTicket" TotalAmount="1601.52" PaymentType="5"></TicketItemInfo>
</KIU_AirDemandTicketRS>

Elementos del Mensaje KIU_AirDemandTicketRS

BookingReferenceID: Contenedor de la información identificatoria de la reserva.
- ID: Alfabético [6]. Identificador único de la reserva asignado por el sistema.
- CompanyName: Contenedor de identificación de la aerolínea.
  - Code: Código OTA de la aerolínea.
TicketItemInfo: Contenedor para la información del ticket que fue emitido.
- TicketNumber: Entero. Número del ticket emitido.
- Type: Alfabético. Tipo de ticket emitido.
- ItemNumber: Entero. Número asociado al ticket para propósitos administrativos.
- TotalAmount: Decimal. Importe bruto del ticket emitido.
- ComissionAmount: Decimal. Importe de comisión a pagar por el ticket emitido.
- PaymentType: Código OTA de la forma de pago, listado en la OpenTravel Code List Payment Type.
- PassengerName: Elemento que agrupa la información acerca del nombre completo del pasajero.
  - GivenName: Alfabético. Nombre.
  - Surname: Alfabético. Apellido.

En caso que el número de boleto no coincida con el RPH informado, se devolverá un error o en caso que el monto informado no sea igual al monto de la reserva al momento de la emisión, se recibirá un error de PRICE DISCREPANCY.

Volver al índice

Posibles Mensajes de Error

Código	Mensaje	Explicación
11017	Error at parameter ISOCountry.	El valor del atributo ISOCountry del elemento Source no se corresponde con el formato descripto (alfabético en mayúsculas de dos caracteres).
11018	Error at parameter ISOCurrency.	El valor del atributo ISOCurrency del elemento Source no se corresponde con el formato descripto (alfabético en mayúsculas de tres caracteres).
11023	Error at parameter PaymentType.	El valor del atributo PaymentType del elemento PaymentInfo no se corresponde con el formato descripto (1, 5, 6, 34 o 37).
11025	Error at parameter BookingReferenceID.	El valor del atributo ID del elemento BookingReferenceID no se corresponde con el formato descripto (alfabético en mayúsculas de seis caracteres).
11026	Error at parameter Endorsement.	El valor del atributo Info del elemento Endorsement no se corresponde con el formato descripto (alfanumérico en mayúsculas con caracteres especiales de hasta 127 caracteres).
11027	Error at parameter Commission Percent.	El valor del atributo Percent del atributo Commission no se corresponde con el formato descripto (número decimal).
11043	Error at parameter Carrier	El valor del atributo Code del elemento CompanyName no se corresponde con el formato descripto (alfanumérico en mayúsculas de dos caracteres).
11046	Error at parameter VAT.	El valor del atributo VAT del elemento ValueAddedTax no se corresponde con el formato descripto (número decimal).
11059	Error at parameter Text.	El valor del atributo Text del elemento PaymentInfo no se corresponde con el formato descripto (alfanumérico en mayúsculas con caracteres especiales de hasta 99 caracteres).
11070	Error at parameter CardCode.	El valor del atributo CardCode del elemento CreditCardInfo no se corresponde con el formato descripto (alfabético en mayúsculas de dos caracteres).
11072	Error at parameter TourCode.	El valor del atributo TourCode del elemento DemandTicketDetail no se corresponde con el formato descripto (alfanumérico en mayúsculas de hasta 16 caracteres).
11078	Error at parameter CardNumber.	El valor del atributo CardNumber del elemento CreditCardInfo no se corresponde con el formato descripto (número entero de 16 dígitos).
11079	Error at parameter CardType.	El valor del atributo CardType del elemento CreditCardInfo no se corresponde con el formato descripto (1 o 2).
11080	Error at parameter SeriesCode.	El valor del atributo CardNumber del elemento CreditCardInfo no se corresponde con el formato descripto (número entero de hasta 6 dígitos).
11081	Error at parameter ExpireDate.	El valor del atributo ExpireDate del elemento CreditCardInfo no se corresponde con el formato descripto (número entero de 4 dígitos).
11082	Error at parameter InvoiceCode.	El valor del atributo InvoiceCode del elemento PaymentInfo no se corresponde con el formato descripto (alfanumérico de hasta 31 caracteres).
11083	Error at parameter MiscellaneousCode.	El valor del atributo MiscellaneousCode del elemento PaymentInfo no se corresponde con el formato descripto (alfabético en mayúsculas de hasta 4 caracteres).
11084	Error at parameter Commission CapAmount.	El valor del atributo CapAmount del atributo Commission no se corresponde con el formato descripto (número decimal).

Volver al índice