retrieve-booking

متد GetHistory

با استفاده از این متد می توان کلیه اطلاعات مربوط به یک رزرو را دریافت نمود

این اطلاعات شامل آخرین وضعیت رزرو، رزرو اولیه و تاریخچه اتفاقات – مثلا سگمنت های کنسل شده یا تغییر پرواز – را شامل می گردد.

زمان (تاریخ و ساعت) هایی که در این وب سرویس خروجی داده میشود – مثلا فیلد BookingDateTime – بر اساس ناحیه زمانی UTC می باشد و در صورت نیاز باید آنها را به زمان ایران تبدیل نمایید.

زمان پرواز به ناحیه زمانی محلی خروجی داده می شود. مثلا برای یک پرواز تهران استانبول، زمان خروج از مبدا به ناحیه زمانی ایران و زمان رسیدن به مقصد به ناحیه زمانی ترکیه خروجی داده می شود.


API Endpoint

POST https://{SupplierWebsiteUrl}/api/Partners/Flight/RetrieveBooking/V3/GetHistory

Request Parameters


Sample Request

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "Pnr": "ES566K"
}

Response Parameters


Sample Response

{
    "LastState": {
        "PassengerList": [{
                "Id": "ed725f88-0b4f-47f9-adfc-453109618e21",
                "FirstName": "KHALED",
                "LastName": "SEDIGHI",
                "AgeType": "ADL",
                "Gender": "M",
                "Birthdate": "1994-09-16",
                "NationalityCountry": "IR",
                "IranianCartMelli": {
                    "CodeMelli": "0011756470"
                },
                "Passport": null,
                "SegmentList": [{
                        "FlightNumber": "3654",
                        "FlightDate": "2024-09-17 14:20",
                        "OriginIataCode": "THR",
                        "DestinationIataCode": "KIH",
                        "CabinType": "First",
                        "BookingCode": "FI",
                        "FareName": "JCL",
                        "AirlineIataCode": "B9",
                        "OriginalPnr": "ES566K",
                        "LocalTicketNumber": "1417222",
                        "OriginalTicketNumber": "1417222",
                        "OriginalSupplierName": "",
                        "SaleInfo": {
                            "BaseFare": 18000000.00,
                            "Tax": 0.00,
                            "TotalFare": 18000000.00,
                            "CommissionPercent": 5,
                            "CalculatedAmountOfCommissionPercent": 900000.00,
                            "CommissionValue": 0.00,
                            "Payable": 17100000.00
                        },
                        "FreeBaggage": {
                            "CheckedBaggage_Quantity": 0,
                            "CheckedBaggage_TotalWeight": 0,
                            "HandBaggage_Quantity": 0,
                            "HandBaggage_TotalWeight": 0
                        },
                        "JarimeCanceliTextFa": "جريمه استرداد تا 15 دقيقه بعد از رزرو (فقط تا 12 ساعت قبل از پرواز) 0 درصد مي باشد.\r\nجريمه استرداد از زمان صدور بليت تا ساعت 12 ظهر 3 روز قبل از پرواز 30 درصد مي باشد.\r\nجريمه استرداد از ساعت 12 ظهر 3 روز قبل از پرواز تا ساعت 12 ظهر 2 روز قبل از پرواز 50 درصد مي باشد.\r\nجريمه استرداد از ساعت 12 ظهر 2 روز قبل از پرواز تا ساعت 12 ظهر 1 روز قبل از پرواز 70 درصد مي باشد.\r\nجريمه استرداد از ساعت 12 ظهر 1 روز قبل از پرواز تا 20 ساعت قبل از پرواز 90 درصد مي باشد.\r\nجريمه استرداد از 20 ساعت قبل از پرواز به بعد 100 درصد مي باشد (NoShow).",
                        "JarimeCanceliTextEn": "The cancellation penalty until 15 minutes after reservation(only 12 hours before flight): 0%\r\nThe cancellation penalty from the time of ticket issuance until (12:00 noon), 3 days before the flight: 30%\r\nThe cancellation penalty from (12:00 noon), 3 days before the flight until (12:00 noon), 2 days before the flight: 50%\r\nThe cancellation penalty from (12:00 noon), 2 days before the flight until (12:00 noon), 1 days before the flight: 70%\r\nThe cancellation penalty from (12:00 noon), 1 days before the flight until 20 hours before the flight: 90%\r\nThe cancellation penalty from 20 hours before the flight onwards: 100% (No-Show)"
                    }
                ]
            }, {
                "Id": "5ba9cbcf-72a4-4a85-8fc4-0179b40242ec",
                "FirstName": "SAGHAR",
                "LastName": "ABASI",
                "AgeType": "INF",
                "Gender": "M",
                "Birthdate": "2023-09-16",
                "NationalityCountry": "IR",
                "IranianCartMelli": {
                    "CodeMelli": "0010175393"
                },
                "Passport": null,
                "SegmentList": [{
                        "FlightNumber": "3654",
                        "FlightDate": "2024-09-17 14:20",
                        "OriginIataCode": "THR",
                        "DestinationIataCode": "KIH",
                        "CabinType": "First",
                        "BookingCode": "FI",
                        "FareName": "JCL",
                        "AirlineIataCode": "B9",
                        "OriginalPnr": "ES566K",
                        "LocalTicketNumber": "1417223",
                        "OriginalTicketNumber": "1417223",
                        "OriginalSupplierName": "",
                        "SaleInfo": {
                            "BaseFare": 10000000.00,
                            "Tax": 0.00,
                            "TotalFare": 10000000.00,
                            "CommissionPercent": 0,
                            "CalculatedAmountOfCommissionPercent": 0.00,
                            "CommissionValue": 0.00,
                            "Payable": 10000000.00
                        },
                        "FreeBaggage": {
                            "CheckedBaggage_Quantity": 0,
                            "CheckedBaggage_TotalWeight": 0,
                            "HandBaggage_Quantity": 0,
                            "HandBaggage_TotalWeight": 0
                        },
                        "JarimeCanceliTextFa": "جریمه استرداد نوزاد بدون صندلی صفر می باشد",
                        "JarimeCanceliTextEn": "Infants without a seat are not charged for cancel/refund"
                    }
                ]
            }
        ]
    },
    "History_InitialBooking": {
        "BookingDateTime": "2024-09-16 09:23:30",
        "Phone": "+989352283333",
        "Email": "your-email-address@your-domain.com",
        "Remarks": null,
        "PassengerList": [{
                "Id": "ed725f88-0b4f-47f9-adfc-453109618e21",
                "AgeTypeCode": "ADL",
                "FirstName": "KHALED",
                "LastName": "SEDIGHI",
                "Gender": "M",
                "Birthdate": "1994-09-16",
                "NationalityCountry": "IR",
                "IranianCartMelli": {
                    "CodeMelli": "0011756470"
                },
                "Passport": null,
                "SegmentList": [{
                        "FlightNumber": "3654",
                        "FlightDate": "2024-09-17 14:20",
                        "OriginIataCode": "THR",
                        "DestinationIataCode": "KIH",
                        "CabinType": "First",
                        "BookingCode": "FI",
                        "FareName": "JCL",
                        "AirlineIataCode": "B9",
                        "OriginalPnr": "ES566K",
                        "LocalTicketNumber": "1417222",
                        "OriginalTicketNumber": "1417222",
                        "OriginalSupplierName": "",
                        "SaleInfo": {
                            "BaseFare": 18000000.00,
                            "Tax": 0.00,
                            "TotalFare": 18000000.00,
                            "CommissionPercent": 5,
                            "CalculatedAmountOfCommissionPercent": 900000.00,
                            "CommissionValue": 0.00,
                            "Payable": 17100000.00
                        }
                    }
                ]
            }, {
                "Id": "5ba9cbcf-72a4-4a85-8fc4-0179b40242ec",
                "AgeTypeCode": "INF",
                "FirstName": "SAGHAR",
                "LastName": "ABASI",
                "Gender": "M",
                "Birthdate": "2023-09-16",
                "NationalityCountry": "IR",
                "IranianCartMelli": {
                    "CodeMelli": "0010175393"
                },
                "Passport": null,
                "SegmentList": [{
                        "FlightNumber": "3654",
                        "FlightDate": "2024-09-17 14:20",
                        "OriginIataCode": "THR",
                        "DestinationIataCode": "KIH",
                        "CabinType": "First",
                        "BookingCode": "FI",
                        "FareName": "JCL",
                        "AirlineIataCode": "B9",
                        "OriginalPnr": "ES566K",
                        "LocalTicketNumber": "1417223",
                        "OriginalTicketNumber": "1417223",
                        "OriginalSupplierName": "",
                        "SaleInfo": {
                            "BaseFare": 10000000.00,
                            "Tax": 0.00,
                            "TotalFare": 10000000.00,
                            "CommissionPercent": 0,
                            "CalculatedAmountOfCommissionPercent": 0.00,
                            "CommissionValue": 0.00,
                            "Payable": 10000000.00
                        }
                    }
                ]
            }
        ]
    },
    "History_Cancelation": {
        "HistoryList": []
    },
    "History_PassengerInfoChanged": {
        "HistoryList": []
    },
    "History_ChangedFlight": {
        "HistoryList": []
    }
}

Response common exceptions

در جدول زیر لیستی از خطاهایی که ممکن است بعد از فراخوانی این متد برگشت داده شود، فهرست شده است.

ExceptionType توضیح خطا
Exception خطای نامشخص. جهت دریافت اطلاعات بیشتر باید به ErrorMessage داخل json برگشتی مراجعه نمود.