این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

OTA_HotelAvailNotifRQ

درخواست ها

نحو

پیام OTA_HotelAvailNotifRQ از دستور زیر استفاده می کند:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="message_ID"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean"
                                Tue="boolean"
                                Weds="boolean"
                                Thur="boolean"
                                Fri="boolean"
                                Sat="boolean"
                                Sun="boolean"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay FixedPatternLength="integer">
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay|FullPatternLOS]">
          <LOS_Pattern FullPatternLOS="pattern"/>
        </LengthOfStay>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer_or_duration"
                         MinAdvancedBookingOffset="integer_or_duration"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

نکته کلیدی: هر پیام <OTA_HotelAvailNotifRQ> به عنوان یک به روز رسانی دلتا در نظر گرفته می شود. برای هر ویژگی، تاریخ، اتاق و بسته مشخص شده در <StatusApplicationControl> ، یک به روز رسانی برای هر محدودیت تعریف شده قبلی تنها مقدار همان محدودیت را جایگزین می کند، در حالی که افزودن محدودیت جدید بر سایر محدودیت های تعریف شده قبلی تأثیری نمی گذارد. به عنوان مثال، اگر قبلاً حداقل مدت اقامت برای 2 روز تعریف شده بود و سپس یک پیام جدید حاوی حداکثر مدت اقامت برای 7 روز به‌روزرسانی شد، این اقدام مقدار حداقل مدت اقامت قبلی را پاک نمی‌کند.

عناصر و صفات

پیام OTA_HotelAvailNotifRQ دارای عناصر و ویژگی های زیر است:

توجه: هر نوع محدودیت مدت اقامت به طور مستقل تنظیم می شود. برای مثال، پیامی که SetMaxLOS را تنظیم می‌کند، مقداری را که قبلاً تعریف شده است برای SetForwardMaxStay بازنویسی نمی‌کند.

