OTA_hotelRateAmountNotifRQ

الكائن Requests

البنية

تستخدم الرسالة OTA_HotelRateAmountNotifRQ البنية التالية:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="message_ID"
                            TimeStamp="timestamp"
                            Version="3.0"
                            NotifType="[Overlay|Delta|Remove]"
                            NotifScopeType="[ProductRate]">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <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"
                                RatePlanCode="PackageID"
                                RatePlanType="[26]" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="float"
                            AmountAfterTax="float"
                            CurrencyCode="currency"
                            NumberOfGuests="integer"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="float"
                                   AgeQualifyingCode="[10|8]"
                                   MaxAge="integer"/>
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

العناصر والسمات

تحتوي رسالة OTA_HotelRateAmountNotifRQ على العناصر والسمات التالية:

العنصر / @Attribute عدد مرات الظهور النوع الوصف
OTA_HotelRateAmountNotifRQ 1 Complex element العنصر الجذر لرسالة الأسعار
OTA_HotelRateAmountNotifRQ / @xmlns 0..1 string (URI) مساحة اسم XML.
OTA_HotelRateAmountNotifRQ / @EchoToken 1 string معرّف فريد لرسالة الطلب هذه. يتم عرض هذه القيمة في رسالة الرد. الأحرف المسموح بها هي a-z وA-Z و0-9 و_ (underscore) و- (dash).
OTA_HotelRateAmountNotifRQ / @TimeStamp 1 DateTime تاريخ ووقت إنشاء هذه الرسالة
OTA_HotelRateAmountNotifRQ / @Version 1 decimal نسخة رسالة OpenTravel.
OTA_HotelRateAmountNotifRQ / @NotifType 0..1 enum

نوع الإشعار الذي سيتم تطبيقه على كل <RateAmountMessage>.

القيم الصالحة هي:

لفهم آلية عمل هذه السمات، يمكنك الاطّلاع على الأمثلة.

  • Overlay: احذف جميع الأسعار الخاصة بالإشغال لنوع الغرفة وخطة السعر والتواريخ المحدّدة في <StatusApplicationControl> واستبدلها بالأسعار الجديدة.
  • Remove: احذف جميع الأسعار الحالية لكل إشغال لنوع الغرفة وخطة السعر والتواريخ المحدّدة في <StatusApplicationControl>.
  • Delta: (القيمة التلقائية إذا لم يتم تحديد NotifType) يمكنك إضافة أو تعديل الأسعار الحالية للإشغال لنوع الغرفة وخطة السعر والتواريخ المحدّدة في <StatusApplicationControl>.
OTA_HotelRateAmountNotifRQ / @NotifScopeType 0..1 enum

نطاق NotifType الذي سيتم تطبيقه على كل <RateAmountMessage>.

القيم الصالحة هي:

  • ProductRate: (الخيار التلقائي في حال عدم تحديد NotifScopeType) تنطبق السمة NotifType على المنتجات، مثلاً المجموعات من نوع الغرفة (InvTypeCode) وخطة الأسعار (RatePlanCode).
OTA_HotelRateAmountNotifRQ / POS 0..1 POS حاوية لتحديد حساب الشريك لهذه الرسالة (تُستخدم عادةً إذا كانت الخلفية توفّر خلاصات أسعار لحسابات شركاء متعدّدة).
OTA_HotelRateAmountNotifRQ / POS / Source 1 Source تكون هذه السمة مطلوبة في حال استخدام السمة <POS>. تمثّل هذه السمة حاوية للسمة <RequestorID>.
OTA_HotelRateAmountNotifRQ / POS / RequestorID 1 RequestorID تكون هذه السمة مطلوبة في حال استخدام السمة <POS>. تحدّد حساب الشريك.
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID 1 string حساب الشريك لهذه الرسالة قيمة السلسلة هذه هي قيمة "مفتاح الشريك" المُدرَجة في صفحة "إعدادات الحساب" في Hotel Center.

ملاحظة: إذا كانت لديك خلفية توفر خلاصات لحسابات متعددة، يجب أن تتطابق هذه القيمة مع قيمة السمة partner لرسالة "المعاملات" (بيانات الموقع) وقيمة السمة ID في العنصر <RequestorID> في رسالة <OTA_HotelAvailNotifRQ> للحساب نفسه.

