Table of contents

Purpose of method::

Through this method the user can:

• Cancel a booking

• Void a Ticket 

• Void an EMD

KIU_CancelRQ

Example:

<?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>

Elements of the KIU_CancelRQ message:

• POS:Element that groups the information of the Point of Sale from which the request is made.
  • Source: Contains the Point of Sale or POS data
    • AgentSine: Alphanumeric (9). Identifier of the agent that makes the request.

    • TerminalID: Alphanumeric (10). Identifier code of the device from which the request is made.

      ATTENTION ! IF YOU ARE TRYING TO VOID A TICKET: The terminalID that is reported in the method, must be coincident with the TerminalID used for the issuance of the tickets that are intended to VOID, otherwise due to a exclusive KIURES funcionality, an error will be obtained.

• UniqueID: Element that contains the information of the code or ticket to be canceled.
  • Type: Integer. Single identifier OTA code (14: PNR, 30: ticket, 44: EMD).
  • ID: Alphabetical (9) / Integer (13). Unique identifier of the reservation assigned by the system, or ticket number or EMD to be canceled. When canceling a reservation, it must be taken into account that the booking must not have tickets issued. Otherwise, each of the tickets must be canceled (making a separate call to this method for each one), after which you can cancel the reservation.
• Reasons: Optional. Contains elements of information about the reasons for cancellation. Only available when a reservation is canceled, NOT when a ticket or an EMD is voided.
  • Reason: Alphanumeric with special characters [127]. Comment about the cancellation of the reservation. It will appear in the same in the form of remark. This element can be repeated.
• Ticketing: Contains information about the ticket to be canceled.

  • TicketTimeLimit: Integer greater than zero. Indicates the maximum number of hours to issue the reservation (through KIU_AirDemandTicket) before it is discarded. In this call it is necessary to send this parameter since, when canceling the last ticket of a reservation, it returns to pending status, which requires a time limit before the system automatically discards it due to lack of payment.

    IMPORTANT: The ticketTimeLimit will be add when the last ticket of a PNR is canceled, if there are more tickets and it is informed, the VOID will be executed but an error will be returned through the method, since will try to add a TimeLimit but there are still active tickets In the reservation.

    
    

    
    

    IMPORTANT: When canceling EMDs, you can optionally declare the reservation code.  EMD-A are always associated with a reservation and the PNR code must be declared
    
    EMD-S may be associated with reservations or not. The user must determine in which cases he must declare a reservation code.

    
    

    
    

Volver al índice

KIU_CancelRS

Examples:

<?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>

Elements of the KIU_AirCancelRS message:

• UniqueID: Element that contains the code information to cancel.
  • Type: Integer. Unique identifier OTA code (14: PNR).
  • ID:Alphabetical [6]. Unique identifier of the reservation assigned by the system.
• Ticketing: Container element of information about the ticket provided.
  • TicketTimeLimit: Optional. Integer greater than zero. The number of hours before the reservation is automatically canceled if it is not issued.
    
    

Volver al índice