طلبات
البنية
تستخدم الرسالة 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 غرف متبقية في 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 المرتبط
بالخطأ ويتم استخدام القيمة 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>