تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

OTA_hotelInvCountNotifRQ

الكائن Requests

البنية

تستخدم رسالة 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 على العناصر والسمات التالية:

العنصر / @Attribute	عدد مرات الظهور	النوع	الوصف
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> ضمن خلاصة بيانات الفنادق. ويكون رقم تعريف الفندق مُدرجًا أيضًا في مركز إدارة معلومات الفنادق.
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`: مدى التوفّر محدّد

أمثلة

المستودع المتبقي

تحديد 5rooms left forRoomID_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 على العناصر والسمات التالية:

العنصر / @Attribute	عدد مرات الظهور	النوع	الوصف
	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	OpenTravel Alliance ERR (رمز الخطأ) المرتبط بالخطأ. يتم استخدام القيمة `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>