GetByFromDateAndToDate – Sepehr Integration Docs

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

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

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

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

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

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

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

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

{ "HotelList": [ { "SepehrGlobalId": 101, "Name": "هتل کوهستان تستي", "RoomTypeList": [ { "SepehrGlobalId": 5001, "Name": "يک تخته استاندارد", "AdultCapacity": 1, "ChildCapacity": 0, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 3924000 }, { "Code": "FB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4414500 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 3924000 }, { "Code": "FB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4414500 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 3924000 }, { "Code": "FB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4414500 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 3924000 }, { "Code": "FB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4414500 } ] } ] }, { "SepehrGlobalId": 5002, "Name": "يک تخته معمولي", "AdultCapacity": 1, "ChildCapacity": 0, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 1, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] } ] }, { "SepehrGlobalId": 5004, "Name": "دو تخته دبل", "AdultCapacity": 2, "ChildCapacity": 0, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 2, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 2, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 2, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 2, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] } ] }, { "SepehrGlobalId": 5003, "Name": "دو تخته استاندارد", "AdultCapacity": 2, "ChildCapacity": 1, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 }, { "Code": "FB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4905000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 }, { "Code": "FB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4905000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 }, { "Code": "FB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4905000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 }, { "Code": "FB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4905000, "Room_NetPrice_TaxIncluded": 4905000 } ] } ] }, { "SepehrGlobalId": 5006, "Name": "دو تخته معمولي", "AdultCapacity": 2, "ChildCapacity": 1, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3270000, "Room_NetPrice_TaxIncluded": 3270000 } ] } ] }, { "SepehrGlobalId": 5005, "Name": "دو تخته رو به دريا", "AdultCapacity": 2, "ChildCapacity": 1, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 4360000, "Room_NetPrice_TaxIncluded": 4360000 } ] } ] }, { "SepehrGlobalId": 5008, "Name": "سه تخته معمولي", "AdultCapacity": 3, "ChildCapacity": 0, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] } ] }, { "SepehrGlobalId": 5007, "Name": "سه تخته استاندارد", "AdultCapacity": 3, "ChildCapacity": 0, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5450000, "Room_NetPrice_TaxIncluded": 5450000 } ] } ] } ] }, { "SepehrGlobalId": 102, "Name": "هتل صحرا تستي", "RoomTypeList": [ { "SepehrGlobalId": 5009, "Name": "دو تخته", "AdultCapacity": 2, "ChildCapacity": 1, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3000000, "Room_NetPrice_TaxIncluded": 3000000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3000000, "Room_NetPrice_TaxIncluded": 3000000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3000000, "Room_NetPrice_TaxIncluded": 3000000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 3000000, "Room_NetPrice_TaxIncluded": 3000000 } ] } ] } ] }, { "SepehrGlobalId": 104, "Name": "هتل خارجي تستي", "RoomTypeList": [ { "SepehrGlobalId": 6468, "Name": "دو تخته", "AdultCapacity": 2, "ChildCapacity": 1, "ChildAge": 5, "DateRangeList": [ { "Date": "2023-10-05", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5000000, "Room_NetPrice_TaxIncluded": 5000000 } ] }, { "Date": "2023-10-06", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5000000, "Room_NetPrice_TaxIncluded": 5000000 } ] }, { "Date": "2023-10-07", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5000000, "Room_NetPrice_TaxIncluded": 5000000 } ] }, { "Date": "2023-10-08", "AvailableRoomCount": 4, "HasCheckinLimit": false, "HasCheckoutLimit": false, "MinimumStay": 0, "MaximumStay": 0, "BoardTypeList": [ { "Code": "BB", "ExtrabedCapacity": 0, "Room_BoardPrice_TaxIncluded": 5000000, "Room_NetPrice_TaxIncluded": 5000000 } ] } ] } ] } ], "CurrencyCode": "IRR" }

availability

متد GetByFromDateAndToDate

API Endpoint

https://{SupplierWebsiteUrl}/api/Partners/Hotel/Availability/V3/GetByFromDateAndToDate post

Request Parameters

Response Data