رسالة المستودع

نظرة عامة

تحدّد رسالة "مستودع الغرف" (OTA_HotelInvCountNotifRQ) عدد الغرف المتاحة للحجز (عدد الغرف الفعلية) لأنواع غرف معيّنة. عند إرسال رسالة "المستودع"، عليك تحديد عدد الغرف المتوفّرة من هذا النوع في تاريخ معيّن. إذا لم تتوفّر غرف من هذا النوع، لن يتم عرض المنتجات التي تتضمّن نوع الغرفة والتاريخ المحدّدين.

تتناول الأقسام التالية إرشادات عامة ومثالاً أساسيًا وسيناريوهات حول كيفية إضافة المستودع الإعلاني وتعديله وإرسال رسائل المستودع الإعلاني لمساعدتك في البدء.

للاطّلاع على أمثلة على سيناريوهات مختلفة ذات صلة بالمستودع الإعلاني، راجِع الإرشادات.

العناصر المطلوبة والاختيارية

تقدّم مرجع XML أوصافًا للعناصر المطلوبة والاختيارية. لمزيد من التفاصيل حول السمات والعناصر الفرعية، يُرجى الاطّلاع على عناصر المستودع وسماته.

البنية والمخططات

استخدِم مثال بنية المستودع كمرجع عند إنشاء رسالة المستودع للتأكّد من اتّباع التنسيق الصحيح.

يمكنك استخدام أداة XML تابعة لجهة خارجية، مثل xmllint، للتحقّق من صحة خلاصاتك باستخدام المخططات المنشورة قبل إرسالها إلى Google. لمزيد من المعلومات عن مخطط رسالة Inventory، اطّلِع على مخططات إعلانات الفنادق.

الإرشادات

اتّبِع الإرشادات التالية لكتابة رسالة بشأن المستودع:

يتم تحديد مفتاح المخزون حسب الفندق والتاريخ ونوع الغرفة.
يجب أن يكون عدد الغرف المتاحة أكبر من 0 لكل ليالي الإقامة من أجل عرض السعر لخطة السعر والإشغال المرتبطَين.
إذا كان عدد المستودع يساوي 0، لن تكون الغرف متاحة للحجز ضمن معرّف الغرفة والنطاق الزمني المحدّدَين.
يجب أن تكون قيمة CountType دائمًا 2 لتكون صالحة، لأنّها تشير إلى عدد "المقاعد المتاحة بشكل مؤكّد".
أرسِل معلومات محدّثة عن المستودع كلّما تم إجراء حجز أو إلغاء حجز غرفة في نظامك.

المستودع مقابل مدى التوفّر

المستودع هو عدد الغرف المتاحة للحجز استنادًا إلى العدد الفعلي، وتشير حالة التوفّر إلى ما إذا كان من المسموح حجز مزيج من نوع الغرفة وخطة الأسعار. بالنسبة إلى ARI، يمكن أن يختلف كل من مدى التوفّر والمستودع استنادًا إلى مجموعة من التواريخ أو نوع مكان الإقامة، ولكل منهما أنواع رسائل مقابلة. يتم تحديد المفتاح الخاص بالمساحة المتوفّرة ومدى التوفّر حسب الفندق والتاريخ ونوع الغرفة، بالإضافة إلى خطة الأسعار الخاصة بمدى التوفّر.

قد لا يتوفّر المنتج حتى إذا كان هناك مستودع، لأنّ المستودع ومدى التوفّر مستقلان عن بعضهما.

هناك مفهومَان للتوفّر. أولاً، هناك مدى التوفّر العام للمنتج خلال فترة إقامة معيّنة، ويتأثر هذا المدى بعوامل مثل ما إذا كان لكل ليلة سعر محدّد، والمخزون المتاح لنوع الغرفة المرتبط، وما إذا كان قيود التوفّر مفتوحة. ثانيًا، هناك القيود المحدّدة على منتج في تاريخ معيّن، ويتم تمثيلها بالرمز <RestrictionStatus Restriction="Master" Status="Open"/> في OTA_HotelAvailNotifRQ، ويُعرف إغلاق مدى التوفّر هذا باسم "إيقاف البيع".

يجب أن يكون المستودع عددًا صحيحًا أكبر من 0 للغرفة، ويجب أن يكون قيود التوفّر مفتوحًا لعرض سعر المنتج.

مثال

يقدّم هذا القسم مثالاً أساسيًا على رسالة مستودع إعلاني تستخدم عناصر إلزامية واختيارية. بعد إعداد ملفك، عليك إرساله إلى Google من خلال رسالة POST إلى نقطة النهاية هذه:

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>

للاطّلاع على المزيد من الأمثلة، راجِع أمثلة على المستودع الإعلاني.

طرق التنفيذ

يقدّم هذا القسم سيناريو قد تواجهه أثناء إرسال رسالة Inventory.

السيناريو: كيفية منع حجز الغرف

الوصف

عليك الإشارة إلى أنّه لم تعُد هناك غرف متاحة للحجز من هذا النوع في مجموعة تواريخ معيّنة، ويحدث ذلك عادةً بسبب عدم توفّر غرف.

الحل

اضبط <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>