لیست سرویس‌ها

• صفحه اول
• مدل کسب و کار
• نکات کلی فنی
• Mapping
  • Hotel
  • Amenity
• Availability
  • SearchByCityAndDateAndGuests
  • SearchByCityAndDate
  • GetCheckinAndCheckoutCompositions
  • GetByFromDateAndToDate
  • سایر ورژن ها
• Booking
  • Lock
  • Book
  • تست سناریو
  • سایر ورژن ها
• Retrieve Booking
  • GetStatus
  • GetHistory
  • سایر ورژن ها

availability

متد 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

• Username

  string

  required

  نام کاربری

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

• Password

  string

  required

  رمز عبور به صورت MD5 شده

• FromDate

  string

  required

  تاریخ شروع

  با فرمت yyyy-MM-dd و به صورت میلادی

• ToDate

  string

  required

  تاریخ پایان

  با فرمت yyyy-MM-dd و به صورت میلادی

Sample Request

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

Response Parameters

• CurrencyCode

  string

  این فیلد مشخص می کند که نرخ های برگشتی بر اساس چه ارزی می باشد.

  مقدار آن بستگی به این دارد که ارز کاربر شما در سایت تامین کننده چه چیزی تعیین شده باشد. مثلا اگر کاربر شما به صورت ریالی باشد مقدار آن IRR و اگر دلاری باشد مقدار آن USD خواهد بود.

• HotelList

  Complex type

  لیست هتل های قابل رزرو

  Show child 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)
            ]
        }
    ]
}