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

نظرة عامة

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

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

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

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

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

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

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

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

الإرشادات

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

  • يرتبط المستودع الإعلاني بالفندق والتاريخ ونوع الغرفة.

  • يجب أن يزيد عدد المستودع الإعلاني عن 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>

لمزيد من الأمثلة، راجع أمثلة للمستودع.

فيديوهات إرشادية

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

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

الوصف

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

الحلّ

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