booking

متد Lock

این متد جهت قفل کردن ظرفیت و نرخ هتل و پرواز (تور) مورد استفاده قرار میگیرد. فراخوانی این متد در زمان انجام رزرو اجباری می باشد.

این متد را به دو روش مختلف می توان استفاده نمود:


API Endpoint

POST https://{SupplierWebsiteUrl}/api/Partners/Tour/Booking/V3/Lock

Request Parameters


Sample Request

نمونه درخواست - یک اتاق - دو بزرگسال

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "DepartureSegment": {
        "FlightNumber": "412",
        "FlightDate": "2025-12-17 18:00",
        "OriginIataCode": "THR",
        "DestinationIataCode": "KIH",
        "FareName": "THRMHD1"
    },
    "ReturningSegment": {
        "FlightNumber": "413",
        "FlightDate": "2025-12-20 10:00",
        "OriginIataCode": "KIH",
        "DestinationIataCode": "THR",
        "FareName": "MHD"
    },
    "CheckinDate": "2025-12-17",
    "CheckoutDate": "2025-12-20",
    "RoomList": [{
            "RoomTypeSepehrGlobalId": 5003,
            "BoardTypeCode": "BB",
            "AdultCount": 2,
            "ChildAgeList": []
        }
    ],
    "FlightTotalPayable": 17809900.00,
    "HotelTotalPayable": 18366500.00
}

نمونه درخواست - دو اتاق - سه بزرگسال - یک کودک 3 ساله

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "DepartureSegment": {
        "FlightNumber": "789",
        "FlightDate": "2025-12-17 13:30",
        "OriginIataCode": "IKA",
        "DestinationIataCode": "IST",
        "FareName": "FF9"
    },
    "ReturningSegment": {
        "FlightNumber": "7845",
        "FlightDate": "2025-12-20 18:30",
        "OriginIataCode": "IST",
        "DestinationIataCode": "IKA",
        "FareName": "IKAISTTEST2"
    },
    "CheckinDate": "2025-12-17",
    "CheckoutDate": "2025-12-20",
    "RoomList": [{
            "RoomTypeSepehrGlobalId": 8235,
            "BoardTypeCode": "RO",
            "AdultCount": 2,
            "ChildAgeList": []
        }, {
            "RoomTypeSepehrGlobalId": 6468,
            "BoardTypeCode": "FF",
            "AdultCount": 1,
            "ChildAgeList": [3]
        }
    ],
    "FlightTotalPayable": 47200000.00,
    "HotelTotalPayable": 395750000.00
}

Response Parameters


Sample Response

نمونه پاسخ - یک اتاق - دو بزرگسال

{
    "HotelLockId": 10469,
    "DepartureFlightLockId": 270438,
    "ReturningFlightLockId": 270439,
    "ExpiryInMinute": 16
}

نمونه پاسخ - دو اتاق - سه بزرگسال - یک کودک 3 ساله

{
    "HotelLockId": 10465,
    "DepartureFlightLockId": 270424,
    "ReturningFlightLockId": 270425,
    "ExpiryInMinute": 22
}

Response common exceptions

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

ExceptionType توضیح خطا
Error1004-NoEnoughCredit باقی مانده اعتبار حساب برای انجام این رزرو کافی نیست.
Error1005-CreditDueDateReached مهلت پرداخت بدهی به اتمام رسیده است و انجام رزرو امکان پذیر نمی باشد
Error1001-FlightNotFound پروازی با اطلاعات درخواستی پیدا نشد.
Error1003-NoEnoughSeatAvailable تعداد صندلی درخواستی در پرواز موجود نمی باشد.
Error1006-FareNotFound کلاس پروازی با اسم fare درخواستی پیدا نشد. این خطا معمولا زمانی اتفاق می افتد که نسبت به آخرین availability که دریافت کرده اید نرخ پرواز تغییر کرده باشد و شما هنوز تغییرات نرخی جدید را دریافت نکرده و با نرخ قبلی درخواست خود را ارسال کرده باشید.
Error1011-FlightTimeMismatch ساعت پرواز درخواستی شما با ساعت پروازی سیستم مطابقت ندارد
Error1013-FlightLockCountLimit زمانی که روی یک پرواز اقدام به قفل کردن بیش از 9 عدد صندلی نمایید، این خطا برگشت داده خواهد شد.
Error1015-HotelLockCountLimit زمانی که روی یک نوع اتاق اقدام به قفل کردن بیش از 4 عدد اتاق نمایید، این خطا برگشت داده خواهد شد.