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

نظرة عامة

تحدِّد رسالة المستودع (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>، يجب استخدام المعرّف نفسه الذي استخدمته في النظام. أنواع الغرف. إنّ الاتساق مع نظامك أمر بالغ الأهمية لضمان حصولك على يعرض بياناتك بشكل صحيح.

يوضح هذا المثال كيفية ضبط مستودع لـ 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>