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

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

العنصر / @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`: تم تحديد مدى التوفّر.

أمثلة

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

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

العنصر / @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 المرتبط بالخطأ ويتم استخدام القيمة `12 (Processing exception)` فقط.
OTA_HotelInvCountNotifRS / Errors / Error / @Code	1	integer	رمز الخطأ في 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>