OTA_HotelRateAmountNotifRQ / RateAmountMessages 1 RateAmountMessages مجموعة من عناصر <RateAmountMessage> التي تحدِّد الأسعار.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode 1 string المعرّف الفريد للموقع. ويجب أن تتطابق هذه القيمة مع رقم تعريف الفندق المحدّد باستخدام <id> في العنصر <listing> بخلاصة بيانات الفنادق. ويتمّ إدراج رقم تعريف الفندق أيضًا في مركز إدارة معلومات الفنادق.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage 1..n RateAmountMessage حاوية لتحديد أسعار سعر الإقامة في الغرفة (مجموعة من نوع الغرفة وخطة السعر خلال نطاق زمني معيّن).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl 1 StatusApplicationControl تحدّد هذه العلامة النطاق الزمني بالإضافة إلى المعرّفات لنوع الغرفة (InvTypeCode) وخطة الأسعار (RatePlanCode).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start 1 Date تاريخ البدء (استنادًا إلى المنطقة الزمنية للموقع)، بما في ذلك، للنطاق الزمني.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End 1 Date تاريخ الانتهاء (استنادًا إلى المنطقة الزمنية للموقع)، بما في ذلك، النطاق الزمني. يجب أن تكون القيمة مساوية لقيمة start أو أكبر منها. إذا كانت السمتان start وend متساويتَين، سيسري التعديل على ذلك التاريخ. تجدر الإشارة إلى أنّ Google توفّر ما يصل إلى ثلاث سنوات من البيانات.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon 0..1 boolean اضبط السمة على true أو 1 لتضمين أيام الاثنين بشكل صريح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue 0..1 boolean اضبط السمة على true أو 1 لتضمين أيام الثلاثاء بشكل صريح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds 0..1 boolean اضبط السمة على true أو 1 لتضمين أيام الأربعاء بوضوح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur 0..1 boolean ويمكنك ضبطها على true أو 1 لتضمين أيام الخميس بشكل صريح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri 0..1 boolean اضبط السمة على true أو 1 لتضمين أيام الجمعة بشكل صريح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat 0..1 boolean اضبط السمة على true أو 1 لتضمين أيام السبت بشكل صريح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun 0..1 boolean اضبط السمة على true أو 1 لتضمين أيام الأحد بشكل صريح.

وفي حال ضبط القيمة على true، يتم استبعاد أيام الأسبوع الأخرى التي لم يتم ضبطها بشكل صريح على true (في هذه الحالة، تتم فلترتها من التواريخ التي تقع ضمن Start وEnd).

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode 1 string المعرّف الفريد للمستودع (نوع الغرفة). ويتم ربط هذه القيمة بـ <RoomID> في رسالة المعاملة (بيانات الموقع).
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode 1 string معرّف فريد لخطة الأسعار ويتم ربط هذا المعرّف بالرسالة <PackageID> في رسالة المعاملة (بيانات الموقع). يتم تحديد خطة الأسعار والرجوع إليها بشكل أكبر في <StatusApplicationControl> في كل من رسائل <OTA_HotelRateAmountNotifRQ> و<OTA_HotelAvailNotifRQ>.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType 0..1 string معرّف يشير إلى نوع نموذج أسعار ARI الذي ينطبق على تعديل الأسعار هذا. يجب تحديد ذلك فقط، باستخدام القيمة 26، عند استخدام نموذج التسعير المستند إلى LOS. تشير استبعاد هذه السمة إلى أنّ هذا التعديل ينطبق على السعر في كل تاريخ.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates 0..1 Rates حاوية لمجموعة من عناصر <Rate> إذا كانت قيمة السمة NotifType هي "Remove"، يجب عدم تحديد هذا العنصر. بخلاف ذلك، يجب تحديد هذا العنصر مرة واحدة فقط.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate 1 Rate حاوية لمجموعة من عناصر <BaseByGuestAmts>
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit 0..1 String الوحدة التي يتم تحديد مدة الإقامة بها. والقيمة الوحيدة المسموح بها هي "Day"، ما يعني أنّ مدة الإقامة سيتم تحديدها بالأيام.

