availability

Download Markdown for LLM

متد GetByFromDateAndToDate

کاربرد این متد برای زمانی است که شما می خواهید اطلاعات را در سیستم خود Cache کنید و سپس درخواست های availability را از Cache خود پاسخ دهید.

این متد به تفکیق هر شب تعداد اتاق موجود و قیمت و قوانین را خروجی می دهد.

به دلایلی که در ادامه شرح داده خواهد شد، اطلاعاتی که توسط این متد خروجی داده می شود همیشه درست نیست و فقط در مواردی که نیاز شما بدست آوردن یک دید کلی از نرخ و موجودی هتل با پذیرش مقداری انحراف در تعداد اتاق های موجود می باشد می توان از این متد استفاده کرد. بنابراین اکیدا پیشنهاد می گردد اگر ساختار نرم افزار شما اجازه می دهد به جای این متد از متد GetCheckinAndCheckoutCompositions استفاده نمایید.

تامین کنندگان در سیستم رزرواسیون سپهر قابلیت تعریف کردن قوانینی را دارند که در نتیجه تعریف شدن آن قوانین، تاریخ ورود و خروج در موضوع availability اهمیت و حساسیت خاص خود را پیدا می کند. بدین معنی که علاوه بر بحث موجود بودن یا نبودن اتاق، تاریخ ورود و خروج هم بر اینکه آیا امکان رزرو اتاق وجود دارد یا خیر تاثیر می گذارد. به عنوان مثال ممکن است سیستم سپهر برای تاریخ ورود 5 شهریور و تاریخ خروج 8 شهریور به شما عدم موجودی جواب دهد ولی برای تاریخ ورود 5 شهریور و تاریخ خروج 9 شهریور به شما تایید رزرو را بدهد. در صورتی که این متد بدون در نظر گرفتن قوانین، تعداد اتاق موجود در هر شب را خروجی می‌دهد.

همچنین سیستم رزرواسیون سپهر در زمان رزرو به شماره اتاق حساس می باشد، بدین معنی که فرض کنیم در تاریخ امشب اتاق 201 و برای تاریخ فردا شب اتاق 202 موجود باشد. در صورتی که شما درخواست رزرو تاریخ ورود امروز و خروج پس فردا را انتخاب نمایید، سیستم رزرواسیون سپهر اجازه رزرو به شما نمی دهد. فقط زمانی اجازه رزرو داده می شود که یا اتاق 201 برای کل بازه تاریخی درخواستی شما موجود باشد یا اتاق 202 برای کل آن بازه تاریخی موجود باشد. در صورتی که این متد (یعنی GetByFromDateAndToDate) این منطق را نقض می کند و در زمان خروجی دادن تعداد اتاق های موجود، بررسی می‌کند که در هر شب چند عدد اتاق موجود هست و به شما آن عدد را خروجی می‌دهد.


API Endpoint

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

Request Parameters


Sample Request

{
    "Username": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "FromDate": "2026-05-22",
    "ToDate": "2026-05-25"
}

Response Parameters


Sample Response

