availability

Download Markdown for LLM

متد SearchByCityAndDateAndGuests

این متد برای جستجو و دریافت فهرست هتل‌های قابل رزرو به‌همراه اطلاعات قیمت آن‌ها در یک شهر مشخص و بر اساس تاریخ مورد نظر استفاده می‌شود.

این متد تنها هتل‌ها یا انواع اتاق‌هایی را در خروجی بازمی‌گرداند که قرارداد تأمین‌کننده آن‌ها با هتل مربوطه در سیستم «سپهر» بررسی و تأیید شده باشد. بنابراین، ممکن است خروجی این متد با فهرست هتل‌ها یا اتاق‌هایی که در وب‌سایت تأمین‌کننده نمایش داده می‌شود، کاملاً یکسان نباشد.

تأمین‌کنندگان در سیستم رزرواسیون سپهر می‌توانند قوانینی تعریف کنند که بر اساس آن‌ها، تاریخ ورود (Check-in) و تاریخ خروج (Check-out) در فرآیند بررسی Availability دارای اهمیت ویژه‌ای می‌شود. به این معنا که صرفاً موجود بودن یا نبودن اتاق ملاک نیست و ترکیب تاریخ‌های ورود و خروج نیز می‌تواند مستقیماً بر امکان‌پذیری رزرو تأثیر بگذارد.

برای مثال، ممکن است سیستم سپهر برای تاریخ ورود ۵ شهریور و تاریخ خروج ۸ شهریور پاسخ «عدم موجودی» برگرداند، اما برای همان تاریخ ورود و با تاریخ خروج ۹ شهریور، رزرو را تأیید کند.

در نتیجه، پاسخ دریافتی از این متد صرفاً برای تاریخ‌های Check-in و Check-out ارسال‌شده در درخواست معتبر است و امکان تعمیم آن به سایر تاریخ‌های ورود یا خروج وجود ندارد.

سؤال:
آیا امکان دارد برای یک رزرو، بخشی از شب‌ها از یک تأمین‌کننده و بخش دیگر از تأمین‌کننده‌ای متفاوت رزرو شود؟

پاسخ:
این موضوع به قوانین و محدودیت‌های تعریف‌شده توسط هر تأمین‌کننده بستگی دارد.

توضیح با مثال:
فرض کنید یک هتل (مثلاً هتل آرامیس پلاس کیش) توسط چند تأمین‌کننده مختلف ارائه می‌شود و هر تأمین‌کننده ممکن است برای شب‌های خاصی نرخ متفاوتی داشته باشد.
برای نمونه، شما قصد دارید یک رزرو ۴ شبه انجام دهید:

در این شرایط ممکن است تصمیم بگیرید:


API Endpoint

POST https://{SupplierWebsiteUrl}/api/Partners/Hotel/Availability/V4/SearchByCityAndDateAndGuests

Request Parameters


Sample Request

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

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "CityIataCode": "KIH",
    "CheckinDate": "2026-05-22",
    "CheckoutDate": "2026-05-25",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }
    ],
    "HotelSepehrGlobalId": null
}

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

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "CityIataCode": "KIH",
    "CheckinDate": "2026-05-22",
    "CheckoutDate": "2026-05-25",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }, {
            "AdultCount": 1,
            "ChildAgeList": [3]
        }
    ],
    "HotelSepehrGlobalId": null
}

Response Parameters


Sample Response

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

{
    "HotelOptionList": [{
            "SepehrHotelGlobalId": 101,
            "Name": "هتل کوهستان تستي",
            "RoomTypeList": [{
                    "SepehrGlobalId": 5004,
                    "Name": "دو تخته دبل",
                    "BoardTypeCode": "BB",
                    "AdultCount": 2,
                    "ChildAgeList": [],
                    "ExtrabedAssignedCount": 0
                }
            ],
            "AmenityList": [{
                    "SepehrGlobalId": 102,
                    "Name": "استخر روباز",
                    "Quantity": 6
                }, {
                    "SepehrGlobalId": 100,
                    "Name": "استقبال فرودگاهی",
                    "Quantity": 6
                }, {
                    "SepehrGlobalId": 103,
                    "Name": "بیمه مسافرتی",
                    "Quantity": 2
                }
            ],
            "TotalGrossPrice": 55810000.00,
            "TotalCommission": 0.0,
            "TotalNetPrice": 59950000.00
        },
        // ... بیشتر هتل‌ها و اتاق‌ها
    ],
    "CurrencyCode": "IRR"
}

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

{
    "HotelOptionList": [{
            "SepehrHotelGlobalId": 101,
            "Name": "هتل کوهستان تستي",
            "RoomTypeList": [{
                    "SepehrGlobalId": 5004,
                    "Name": "دو تخته دبل",
                    "BoardTypeCode": "BB",
                    "AdultCount": 2,
                    "ChildAgeList": [],
                    "ExtrabedAssignedCount": 0
                }, {
                    "SepehrGlobalId": 5004,
                    "Name": "دو تخته دبل",
                    "BoardTypeCode": "BB",
                    "AdultCount": 1,
                    "ChildAgeList": [3],
                    "ExtrabedAssignedCount": 0
                }
            ],
            "AmenityList": [{
                    "SepehrGlobalId": 102,
                    "Name": "استخر روباز",
                    "Quantity": 12
                }, {
                    "SepehrGlobalId": 100,
                    "Name": "استقبال فرودگاهی",
                    "Quantity": 12
                }, {
                    "SepehrGlobalId": 103,
                    "Name": "بیمه مسافرتی",
                    "Quantity": 4
                }
            ],
            "TotalGrossPrice": 111620000.00,
            "TotalCommission": 0.0,
            "TotalNetPrice": 119900000.00
        },
        // ... بیشتر هتل‌ها و اتاق‌ها
    ],
    "CurrencyCode": "IRR"
}