retrieve-booking

متد GetStatus

کاربرد این متد برای زمانی است که شما متد Book را فراخوانی نموده اید، ولی به هر دلیلی – مانند مشکلات شبکه و قطعی اینترنتی یا ریست شدن سرور – جوابی از سپهر دریافت نکرده اید، با استفاده از این متد می توانید وضعیت درخواست رزرو و اینکه آیا رزرو صادر شده است یا خیر را بررسی نمایید.

پیشنهاد می گردد اگر بعد از فراخوانی متد Book هیچ جوابی دریافت نکردید، حداقل 15 ثانیه صبر نموده و سپس از متد GetStatus استفاده نمایید. در صورتی که فاصله بین فراخوانی متد Book و متد GetStatus کمتر از 15 ثانیه باشد، احتمال اینکه متد GetStatus جواب اشتباهی را خروجی دهد زیاد است. و ممکن است رزرو شما در حال صادر شدن باشد ولی متد GetStatus در جواب پاسخ دهد که هیچ رزروی صادر نشده است. به بیان فنی تر می توان اینطور گفت که وقتی متد Book را فراخوانی می نمایید یک Timeout به میزان 15 ثانیه برای آن تنظیم نمایید و در صورتی که خطای timeout دریافت کردید آنگاه متد GetStatus را فراخوانی نمایید تا از نتیجه صادر شدن یا نشدن رزرو خود مطلع شوید.

این متد در صورت اعمال هرگونه تغییر در اطلاعات مسافران یا پرواز , آخرین وضعیت رزرو (Last State) را خروجی میدهد.


API Endpoint

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

Request Parameters


Sample Request

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "YourLocalInventoryPnr": "fbb5a76a-a69e-4e09-be36-1d2327cfc558"
}

Response Parameters


Sample Response

{
    "StatusId": 1,
    "StatusDesc": "OK",
    "LocalPnr": "SU6Q7C",
    "FailReason": null,
    "PassengerList": [{
            "Id": "49ff2721-f598-4f0f-8d1a-dec1227d5520",
            "FirstName": "MOHADESEH",
            "LastName": "PAKNIAT",
            "AgeType": "ADL",
            "Gender": "M",
            "Birthdate": "1996-01-26",
            "NationalityCountry": "IR",
            "IranianCartMelli": {
                "CodeMelli": "0010905121"
            },
            "Passport": null,
            "SegmentList": [{
                    "FlightNumber": "7411",
                    "FlightDate": "2026-01-27 18:00",
                    "OriginIataCode": "AWZ",
                    "DestinationIataCode": "IFN",
                    "CabinType": "Economy",
                    "BookingCode": "P",
                    "FareName": "THRKIH I3 835",
                    "AirlineIataCode": "FP",
                    "OriginalPnr": "SU6Q7C",
                    "LocalTicketNumber": "1546524",
                    "OriginalTicketNumber": "1546524",
                    "OriginalSupplierName": "",
                    "SaleInfo": {
                        "BaseFare": 8350000.00,
                        "Tax": 0.00,
                        "TotalFare": 8350000.00,
                        "CommissionPercent": 10,
                        "CalculatedAmountOfCommissionPercent": 835000.00,
                        "CommissionValue": 0.00,
                        "Payable": 7515000.00
                    },
                    "FreeBaggage": {
                        "CheckedBaggage_Quantity": 2,
                        "CheckedBaggage_TotalWeight": 20,
                        "HandBaggage_Quantity": 1,
                        "HandBaggage_TotalWeight": 5
                    },
                    "JarimeCanceliTextFa": "\r\nجريمه استرداد از زمان صدور بليت تا ساعت 12 ظهر 3 روز قبل از پرواز 10 درصد مي باشد.\r\nجريمه استرداد از ساعت 12 ظهر 3 روز قبل از پرواز تا ساعت 12 ظهر 2 روز قبل از پرواز 30 درصد مي باشد.\r\nجريمه استرداد از ساعت 12 ظهر 2 روز قبل از پرواز تا ساعت 12 ظهر 1 روز قبل از پرواز 50 درصد مي باشد.\r\nجريمه استرداد از ساعت 12 ظهر 1 روز قبل از پرواز تا 22 ساعت قبل از پرواز 90 درصد مي باشد.\r\nجريمه استرداد از 22 ساعت قبل از پرواز به بعد 50 درصد مي باشد (NoShow).",
                    "JarimeCanceliTextEn": "\r\nThe cancellation penalty from the time of ticket issuance until (12:00 noon), 3 days before the flight: 10%\r\nThe cancellation penalty from (12:00 noon), 3 days before the flight until (12:00 noon), 2 days before the flight: 30%\r\nThe cancellation penalty from (12:00 noon), 2 days before the flight until (12:00 noon), 1 days before the flight: 50%\r\nThe cancellation penalty from (12:00 noon), 1 days before the flight until 22 hours before the flight: 90%\r\nThe cancellation penalty from 22 hours before the flight onwards: 50% (No-Show)"
                }
            ]
        }
    ]
}

Response common exceptions

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

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