Skip to main content

Stateless Void API

trip management
ticketing
REST API
Airline Carrier
Try Now

What is it?

The Stateless Void API lets you manage your reservation in a more efficient way. It is available in RPC/JSON format and designed to operate in a stateless way. These implementations are simplified to ensure that both experts and novices alike can integrate and adopt Sabre APIs in the most seamless way possible.

The Stateless Void API method provides a single, unified service to void a list of electronic documents. The initial release (PoC) supports the voiding operation of the stand-alone tickets.

Why use it?

Stateless Void API

  • Simplifies the ticket cancellation process by removing the need to use individual/granular APIs to void an electronic document
  • Voids multiple electronic documents (up to 12) from one reservation in a single call
  • Verifies status of the ticket coupons before voiding operation is executed
  • Voids electronic documents and update the reservation in a stateless way
  • Adds capability to define the API's behavior when encountering errors (halt on error or allow partial cancel)

How it works

Stateless Void API

  1. Retrieves all electronic documents by the given ticketing document number or confirmationId.
  2. Validates the coupon status.
  3. Validates the void period.
  4. Calls the Void Air Ticket downline service.
  5. Finalizes/commits the transaction in the event of a success or partial success.

How to use

Stateless Void API

A few examples of using Stateless Void API are mentioned below. Additional information can be found under the Reference Documentation tab and the Help tab.

Cancel single electronic document with "allow partial cancel" error policy

To ensure the successful cancellation of the document, the request should contain the below information:

  1. Add tickets (13 digit electronic document number) or confirmationId (PNR Locator).
  2. Add and set the errorHandlingPolicy flag to ALLOW_PARTIAL_CANCEL ("errorHandlingPolicy": "ALLOW_PARTIAL_CANCEL").
    {
      "tickets": [
        "0392161398414"
      ],
      "errorHandlingPolicy": "ALLOW_PARTIAL_CANCEL"  
    }

The electronic document was voided and the reservation was updated:

TKT/TIME LIMIT                                                  
  1.T-22MAR-LAX5B11                                            
  2.TE 0392161398414 ABC/J LAX5B11 0135/22MAR
    TV 0392161398414 *VOID*  LAX5B11 0136/22MAR

Cancel multiple electronic document with "halt on error" error policy

To ensure the successful cancellation of the document, the request should contain the below information:

  1. Add tickets (13 digit electronic document number).
  2. Add and set the errorHandlingPolicy flag to HALT_ON_ERROR ("errorHandlingPolicy": "HALT_ON_ERROR").
    {
      "tickets": [
        "0392161398415",
        "0392161398416",
        "0392161398417"
      ],
      "errorHandlingPolicy": "HALT_ON_ERROR"  
    }

The electronic documents were voided and the reservation was updated:

TKT/TIME LIMIT                                                  
  1.T-22MAR-LAX5B11
  2.TE 0392161398415 ABC/J LAX5B11 0146/22MAR
  3.TE 0392161398416 ABC/J LAX5B11 0147/22MAR
  4.TE 0392161398417 ABC/J LAX5B11 0147/22MAR
    TV 0392161398415 *VOID*  LAX5B11 0149/22MAR
    TV 0392161398416 *VOID*  LAX5B11 0149/22MAR
    TV 0392161398417 *VOID*  LAX5B11 0149/22MAR