Cancel (JSON)

 

API情報

当該機能は、NDC PNRをキャンセルするAPI(Endpoint)です。

Sabre NDC 機能対応状況一覧表につきましては以下のページよりご確認ください。
(Sabre Help Desk - 機能対応状況一覧表:ログインが必要です)  

最新バージョン :1.4.0
プロトコル :JSON
HTTPメソッド :POST
Endpoint :/v1/orders/cancel
注1: Endpointは、HTTPリクエストヘッダーに設定します。
注2: Endpoint情報は、バージョンによって異なりますので、
最新バージョン以外のEndpointは、タグ定義書をご確認ください。
 

更新履歴

Order Management(Order Cancel) v1.4.0 on July 31, 2025
  • Version 1.4.0をリリースいたしました。
Order Management(Order Cancel) v1.3.0 on March 31, 2025
  • Version 1.3.0をリリースいたしました。
 

リクエストサンプル

未発券

未発券PNRへキャンセル操作を行うと、セグメント情報は全て削除されます。
削除後のPNRでは、セグメント情報を確認することはできないためご注意ください。
 選択{
	"id":"1SXXXCZQOMVWW"
}

レスポンスサンプル

 選択{
    "order": {
        "id": "1SXXXCZQOMVWW",
        "type": "ORDER",
        "pnrLocator": "TWYLZG",
        "pnrCreateDate": "2024-10-23",
        "offerVendor": "SQ",
        "orderOwner": "1S",
        "partition": "AA",
        "primeHost": "1S",
        "countryCode": "JP",
        "contactInfos": [
            {
                "id": "9F0B8D2E-6B9A-41F8-89DA-D5B5C3287367",
                "givenName": "TARO",
                "phones": [
                    {
                        "id": "B5887141-5D71-4719-8827-1D43955498A1",
                        "number": "000-000-0000",
                        "label": "Agency"
                    }
                ],
                "emailAddresses": [
                    {
                        "id": "3050A16E-8E33-431B-A5DC-7D16F1470DD1",
                        "address": "xxxxx@aaaaa.jp"
                    }
                ]
            },
            {
                "id": "A3BB7ECF-234A-4D42-B2AC-946677643C6F",
                "givenName": "HANAKO",
                "phones": [
                    {
                        "id": "33CD9D67-E6E6-4F83-8C89-9EB897ADB8FD",
                        "number": "000-000-0000",
                        "label": "Agency"
                    }
                ],
                "emailAddresses": [
                    {
                        "id": "39BABC8A-1B22-445C-A75A-E7E642746BC1",
                        "address": "xxxxx@aaaaa.jp"
                    }
                ]
            }
        ],
        "passengers": [
            {
                "id": "Passenger1",
                "externalId": "PAX2",
                "typeCode": "ADT",
                "contactInfoRefIds": [
                    "9F0B8D2E-6B9A-41F8-89DA-D5B5C3287367"
                ],
                "contactInfoRefId": "9F0B8D2E-6B9A-41F8-89DA-D5B5C3287367",
                "birthdate": "1990-10-01",
                "titleName": "MR",
                "givenName": "TARO",
                "middleName": "M",
                "surname": "INFINI",
                "genderCode": "M",
                "identityDocuments": [
                    {
                        "id": "32928E2A-E82E-4FC1-9583-9A623E47BE71",
                        "documentNumber": "56789",
                        "documentTypeCode": "PT",
                        "issuingCountryCode": "JP",
                        "residenceCountryCode": "JP",
                        "expiryDate": "2025-10-08",
                        "birthdate": "1990-10-01",
                        "genderCode": "M",
                        "givenName": "TARO",
                        "surname": "INFINI"
                    },
                    {
                        "id": "CEA29042-4165-4A4A-B5A6-B63C24C3247A",
                        "documentNumber": "76543210",
                        "documentTypeCode": "VA",
                        "issuingCountryCode": "JP",
                        "expiryDate": "2025-08-27",
                        "birthdate": "1990-10-01",
                        "genderCode": "M",
                        "givenName": "TARO",
                        "surname": "INFINI"
                    }
                ],
                "loyaltyProgramAccounts": [
                    {
                        "id": "6537E552-E61B-4121-B66A-F71656E70D0E",
                        "accountNumber": "0123456789",
                        "carrier": {
                            "carrierCode": "SQ"
                        }
                    }
                ]
            },
            {
                "id": "Passenger2",
                "externalId": "PAX3",
                "typeCode": "ADT",
                "contactInfoRefIds": [
                    "A3BB7ECF-234A-4D42-B2AC-946677643C6F"
                ],
                "contactInfoRefId": "A3BB7ECF-234A-4D42-B2AC-946677643C6F",
                "birthdate": "2012-10-11",
                "titleName": "MS",
                "givenName": "HANAKO",
                "middleName": "BBB",
                "surname": "INFINI",
                "genderCode": "F"
            }
        ],
        "customerNumber": {},
        "externalOrders": [
            {
                "id": "CBB825F1-5581-4B9D-BE85-407D45F5989C",
                "systemId": "SQ",
                "externalOrderId": "SQ_6HAMGE",
                "bookingReferences": [
                    {
                        "id": "6HAMGE",
                        "carrierCode": "SQ"
                    }
                ]
            }
        ]
    }
}