لاستخدام الأسعار المستندة إلى LOS، يجب تحديد RateTimeUnit وUnitMultiplier. وبخلاف ذلك، لا ينبغي تحديد أي منهما.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier 0..1 Integer تمثّل هذه السمة عدد RateTimeUnits الذي يمثّل مدة الإقامة لهذا السعر.

على سبيل المثال، إذا كانت قيمة RateTimeUnits هي "Day"، تشير السمة UnitMultiplier من 5 إلى أنّ الأسعار المحدّدة ضمن عنصر Rate هذا تنطبق على كل ليلة من ليالي الإقامة لمدة 5 ليالٍ.

سيتم ضرب معدّلات الإشغال المحدّدة تحت عنصر Rate هذا في UnitMultiplier (مدة الإقامة) للوصول إلى السعر الإجمالي للإقامة.

لاستخدام الأسعار المستندة إلى LOS، يجب تحديد RateTimeUnit وUnitMultiplier. وبخلاف ذلك، لا ينبغي تحديد أي منهما.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts 1 BaseByGuestAmts حاوية لمجموعة من الرسوم الأساسية
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt 1..n BaseByGuestAmt تحدّد أسعار الغرف بعملة محدّدة. يمكن أن يكون السعر لكل إشغال باستخدام عناصر <BaseByGuestAmt> متعددة، لكل منها قيمة مختلفة لـ NumberOfGuests. وفي حال عدم تنفيذ هذا الإجراء، يسري السعر على الحدّ الأقصى لعدد النزلاء المحدّد في NumberOfGuests.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax 0..1 float

السعر اليومي لسعر الإقامة في الغرفة قبل احتساب الضرائب والرسوم

يمكن تحديد كل من AmountBeforeTax وAmountAfterTax. إذا لم يتم تحديد السمة AmountBeforeTax، يجب تحديد السمة AmountAfterTax. إذا تم تحديد AmountBeforeTax ولم يتم تحديد AmountAfterTax، يجب تحديد الضرائب والرسوم في رسالة <TaxFeeInfo>.

إذا كنت تستخدم العروض الترويجية، يتم تطبيق الخصم على AmountBeforeTax، ويتم أيضًا تطبيق النسبة المئوية للخصومات على AmountAfterTax. بما أنّ هذه الطريقة لا تتوافق مع بعض الهياكل الضريبية، ننصحك بشدة بتحديد AmountBeforeTax فقط هنا واستخدام <TaxFeeInfo> لتحديد الضرائب والرسوم.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax 0..1 float السعر اليومي لسعر الغرفة بعد تضمين الضرائب والرسوم السارية. في حال تحديد AmountAfterTax، لن يكون من الضروري إرسال رسائل <TaxFeeInfo> منفصلة لكل موقع. يمكن استخدام هذه السمة مع السمة AmountBeforeTax لتقديم أسعار أساسية وإجمالية يمكن عرضها للمستخدمين في مناطق معيّنة.

تحذير: إذا كنت تستخدم إعلانات ترويجية، ننصحك بشدة بعدم استخدام مبالغ AmountAfterTax. إذا أردت استخدام الخصومات، حدِّد الضرائب والرسوم باستخدام رسالة <TaxFeeInfo>. سيتم بعد ذلك تطبيق الخصومات على AmountBeforeTax مبلغ.

ملاحظة: إذا لم يتم تحديد السمة AmountBeforeTax، يجب تحديد السمة AmountAfterTax.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode 1 enum رمز الأحرف الأولي وفقًا لمعيار ISO 4217 (3) لوحدة مالية محدّدة.

راجِع قائمة العملات المتوافقة.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests 0..1 integer الحدّ الأقصى لعدد النزلاء الذي يمكن أن يستوعبه هذا السعر ويتم الإعداد تلقائيًا على نزيلَين في حال عدم توفيرهما.

يُرجى العِلم أنّه إذا كان التصنيف <AdditionalGuestAmounts> يتضمّن رسومًا للأطفال، تشير السمة NumberOfGuests إلى البالغين فقط. وإذا لم يتم تحديد سمة <AdditionalGuestAmounts> أو كانت لا تحتوي على رسوم للأطفال، يشير السمة NumberOfGuests إلى إجمالي عدد النزلاء بما في ذلك البالغين والأطفال.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts 0..1 AdditionalGuestAmounts حاوية لمجموعة من الرسوم للنزلاء الإضافيين

