Void Flight Tickets
The Void Flight Tickets method is designed to facilitate the process of canceling any type of electronic document in a single, seamless API call.
The Void Flight Tickets method is part of the larger Booking Management API, available in RPC/JSON format and designed to operate in a stateless way. When successful, the API will automatically commit the changes applied to a Sabre reservation.
While this API is designed to operate in a stateless way, it accepts both sessionless (ATK) and session-based (ATH) tokens. When a call is made to this API via a session-based token, the session (AAA) is cleared before and after execution.
The logic executed by Void Flight Tickets is defined by the electronic documents submitted. Firstly, the application will retrieve details for each document and then validates if the requirements for the void procedure are met. The analysis includes the void period, coupon status, and whether all documents belong to the same reservation.
Before entering the void flow, the application will sort documents into three buckets:
- stand-alone tickets
- stand-alone EMDs (EMD type S)
- tickets with at least one associated EMD (EMD type A) and the associated EMDs
The void flow will be executed based on this sorted list. After each successful void, the reservation is updated (EnhancedEndtransactionRQ).
Caution! This feature requires AUTO-END and AUTO-ER settings to be inactive. Otherwise, these functionalities are responsible for an automatic reservation update and no EnhancedEndTransactionRQ call is made.
The APIs orchestrated by Void Flight Tickets are:
The Void Flight Tickets method cancels electronic documents as specified. This allows you to submit a list of up to 12 elements from the same reservation to be canceled.
errorHandlingPolicyallows you to define the API's behavior in the event of an error. Two options are available:
HALT_ON_ERROR(default): Execution is stopped in case an error is encountered, a rollback is executed if some products were successfully executed to ensure the original state of the reservation is preserved.
ALLOW_PARTIAL_CANCEL: Execution continues even when some products failed to cancel.
targetPCCis used to specify which city (PCC) should change context using
ContextChange(AAA). If empty, or equals the current city, the context doesn't change.
ticketsis used to provide a list of 13-digit electronic document numbers to be voided. 1 to 12 elements are accepted.
receivedFromis an optional element to specify whether the API should sign the booking change with a specific value (default=
LW CANCEL API).
notificationallows you to define options to notify after transaction succeeded. Two options are available:
queuePlacementthe PNR will be placed on one or more queues after finishing the transaction.
designatePrintersallows you to define printers to be used during the transaction. The following options are available:
printerProfileNumber- assigns a previously defined printer profile
hardcopy- assigns a hardcopy printer for the transaction
invoiceItinerary- assigns an invoice and itinerary printer for the transaction
ticket- assigns a ticket printer for the transaction
confirmationIdis used to specify the PNR Locator or Sabre Order ID. Alternatively,
ticketscan be defined.
The Void Flight Tickets response contains:
- Errors and warnings (if applicable). If not present (empty or contains warnings only) then execution is successful. Warnings might be returned for unsuccessful cancellation of a particular ticket when requested ErrorHandlingPolicy=ALLOW_PARTIAL_CANCEL.
- Original request
- List of voided tickets
Void of NDC documents is currently not available
A maximum of 12 documents is supported
All documents must belong to the same reservation (PNR)
This section illustrates the current error handling logic for Void Flight Tickets:
Note: Please access the Void Flight Tickets - Error List section for additional details on possible errors returned by Void Flight Tickets.
The error type
UNABLE_TO_VOID_TICKET can be returned with the category
CANCELLATION_ERROR, as well as with a
WARNING. The category depends on the
ErrorHandlingPolicy sent in the request. For
CANCELLATION_ERROR displays, and for
If you've set the API to not accept any failures (policy=
HALT_ON_ERROR), then any failure in a downstream API being called results in an error in the Void Flight Tickets response.
If you've set the API to accept partial successes (policy=
ALLOW_PARTIAL_CANCEL), then returning downstream API errors suggests that the entire void process failed. However, this is not quite true. Therefore, these errors/failures result as warnings in the Void Flight Tickets response.
The Void Flight Tickets response contains errors and warnings returned by downstream APIs and are always returned as a
Caution! Since void transaction is irreversible, a failure with one of the documents might return an error, but previously processed documents are voided.