{
    "HotelList": [
        {
            "SepehrGlobalId": 102,
            "Name": "هتل صحرا تستی",
            "StayDateList": [
                {
                    "Date": "2026-05-22",
                    "RoomTypeList": [
                        {
                            "SepehrGlobalId": 5009,
                            "Name": "دو تخته",
                            "AdultCapacity": 2,
                            "ChildCapacity": 1,
                            "ChildAge": 5,
                            "AvailableRoomCount": 4,
                            "HasCheckinLimit": false,
                            "HasCheckoutLimit": false,
                            "MinimumStay": 0,
                            "MaximumStay": 0,
                            "BoardTypeList": [
                                {
                                    "Code": "BB",
                                    "ExtrabedCapacity": 0,
                                    "Room_BoardPrice_TaxIncluded": 3000000.0,
                                    "Room_NetPrice_TaxIncluded": 3000000.0,
                                    "Extrabed_BoardPrice_TaxIncluded": 0.0,
                                    "Extrabed_NetPrice_TaxIncluded": 0.0
                                }
                            ]
                        }
                    ],
                    "AmenityList": []
                }
                // ... بیشتر تاریخ‌ها (2026-05-23, 2026-05-24, 2026-05-25)
            ]
        },
        {
            "SepehrGlobalId": 104,
            "Name": "هتل خارجی تستی",
            "StayDateList": [
                {
                    "Date": "2026-05-22",
                    "RoomTypeList": [
                        {
                            "SepehrGlobalId": 8235,
                            "Name": "سه تخته",
                            "AdultCapacity": 3,
                            "ChildCapacity": 2,
                            "ChildAge": 5,
                            "AvailableRoomCount": 4,
                            "HasCheckinLimit": false,
                            "HasCheckoutLimit": false,
                            "MinimumStay": 0,
                            "MaximumStay": 0,
                            "BoardTypeList": [
                                {
                                    "Code": "RO",
                                    "ExtrabedCapacity": 2,
                                    "Room_BoardPrice_TaxIncluded": 16000000.0,
                                    "Room_NetPrice_TaxIncluded": 15680000.0,
                                    "Extrabed_BoardPrice_TaxIncluded": 5000000.0,
                                    "Extrabed_NetPrice_TaxIncluded": 4750000.0
                                }
                            ]
                        },
                        {
                            "SepehrGlobalId": 8236,
                            "Name": "سوئیت چهار تخته",
                            "AdultCapacity": 4,
                            "ChildCapacity": 0,
                            "ChildAge": 5,
                            "AvailableRoomCount": 4,
                            "HasCheckinLimit": false,
                            "HasCheckoutLimit": false,
                            "MinimumStay": 0,
                            "MaximumStay": 0,
                            "BoardTypeList": [
                                {
                                    "Code": "UA",
                                    "ExtrabedCapacity": 1,
                                    "Room_BoardPrice_TaxIncluded": 56000000.0,
                                    "Room_NetPrice_TaxIncluded": 56000000.0,
                                    "Extrabed_BoardPrice_TaxIncluded": 25000000.0,
                                    "Extrabed_NetPrice_TaxIncluded": 25000000.0
                                }
                            ]
                        }
                    ],
                    "AmenityList": [
                        {
                            "SepehrGlobalId": 100,
                            "Name": "استقبال فرودگاهی",
                            "CountingMethod": "PerGuest",
                            "RateDetail": {
                                "GuestAgeRangeStart": 3,
                                "GuestAgeRangeEnd": 120,
                                "BoardPrice_TaxIncluded": 0.0,
                                "NetPrice_TaxExcluded": 0.0,
                                "NetPrice_TaxIncluded": 0.0
                            }
                        },
                        {
                            "SepehrGlobalId": 102,
                            "Name": "استخر",
                            "CountingMethod": "PerGuestPerNight",
                            "RateDetail": {
                                "GuestAgeRangeStart": 3,
                                "GuestAgeRangeEnd": 120,
                                "BoardPrice_TaxIncluded": 0.0,
                                "NetPrice_TaxExcluded": 0.0,
                                "NetPrice_TaxIncluded": 0.0
                            }
                        },
                        {
                            "SepehrGlobalId": 103,
                            "Name": "بیمه مسافرتی",
                            "CountingMethod": "PerGuest",
                            "RateDetail": {
                                "GuestAgeRangeStart": 3,
                                "GuestAgeRangeEnd": 120,
                                "BoardPrice_TaxIncluded": 50000000.0,
                                "NetPrice_TaxExcluded": 50000000.0,
                                "NetPrice_TaxIncluded": 50000000.0
                            }
                        }
                    ]
                }
                // ... بیشتر تاریخ‌ها (2026-05-23, 2026-05-24, 2026-05-25)
            ]
        },
        {
            "SepehrGlobalId": 101,
            "Name": "هتل کوهستان تستی",
            "StayDateList": [
                {
                    "Date": "2026-05-22",
                    "RoomTypeList": [
                        {
                            "SepehrGlobalId": 5001,
                            "Name": "یک تخته استاندارد",
                            "AdultCapacity": 1,
                            "ChildCapacity": 0,
                            "ChildAge": 5,
                            "AvailableRoomCount": 4,
                            "HasCheckinLimit": false,
                            "HasCheckoutLimit": false,
                            "MinimumStay": 0,
                            "MaximumStay": 0,
                            "BoardTypeList": [
                                {
                                    "Code": "BB",
                                    "ExtrabedCapacity": 1,
                                    "Room_BoardPrice_TaxIncluded": 4360000.0,
                                    "Room_NetPrice_TaxIncluded": 3924000.0,
                                    "Extrabed_BoardPrice_TaxIncluded": 1090000.0,
                                    "Extrabed_NetPrice_TaxIncluded": 981000.0
                                }
                            ]
                        }
                        // ... بیشتر نوع اتاق‌ها
                    ],
                    "AmenityList": [
                        {
                            "SepehrGlobalId": 102,
                            "Name": "استخر روباز",
                            "CountingMethod": "PerGuestPerNight",
                            "RateDetail": {
                                "GuestAgeRangeStart": 3,
                                "GuestAgeRangeEnd": 120,
                                "BoardPrice_TaxIncluded": 5450000.0,
                                "NetPrice_TaxExcluded": 5000000.0,
                                "NetPrice_TaxIncluded": 5450000.0
                            }
                        },
                        {
                            "SepehrGlobalId": 100,
                            "Name": "استقبال فرودگاهی",
                            "CountingMethod": "PerGuestPerNight",
                            "RateDetail": {
                                "GuestAgeRangeStart": 3,
                                "GuestAgeRangeEnd": 120,
                                "BoardPrice_TaxIncluded": 0.0,
                                "NetPrice_TaxExcluded": 0.0,
                                "NetPrice_TaxIncluded": 0.0
                            }
                        },
                        {
                            "SepehrGlobalId": 103,
                            "Name": "بیمه مسافرتی",
                            "CountingMethod": "PerGuest",
                            "RateDetail": {
                                "GuestAgeRangeStart": 3,
                                "GuestAgeRangeEnd": 120,
                                "BoardPrice_TaxIncluded": 8720000.0,
                                "NetPrice_TaxExcluded": 8000000.0,
                                "NetPrice_TaxIncluded": 8720000.0
                            }
                        }
                    ]
                }
                // ... بیشتر تاریخ‌ها (2026-05-23, 2026-05-24, 2026-05-25)
            ]
        }
    ]
}