発券済み(VOID/REFUND)

リクエストに設定する"reshopOfferItemIds"はReshop Cancel Orderから取得してください。
 選択{
	"id": "1SXXXCTSAWOXW",
	"reshopOfferItemIds":[
        "ce0cb74c46d9v8w6qmddvy6ir3-1"
    ] 
}

レスポンスサンプル

 選択{
    "order": {
        "id": "1SXXXCTSAWOXW",
        "type": "ORDER",
        "pnrLocator": "PVZLVL",
        "pnrCreateDate": "2025-07-18",
        "offerVendor": "QF",
        "orderOwner": "1S",
        "partition": "AA",
        "primeHost": "1S",
        "countryCode": "JP",
        "contactInfos": [
            {
                "id": "9AD61C46-2721-42E6-983F-366AD7CCF6A3",
                "givenName": "AO",
                "phones": [
                    {
                        "id": "78FA11A3-B5CC-4D6C-91DC-F46B7770D49A",
                        "number": "000-000-0000",
                        "label": "Agency"
                    }
                ],
                "emailAddresses": [
                    {
                        "id": "8055F8AB-948D-4DF3-83FC-CE18B8F61277",
                        "address": "xxxxx@aaaaa.jp"
                    }
                ]
            }
        ],
        "passengers": [
            {
                "id": "Passenger1",
                "externalId": "T1",
                "typeCode": "ADT",
                "contactInfoRefIds": [
                    "9AD61C46-2721-42E6-983F-366AD7CCF6A3"
                ],
                "contactInfoRefId": "9AD61C46-2721-42E6-983F-366AD7CCF6A3",
                "birthdate": "1990-10-01",
                "titleName": "MR",
                "givenName": "AO",
                "middleName": "M",
                "surname": "SORANO",
                "genderCode": "M",
                "identityDocuments": [
                    {
                        "id": "8E87240E-DECD-4179-9856-B95172612EF4",
                        "documentNumber": "56789",
                        "documentTypeCode": "PT",
                        "issuingCountryCode": "JP",
                        "residenceCountryCode": "JP",
                        "expiryDate": "2025-10-08",
                        "birthdate": "1990-10-01",
                        "genderCode": "M",
                        "givenName": "AO",
                        "surname": "SORANO"
                    }
                ],
                "loyaltyProgramAccounts": [
                    {
                        "id": "D3EBBE48-1D9A-4BB6-8711-BA919EE9059A",
                        "accountNumber": "0123456789",
                        "carrier": {
                            "carrierCode": "SQ"
                        }
                    }
                ]
            }
        ],
        "customerNumber": {},
        "externalOrders": [
            {
                "id": "8E387296-96EC-4841-A2FF-A76EA840B3C3",
                "systemId": "QF",
                "externalOrderId": "QF081HM3HNUA7",
                "bookingReferences": [
                    {
                        "id": "9M3HNU",
                        "carrierCode": "F1"
                    },
                    {
                        "id": "F8NCKF",
                        "carrierCode": "QF"
                    }
                ]
            }
        ],
        "ticketingDocumentInfo": [
            {
                "document": {
                    "number": "0815758527423",
                    "type": "702",
                    "issueDateTime": "2025-07-18T16:57:00Z",
                    "ticketingLocation": "TYO",
                    "numberOfBooklets": 1,
                    "reportingType": "BSP",
                    "coupons": [
                        {
                            "number": 1,
                            "status": "RF",
                            "segmentInfo": {
                                "departureAirport": "NRT",
                                "arrivalAirport": "BNE",
                                "marketingAirlineCode": "QF",
                                "departureTime": "2025-10-12T21:30:00",
                                "arrivalTime": "2025-10-13T07:25:00",
                                "flightNumber": 62,
                                "classOfService": "Q"
                            }
                        },
                        {
                            "number": 2,
                            "status": "RF",
                            "segmentInfo": {
                                "departureAirport": "BNE",
                                "arrivalAirport": "SYD",
                                "marketingAirlineCode": "QF",
                                "departureTime": "2025-10-13T10:15:00",
                                "arrivalTime": "2025-10-13T12:50:00",
                                "flightNumber": 521,
                                "classOfService": "Q"
                            }
                        },
                        {
                            "number": 3,
                            "status": "RF",
                            "segmentInfo": {
                                "departureAirport": "SYD",
                                "arrivalAirport": "HND",
                                "marketingAirlineCode": "QF",
                                "departureTime": "2025-10-18T12:10:00",
                                "arrivalTime": "2025-10-18T20:15:00",
                                "flightNumber": 59,
                                "classOfService": "O"
                            }
                        }
                    ],
                    "issueDateTimeText": "2025-07-18T16:57:00",
                    "issueDateTimeComment": "Timezone details not available"
                },
                "price": {
                    "baseAmount": {
                        "amount": "110000",
                        "code": "JPY"
                    },
                    "totalAmount": {
                        "amount": "131985",
                        "code": "JPY"
                    },
                    "totalTaxAmount": {
                        "amount": "21985",
                        "code": "JPY"
                    }
                },
                "paxRefId": "Passenger1"
            }
        ],
        "totalPrice": {
            "totalAmount": {
                "amount": "131985",
                "code": "JPY"
            }
        },
        "changeFee": {
            "penaltyAmount": {
                "amount": "30000",
                "code": "JPY"
            },
            "differentialAmountDue": {
                "amount": "-101985",
                "code": "JPY"
            },
            "differentialAmountDueTaxSummary": {
                "totalTaxAmount": {
                    "amount": "21985",
                    "code": "JPY"
                },
                "taxes": [
                    {
                        "amount": {
                            "amount": "700",
                            "code": "JPY"
                        },
                        "countryCode": "JP",
                        "taxCode": "OI",
                        "description": "PASSENGER SECURITY SERVICE CHARGE",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "1335",
                            "code": "JPY"
                        },
                        "countryCode": "*",
                        "taxCode": "YR",
                        "description": "NDC SURCHARGE",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "4060",
                            "code": "JPY"
                        },
                        "countryCode": "AU",
                        "taxCode": "WY",
                        "description": "PASSENGER SERVICES CHARGE DEPARTURE INTERNATIONAL",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "1000",
                            "code": "JPY"
                        },
                        "countryCode": "JP",
                        "taxCode": "TK",
                        "description": "INTERNATIONAL TOURIST TAX",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "1270",
                            "code": "JPY"
                        },
                        "countryCode": "AU",
                        "taxCode": "QR",
                        "description": "PASSENGER SERVICE CHARGE DOMESTIC ARRIVAL",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "2760",
                            "code": "JPY"
                        },
                        "countryCode": "AU",
                        "taxCode": "WY",
                        "description": "PASSENGER SERVICES CHARGE ARRIVAL INTERNATIONAL",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "1140",
                            "code": "JPY"
                        },
                        "countryCode": "AU",
                        "taxCode": "QR",
                        "description": "PASSENGER SERVICE CHARGE DOMESTIC DEPARTURE",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "480",
                            "code": "JPY"
                        },
                        "countryCode": "AU",
                        "taxCode": "WG",
                        "description": "SAFETY AND SECURITY CHARGE ARRIVAL",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "2460",
                            "code": "JPY"
                        },
                        "countryCode": "JP",
                        "taxCode": "SW",
                        "description": "PASSENGER SERVICE FACILITIES CHARGE  INTERNATIONAL",
                        "refundable": true
                    },
                    {
                        "amount": {
                            "amount": "6780",
                            "code": "JPY"
                        },
                        "countryCode": "AU",
                        "taxCode": "AU",
                        "description": "PASSENGER MOVEMENT CHARGE  PMC",
                        "refundable": true
                    }
                ]
            }
        },
        "remarks": [
            {
                "text": "OCN/QF/No reason Given/9/2025Jul18 0757Z"
            },
            {
                "id": "4d54593d",
                "text": "INV¥2223",
                "type": "1"
            }
        ],
        "paymentInformation": [
            {
                "id": "205432b9-eebf-472a-98cb-ee056c9fc650",
                "amount": {
                    "amount": "131985",
                    "code": "JPY"
                },
                "paymentMethod": {
                    "paymentTypeCode": "CASH"
                }
            }
        ],
        "invoices": [
            {
                "invoiceNumber": "0002223",
                "issueDateTime": "2025-07-18T16:57:00Z",
                "ticketingDocumentRefIds": [
                    "0815758527423"
                ],
                "issuedBy": {
                    "pseudoCityCode": "XXXX",
                    "agentSignatureId": "AWS",
                    "agentId": "AA/123456/XXXX",
                    "primeHost": "1S"
                }
            }
        ]
    }
}
 

JSONタグ定義書

スキーマ

【注意点】
各種スキーマは、Sabre社提供のオリジナル版となるため、「JSONタグ定義書」の記載上、
利用不可の情報が含まれております。
スキーマを利用してアプリケーションを構築される場合の各タグの利用可否は、
必ず「JSONタグ定義書」にてご確認ください。

※弊社にて「JSONタグ定義書」を作成する際、各タグの利用可否確認を行っております。