عنصر / @Attribute	ظهور	تایپ کنید	شرح
OTA_HotelAvailNotifRQ	1	Complex element	عنصر ریشه برای پیامی که در دسترس بودن نرخ اتاق را تعریف می کند.
OTA_HotelAvailNotifRQ / @xmlns	0..1	string (URI)	فضای نام XML
OTA_HotelAvailNotifRQ / @EchoToken	1	string	یک شناسه منحصر به فرد برای این پیام درخواست. این مقدار در پیام پاسخ برگردانده می شود. کاراکترهای مجاز عبارتند از `az` , `AZ` , `0-9` , `_` (خارج) و `-` (خط تیر).
OTA_HotelAvailNotifRQ / @TimeStamp	1	DateTime	تاریخ و زمان ایجاد این پیام.
OTA_HotelAvailNotifRQ / @Version	1	decimal	نسخه پیام OpenTravel.
OTA_HotelAvailNotifRQ / POS	0..1	POS	ظرفی برای تعیین حساب شریک برای این پیام. معمولاً در صورتی استفاده می‌شود که باطن شما فید قیمت برای چندین حساب شریک ارائه دهد.
OTA_HotelAvailNotifRQ / POS/ Source	1	Source	در صورت وجود `<POS>` الزامی است. ظرفی برای `<RequestorID>` .
OTA_HotelAvailNotifRQ / POS / RequestorID	1	RequestorID	در صورت وجود `<POS>` الزامی است. حساب شریک را تعریف می کند.
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID	1	string	حساب شریک برای این پیام. این مقدار رشته، مقدار `Partner key` لیست شده در صفحه تنظیمات حساب در مرکز هتل است. توجه: اگر یک Backend دارید که برای چندین حساب فید ارائه می‌دهد، این مقدار باید با مقدار ویژگی `partner` پیام تراکنش (داده‌های ویژگی) و مقدار ویژگی `ID` در عنصر `<RequestorID>` پیام `<OTA_HotelRateAmountNotifRQ>` شما مطابقت داشته باشد. همان حساب
OTA_HotelAvailNotifRQ / AvailStatusMessages	1	AvailStatusMessages	ظرفی برای یک یا چند عنصر `<AvailStatusMessage>` .
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode	1	string	شناسه منحصر به فرد ملک این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید لیست هتل مطابقت داشته باشد. شناسه هتل نیز در مرکز هتل درج شده است.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage	1..n	AvailStatusMessage	در دسترس بودن نرخ اتاق و محدودیت‌ها را برای بازه‌های زمانی مختلف برای یک ملک مشخص می‌کند.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit	1	integer	توجه: پیام OTA_HotelInvCountNotifRQ بر تنظیم این ویژگی ترجیح داده می شود. تعداد اتاق‌های باقی‌مانده که می‌توان برای محدوده تاریخ در `<StatusApplicationControl>` رزرو کرد. اگر `BookingLimit` مشخص شده باشد، `<StatusApplicationControl>` باید `InvTypeCode` مشخص کند و `<AvailStatusMessage>` نمی تواند حاوی `<LengthOfStay>` یا `<RestrictionStatus>` باشد. باید مساوی یا بزرگتر از 0 باشد. اگر منفی یا ارائه نشده باشد، پیش‌فرض 0 است. توجه: برای تعیین در دسترس بودن اتاق برای یک تنظیم معین `<StatusApplicationControl>` ، ویژگی `BookingLimit` باید حداقل یک بار تنظیم شود.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl	1	StatusApplicationControl	محدوده تاریخ و همچنین شناسه‌های نوع اتاق - `InvTypeCode` و طرح نرخ - `RatePlanCode` را تعریف می‌کند.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start	1	Date	تاریخ شروع بر اساس منطقه زمانی ملک که شامل محدوده تاریخ است.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End	1	Date	تاریخ پایان (بر اساس منطقه زمانی ملک)، شامل محدوده تاریخ. باید مساوی یا بزرگتر از مقدار `start` باشد. اگر `start` و `end` برابر باشند، به‌روزرسانی برای آن تاریخ اعمال می‌شود.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon	0..1	boolean	روی `true` یا `1` تنظیم کنید تا صراحتاً دوشنبه ها را شامل شود. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی «درست» تنظیم نشده‌اند، حذف می‌شوند (در واقع، از تاریخ‌های درون `Start and End ).`
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue	0..1	boolean	روی `true` یا `1` تنظیم کنید تا به صراحت سه‌شنبه‌ها را شامل شود. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی `true` تنظیم نشده اند، حذف می شوند (در واقع، از تاریخ های درون `Start` و `End` فیلتر می شوند).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds	0..1	boolean	روی `true` یا `1` تنظیم کنید تا صراحتاً چهارشنبه‌ها را شامل شود. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی `true` تنظیم نشده اند، حذف می شوند (در واقع، از تاریخ های درون `Start` و `End` فیلتر می شوند).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur	0..1	boolean	روی `true` یا `1` تنظیم کنید تا به صراحت پنجشنبه ها را در برگیرد. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی `true` تنظیم نشده اند، حذف می شوند (در واقع، از تاریخ های درون `Start` و `End` فیلتر می شوند).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri	0..1	boolean	روی `true` یا `1` تنظیم کنید تا به صراحت جمعه ها را شامل شود. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی `true` تنظیم نشده اند، حذف می شوند (در واقع، از تاریخ های درون `Start` و `End` فیلتر می شوند).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat	0..1	boolean	روی `true` یا `1` تنظیم کنید تا به صراحت شنبه ها را شامل شود. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی `true` تنظیم نشده اند، حذف می شوند (در واقع، از تاریخ های درون شروع و `End` فیلتر می شوند).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun	0..1	boolean	روی `true` یا `1` تنظیم کنید تا صراحتاً یکشنبه ها را شامل شود. اگر روی `true` تنظیم شود، سایر روزهای هفته که به صراحت روی `true` تنظیم نشده اند، حذف می شوند (در واقع، از تاریخ های درون `Start` و `End` فیلتر می شوند).
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode	1	string	شناسه منحصر به فرد موجودی (نوع اتاق). این مقدار در پیام Transactions (Property Data) به `<RoomID>` نشان داده می شود.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode	0..1	string	یک شناسه منحصر به فرد برای طرح نرخ. این شناسه به مقدار `<PackageID>` در پیام تراکنش (داده های ویژگی) نگاشت می شود. طرح نرخ بیشتر تعریف شده و در `<StatusApplicationControl>` در هر دو پیام `<OTA_HotelRateAmountNotifRQ>` و `<OTA_HotelAvailNotifRQ>` ارجاع داده شده است. وقتی `<AvailStatusMessage>` دارای ویژگی `BookingLimit` باشد، ویژگی `RatePlanCode` قابل اجرا نیست و نباید مشخص شود. اگر `<RestrictionStatus>` یا `<LengthOfStay>` مشخص شده باشد، باید مشخص شود.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay	0..1	LengthsOfStay	ظرفی برای تعریف محدودیت های LOS. اگر `<AvailStatusMessage>` دارای ویژگی `BookingLimit` باشد، نباید وجود داشته باشد.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength	0..1	integer	طول الگوی تعریف شده در `FullPatternLOS` . توجه: این ویژگی باید هنگام استفاده از `MinMaxMessageType="FullPatternLOS"` تنظیم شود و در غیر این صورت وجود نداشته باشد.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay	1..n	LengthOfStay	محدودیت هایی را برای مدت اقامت تعریف می کند. هنگام استفاده از بیش از یک عنصر `<LengthOfStay>` ، هر یک باید مقدار `MinMaxMessageType` متفاوتی را مشخص کند.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time	0..1	integer	مقدار واحد اندازه گیری طول اقامت. توجه داشته باشید که مقدار صفر به عنوان بدون محدودیت در نظر گرفته می شود. برای مثال، `<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS">` به معنای عدم حداکثر مدت اقامت است. توجه: این ویژگی باید تنظیم شود مگر اینکه از `MinMaxMessageType="FullPatternLOS"` استفاده کنید.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit	0..1	enum	واحد زمان اگر ارائه نشده باشد، پیش‌فرض `"Day"` است. مقدار معتبر: `Day` نکته: یک واحد `"Day"` برابر با 1 شب اقامت است.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType	1	enum	انواع محدودیت های مدت اقامت. `SetMaxLOS` ، `SetMinLOS` و `FullPatternLOS` مبتنی بر ورود هستند. `SetForwardMinStay` و `SetForwardMaxStay` مبتنی بر اقامت هستند. حداکثر مقادیر باید بزرگتر یا مساوی با حداقل مقادیر باشد.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern	0..1	LOS_Pattern	الگوی محدودیت مدت اقامت را تعریف می کند. توجه: این عنصر باید هنگام استفاده از `MinMaxMessageType="FullPatternLOS"` وجود داشته باشد و در غیر این صورت وجود نداشته باشد.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS	1	string	دنباله ای از نویسه های `Y` و `N` که نشان می دهد آیا هر مدت اقامت مجاز است، از یک شب تا مقدار در `FixedPatternLength` . هر مدت اقامت بیشتر از `FixedPatternLength` مقدار را در موقعیت نهایی به ارث می برد. برای مثال، با `FixedPatternLength="4"` و `FullPatternLOS="YNYN"` ، فقط مدت اقامت 1 و 3 مجاز است.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus	0..1	RestrictionStatus	محدودیت های سفر را تعریف می کند. اگر `<AvailStatusMessage>` دارای ویژگی `BookingLimit` باشد، نباید وجود داشته باشد.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status	0..1	enum	نشان می دهد که آیا نوع محدودیت مشخص شده توسط ویژگی `Restriction` باز یا بسته است. مقادیر معتبر عبارتند از: `Open` `Close` توجه داشته باشید: به‌طور پیش‌فرض، Google فرض می‌کند که تنظیمات `Master` برای همه محصولات، `Close` است. می‌توانید این را از طریق «در دسترس بودن پیش‌فرض» در تنظیمات قیمت‌گذاری مرکز هتل پیکربندی کنید. مقدار "بسته" در مرکز هتل با مقدار `Close` در اینجا مطابقت دارد. تنظیم `Master` برای `Close` به عنوان "stop sell" شناخته می شود.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction	0..1	enum	در صورت ارائه `Status` این ویژگی مورد نیاز است. مقادیر معتبر عبارتند از: `Arrival:` این مقدار از برنامه های سفر با تاریخ ورود در محدوده تاریخ `Start` و `End` ، از جمله، جلوگیری می کند. `Departure:` این مقدار از برنامه‌های سفر با تاریخ خروج در محدوده تاریخ `Start` و `End` ، از جمله، جلوگیری می‌کند. `Master:` این مقدار نشان می دهد که آیا نرخ اتاق برای رزرو در تاریخ موجود است یا خیر. توجه: اگر `Restriction` مشخص نشده باشد، مقدار پیش‌فرض `Master` است.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset	0..1	integer or duration	حداقل مدت قبل از تاریخ ورود (به وقت محلی ملک) که برای آن می توان این نرخ اتاق را رزرو کرد. انواع مقادیر معتبر عبارتند از: `Integer:` تعداد روزهای قبل از تاریخ ورود. به عنوان مثال، مقدار `1` نشان می دهد که نرخ اتاق باید حداقل یک روز قبل از تاریخ ورود رزرو شود. مقدار `0` (مقدار پیش فرض) نشان دهنده عدم محدودیت در آخرین زمان رزرو است. `ISO 8601 Duration (days, hours, and minutes):` تعداد روزها (و در صورت اختیاری ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال، مقدار `P1D` نشان می دهد که نرخ اتاق باید یک روز قبل از تاریخ ورود رزرو شود. مقدار `P0DT6H` نشان می دهد که رزرو باید شش ساعت قبل از پایان تاریخ ورود (یعنی ساعت 18:00) یا زودتر انجام شود.
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset	0..1	integer or duration	حداکثر مدت قبل از تاریخ ورود (به وقت محلی ملک) که برای آن می توان این نرخ اتاق را رزرو کرد. انواع مقادیر معتبر عبارتند از: `Integer:` تعداد روزهای قبل از تاریخ ورود. به عنوان مثال، مقدار `30` نشان می دهد که نرخ اتاق را نمی توان زودتر از 30 روز قبل از تاریخ ورود رزرو کرد. مقدار `0` (مقدار پیش فرض) نشان دهنده عدم محدودیت در اولین زمان رزرو است. `ISO 8601 Duration (days, hours, and minutes):` تعداد روزها (و در صورت تمایل ساعت/دقیقه) قبل از تاریخ ورود. به عنوان مثال، مقدار `P30D` نشان می دهد که نرخ اتاق را نمی توان زودتر از 30 روز قبل از تاریخ ورود رزرو کرد. مقدار `P30DT6H` نشان می دهد که رزرو نمی تواند زودتر از ساعت 18:00، 30 روز قبل از تاریخ ورود انجام شود.

مثال ها

تاریخ ورود LoS

حداقل و حداکثر مدت اقامت (بر اساس تاریخ ورود) را تنظیم کنید.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

مدت زمان LoS

حداقل و حداکثر مدت اقامت (بر اساس اقامت از طریق اقامت) را تنظیم کنید.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

محدودیت خروج

یک محدودیت بسته به خروج تنظیم کنید. (این از برنامه های سفر با خروج در تاریخ های مشخص جلوگیری می کند.)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

محدودیت ورود

محدودیت ورود بسته را تعیین کنید. (این از برنامه های سفر با ورود در تاریخ های مشخص جلوگیری می کند.)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

باز کردن تاریخ های در دسترس بودن

در دسترس بودن برای نوع اتاق و طرح نرخ در تاریخ های مشخص شده.

توجه: قبل از اینکه قیمت‌ها کاملاً در دسترس باشند، به نرخ‌های شبانه، همراه با تعداد موجودی بیشتر از 0 برای نوع اتاق نیز نیاز است.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

تاریخ های دسترسی را ببندید

بسته بودن در دسترس بودن برای نوع اتاق و طرح نرخ در تاریخ های مشخص. (این به عنوان "فروش توقف" نیز شناخته می شود.)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

محدودیت رزرو قبلی

حداقل و حداکثر محدودیت های پنجره رزرو پیشرفته را تنظیم کنید که فقط در آخر هفته اعمال می شود.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

رزرو قطع شده

برای رزرو در تاریخ ورود در ساعت 18:00 به وقت محلی هتل، قطعی را اعمال کنید.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-06-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

محدودیت های متعدد

برای یک نوع اتاق و طرح نرخ، محدودیت‌های متعددی را در تاریخ‌های یکسان تنظیم کنید.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

محدودیت رزرو

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

توجه: پیام OTA_HotelInvCountNotifRQ بر تنظیم این ویژگی ترجیح داده می شود.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-31"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

FullPatternLoS

یک الگوی کامل محدودیت مدت اقامت تنظیم کنید.

برای اعلام حضور در 26 ژوئیه 2023، تنها مدت اقامت 2، 4، و 6 مجاز است. مدت اقامت 1، 3، 5، و 7+ در دسترس نیست.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2023-07-26"
                                End="2023-07-26"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay FixedPatternLength="7">
        <LengthOfStay MinMaxMessageType="FullPatternLOS">
          <LOS_Pattern FullPatternLOS="NYNYNYN"/>
        </LengthOfStay>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

پاسخ

نحو

پیام OTA_HotelAvailNotifRS از دستور زیر استفاده می کند:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       EchoToken="echo_token"
                       Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelAvailNotifRS>

عناصر و صفات

پیام OTA_HotelAvailNotifRS دارای عناصر و ویژگی های زیر است:

عنصر / @Attribute	ظهور	تایپ کنید	شرح
OTA_HotelAvailNotifRS	1	Complex element	عنصر ریشه برای پاسخ به پیام در دسترس بودن.
OTA_HotelAvailNotifRS / @TimeStamp	1	DateTime	تاریخ و زمان ایجاد این پیام.
OTA_HotelAvailNotifRS / @EchoToken	1	string	شناسه منحصر به فرد از پیام `OTA_HotelAvailNotifRQ` مرتبط.
OTA_HotelAvailNotifRS / Success	0..1	Success	نشان می دهد که پیام `OTA_HotelAvailNotifRQ` با موفقیت پردازش شده است. یا `<Success>` یا `<Errors>` در هر پیام وجود دارد.
OTA_HotelAvailNotifRS / Errors	0..1	Errors	محفظه ای برای یک یا چند مشکلی که هنگام پردازش پیام `OTA_HotelAvailNotifRQ` با آن مواجه می شوید. یا `<Success>` یا `<Errors>` در هر پیام وجود دارد.
OTA_HotelAvailNotifRS / Errors / Error	1..n	Error	شرح خطایی که هنگام پردازش پیام `OTA_HotelAvailNotifRQ` رخ داد. جزئیات مربوط به این خطاها را می‌توانید در پیام‌های خطای وضعیت فید مشاهده کنید.
OTA_HotelAvailNotifRS / Errors / Error / @Type	1	integer	OpenTravel Alliance EWT (نوع هشدار خطا) مرتبط با خطا. فقط از مقدار `12 (Processing exception)` استفاده می شود.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	integer	OpenTravel Alliance ERR (کد خطا) مرتبط با خطا. فقط از مقدار `450 (Unable to process)` استفاده می شود.
OTA_HotelAvailNotifRS / Errors / Error / @Code	1	enum	وضعیت درخواست اصلی فقط از مقدار `NotProcessed` استفاده می شود.
OTA_HotelAvailNotifRS / Errors / Error / @ShortText	1	string	شناسه Google برای مشکل. جزئیات مربوط به این خطاها را می‌توانید در پیام‌های خطای وضعیت فید مشاهده کنید.

مثال ها

موفقیت

زیر پاسخی به یک پیام OTA_HotelAvailNotifRQ است که با موفقیت پردازش شده است.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelAvailNotifRS>

خطاها

زیر پاسخی به یک پیام OTA_HotelAvailNotifRQ است که به دلیل خطا پردازش نشده است.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2023-07-21T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelAvailNotifRS>