availability

متد GetCheckinAndCheckoutCompositions

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

روش کار این متد بدین صورت می باشد که برای هر تاریخی که شما به عنوان CheckinDate به آن ارسال نمایید، تمام حالت های ممکن و قابل رزرو تاریخ Checkin و Checkout را تا 20 روز آینده محاسبه کرده و اطلاعات قیمت و تعداد اتاق موجود را برای هر ترکیب برگشت خواهد داد.

استفاده از این روش به جای متد SearchByCityAndDate پیچیدگی پیاده سازی بیشتری دارد ولی در صورتی که سایت شما تعداد زیادی کاربر داشته باشد، از نظر منابع و سرعت پاسخگویی به درخواست های availability کاربران، به شدت بهبود حاصل می گردد.

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

با توجه به اینکه تجربه نشان داده است تغییرات ظرفیت و نرخ روی تاریخ های نزدیک (مثلا سه روز آینده) خیلی بیشتر از تغییرات روی تاریخ های دورتر می باشد، بهینه ترین حالت این است که شما تاریخ های نزدیک را زود به زودتر از تاریخ های دورتر دریافت و به روزرسانی نمایید.

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


API Endpoint

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

Request Parameters


Sample Request

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

Response Parameters


Sample Response

{
    "HotelList": [{
            "SepehrGlobalId": 102,
            "Name": "هتل صحرا تستي",
            "DateRangeList": [{
                    "CheckinDate": "2026-05-22",
                    "CheckoutDate": "2026-05-23",
                    "RoomTypeList": [{
                            "SepehrGlobalId": 5009,
                            "Name": "دو تخته",
                            "AdultCapacity": 2,
                            "ChildCapacity": 1,
                            "ChildAge": 5,
                            "AvailableRoomCount": 4,
                            "BoardTypeList": [{
                                    "Code": "BB",
                                    "ExtrabedCapacity": 0,
                                    "RateDetailList": [{
                                            "Date": "2026-05-22",
                                            "Room_BoardPrice_TaxIncluded": 3000000.0,
                                            "Room_NetPrice_TaxExcluded": 3000000.00,
                                            "Room_NetPrice_TaxIncluded": 3000000.0,
                                            "Extrabed_BoardPrice_TaxIncluded": 0.0,
                                            "Extrabed_NetPrice_TaxExcluded": 0.00,
                                            "Extrabed_NetPrice_TaxIncluded": 0.0
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "AmenityList": []
                }, {
                    "CheckinDate": "2026-05-22",
                    "CheckoutDate": "2026-05-24",
                    "RoomTypeList": [{
                            "SepehrGlobalId": 5009,
                            "Name": "دو تخته",
                            "AdultCapacity": 2,
                            "ChildCapacity": 1,
                            "ChildAge": 5,
                            "AvailableRoomCount": 4,
                            "BoardTypeList": [{
                                    "Code": "BB",
                                    "ExtrabedCapacity": 0,
                                    "RateDetailList": [{
                                            "Date": "2026-05-22",
                                            "Room_BoardPrice_TaxIncluded": 3000000.0,
                                            "Room_NetPrice_TaxExcluded": 3000000.00,
                                            "Room_NetPrice_TaxIncluded": 3000000.0,
                                            "Extrabed_BoardPrice_TaxIncluded": 0.0,
                                            "Extrabed_NetPrice_TaxExcluded": 0.00,
                                            "Extrabed_NetPrice_TaxIncluded": 0.0
                                        }, {
                                            "Date": "2026-05-23",
                                            "Room_BoardPrice_TaxIncluded": 3000000.0,
                                            "Room_NetPrice_TaxExcluded": 3000000.00,
                                            "Room_NetPrice_TaxIncluded": 3000000.0,
                                            "Extrabed_BoardPrice_TaxIncluded": 0.0,
                                            "Extrabed_NetPrice_TaxExcluded": 0.00,
                                            "Extrabed_NetPrice_TaxIncluded": 0.0
                                        }
                                    ]
                                }
                            ]
                        }
                    ],
                    "AmenityList": []
                }
                // ... بیشتر ترکیبات تاریخ Checkin/Checkout تا 20 روز آینده
            ],
            "AmenityList": []
        }
    ]
}