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>