Skip to main content

Order Management

Air
Reservation
REST API
Travel Agency
Try Now

What is it?

Order Management is used to create, change, cancel, and view the content of a specified airline order.

All methods listed below are stateless and REST/JSON:

Orders/Create

The Orders/Create method is used to book flights returned within an NDC (New Distribution Capability) offer. Orders/Create is used for single passenger itineraries and does not currently support ancillary services.

Orders/Change (Passenger Data)

The Orders/Change method is used to add, delete, or change information in an existing order. Items to change can include remarks, telephone contacts, secure flight information and APIS, email addresses, and frequent flyer numbers. Orders/Change does not currently allow the modification of flights.

Orders/View

The Orders/View method is used to display information from an Order within the Sabre Order Management System (OMS).

Orders/Cancel

The Orders/Cancel method is used to cancel an entire order. This may be prior to or after the order has been fulfilled.

Orders/Change (Fulfillment)

The Orders/Change method is primarily used to add information to an order, but can also be used for fulfillment.

Offers/Reshop/CancelOrder

The Offers/Reshop/CancelOrder method is used to determine price variation as a result of a modification to the itinerary:

  • Check for any applicable penalty fees when a fulfilled order is canceled
  • Determine whether the ticket is in the void period or is eligible to be refunded with any penalty fees

Why use it?

Carriers are looking to enhance product offerings and increase revenues by providing personalized offers. Previously, fares and ancillary prices were based on filed schedules and fare information.

With NDC capabilities, shopping requests are sent to the airline and an offer is returned; these shopping requests may be anonymous or contain passenger information such as a corporate ID.

Orders/Create

Business use case

The Orders/Create API enables the booking capability of NDC offers that were returned by carriers and then saved to the Sabre Offer Store.

Orders/Change (Passenger Data)

Business use case

After the successful creation of an NDC order, use Orders/Change to update information within the order. For example, an agent may receive a request to add a frequent flyer number to an order.

Orders/View

Business use case

After the successful creation of an NDC order, use Orders/View to display information from the order; this can include itinerary information, passenger data, pricing information, and information on any documents that have been issued.

Note: Either a Sabre Order ID or the Sabre Record Locator may be used to retrieve the order.

Orders/Cancel

Business use case

Use Orders/Cancel to cancel and order. Once the cancellation has been completed, the order and the PNR will show that the flights have been canceled.

Orders/Change (Fulfillment)

Business use case

Use Orders/Change to complete the payment for an order.

Send the Orders/Change request with the payment information and an Order ID, and the carrier will process the payment and provide the applicable documents, ticket numbers, and coupon statuses in the response.

Offers/Reshop/CancelOrder

Business use case

Use Offers/Reshop/CancelOrder to determine if a ticket may be voided or if it needs to be refunded first. Offers/Reshop/CancelOrder will also identify any cancellation fees that the passenger should be made aware of.

The carrier will return an offer ID for the cancellation, which must be referenced in the Orders/Cancel request.

How it works

Data used by Orders/Create

To make a successful call, include the OfferID in the Orders/Create request, along with the passenger name and other mandatory data elements. After the request is sent, a response is returned with the carrier’s OrderID, the Sabre OrderID, and the Sabre Record Locator.

  • Orders/Create is dependent on a sellable offer in the Offer Store
  • The response to an Orders/Create request is an Orders/View response
  • The offer is validated by use of Offers/Price, which includes additional information from the initial BFM response, including a full breakdown of taxes
  • The order is written to the Sabre Order Management System (OMS)
  • In our initial implementation of this API, all offers are meant for a single adult passenger
  • Flight types include: nonstop, connecting, and flights with stops (Direct)
  • Offers may include codeshare flights, flights operated by regional carriers, and interline itineraries
  • Total fares: All taxes and fees are included; however, ancillary fees charged by airlines, such as baggage and preferred seating, are not included
  • Orders can only be created for NDC offers; carrier activations will increase the amount of NDC offers returned in Bargain Finder Max (BFM) results
  • After the successful creation of an order, a PNR is created in the Sabre system
  • An NDC order may be added to a partial or completed PNR
  • Passenger information can be added to the order during creation, with the supported data elements:
    • Remarks
    • Frequent flyer number
    • Telephone contact numbers
    • Email address
    • Secure flight information
    • Passport (APIS)
    • Client ID (CLID)

