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 نوع التحذير من الخطأ (EWT) في OpenTravel Alliance المرتبط بالخطأ يتم استخدام القيمة 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>