پیام موجودی

بررسی اجمالی

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

بخش‌های زیر دستورالعمل‌های کلی، یک مثال اساسی و سناریوهای چگونگی شروع کار با افزودن و به‌روزرسانی موجودی و ارسال پیام‌های موجودی را پوشش می‌دهند.

برای نمونه‌هایی از سناریوهای مختلف مرتبط با موجودی، به دستورالعمل‌ها مراجعه کنید.

عناصر مورد نیاز و اختیاری

مرجع XML توضیحاتی در مورد عناصر مورد نیاز و اختیاری ارائه می دهد. برای جزئیات بیشتر در مورد ویژگی‌ها و عناصر فرزند، به عناصر و ویژگی‌های موجودی مراجعه کنید.

نحو و طرحواره

هنگام ایجاد پیام Inventory از مثال نحو Inventory به عنوان مرجع استفاده کنید تا مطمئن شوید که فرمت صحیح را دنبال می کنید.

می‌توانید از یک ابزار XML شخص ثالث مانند xmllint برای تأیید اعتبار فیدهای خود با طرح‌واره‌های منتشر شده قبل از ارسال آنها به Google استفاده کنید. برای طرح پیام موجودی، به طرح‌های تبلیغات هتل مراجعه کنید.

رهنمودها

از دستورالعمل های زیر برای پیام موجودی استفاده کنید:

  • موجودی بر اساس هتل، تاریخ و نوع اتاق کلید می‌خورد.

  • تعداد موجودی‌ها باید برای تمام شب‌های اقامت بیشتر از 0 باشد تا قیمت طرح نرخ مرتبط و اشغال نشان داده شود.

  • اگر تعداد موجودی برابر با 0 باشد، اتاق‌ها برای رزرو اتاق برای شناسه اتاق و محدوده تاریخ مشخص شده در دسترس نخواهد بود.

  • CountType همیشه باید مقدار 2 را داشته باشد تا معتبر باشد زیرا تعداد "در دسترس بودن قطعی" را نشان می دهد.

  • هر زمان که رزرو یا کنسلی اتاقی در سیستم شما رخ داد، موجودی به روز شده را ارسال کنید.

موجودی در مقابل در دسترس بودن

موجودی تعداد اتاق‌های قابل رزرو بر اساس تعداد فیزیکی است و در دسترس بودن نشان می‌دهد که آیا ترکیبی از نوع اتاق و طرح نرخ مجاز به رزرو است یا خیر. برای ARI، در دسترس بودن و موجودی هر دو می توانند بر اساس مجموعه ای از تاریخ ها یا نوع محل اقامت متفاوت باشند، و هر دو دارای انواع پیام متناظر هستند. موجودی و در دسترس بودن بر اساس هتل، تاریخ و نوع اتاق، با اضافه شدن برنامه نرخ برای در دسترس بودن کلید می‌خورد.

حتی زمانی که موجودی وجود دارد، ممکن است "عدم دسترسی" وجود داشته باشد زیرا موجودی و در دسترس بودن مستقل از یکدیگر هستند.

دو مفهوم در دسترس بودن وجود دارد. اول، در دسترس بودن کلی یک محصول برای یک اقامت مشخص وجود دارد که تحت تأثیر عواملی مانند اینکه آیا هر شب یک نرخ تعریف شده دارد یا خیر، موجودی برای نوع اتاق مرتبط، و محدودیت در دسترس بودن باز است، وجود دارد. دوم، محدودیت خاصی برای یک محصول در تاریخ معین وجود دارد که با <RestrictionStatus Restriction="Master" Status="Open"/> در OTA_HotelAvailNotifRQ نشان داده می شود، و بسته شدن این در دسترس بودن به عنوان "توقف فروش" شناخته می شود.

موجودی باید یک عدد صحیح بزرگتر از 0 برای اتاق باشد و محدودیت در دسترس بودن باید باز باشد تا قیمت یک محصول نشان داده شود.

مثال

این بخش یک مثال اساسی از پیام موجودی را با استفاده از عناصر مورد نیاز و اختیاری ارائه می دهد. هنگامی که فایل خود را آماده کردید، باید آن را از طریق یک پیام POST به این نقطه پایانی به Google ارسال کنید:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

برای کسب اطلاعات بیشتر در مورد نحوه فشار دادن/پست کردن پیام، به ارسال پیام‌ها مراجعه کنید.

برای HotelCode ، از شناسه هتل منحصربه‌فردی که در سیستم خود برای شناسایی ملک استفاده کرده‌اید، استفاده کنید. این مقدار باید با شناسه هتل مشخص شده با استفاده از <id> در عنصر <listing> در فید لیست هتل مطابقت داشته باشد. برای <RoomID> ، از همان شناسه ای که در سیستم خود برای انواع اتاق استفاده می کردید استفاده کنید. سازگاری با سیستم شما برای اطمینان از اینکه Google اطلاعات شما را به درستی نمایش می دهد بسیار مهم است.

این مثال نحوه تنظیم موجودی 13 اتاق قابل رزرو برای ماه دسامبر را نشان می دهد:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

برای مثال‌های بیشتر، نمونه‌های موجودی را ببینید.

چگونه

این بخش سناریویی را ارائه می دهد که ممکن است هنگام ارسال پیام موجودی با آن مواجه شوید.

سناریو: چگونه از رزرو اتاق جلوگیری کنیم

شرح

باید مشخص کنید که اتاق‌های باقی‌مانده‌ای وجود ندارد که بتوان برای این نوع اتاق در مجموعه‌ای از تاریخ‌های خاص رزرو کرد، بیشتر به این دلیل که آنها فروخته شده‌اند.

راه حل

شما <InvCount Count> روی مقدار 0 تنظیم می کنید و محدوده تاریخ مورد نظر را اضافه می کنید.

نمونه

این نمونه نحوه استفاده از InvCount برای تنظیم موجودی روی 0 برای اتاق و تاریخ‌های مشخص شده نشان می‌دهد (به عنوان مثال، چند هفته اول ژانویه).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>