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>