OTA_HotelInvCountNotifRQ

الطلبات

البنية

تستخدم رسالة OTA_HotelInvCountNotifRQ البنية التالية:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

العناصر والسمات

تحتوي رسالة OTA_HotelInvCountNotifRQ على العناصر والسمات التالية:

العنصر / @السمة عدد مرات الظهور النوع الوصف
OTA_HotelInvCountNotifRQ 1 Complex element العنصر الجذر لرسالة تحدّد مدى توفّر سعر الإقامة في الغرفة.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) مساحة اسم XML
OTA_HotelInvCountNotifRQ / @EchoToken 1 string معرّف فريد لرسالة الطلب هذه. يتم عرض هذه القيمة في رسالة الردّ. الأحرف المسموح بها هي a-z وA-Z و0-9 و_ (شرطة سفلية) و- (شرطة).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime تمثّل هذه السمة تاريخ إنشاء هذه الرسالة ووقته.
OTA_HotelInvCountNotifRQ / @Version 1 decimal إصدار رسالة OpenTravel
OTA_HotelInvCountNotifRQ / POS 0..1 POS حاوية لتحديد حساب الشريك لهذه الرسالة (يتم استخدامها عادةً إذا كانت الخلفية توفّر خلاصات أسعار لعدة حسابات شركاء).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source مطلوبة في حال توفّر <POS> تمثّل هذه السمة حاوية لـ <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID مطلوبة في حال توفّر <POS> تحدّد هذه السمة حساب الشريك.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string حساب الشريك لهذه الرسالة قيمة السلسلة هذه هي قيمة مفتاح الشريك المُدرَجة في صفحة إعدادات الحساب في Hotel Center.

ملاحظة: إذا كان لديك نظام خلفي يوفّر خلاصات لعدة حسابات، يجب أن تتطابق هذه القيمة مع قيمة السمة partner في رسالة المعاملة (بيانات الموقع) وقيمة السمة ID في العنصر <RequestorID> من رسالة <OTA_HotelRateAmountNotifRQ> للحساب نفسه.
OTA_HotelInvCountNotifRQ / Inventories 1 Inventories تمثّل هذه السمة حاوية لعنصر واحد أو أكثر من عناصر <Inventory>.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string المعرّف الفريد للمكان المخصّص للاستئجار. يجب أن تتطابق هذه القيمة مع معرّف الفندق المحدّد باستخدام <id> في العنصر <listing> من خلاصة بيانات الفنادق. يظهر رقم تعريف الفندق أيضًا في Hotel Center.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory تحدّد هذه السمة عدد الغرف المتاحة لنطاقات زمنية مختلفة في مكان إقامة واحد.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl تحدّد هذه السمة النطاق الزمني، بالإضافة إلى معرّف نوع الغرفة (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date تمثّل هذه السمة تاريخ البدء (استنادًا إلى المنطقة الزمنية للموقع)، وهو تاريخ مشمول في النطاق الزمني.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date تاريخ الانتهاء (استنادًا إلى المنطقة الزمنية للموقع)، شاملًا النطاق الزمني. يجب أن تكون القيمة مساوية لقيمة start أو أكبر منها. إذا كان start وend متساويَين، ينطبق التعديل على هذا التاريخ.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الاثنين بشكل صريح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الثلاثاء بشكلٍ صريح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام الأربعاء بشكلٍ صريح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean اضبط النوع على true أو 1 لتضمين أيام الخميس بشكلٍ واضح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean اضبط النوع على true أو 1 لتضمين أيام الجمعة بشكل صريح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean اضبط القيمة على true أو 1 لتضمين أيام السبت بشكل صريح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean اضبط النوع على true أو 1 لتضمين أيام الأحد بشكل صريح.

إذا تم ضبطها على true، سيتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل واضح على true (أي سيتم فلترتها من التواريخ ضمن Start وEnd).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string المعرّف الفريد للمستودع (نوع الغرفة). ترتبط هذه القيمة بالحقل <RoomID> في رسالة المعاملات (بيانات الموقع).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts حاوية لتحديد عدد مستودع واحد
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount تحدّد هذه السمة عدد الغرف المتاحة التي يمكن حجزها.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer عدد الغرف المتاحة التي يمكن حجزها لنوع الغرفة تشير القيمة صفر إلى أنّ نوع الغرفة غير متوفّر. ويتم التعامل مع القيمة السالبة على أنّها صفر.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

نوع عدد المستودع الذي يتم تحديده القيمة الصالحة هي:

  • ‫2: مدى التوفّر المحدّد

أمثلة

المساحات الإعلانية المتبقية

يضبط هذا السمة 5 غرف متبقية في RoomID_1 في التواريخ المحدّدة.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

المساحات الإعلانية التي تم بيعها

تم تصنيف RoomID_1 على أنّه غير متوفّر في التواريخ المحدّدة.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

الردود

البنية

تستخدم رسالة OTA_HotelInvCountNotifRS البنية التالية:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

العناصر والسمات

تحتوي رسالة OTA_HotelInvCountNotifRS على العناصر والسمات التالية:

العنصر / @السمة عدد مرات الظهور النوع الوصف
1 Complex element العنصر الجذر للردّ على رسالة بيانات التوفّر
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime تمثّل هذه السمة تاريخ إنشاء هذه الرسالة ووقته.
OTA_HotelInvCountNotifRS / @EchoToken 1 string المعرّف الفريد من الرسالة المرتبطة.OTA_HotelInvCountNotifRQ
OTA_HotelInvCountNotifRS / Success 0..1 Success يشير إلى أنّه تمت معالجة الرسالة OTA_HotelInvCountNotifRQ بنجاح.

يجب أن تتضمّن كل رسالة إما <Success> أو <Errors>.
OTA_HotelInvCountNotifRS / Errors 0..1 Errors حاوية لمشكلة واحدة أو أكثر حدثت أثناء معالجة الرسالة OTA_HotelInvCountNotifRQ.

يجب أن تتضمّن كل رسالة إما <Success> أو <Errors>.
OTA_HotelInvCountNotifRS / Errors / Error 1..n Error تمثّل هذه السمة وصفًا للخطأ الذي حدث أثناء معالجة الرسالة التي تحمل المعرّف OTA_HotelInvCountNotifRQ. يمكنك الاطّلاع على تفاصيل حول هذه الأخطاء في رسائل الخطأ في حالة الخلاصة.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer تمثّل هذه السمة نوع الخطأ أو التحذير وفقًا لمعيار OpenTravel Alliance EWT. يتم استخدام القيمة 12 (Processing exception) فقط.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer رمز الخطأ (ERR) الصادر عن OpenTravel Alliance والمرتبط بالخطأ يتم استخدام القيمة 450 (Unable to process) فقط.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum حالة الطلب الأصلي. يتم استخدام القيمة NotProcessed فقط.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string معرّف Google للمشكلة. يمكنك الاطّلاع على تفاصيل حول هذه الأخطاء في رسائل الخطأ في حالة الخلاصة.

أمثلة

تم الإجراء بنجاح

في ما يلي ردّ على رسالة OTA_HotelInvCountNotifRQ تمت معالجتها بنجاح.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

الأخطاء

في ما يلي ردّ على رسالة OTA_HotelInvCountNotifRQ لم تتم معالجتها بسبب حدوث أخطاء.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>