KIU_CancelRQ/RS


INDICE DE CONTENIDO


 



Objetivo:

A través de este método el usuario puede:

  • Cancelar una reserva.

  • Anular un Ticket. 

  • Anular un EMD


KIU_CancelRQ


Ejemplos:


KIU_CancelRQ - Cancelar reserva
<?xml version="1.0" encoding="UTF-8"?>
<KIU_CancelRQ EchoToken="1" TimeStamp="2015-03-12T17:17:36+00:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
   <POS>
      <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" />
   </POS>
   <UniqueID Type="14" ID="UNSXXM" />
   <Reasons>
      <Reason>RESERVA ERRONEA</Reason>
   </Reasons>
</KIU_CancelRQ>




KIU_CancelRQ - Anulación de Tickets
<?xml version="1.0" encoding="UTF-8"?>
<KIU_CancelRQ EchoToken="1" TimeStamp="2016-11-09T17:17:36+00:00" Target="Testing" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" />
    </POS>
    <UniqueID Type="14" ID="PUKZQF" />
    <UniqueID Type="30" ID="9990210018009" />
    <Ticketing TicketTimeLimit="1" />
</KIU_CancelRQ>




KIU_CancelRQ - Anular EMD
<?xml version="1.0" encoding="UTF-8"?>
<KIU_CancelRQ EchoToken="1" TimeStamp="2015-03-12T17:17:36+00:00" Target="Production" Version="3.0" SequenceNmbr="1" PrimaryLangID="en-us">
    <POS>
        <Source AgentSine="AEP00XXSM" TerminalID="AEP00XX816" />
    </POS>
    <UniqueID Type="14" ID="PUKZQF"/>
    <UniqueID Type="44" ID="0123456789012" />
</KIU_CancelRQ>



Elementos del mensaje KIU_CancelRQ:

  • 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.

        ATENCION!: CASO ANULACIÓN DE BOLETOS: El terminalID que se informa en el método, debe ser coincidente con el TerminalID usado para la emisión de los boletos que se pretenden ANULAR, caso contrario y por funcional gral de KIURES, se obtendrá un error.

  • UniqueID: Elemento que contiene la información del código o ticket a cancelar.
    • Type: Entero. Código OTA de identificador único (14: PNR, 30: ticket, 44: EMD).
    • ID: Alfabético (9)/Entero (13). Identificador único de la reserva asignado por el sistema, o bien número de ticket o EMD a cancelar. Al momento de cancelar una reserva, debe tenerse en cuenta que la misma no debe tener tickets emitidos. De lo contrario, deben cancelarse cada uno de los tickets (realizando una llamada separada a este método para cada uno), para después poder cancelar la reserva.
  • Reasons: Optativo. Elemento contenedor de información acerca de los motivos de la cancelación. Sólo disponible cuando se cancela una reserva, NO cuando se voidea un ticket o un EMD.
    • Reason: Alfanumérico con caracteres especiales [127]. Comentario acerca de la cancelación de la reserva. Aparecerá en la misma en forma de remark. Este elemento puede repetirse.
  • Ticketing: Elemento contenedor de información acerca del ticket a cancelar.
    • TicketTimeLimit: Entero mayor a cero. Indica la cantidad de horas máxima para emitir la reserva (mediante KIU_AirDemandTicket) antes de que la misma sea desechada. En esta llamada es necesario enviar este parámetro ya que, al cancelar el último ticket de una reserva, la misma vuelve a estado pendiente de emisión, con lo que se requiere un tiempo límite antes de que el sistema la deseche automáticamente por falta de pago.

      IMPORTANTE: El ticketTimeLimit corresponde agregarlo cuando se este anulando el ultimo boleto de un PNR, si existe mas boletos y se informa, se ejecutara el VOID pero se devolvera un error por parte del método, ya que pretende ingresar un TimeLimit pero existen aún boletos activos en la reserva.

      IMPORTANTE: Al anular EMDs, se puede optativamente declarar el código de reserva. Los EMD tipo A, están siempre asociados a una reservas y se deberá declarar el código de PNR

      Los EMD tipos S pueden estar asociados a reservas como no. El usuario deberá determinar en que casos deberá declarar código de reserva.




Volver al índice




KIU_CancelRS


Ejemplos:

KIU_CancelRS - Cancelar reserva
<?xml version="1.0" encoding="UTF-8"?>
<KIU_CancelRS EchoToken="1" TimeStamp="2015-03-12T17:17:36+00:00" Target="Production" Version="3.0" SequenceNmbr="1">
    <Warnings>
        <Warning Type="13">COULD NOT INSERT CANCELLATION REASONS</Warning>
    </Warnings>
    <Success />
    <UniqueID Type="14" ID="UNSXXM" />
</KIU_CancelRS>




KIU_CancelRS - Anulación de Ticket
<?xml version="1.0" encoding="UTF-8"?>
<KIU_CancelRS EchoToken="1" TimeStamp="2015-03-12T17:17:36+00:00" Target="Testing" Version="3.0" SequenceNmbr="1">
    <Success />
    <UniqueID Type="14" ID="UNSXXM" />
    <Ticketing TicketTimeLimit="2" />
</KIU_CancelRS>




KIU_CancelRS - Anulación EMD
<?xml version="1.0" encoding="UTF-8"?>
<KIU_CancelRS EchoToken="1" TimeStamp="2015-03-12T17:17:36+00:00" Target="Testing" Version="3.0" SequenceNmbr="1">
    <Success />
</KIU_CancelRS>




Elementos del mensaje KIU_AirCancelRS:


  • UniqueID: Elemento que contiene la información del código a cancelar.
    • Type: Entero. Código OTA de identificador único (14: PNR).
    • ID: Alfabético[6]. Identificador único de la reserva asignado por el sistema.
  • Ticketing: elemento contenedor de información acerca del ticket provisto.
    • TicketTimeLimit: Optativo. Entero mayor a cero. La cantidad de horas antes de que la reserva sea automáticamente dada de baja en caso de no ser emitida.

En caso que no se declare TicketTimeLimit el sistema auto-asignara el default de vencimiento de 10 minutos.


Volver al índice


Posibles mensajes de error:


Código

Mensaje

Explicación

0

INVALID COUPON STATUS

El ticket enviado ya no se encuentra activo (i.e. fue cancelado o ya fue utilizado y no puede cancelarse).

10006

Too many PNRs to process.

Se envió más de un PNR. La llamada acepta hasta uno.

10007

Too many eTKTs to process.

Se envió más de un ticket. La llamada acepta hasta uno.

10013

PNR not informed.

No se envió el PNR.

10014

Too many Time Limits to process.

Se envió más de un time limit. La llamada acepta hasta uno.

10015

New Time Limit not informed.

No se envió el nuevo valor del time limit.

11028

Error at parameter TicketTimeLimit.

El valor del atributo TicketTimeLimit no se corresponde con el formato descripto (número entero mayor a 0).

11039

Error at parameter PNR.

El PNR enviado no se corresponde con el formato descripto (alfabético en mayúsculas de seis caracteres).

11040

Error at parameter Ticket Number.

El ticket enviado no se corresponde con el formato descripto (número entero de 13 dígitos).

11041

Error at parameter ID Type.

El valor del atributo Type del elemento ID no se corresponde con los valores aceptados (14 y 30).

11097

Error at parameter Reason.

El valor del elemento Reason no se corresponde con el formato descripto (alfanumérico en mayúsculas con caracteres especiales de hasta 127 caracteres).

12002

The PNR does not correspond with an active reservation.

El PNR enviado no existe.

12007

There are no more available areas for operation. Please try again.

El sistema no pudo procesar la petición por sobrecarga. Se recomienda reintentar.

12008

The supplied AgentSine does not have the proper duties for this action.

El AgentSine enviado no tiene los permisos necesarios para cancelar una reserva o un ticket. Conactarse con webservices@kiusys.com.

12012

The reservation has already been cancelled.

El PNR enviado corresponde a una reserva que ya no está activa (i.e. ya fue cancelada o venció).

12024

The requested Ticket number could not be found.

El EMD cuyo voideo fue solicitado no existe.

Posibles warnings:

 

Mensaje

Explicación

COULD NOT INSERT CANCELLATION REASONS

Indica que no se pudo insertar el/los remark/s con los motivos para la cancelación de la reserva.

El método de KIU_Cancel, requiere que la terminal sea una terminal válida de una ciudad/País existente del cliente. No se puede declarar una terminal/Agent Sine ´NET´. En tal caso, se va a recibir un error de ´Need Duty´


 Volver al índice