تمت ترجمة هذه الصفحة بواسطة 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> في خلاصة قائمة الفنادق. رقم تعريف الفندق مُدرج أيضًا في 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 على العناصر التالية :

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