وتكون هذه البنية مفيدة إذا تغيّرت الأسعار الإضافية للضيوف أو الأطفال بناءً على التاريخ. يمكنك استخدام رسالة ExtraGuestCharges الأكثر فعالية إذا كان من الممكن تحديد هذه المبالغ بشكلٍ ثابت على مستوى الموقع.

يتم تطبيق المبالغ الإضافية للضيوف على النحو التالي:
  • وسيتم تطبيقها على معدل الإشغال الأساسي. معدّل الإشغال الأساسي هو أعلى معدّل إشغال محدّد في <BaseByGuestAmts> وأقل من أو يساوي عدد الأشخاص البالغين في بحث مستخدم.
  • ويتم تطبيقها طالما أنّ عدد الإشغال في بحث المستخدم ضمن سعة الغرفة.
  • تستبدل السمة <AdditionalGuestAmounts> دائمًا المبالغ الإضافية المحدّدة سابقًا بمبالغ جديدة عندما تكون قيمة السمة NotifType إما Delta أو تراكب.
  • لا يمكن إرسال <AdditionalGuestAmounts> بشكل مستقل عن الأسعار الأساسية إلا عندما تكون قيمة NotifType دلتا. ويجب تحديد <BaseByGuestAmts> عندما تكون قيمة NotifType هي Overlay.
  • يؤدي استخدام عنصر <AdditionalGuestAmounts> فارغ مع ضبط NotifType على Delta إلى إزالة المبالغ الإضافية الحالية بدون التأثير في الأسعار الأساسية.
  • ويتم تطبيقها باستخدام العملة المحدّدة في <BaseByGuestAmt>.

على سبيل المثال، لنفترض أنّ الأسعار الأساسية محدّدة لشخص بالغ واحد أو شخصين بالغين.

  • في حال بحث المستخدم عن 3 أشخاص بالغين، سيتم اختيار سعر الإقامة المزدوج باعتباره السعر الأساسي، ويتم تطبيق سعر إضافي للنزلاء على شخص بالغ واحد.
  • في حال بحث المستخدم عن شخص بالغ وطفلَين، سيتم اختيار سعر الإقامة الفردية باعتباره السعر الأساسي، وسيتم تطبيق مبالغ إضافية على سعر الإقامة لطفلين.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount 0..n AdditionalGuestAmount تحدّد الأسعار استنادًا إلى نوع النزيل المحدد في AgeQualifyingCode، وإذا كان عمر النزيل معيّنًا، يتم تحديده من خلال MaxAge.
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode 1 enum يحدد نوع الضيف الإضافي، سواء كان بالغًا أو طفلاً. وفي ما يلي الخيارات الصالحة:
  • 10: للأشخاص البالغين.
  • طفل واحد (8:).

يمكن ضبط AgeQualifyingCode على 10 لعنصر AdditionalGuestAmount واحد على الأكثر.

يجب تحديد MaxAge عندما تكون قيمة AgeQualifyingCode هي 8.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge 0..1 integer يجب تحديد MaxAge عندما تكون قيمة AgeQualifyingCode هي 8. ويجب عدم تحديدها عندما تكون قيمة AgeQualifyingCode هي 10.

يجب أن يكون MaxAge عددًا صحيحًا يتراوح بين 0 و17..

ويمكن تحديد فئات عمرية فرعية متعددة من خلال عناصر AdditionalGuestAmount منفصلة. يجب أن تكون الفئات العمرية متجاورة وغير متداخلة.

OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount 1 float المبلغ قبل الضرائب والرسوم المضاف إلى السعر الأساسي لكل ضيف إضافي.

يجب تحديد الضرائب والرسوم التي تعتمد على أعمار النزلاء من خلال العنصر <AgeBrackets> في رسالة <TaxFeeInfo>.

أمثلة

يوفّر هذا القسم أمثلة على رموز برمجية تُبرز كيفية تنفيذ ما يلي:

عند ضبط القيم add أو overlay أو remove، يمكن أن تكون النطاقات الزمنية هي نفسها أو مختلفة حسب أهدافك. على سبيل المثال، يمكنك استخدام overlay لتحديد بضعة أسابيع فقط لعطلات شهر كانون الأول (ديسمبر) بدلاً من ضبط النطاق الكامل لرسالة "إضافة سعر". سيحل هذا محل أسعار الإشغال لهذه الفترة فقط.

التسعير حسب التاريخ

إعداد الأسعار الأساسية والأسعار الإجمالية

مثال 1

السعر الأساسي (بدون ضرائب أو رسوم) للإشغال التلقائي (مزدوج). في هذا النموذج، يجب تحديد الضرائب والرسوم المفروضة على الموقع باستخدام رسالة <TaxFeeInfo>. وسيكون السعر الأساسي أكثر بروزًا للمستخدمين الذين يجرون عمليات بحث من مناطق معيّنة.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

مثال 2

السعر الأساسي والإجمالي للإشغال التلقائي (مزدوج). في هذا النموذج، يجب عدم تعريف الضرائب والرسوم بشكل منفصل باستخدام رسائل <TaxFeeInfo>. سيكون السعر الأساسي أكثر بروزًا للمستخدمين الذين يجرون عمليات بحث من مناطق معيّنة.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

مثال 3

السعر الإجمالي (مع الضرائب والرسوم) لإشغالات متعددة. في هذا النموذج، يجب عدم تعريف الضرائب والرسوم بشكل منفصل باستخدام رسائل <TaxFeeInfo>.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountAfterTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountAfterTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

مثال 4

السعر الأساسي والإجمالي لأنواع الغرف المتعددة وخطط الأسعار في نطاقات زمنية مختلفة.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            AmountAfterTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-01"
                                End="2020-05-31"
                                InvTypeCode="RoomID_2"
                                RatePlanCode="PackageID_2"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            AmountAfterTax="220.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
إضافة الأسعار وتراكبها وإزالتها

إضافة أسعار

اضبط NotifType على Delta لإضافة أسعار الإشغال لكل إقامة في RoomID_1 وPackageID_1 بين عامَي 2021-10-20 و2021-12-31. ونشير إلى أنّ محرّك بحث Google يتيح استخدام البيانات لمدة تصل إلى ثلاث سنوات.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
            <BaseByGuestAmt AmountBeforeTax="120.00"
                            CurrencyCode="USD"
                            NumberOfGuests="3"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

معدلات التراكب

اضبط NotifType على Overlay لحذف كل أسعار الإشغال في RoomID_1 وPackageID_1 في الفترة بين 2021-10-20 و31-12-2021 واستبدالها بالأسعار المحدّدة حديثًا لكل إشغال.

على سبيل المثال، إذا تم إرسال هذه الرسالة بعد رسالة "إضافة الأسعار"، سيتم حذف معدّلات الإشغال 1 و2 و3، وسيتم تخزين الأسعار الجديدة لنسبة الإشغال 1 فقط. يمكنك أيضًا تحديد نطاق زمني أقصر (على سبيل المثال: 2020-12-2021 و31-12-2021) لاستبدال بعض أسعار الإشغال فقط في تواريخ معيّنة، مثل أيام العطلات.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

إزالة الأسعار

اضبط NotifType على Remove لحذف كل أسعار الإشغال لكل فندق في الغرفةID_1 وPackageID_1 في الفترة بين 20/10/2021 و31/12/2021.

على سبيل المثال، إذا تم إرسال هذه الرسالة بعد أيٌّ من المثالَين الآخرَين، لن يتم تخزين معدّلات الإشغال.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
إضافة مبالغ إضافية للضيوف وتراكبها وإزالتها

إضافة مبالغ

اضبط NotifType على Delta لإضافة الأسعار الأساسية للإشغال 1 و2 ومبالغ إضافية للنزلاء للإقامة في RoomID_1 وPackageID_1 في الفترة بين 2021-10-20 و 31-12-2021.

سيتم تطبيق المبالغ الإضافية للنزلاء على السعر الأساسي الذي سيتم تحديده حسب الإشغال في بحث المستخدم. ويجب أن يكون عدد النزلاء الذي حدّده المستخدم في حدود سعة الغرفة ID_1.

