طلبات
البنية
تستخدم الرسالة OTA_HotelAvailNotifRQ
البنية التالية:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<AvailStatusMessages HotelCode="HotelID">
<AvailStatusMessage BookingLimit="integer">
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="YYYY-MM-DD"
End="YYYY-MM-DD"
Mon="boolean"
Tue="boolean"
Weds="boolean"
Thur="boolean"
Fri="boolean"
Sat="boolean"
Sun="boolean"
InvTypeCode="RoomID"
RatePlanCode="PackageID"/>
<LengthsOfStay FixedPatternLength="integer">
<LengthOfStay Time="integer"
TimeUnit="[Day]"
MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
SetForwardMinStay|FullPatternLOS]">
<LOS_Pattern FullPatternLOS="pattern"/>
</LengthOfStay>
</LengthsOfStay>
<RestrictionStatus Status="[Close|Open]"
Restriction="[Arrival|Departure|Master]"
MaxAdvancedBookingOffset="integer_or_duration"
MinAdvancedBookingOffset="integer_or_duration"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
العناصر والسمات
تحتوي رسالة OTA_HotelAvailNotifRQ
على العناصر والسمات التالية:
ملاحظة: يتم تحديد كل نوع من أنواع القيود المفروضة على مدة الإقامة بشكل مستقل. على سبيل المثال، لن تحلّ الرسالة التي تضبط SetMaxLOS
محل القيمة التي تم تحديدها سابقًا للسمة SetForwardMaxStay
.
العنصر / @Attribute | عدد مرات الظهور | النوع | الوصف |
---|---|---|---|
OTA_HotelAvailNotifRQ | 1 | Complex element | تمثّل هذه السمة العنصر الجذر لرسالة تحدّد مدى توفّر سعر الإقامة في الغرفة. |
OTA_HotelAvailNotifRQ / @xmlns | 0..1 | string (URI) | مساحة الاسم XML. |
OTA_HotelAvailNotifRQ / @EchoToken | 1 | string | معرّف فريد لرسالة الطلب هذه. يتم عرض هذه القيمة في رسالة الرد. الأحرف المسموح بها هي a-z
وA-Z و0-9 و_ (شرطة سفلية)
و- (شرطة). |
OTA_HotelAvailNotifRQ / @TimeStamp | 1 | DateTime | تاريخ ووقت إنشاء هذه الرسالة |
OTA_HotelAvailNotifRQ / @Version | 1 | decimal | إصدار رسالة OpenTravel. |
OTA_HotelAvailNotifRQ / POS | 0..1 | POS | حاوية لتحديد حساب الشريك لهذه الرسالة ويتم استخدام هذه الطريقة عادةً إذا كانت الخلفية توفر خلاصات أسعار لحسابات شركاء متعددة. |
OTA_HotelAvailNotifRQ / POS/ Source | 1 | Source | تكون هذه السمة مطلوبة في حال استخدام السمة <POS> . تمثّل هذه السمة حاوية للسمة <RequestorID> . |
OTA_HotelAvailNotifRQ / POS / RequestorID | 1 | RequestorID | تكون هذه السمة مطلوبة في حال استخدام السمة <POS> . تحدّد حساب الشريك. |
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID | 1 | string | حساب الشريك لهذه الرسالة قيمة السلسلة هذه هي
القيمة Partner key المُدرجة في
صفحة "إعدادات الحساب" في Hotel Center.
ملاحظة: إذا كانت لديك خلفية توفّر خلاصات لحسابات متعددة، يجب أن تتطابق هذه القيمة مع قيمة السمة |
OTA_HotelAvailNotifRQ / AvailStatusMessages | 1 | AvailStatusMessages | تمثّل هذه السمة حاوية لعنصر <AvailStatusMessage>
واحد أو أكثر. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode | 1 | string | تمثّل هذه السمة المعرّف الفريد الخاص بالمكان المخصّص للاستئجار. ويجب أن تتطابق هذه القيمة مع رقم تعريف الفندق المحدّد باستخدام <id> في العنصر <listing> ضمن خلاصة "قائمة الفنادق". يكون رقم تعريف الفندق مُدرَجًا أيضًا في مركز إدارة معلومات الفنادق. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage | 1..n | AvailStatusMessage | تحدّد هذه السمة مدى توفّر سعر الإقامة في الغرفة والقيود المفروضة على النطاقات الزمنية المختلفة لفندق واحد. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit | 1 | integer |
ملاحظة: يُفضّل استخدام رسالة
OTA_HotelInvCountNotifRQ بدلاً من إعداد
هذه السمة. تمثّل هذه السمة عدد الغرف المتبقية التي يمكن حجزها
للنطاق الزمني في ويجب أن تساوي القيمة 0 أو تزيد عنها. يتم ضبط القيمة تلقائيًا على 0 إذا كانت القيمة سالبة أو لم يتم توفيرها. ملاحظة: للتأكّد من توفّر الغرف في إعداد |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl | 1 | StatusApplicationControl | يتم تحديد النطاق الزمني، بالإضافة إلى معرّفات نوع الغرفة
— InvTypeCode وخطة الأسعار
—RatePlanCode . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start | 1 | Date | تاريخ البدء استنادًا إلى المنطقة الزمنية للموقع التي تشمل النطاق الزمني. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End | 1 | Date | تاريخ الانتهاء (استنادًا إلى المنطقة الزمنية للموقع)، بما في ذلك
النطاق الزمني. يجب أن تساوي القيمة start أو تزيد عنها.
إذا كانت قيمة start وend متساويتَين، سيسري التعديل
على ذلك التاريخ. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الاثنين بشكل صريح.
في حال ضبط السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الثلاثاء بشكل صريح.
في حال الضبط على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الأربعاء بشكل واضح.
في حال الضبط على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur | 0..1 | boolean | اضبط السمة على true أو 1 لتضمين أيام الخميس بوضوح.
في حال الضبط على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام الجمعة بشكل صريح.
في حال الضبط على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام السبت بشكلٍ صريح.
وفي حال ضبط السياسة على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun | 0..1 | boolean | اضبط النوع على true أو 1 لتضمين أيام الأحد بشكل صريح.
في حال الضبط على |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode | 1 | string | المعرّف الفريد للمستودع (نوع الغرفة) ترتبط هذه القيمة بـ <RoomID> في رسالة المعاملات
(بيانات الموقع). |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode | 0..1 | string | معرّف فريد لخطة الأسعار يرتبط هذا المعرّف بقيمة
<PackageID> في رسالة المعاملة (بيانات الموقع). تم تعريف خطة السعر بشكل أكبر ويُشار إليها
في <StatusApplicationControl> في كل من رسائل
<OTA_HotelRateAmountNotifRQ>
و<OTA_HotelAvailNotifRQ> .
السمة |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay | 0..1 | LengthsOfStay | حاوية لتحديد قيود LOS. يجب ألا تُستخدم هذه السمة إذا تضمّن
<AvailStatusMessage> السمة
BookingLimit . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / @FixedPatternLength | 0..1 | integer | طول النمط المحدّد في FullPatternLOS .
ملاحظة: يجب ضبط هذه السمة عند استخدام
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay | 1..n | LengthOfStay | تحدّد هذه السمة القيود المفروضة على مدة الإقامة. عند استخدام أكثر من عنصر <LengthOfStay> واحد، يجب أن يحدّد كل عنصر
قيمة MinMaxMessageType مختلفة. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time | 0..1 | integer | قيمة الوحدة لقياس مدة الإقامة. يُرجى العِلم أنّه يتم التعامل مع القيمة صفر على أنّها بدون قيود. على سبيل المثال، تعني السمة <LengthOfStay
Time="0" MinMaxMessageType="SetMaxLOS"> أنّه ليس هناك حدّ أقصى لمدة الإقامة.
ملاحظة: يجب ضبط هذه السمة ما لم تستخدم
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit | 0..1 | enum | الوحدة الزمنية. ويتم ضبط القيمة تلقائيًا على "Day" إذا لم يتم توفيرها. القيمة
الصالحة هي:
"Day" واحدة إقامة ليلة واحدة.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType | 1 | enum | أنواع مختلفة من القيود المفروضة على مدة الإقامة. يستند كل من SetMaxLOS
وSetMinLOS وFullPatternLOS إلى الوصول. يعتمد كل من SetForwardMinStay و
SetForwardMaxStay على الإقامة في الوقت الفعلي. ويجب أن تكون القيم القصوى أكبر من الحد الأدنى للقيم أو مساويةً لها. |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern | 0..1 | LOS_Pattern | تحدّد هذه السمة طول نمط حظر الإقامة.
ملاحظة: يجب أن يكون هذا العنصر متوفرًا عند استخدام |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / LOS_Pattern / @FullPatternLOS | 1 | string | تسلسل من Y وN حرف يشير إلى
ما إذا كان يُسمح بكل مدة إقامة، بدءًا من ليلة واحدة إلى القيمة في
FixedPatternLength . وأي مدة إقامة أكبر من
FixedPatternLength سيكتسب القيمة في الموضع النهائي. على سبيل المثال، في FixedPatternLength="4" و
FullPatternLOS="YNYN" ، يُسمح فقط بمدد الإقامة 1 و3.
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus | 0..1 | RestrictionStatus | تحدِّد هذه السياسة قيود برنامج الرحلة. يجب ألا تُستخدم هذه السمة إذا تضمّن
<AvailStatusMessage> السمة
BookingLimit . |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status | 0..1 | enum | يشير هذا العمود إلى ما إذا كان نوع الحظر الذي تحدّده السمة Restriction مفتوحًا أو مغلقًا. وتشمل القيم الصالحة ما يلي:
ملاحظة:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction | 0..1 | enum | هذه السمة مطلوبة إذا تم تقديم القيم الصالحة هي:
ملاحظة: إذا لم يتم تحديد |
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset | 0..1 | integer or duration | تمثّل هذه السمة الحد الأدنى للمدة التي يمكن حجز سعر الغرفة هذا خلالها قبل تاريخ الوصول (بالتوقيت المحلي للفندق).
في ما يلي أنواع القيم الصالحة:
|
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset | 0..1 | integer or duration | تمثّل هذه السمة الحد الأقصى للمدة التي يمكن خلالها حجز سعر الغرفة هذا قبل تاريخ الوصول (بالتوقيت المحلي للفندق).
في ما يلي أنواع القيم الصالحة:
|
أمثلة
تاريخ الوصول لخسارة الأرباح
اضبط الحد الأدنى والأقصى لمدة الإقامة (بناءً على تاريخ الوصول).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetMaxLOS"/>
<LengthOfStay Time="2" MinMaxMessageType="SetMinLOS"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
مدة الخسارة
اضبط الحد الأدنى والأقصى لمدة الإقامة (بناءً على الإقامة).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay>
<LengthOfStay Time="5" MinMaxMessageType="SetForwardMaxStay"/>
<LengthOfStay Time="2" MinMaxMessageType="SetForwardMinStay"/>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
القيود المفروضة على رحلات المغادرة
اضبط تقييدًا من الإغلاق إلى المغادرة. (يمنع ذلك برامج الرحلات التي تتضمن تسجيل المغادرة في تواريخ محددة).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
القيود المفروضة على الوصول
اضبط قيودًا على الوصول من حيث الإغلاق إلى الوصول. (يمنع ذلك برامج الرحلات التي تسجّل الوصول في التواريخ المحددة).
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
فتح تواريخ التوفّر
يتم فتح مدى توفّر نوع الغرفة وخطة الأسعار في تواريخ محدّدة.
ملاحظة: يجب أيضًا تحديد أسعار الإقامة في الليلة، بالإضافة إلى أن يكون عدد المستودعات أكبر من 0 لنوع الغرفة قبل أن تصبح الأسعار متوفّرة بالكامل.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
إغلاق تواريخ التوفّر
يمكنك إغلاق مدى توفّر نوع غرفة وخطة أسعار في تواريخ محدّدة. (يُعرَف هذا أيضًا باسم "إيقاف البيع").
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Master"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
قيود الحجز المُسبق
يمكنك ضبط الحد الأدنى والأقصى لقيود فترة الحجز المُسبق، والتي يتم تطبيقها في عطلات نهاية الأسبوع فقط.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
Mon=”false”
Tue=”false”
Weds=”false”
Thur=”false”
Fri=”false”
Sat=”true”
Sun=”true”
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MaxAdvancedBookingOffset="30"
MinAdvancedBookingOffset="2"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
الموعد النهائي للحجز
حدِّد موعدًا نهائيًا للحجز في تاريخ الوصول الساعة 18:00 بالتوقيت المحلي للفندق.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-01-01"
End="2023-06-30"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus MinAdvancedBookingOffset="P0DT6H0M"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
قيود متعددة
يمكنك وضع قيود متعددة خلال التواريخ نفسها لنوع الغرفة وخطة السعر.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Open" Restriction="Master"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Arrival"/>
</AvailStatusMessage>
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<RestrictionStatus Status="Close" Restriction="Departure"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
الحدّ الأقصى للحجز
تحديد عدد المستودعات لنوع معيّن من الغرف خلال تواريخ محدّدة
ملاحظة: يُفضّل استخدام رسالة OTA_HotelInvCountNotifRQ بدلاً من ضبط هذه السمة.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage BookingLimit="5">
<!-- Note: RatePlanCode must not be specified here when setting inventory counts. -->
<StatusApplicationControl Start="2023-07-26"
End="2023-07-31"
InvTypeCode="RoomID_1"/>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
FullPatternLoS
اضبط نمطًا كاملاً لتحديد مدة الإقامة.
لتسجيل الوصول في 26 يوليو 2023، يُسمح فقط لفترات الإقامة المؤلفة من 2 و4 و6. لا تتوفّر مدد الإقامة 1 و3 و5 و7 أيام أو أكثر.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="12345678"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<AvailStatusMessages HotelCode="Property_1">
<AvailStatusMessage>
<StatusApplicationControl Start="2023-07-26"
End="2023-07-26"
InvTypeCode="RoomID_1"
RatePlanCode="PackageID_1"/>
<LengthsOfStay FixedPatternLength="7">
<LengthOfStay MinMaxMessageType="FullPatternLOS">
<LOS_Pattern FullPatternLOS="NYNYNYN"/>
</LengthOfStay>
</LengthsOfStay>
</AvailStatusMessage>
</AvailStatusMessages>
</OTA_HotelAvailNotifRQ>
الردود
البنية
تستخدم الرسالة OTA_HotelAvailNotifRS
البنية التالية:
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS 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_HotelAvailNotifRS>
العناصر والسمات
تحتوي رسالة OTA_HotelAvailNotifRS
على العناصر والسمات التالية:
العنصر / @Attribute | عدد مرات الظهور | النوع | الوصف |
---|---|---|---|
OTA_HotelAvailNotifRS | 1 | Complex element | العنصر الجذر للاستجابة لرسالة مدى التوفّر. |
OTA_HotelAvailNotifRS / @TimeStamp | 1 | DateTime | تاريخ ووقت إنشاء هذه الرسالة |
OTA_HotelAvailNotifRS / @EchoToken | 1 | string | المعرّف الفريد لرسالة OTA_HotelAvailNotifRQ المرتبطة |
OTA_HotelAvailNotifRS / Success | 0..1 | Success | يشير إلى أنّه تمت معالجة رسالة OTA_HotelAvailNotifRQ
بنجاح.
تحتوي كل رسالة على |
OTA_HotelAvailNotifRS / Errors | 0..1 | Errors | حاوية تتضمّن مشكلة واحدة أو أكثر حدثت أثناء معالجة رسالة OTA_HotelAvailNotifRQ
تحتوي كل رسالة على |
OTA_HotelAvailNotifRS / Errors / Error | 1..n | Error | وصف الخطأ الذي حدث أثناء معالجة رسالة OTA_HotelAvailNotifRQ . ويمكن العثور على تفاصيل حول هذه الأخطاء في
رسائل الخطأ لحالة الخلاصة. |
OTA_HotelAvailNotifRS / Errors / Error / @Type | 1 | integer | The OpenTravel Alliance EWT (نوع تحذير الخطأ) المرتبط
بالخطأ. تُستخدم القيمة 12 (Processing exception) فقط. |
OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | integer | رمز الخطأ OpenTravel Alliance ERR المرتبط بالخطأ.
تُستخدم القيمة 450 (Unable to process) فقط. |
OTA_HotelAvailNotifRS / Errors / Error / @Code | 1 | enum | حالة الطلب الأصلي. ويتم استخدام القيمة
NotProcessed فقط. |
OTA_HotelAvailNotifRS / Errors / Error / @ShortText | 1 | string | معرّف Google للمشكلة يمكن العثور على تفاصيل حول هذه الأخطاء في رسائل الخطأ لحالة الخلاصة. |
أمثلة
تم الإجراء بنجاح
في ما يلي رد على رسالة OTA_HotelAvailNotifRQ تمت معالجتها بنجاح.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Success/>
</OTA_HotelAvailNotifRS>
الأخطاء
في ما يلي رد على رسالة OTA_HotelAvailNotifRQ لم تتم معالجتها بسبب بعض الأخطاء.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
TimeStamp="2023-07-21T20:50:37-05:00"
Version="3.0">
<Errors>
<Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
</Errors>
</OTA_HotelAvailNotifRS>