Breadcrumb
- Booking Management API User Guide
- Check Flight Tickets
- Check Flight Tickets - Examples
Check Flight Tickets - Examples
Below are some common use cases on how to check flight tickets:
Check a single document
To ensure the successful check of the requested document, the request should contain:
- Add
tickets
number
(13-digit electronic document number)
"tickets": [
{
"number": "1607531707951"
}
]
}
Check all documents of a booking
To ensure the successful check of the requested document, the request should contain:
- Add
confirmationId
(PNR Locator or Sabre Order ID)
"confirmationId": "ABCDEF"
}
Check two documents and change context
To ensure the successful check of the requested documents and to switch from the current Pseudo City Code (PCC) to the target PCC where the transaction should be executed, the request should contain:
- Add
tickets
number
(13-digit electronic document number)
- Add
targetPcc
(The PCC where the void transaction of the ticket should be executed)
"targetPcc": "7KFA",
"tickets": [
{
"number": "0143357868284"
},
{
"number": "0143357868285"
}
]
}
Check multiple documents and define refund qualifiers
To ensure the successful check of multiple documents, including refund qualifiers, the request should contain:
- Add
tickets
number
(13-digit electronic document number)
- Add
refundQualifiers
- for example:waiverCode
overrideCancelFee
commissionAmount
"tickets": [
{
"number": "6077531707952",
"refundQualifiers": {
"waiverCode": "ABCD1234",
"commissionAmount": "25.00"
}
},
{
"number": "6077531707953",
"refundQualifiers": {
"overrideCancelFee": "0.00",
"commissionAmount": "15.00"
}
}
]
}
Caution! By defining refund qualifiers, you'll override Sabre system pricing. Use this at your own risk.
Use Cases
The use cases below have been compiled to better illustrate the logical flow of Check Flight Ticket.
Use Case 1 - Check a single flight ticket
This use case is based on a reservation (PNR RECLOC: MSPKUK
) for one traveler. The segment was booked as traditional Sabre air content:
*MSPKUK*IA«
1 CX 652Y 10JUN Q SINHKG HK1 1255P 505P /DCCX*3EGJAB /E
2 CX 735Y 15JUN T HKGSIN HK1 225P 625P /DCCX*3EGJAB /E
The ticket was issued without any additional documents:
*BYOKLY*T«
TKT/TIME LIMIT
1.T-11FEB-G7RE*AWX
2.TE 1607531707951-AT MILLE/M G7RE*AWX 0114/11FEB*
The current ticket image indicates:
ELECTRONIC TICKET RECORD CRS CODE:1536
INV: CUST: PNR:MSPKUK
TKT:1607531707951 ISSUED:11FEB21 PCC:G7RE IATA:99999999
NAME:MILLER/MAX
FORM OF PAYMENT FCI: 0
1 CASH
CPN A/L FLT CLS DATE BRDOFF TIME ST F/B STAT
1 CX 652 Y 10JUN SINHKG 1255P OK YRZZSGAR OPEN
NVB:10JUN NVA:10JUN BAG:30K
2 CX 735 Y 15JUN HKGSIN 225P OK YRZZSGAR OPEN
NVB:15JUN NVA:15JUN BAG:30K
FARE SGD1295.00
TOTAL USD1063.80 EQUIVALENT FARE PAID USD975.00
In order to execute check flight ticket operation, determine the desired document number.
For example, the request to check the document could be:
"tickets": [
{
"number": "1607531707951"
}
]
}
The response does not contain errors:
"request": {
"tickets": [
{
"number": "1607531707951"
}
]
},
"tickets": [
{
"number": "1607531707951",
"isVoidable": true,
"isRefundable": true,
"refundTotals": {
"subtotal": "885.00",
"taxes": "88.80",
"total": "973.80",
"currencyCode": "USD"
}
}
]
}
In this case, the ticket meets the requirements for both options:
- Void: ticket is within void period, coupons are all open
- Refund: at least one coupon is open, carrier (CX - Cathay Pacific participates in Automated Refunds), system was able to price a refund
The reservation was not updated and the ticket remains untouched.
Use Case 2 - Check multiplke flight tickets and change context
This use case is based on a reservation (PNR RECLOC: KOEYRR
) for two travelers. The segments were booked as traditional Sabre air content:
*KOEYRR*I*T«
1 AC 200Y 10SEP F YVRYYC HK2 600A 830A /DCAC*TQGZ47 /E
2 AC 201Y 15SEP W YYCYVR HK2 630A 705A /DCAC*TQGZ47 /E
TKT/TIME LIMIT
1.T-11FEB-7KFA*AWX
2.TE 0143357868284-AT MEYER/C 7KFA*AWX 0729/11FEB*I
3.TE 0143357868285-AT SCHUL/A 7KFA*AWX 0729/11FEB*I
The ticket image of 0143357868284
indicates:
ELECTRONIC TICKET RECORD CRS CODE:1536
INV: CUST: PNR:KOEYRR
TKT:0143357868284 ISSUED:11FEB21 PCC:7KFA IATA:99999999
NAME:MEYER/CAROL
FORM OF PAYMENT FCI: 0
1 CASH
CPN A/L FLT CLS DATE BRDOFF TIME ST F/B STAT
1 AC 200 Y 10SEP YVRYYC 600A OK Y0NAZALT OPEN
NVB: NVA:10SEP BAG:2PC
2 AC 201 Y 15SEP YYCYVR 630A OK Y0NAZALT OPEN
NVB: NVA:10SEP BAG:2PC
FARE CAD1364.00
TOTAL GBP849.90 EQUIVALENT FARE PAID GBP778.00
To check both documents and change the context to the Pseudo City where they were issued, the request to Check Flight Ticket should be:
"targetPcc": "7KFA",
"tickets": [
{
"number": "0143357868284"
},
{
"number": "0143357868285"
}
]
}
No errors are returned in the response:
"request": {
"targetPcc": "7KFA",
"tickets": [
{
"number": "0143357868284"
},
{
"number": "0143357868285"
}
]
},
"tickets": [
{
"number": "0143357868284",
"isVoidable": true,
"isRefundable": true,
"refundTotals": {
"subtotal": "778.00",
"taxes": "71.90",
"total": "849.90",
"currencyCode": "GBP"
}
},
{
"number": "0143357868285",
"isVoidable": true,
"isRefundable": true,
"refundTotals": {
"subtotal": "778.00",
"taxes": "71.90",
"total": "849.90",
"currencyCode": "GBP"
}
}
]
}
The reservation was not updated. Both tickets return options for void and refund.
Use Case 3 - Check multiple documents and define refund qualifiers
Below is an example of a simple round-trip air itinerary (PNR RECLOC: WLXFYU
). These segments are booked as traditional Sabre air content:
*IA*T
1 EY7309Y 11JUN F AMSAUH*HK2 1115A 805P /DCEY*UTCAPI /E
2 EY 377Y 11JUN F AUHBAH*HK2 935P 945P /DCEY*UTCAPI /E
3 EY3154Y 21JUN M BAHAUH*TK2 130A 345A /DCEY*UTCAPI /E
4 EY 77Y 21JUN M AUHAMS*HK2 930A 240P /DCEY*UTCAPI /E
TKT/TIME LIMIT
1.T-11FEB-G7RE*AWX
2.TE 6077531707952-AT DOE/J G7RE*AWX 0147/11FEB*
3.TE 6077531707953-AT SMITH/L G7RE*AWX 0147/11FEB*
Tickets were issued for both travelers:
ELECTRONIC TICKET RECORD CRS CODE:0011
INV: CUST: PNR:WLXFYU
TKT:6077531707952 ISSUED:11FEB21 PCC:G7RE IATA:99999999
NAME:DOE/JOHN
FORM OF PAYMENT FCI: 0
1 CASH
CPN A/L FLT CLS DATE BRDOFF TIME ST F/B STAT
1 EY 7309 Y 11JUN AMSAUH 1115A OK YLF2NL OPEN
NVB:11JUN NVA:11JUN BAG:35K
2 EY 377 Y 11JUN AUHBAH 935P OK YLF2NL OPEN
NVB:11JUN NVA:11JUN BAG:35K
3 EY 3154 Y 21JUN BAHAUH 130A OK YLF2NL OPEN
NVB:21JUN NVA:21JUN BAG:35K
4 EY 77 Y 21JUN AUHAMS 930A OK YLF2NL OPEN
NVB:21JUN NVA:21JUN BAG:35K
FARE EUR1872.00
TOTAL USD2509.20 EQUIVALENT FARE PAID USD2264.00
ELECTRONIC TICKET RECORD CRS CODE:0011
INV: CUST: PNR:WLXFYU
TKT:6077531707953 ISSUED:11FEB21 PCC:G7RE IATA:99999999
NAME:SMITH/LAWRENCE
FORM OF PAYMENT FCI: 0
1 CASH
CPN A/L FLT CLS DATE BRDOFF TIME ST F/B STAT
1 EY 7309 Y 11JUN AMSAUH 1115A OK YLF2NLCH OPEN
NVB:11JUN NVA:11JUN BAG:35K
2 EY 377 Y 11JUN AUHBAH 935P OK YLF2NLCH OPEN
NVB:11JUN NVA:11JUN BAG:35K
3 EY 3154 Y 21JUN BAHAUH 130A OK YLF2NLCH OPEN
NVB:21JUN NVA:21JUN BAG:35K
4 EY 77 Y 21JUN AUHAMS 930A OK YLF2NLCH OPEN
NVB:21JUN NVA:21JUN BAG:35K
FARE EUR1409.00
TOTAL USD1949.20 EQUIVALENT FARE PAID USD1704.00
In order to execute the check flight ticket operation, determine the desired document numbers and applicable refund qualifiers.
For example, the request to check all documents could be:
"tickets": [
{
"number": "6077531707952",
"refundQualifiers": {
"waiverCode": "ABCD1234",
"commissionAmount": "25.00"
}
},
{
"number": "6077531707953",
"refundQualifiers": {
"overrideCancelFee": "0.00",
"commissionAmount": "15.00",
"overrideTaxes": [
{
"taxCode": "CJ",
"taxAmount": "5.00"
}
]
}
}
]
}
In this example, we specified different qualifiers for each ticket:
6077531707952
waiverCode
to apply a waiver code as provisioned by the issueing carriercommissionAmount
to apply a commission you will receive for this refund
6077531707953
overrideCancelFee
to specify the cancel feecommissionAmount
to apply a commission you will receive for this refundoverrideTaxes
to apply refundable amounts for specific taxes
Caution! By defining refund qualifiers, you'll override Sabre system pricing. Use at your own risk.
There are no errors in the response:
"request": {
"tickets": [
{
"number": "6077531707952",
"refundQualifiers": {
"commissionAmount": "25.00",
"waiverCode": "ABCD1234"
}
},
{
"number": "6077531707953",
"refundQualifiers": {
"overrideCancelFee": "0.00",
"overrideTaxes": [
{
"taxCode": "CJ",
"taxAmount": "5.00"
}
],
"commissionAmount": "15.00"
}
}
]
},
"tickets": [
{
"number": "6077531707952",
"isVoidable": true,
"isRefundable": true,
"refundTotals": {
"subtotal": "2264.00",
"taxes": "245.20",
"total": "2509.20",
"currencyCode": "USD"
}
},
{
"number": "6077531707953",
"isVoidable": true,
"isRefundable": true,
"refundTotals": {
"subtotal": "1704.00",
"taxes": "245.20",
"total": "1949.20",
"currencyCode": "USD"
}
}
]
}
The reservation was not updated. The tickets remain with open coupons.
Use Case 4 - Check NDC Order
Below is an example of a simple round-trip air itinerary (PNR RECLOC: IORVQO
/ Sabre Order ID: 1SXXXCITUW8P4
). These segments are booked as NDC Sabre air content:
"startDate": "2021-05-30",
"endDate": "2021-06-05",
"flights": [
{
"itemId": "10",
"confirmationId": "4T3XNE",
"sourceType": "NDC",
"flightNumber": 444,
"airlineCode": "QF",
"operatingFlightNumber": 444,
"operatingAirlineCode": "QF",
"fromAirportCode": "MEL",
"toAirportCode": "SYD",
"departureDate": "2021-05-30",
"departureTime": "13:00:00",
"departureTerminalName": "1",
"arrivalDate": "2021-05-30",
"arrivalTime": "14:25:00",
"arrivalTerminalName": "3",
"cabinTypeName": "ECONOMY",
"cabinTypeCode": "Y",
"aircraftTypeCode": "73H",
"aircraftTypeName": "BOEING 737 800",
"bookingClass": "O",
"meals": [
{
"code": "H",
"description": "Hot meal"
}
],
"flightStatusCode": "HK",
"flightStatusName": "Confirmed",
"durationInMinutes": 85,
"distanceInMiles": 456
},
{
"itemId": "11",
"confirmationId": "4T3XNE",
"sourceType": "NDC",
"flightNumber": 437,
"airlineCode": "QF",
"operatingFlightNumber": 437,
"operatingAirlineCode": "QF",
"fromAirportCode": "SYD",
"toAirportCode": "MEL",
"departureDate": "2021-06-05",
"departureTime": "11:00:00",
"departureTerminalName": "3",
"arrivalDate": "2021-06-05",
"arrivalTime": "12:35:00",
"arrivalTerminalName": "1",
"cabinTypeName": "ECONOMY",
"cabinTypeCode": "Y",
"aircraftTypeCode": "73H",
"aircraftTypeName": "BOEING 737 800",
"bookingClass": "O",
"meals": [
{
"code": "H",
"description": "Hot meal"
}
],
"flightStatusCode": "HK",
"flightStatusName": "Confirmed",
"durationInMinutes": 95,
"distanceInMiles": 456
}
],
"flightTickets": [
{
"number": "0815740238620",
"date": "2021-03-22",
"travelerIndex": 1,
"flightCoupons": [
{
"itemId": "10",
"couponStatus": "Not Flown",
"couponStatusCode": "I"
},
{
"itemId": "11",
"couponStatus": "Not Flown",
"couponStatusCode": "I"
}
],
"payment": {
"subtotal": "153.00",
"taxes": "57.20",
"total": "210.20",
"currencyCode": "USD"
},
"ticketStatusName": "Issued",
"ticketStatusCode": "TO"
}
],
"request": {
"confirmationId": "1SXXXCITUW8P4",
"returnOnly": [
"FLIGHTS",
"TICKETS"
]
}
}
In this example, we will check void or refund options for the entire order using the Sabre Order ID:
"confirmationId": "1SXXXCITUW8P4"
}
There are no errors in the response:
"request": {
"confirmationId": "1SXXXCITUW8P4"
},
"cancelOffers": [
{
"offerType": "VOID",
"offerItemId": "cb7778589bcbb4hpnkmkhp4ya1",
"offerExpirationDate": "2021-03-22",
"offerExpirationTime": "11:53"
}
]
}
The reservation was not updated and the order remains in its current state.
In this example, we're still in the void period and the only option is offerType: "VOID"
. To finally execute the void offer, apply "offerItemId": "cb7778589bcbb4hpnkmkhp4ya1"
to your cancelBookingRequest.