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>

محدودیت های LoS را حذف کنید

تنظیم Time="0" در <LengthOfStay> نشان می دهد که هیچ محدودیتی برای مدت زمان مشخص شده اقامت وجود ندارد. به عنوان مثال، <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> به این معنی است که محدودیت حداکثر مدت اقامت وجود ندارد. 

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

درخواست ها

نحو

پیام 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>

محدودیت های LoS را حذف کنید

تنظیم Time="0" در <LengthOfStay> نشان می دهد که هیچ محدودیتی برای مدت زمان مشخص شده اقامت وجود ندارد. به عنوان مثال، <LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> به این معنی است که محدودیت حداکثر مدت اقامت وجود ندارد. 

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