TravelCaster API - Flights - ChangeFlightBookingStatus operation

Back to Flights home.

After you perform a booking over the TravelCaster API, you can interact with your API provider to request ticketing or cancellation of that booking up to 48hs after booking creation. It mimics the feature available in the TravelCaster BackOffice. Always check the actual status using RetrieveBooking operation.

The ChangeFlightBookingStatus operation returns a FlightBookingStatusChangeResponse object, containing the booking number, the previous status and the new status. To call this operation you will need a valid token, obtained previously with the GetAccessToken operation. If your token is no longer valid, you will receive a 1210 error. See the Transaction Codes page for more information.

Request

JSON

http://endpoint/api/version/FlightService.json/ChangeFlightBookingStatus [POST]

url-encoded parameter: request([FlightBookingStatusChangeRequest])

returns: FlightBookingStatusChangeResponse

WebService

http://endpoint/api/version/FlightService.asmx

operation: ChangeFlightBookingStatus

parameters: request([FlightBookingStatusChangeRequest])

returns: FlightBookingStatusChangeResponse

Structure of the FlightBookingStatusChangeRequest object

FlightBookingStatusChangeRequest
 |
 |_ Token (string)
 |_ BookingNumber (string)
 |_ BookingStatus (int - see below for supported values)
 |_ AdditionalFreeText (string - optional free text to attach to the booking status change, use BookingStatus code 999 to just add the message without changing the current status)

Structure of the FlightBookingStatusChangeResponse object

FlightBookingStatusChangeResponse
 |
 |_ Token (string)
 |_ TransactionID (string)
 |_ TransactionCode (string)
 |_ TransactionMessage (string)
 |
 |_ BookingNumber (string)
 |_ PreviousStatus (int - status of the booking previous to the update)
 |_ CurrentStatus (int - current updated booking status)

List of supported status values

  • 101 - Request booking cancellation.
    • If the reservation does not contain tickets, the service will cancel the itinerary.
    • If the reservation contains tickets, the service will cancel the itinerary and void the tickets.
  • 102 - Request ticketing.
  • 999 - Do not change status, only add message to the booking.

Notes

Back to Flights home.

See change history for this file
Loading...