في هذا المثال، سيتم تطبيق مبالغ الضيوف الإضافية على النحو التالي:

  • 5 دولار للأطفال الذين تتراوح أعمارهم بين 0 و10 سنوات (شاملةً).
  • 10 دولار للأطفال الذين تتراوح أعمارهم بين 11 و17 عامًا (شاملًا).
  • 20 دولارًا للبالغين.
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
            <BaseByGuestAmt AmountBeforeTax="110.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" />
            <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" />
            <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

المبالغ التي تظهر على سطح الفيديو

اضبط NotifType على Overlay لحذف كل أسعار الإشغال وجميع المبالغ الإضافية للنزلاء في RoomID_1 وPackageID_1 خلال الفترة من 2020-10-2021 و31-12-2021 واستبدالها بالأسعار المحددة حديثًا لكل إشغال ومبالغ إضافية.

على سبيل المثال، إذا تم إرسال هذه الرسالة بعد رسالة "إضافة الأسعار"، سيتم حذف معدّل الإشغال الأساسي 1 و2، وسيتم تخزين سعر الإشغال الأساسي الجديد فقط. سيتم حذف المجموعة السابقة من المبالغ الإضافية للضيوف، وسيتم تخزين المجموعة الجديدة فقط من المبالغ. ستستخدم الآن المبالغ الإضافية للنزلاء السعر الجديد للإشغال 1 باعتباره السعر الأساسي. يُرجى العلم أنّه بعد هذا التعديل، لن يتم تحديد أي رسوم إضافية للنزلاء للأطفال.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="200.00"
                            CurrencyCode="USD"
                            NumberOfGuests="1"/>
          </BaseByGuestAmts>
          <AdditionalGuestAmounts>
            <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" />
          </AdditionalGuestAmounts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

إزالة المبالغ

اضبط NotifType على Delete لحذف كل الأسعار الأساسية لكل إقامة وجميع المبالغ الإضافية للنزلاء في RoomID_1 وPackageID_1 في الفترة بين 20-10-2021 و 31-12-2021.

على سبيل المثال، إذا تم إرسال هذه الرسالة بعد أيٍ من الرسالتين الأخريين، لن يتم تخزين أي أسعار أساسية حسب الإشغال أو مبالغ إضافية للضيوف.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">>
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

إزالة المبالغ الإضافية من حسابات الضيوف فقط

يمكنك ضبط NotifType على Delta مع تضمين عنصر <AdditionalGuestAmounts> فارغ لحذف كل المبالغ الإضافية للضيوف في RoomID_1 وPackageID_1 بدون التأثير في الأسعار الأساسية في الفترة بين 2021-10-20 و 2021-12-31.

على سبيل المثال، إذا تم إرسال هذه الرسالة بعد أي من المثالَين الآخرَين، سيتم تخزين المبالغ الأساسية فقط.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <Rates>
        <Rate>
          <AdditionalGuestAmounts/>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

التسعير استنادًا إلى LOS

إعداد الأسعار المستنِدة إلى LOS

مثال 1

يُرجى ضبط أسعار الإقامة لمدة ليلة واحدة وليلتَين و3 ليالٍ بدءًا من 18 أيار (مايو) 2020. في هذا المثال، سيكون السعر الإجمالي للإقامة لمدة ليلة واحدة وليلتين و3 ليالٍ هو 100 دولار أمريكي و180 دولار أمريكي و240 دولار أمريكي على التوالي.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="1" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="100.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="2" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="90.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
إضافة المعدّلات المستندة إلى LOS وتراكبها وإزالتها

إضافة مُدد الإقامة

عند استخدام نظام التسعير المستند إلى LOS، تسمح عملية Delta بتعديل الأسعار تدريجيًا للنطاقات الزمنية لتسجيل الوصول المُشار إليها في <StatusApplicationControl>، ولكل مُدد الإقامة التي تشير إليها العنصر UnitMultiplier في عنصر Rate الثانوي.

يجب تحديد جميع أسعار الإشغال لكل تاريخ تسجيل وصول سارٍ ومدة إقامة سارية.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

مدة التراكب لفترة الإقامة

