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:
<?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>
<?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>
<?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.
- Source: Contenedor de los datos del Punto de Venta o POS
- 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.
KIU_CancelRS
Ejemplos:
<?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>
<?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>
<?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.
- 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.
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´