Data used by Orders/Change (Passenger Data)

Note: Orders/Change does not currently allow for the modification of flights.

  • Orders/Change is dependent on an order in the Sabre Order Management System (OMS)
  • The response to an Orders/Change request is an Orders/View response
  • Passenger information can be added to the order with the supported data elements:
    • Remarks
    • Frequent flyer number
    • Telephone contact numbers
    • Email address
    • Secure flight information
    • Passport (APIS)
  • Information added to the order may be replicated into the Sabre PNR
  • Some carriers may not support the addition or deletion of passenger data to or from an order

Data used by Orders/View

  • Orders/View is dependent on an order in the Sabre Order Management System (OMS)
  • The response to an Orders/View request is an Orders/View response
  • Orders/View returns all data within the order from the Sabre Order Management System (OMS), including:
    • Flight segments
    • Passenger information
    • Pricing data, including full breakdown of taxes
    • Ticket information, including document numbers and coupon status
    • Carrier order IDs

Data used by Orders/Cancel

This method may be utilized prior to or after the order has been fulfilled.

  • An Orders/Cancel request requires either a Sabre Order ID, or the Sabre Record Locator and ReshopOfferItemID if the order has been fulfilled
  • The response to an Orders/Cancel request is an Orders/View response without canceled flight information
  • In the case where the order has been fulfilled, the Sabre PNR will be updated with ticketing lines (void or refund)
  • At this time, a refund accounting line is not added to the PNR and an Interface User Record (IUR) is not generated

Data used by Orders/Change (Fulfillment)

To fulfill an order using the Orders/Change method, send payment information, along with the order ID, in the request message.

  • Orders/Change is dependent on an order in the Sabre Order Management System (OMS)
  • The Orders/Change API sends the fulfillment request to the airline who processes payments and issues documents
  • The order is updated with the ticket number(s) and coupon status
  • Cash and credit card forms of payment are supported
  • When cash is requested, Sabre checks the TJR for CC FOP and validates that the requestor has a valid IATA number
  • The Sabre PNR is updated with ticketing lines
  • An accounting line is added to the PNR
  • An Interface User Record (IUR) is generated to the agent’s back office system if applicable

Data used by Offers/Reshop/CancelOrder

This method is used prior to the Orders/Cancel request and identifies whether the ticket is in the void period, or if it's eligible to be refunded (and if so, whether any penalty fees apply).

This method is mandatory prior to cancelling a fulfilled order. The "re-shop" offer ID must be included in the cancellation request.

Note: Offers/Reshop/CancelOrder requires the Sabre Order ID and the Order Items ID.

  1. Offers/Reshop/CancelOrder sends the re-shop request to the carrier, who determines if the ticket(s) is in the void period or if it must be refunded. If so, cancellation fees are calculated and returned in the response.
  2. The carrier returns an offer for the cancellation, which is written to the Sabre Offer Store (OFS).
  3. The offer has a time to live that is returned in the response (Offer Expiration Date/Time).
  4. If the agent decides to continue with the cancellation, then the Offer Item ID(s) must be included in the Orders/Cancel request.

Note: Some carriers may not support void or refund actions.

For this initial release, a refund accounting line is not added to the PNR and an Interface User Record (IUR) is not generated to the agent’s back office system, if applicable.

How to use

NOTE: All endpoints accept only JSON format.

Orders/Create API

POST /v1/orders/create HTTP/1.1 - Create Order Request: Order with OfferID.
Response: Created Order with OrderID.

Orders/Change API

POST /v1/orders/change HTTP/1.1 - Change Order Request: Elements to be added or changed in Order.
Response: Changed Order.

Orders/View API

POST /v1/orders/view HTTP/1.1 - View Order Request: OrderID.
Response: Order.

Orders/Cancel API

POST /v1/orders/cancel HTTP/1.1 - Cancel Order Request: Cancel Order.
Response: Canceled Order.

Resources