الكائن 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.
ملاحظة: إذا كانت لديك خلفية توفّر خلاصات لحسابات متعددة، يجب أن تتطابق هذه القيمة مع قيمة سمة |
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 لتضمين أيام الاثنين بشكل صريح.
في حال الضبط على |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام الثلاثاء بوضوح.
في حال الضبط على |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام الأربعاء بشكل صريح.
في حال الضبط على |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام الخميس بشكل صريح.
في حال الضبط على |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام الجمعة بشكل صريح.
في حال الضبط على |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام السبت بشكل صريح.
في حال الضبط على |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الأحد بشكل صريح.
في حال الضبط على |
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 | نوع عدد المستودع الذي يتمّ تحديده. القيمة الصالحة هي:
|
أمثلة
المستودع المتبقي
تحديد 5
rooms left for
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 بنجاح.
تتضمّن كل رسالة إما |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | حاوية تتضمّن مشكلة واحدة أو أكثر حدثت أثناء معالجة رسالة OTA_HotelInvCountNotifRQ .
تتضمّن كل رسالة إما |
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>