عند استخدام الأسعار المستندة إلى LOS، تحلّ عملية Overlay محلّ الأسعار لجميع مُدد إقامة المنتج والنطاق الزمني لتسجيل الوصول المُشار إليهما في <StatusApplicationControl>.

من خلال هذه الرسالة، ستتم إزالة أسعار الإشغال لكل مدد الإقامة في تواريخ الوصول المحددة واستبدالها بمعدل الإشغال المزدوج المحدَّد فقط لمدة الإقامة 3.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2020-05-19T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Overlay"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-18"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
      <Rates>
        <Rate UnitMultiplier="3" RateTimeUnit="Day">
          <BaseByGuestAmts>
            <BaseByGuestAmt AmountBeforeTax="80.00"
                            CurrencyCode="USD"
                            NumberOfGuests="2"/>
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

إزالة مدد الإقامة

عند استخدام نظام التسعير المستند إلى LOS، تؤدي عملية Remove إلى إزالة الأسعار لجميع مدد إقامة المنتج والنطاق الزمني لتسجيل الوصول المُشار إليهما في <StatusApplicationControl>.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2021-10-20T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Remove"
                            NotifScopeType="ProductRate">
  <RateAmountMessages HotelCode="Property_1">
    <RateAmountMessage>
      <StatusApplicationControl Start="2021-10-20"
                                End="2021-12-31"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"
                                RatePlanType="26"/>
    </RateAmountMessage>
  </RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>

الردود

البنية

تستخدم الرسالة OTA_HotelRateAmountNotifRS البنية التالية:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS 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_HotelRateAmountNotifRS>

العناصر والسمات

تحتوي رسالة OTA_HotelRateAmountNotifRS على العناصر والسمات التالية:

العنصر / @Attribute عدد مرات الظهور النوع الوصف
OTA_HotelRateAmountNotifRS 1 Complex element العنصر الجذر للاستجابة لرسالة مدى التوفّر.
OTA_HotelRateAmountNotifRS / @TimeStamp 1 DateTime تاريخ ووقت إنشاء هذه الرسالة
OTA_HotelRateAmountNotifRS / @EchoToken 1 string المعرّف الفريد من رسالة OTA_HotelRateAmountNotifRQ المرتبطة
OTA_HotelRateAmountNotifRS / Success 0..1 Success يشير إلى أنّه تمّت معالجة رسالة OTA_HotelRateAmountNotifRQ بنجاح.

تتضمّن كل رسالة إما <Success> أو <Errors>.

OTA_HotelRateAmountNotifRS / Errors 0..1 Errors حاوية تتضمّن مشكلة واحدة أو أكثر حدثت أثناء معالجة رسالة OTA_HotelRateAmountNotifRQ.

تتضمّن كل رسالة إما <Success> أو <Errors>.

OTA_HotelRateAmountNotifRS / Errors / Error 1..n Error وصف الخطأ الذي حدث أثناء معالجة رسالة OTA_HotelRateAmountNotifRQ. ويمكن العثور على تفاصيل حول هذه الأخطاء في رسائل خطأ حالة الخلاصة.
OTA_HotelRateAmountNotifRS / Errors / Error / @Type 1 integer نوع تحذير الخطأ من OpenTravel Alliance EWT المرتبط بالخطأ. يتم استخدام القيمة 12 (Processing exception) فقط.
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 integer رمز الخطأ (ERR Code) المرتبط بالخطأ لدى OpenTravel Alliance. يتم استخدام القيمة 450 (Unable to process) فقط.
OTA_HotelRateAmountNotifRS / Errors / Error / @Code 1 enum حالة الطلب الأصلي ويتم استخدام القيمة NotProcessed فقط.
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText 1 string معرّف Google للمشكلة ويمكن العثور على تفاصيل حول هذه الأخطاء في القسم رسائل خطأ حالة الخلاصة.

أمثلة

تم الإجراء بنجاح

في ما يلي رد على رسالة OTA_HotelRateAmountNotifRQ تمت معالجتها بنجاح.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Success/>
</OTA_HotelRateAmountNotifRS>

الأخطاء

في ما يلي رد على رسالة OTA_HotelRateAmountNotifRQ التي لم تتم معالجتها بسبب حدوث أخطاء.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2021-10-20T20:50:37-05:00"
                       Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelRateAmountNotifRS>