نمای کلی
پیام در دسترس بودن ( OTA_HotelAvailNotifRQ
) تعریف می کند که آیا یک محصول (نوع اتاق همراه با طرح نرخ) برای یک برنامه سفر مشخص می تواند برای تاریخ های مربوطه فروخته شود یا خیر. هنگامی که یک پیام در دسترس بودن ارسال می کنید، نشان می دهید که آیا در دسترس بودن یا محدودیت های یک محصول تغییر کرده است یا خیر.
بخشهای زیر دستورالعملهای کلی، یک مثال اساسی و سناریوهای نحوه شروع را برای افزودن و بهروزرسانی در دسترس بودن با استفاده از پیام Availability پوشش میدهند.
محدودیت در دسترس بودن شبانه
پیام در دسترس بودن به شما امکان می دهد محدودیت هایی را تعریف کنید که در دسترس بودن کلی رزرو را کنترل می کند. یکی از انواع محدودیت های قابل توجه «در دسترس بودن شبانه» است: اینکه آیا محصول می تواند در تاریخ خاصی فروخته شود یا خیر. برای اینکه اقامت (از ورود به خروج تا خروج) قابل رزرو باشد، باید در تمام تاریخها در دسترس باشد، و سایر محدودیتهای رزرو و اقامت باید رعایت شوند.
تنظیمات محدودیت
به طور پیش فرض، RestrictionStatus
برای Restriction="Master"
بسته است. به عبارت دیگر، به طور پیش فرض، هر شب یک "stop sell" وجود دارد.
برای اینکه محصولی قابل فروش باشد، باید <RestrictionStatus Restriction="Master" Status="Open">
را برای همه ترکیبات محصولات در تمام شب های اقامت داشته باشد. یا باید برای هر محصول یک Open
صریح به Google ارسال کنید یا پیشفرض را در مرکز هتل تغییر دهید. این را می توان با رفتن به صفحه قیمت > تنظیمات در مرکز هتل و ویرایش فیلد "در دسترس بودن پیش فرض" انجام داد.
سایر محدودیت ها
- ورود/خروج
- از رسیدن یا خروج یک برنامه سفر در تاریخ مشخص شده جلوگیری می کند. به طور پیش فرض
Open
است. - حداقل و حداکثر رزرو رزرو
- مستلزم آن است که برنامه سفر حداقل یا حداکثر چند روز قبل از ورود خریداری شود.
- حداقل و حداکثر مدت اقامت
- مدت اقامت را برای سفرهایی که این تاریخ ورود دارند محدود می کند.
- حداقل و حداکثر اقامت رو به جلو (یا "Sy-through")
- مدت اقامت را برای سفرهایی که حاوی این تاریخ اقامت هستند محدود می کند.
- الگوی طول اقامت
- کنترل دقیق مدت اقامت مجاز برای این تاریخ ورود را می دهد.
دستورالعمل های عمومی
محدودیتهای در دسترس بودن بر اساس هتل، تاریخ، نوع اتاق و برنامه نرخ تعیین میشوند.
یک محصول فقط در صورتی قابل رزرو است که هیچ محدودیتی برای اقامت اعمال نشده باشد (از ورود تا خروج) یا زمانی که کاربر بتواند اقامت خود را رزرو کند.
هر زمان تغییری در محدودیتهای در دسترس بودن محصول در تاریخهای خاص ایجاد شد، بهروزرسانی پیام دسترسی به Google ارسال کنید.
مثال
این بخش یک مثال اساسی از پیام در دسترس بودن را با استفاده از عناصر مورد نیاز و اختیاری ارائه می دهد. هنگامی که فایل خود را آماده کردید، باید آن را از طریق یک پیام POST به این نقطه پایانی به Google ارسال کنید:
https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif
برای کسب اطلاعات بیشتر در مورد نحوه فشار دادن/پست کردن پیام، به ارسال پیامها مراجعه کنید.
برای HotelCode
، از شناسه هتل منحصربهفردی که در سیستم خود برای شناسایی ملک استفاده کردهاید، استفاده کنید. این مقدار باید با شناسه هتل مشخص شده با استفاده از <id>
در عنصر <listing>
در فید لیست هتل مطابقت داشته باشد. سازگاری با سیستم شما برای اطمینان از اینکه Google اطلاعات شما را به درستی نمایش می دهد بسیار مهم است.
این مثال نحوه تنظیم محدودیت های دسترسی را نشان می دهد:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-03-20T20:50:37-05:00"
Version="3.0">
<POS><Source><RequestorID ID="partner_key" /></Source></POS>
<AvailStatusMessages HotelCode="HOTELID">
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="202X-03-20"
End="202X-03-25"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
</LengthsOfStay>
<RestrictionStatus Restriction="Master" Status="Open" />
</AvailStatusMessage>
</OTA_HotelAvailNotifRQ>
برای مثالهای بیشتر، نمونههای در دسترس بودن را ببینید.
چگونه
این بخش راهحلهایی برای سناریوهایی که ممکن است هنگام ارسال پیامهای دسترسپذیری با آنها مواجه شوید، ارائه میکند، بهویژه جزئیات محدودیت در دسترس بودن شبانه (همچنین به عنوان «توقف فروش» شناخته میشود).
سناریو 1: نحوه فروش محصولات در تاریخ های خاص
توضیحات
میخواهید نوع اتاق و ترکیب طرح نرخ (محصول) را در تاریخهای خاص در دسترس قرار دهید.
راه حل
محدودیت Master
را روی Open
تنظیم کنید و تاریخ ها را مشخص کنید.
نمونه
این نمونه نحوه باز کردن در دسترس بودن شبانه برای یک محصول را برای چند هفته در ماه مارس نشان می دهد.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-03-20T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2022-03-20"
End="2022-03-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
برای اطلاعات بیشتر در مورد نحوه تعیین قیمت، به عیبیابی قیمتگذاری ناقص یا ناقص مراجعه کنید.
سناریو 2: چگونه می توان فروش محصولات را در تاریخ های خاص متوقف کرد
توضیحات
شما به صراحت می خواهید فروش یک محصول را (به جای اینکه موجودی آن تمام شده باشد) در تاریخ های خاص متوقف کنید.
راه حل
محدودیت Master
را روی Close
قرار دهید و تاریخ ها را مشخص کنید.
نمونه
این نمونه نحوه «توقف فروش» یا بستن در دسترس بودن شبانه یک محصول در تاریخهای مشخص را نشان میدهد.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2022-03-20T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2022-04-20"
End="2022-04-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>