رسالة الضرائب والرسوم

نظرة عامة

تحدّد الرسالة TaxFeeInfo الضرائب والرسوم التي تنطبق على المستخدم عند حجز مكان إقامة، وذلك استنادًا إلى لوائح الضرائب الخاصة بمكان الإقامة الموضّحة على الموقع الإلكتروني. لإضافة بيانات الضرائب والرسوم، عليك استخدام رسالة السعر (OTA_HotelRateAmountNotifRQ).

الإجراء الوحيد المتاح لهذه الرسالة هو overlay، ويُستخدَم لاستبدال بيانات الضرائب والرسوم لكل منشأة. من المهم إرسال إشعارات بشأن الضرائب والرسوم عند إجراء أي تغييرات.

لمزيد من المعلومات حول كيفية إرسال الضرائب والرسوم، بالإضافة إلى تفاصيل الأسعار المحدّدة لمعدّلاتك، يُرجى الرجوع إلى سياسة الضرائب والرسوم.

طُرق إضافة الضرائب والرسوم

هناك طريقتان عامّتان لإضافة الضرائب والرسوم:

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

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

تصف هذه الصفحة وتشير فقط إلى الطريقة المفضّلة لاستخدام TaxFeeInfo، وليس إلى طريقة تحديد AmountAfterTax في رسالة التقييم (OTA_HotelRateAmountNotifRQ).

طُرق تحديد الضرائب

تتوفّر لك الخيارات التالية لضبط الضرائب:

Basis = [room|person]
الفترة = [إقامة|ليلة]
النوع = [percent|amount]

عندما تكون "الفترة" stay و"النوع" percent، تفرض Google الضرائب والرسوم على الإقامة بأكملها حتى إذا كان تاريخ واحد في خطة الرحلة يتداخل مع النطاق StayDates. لا يمكنك تحديد تطبيق ضريبة ورسوم فقط إذا كانت جميع التواريخ في خطة الرحلة تتداخل مع النطاق الزمني لتواريخ الإقامة. بالنسبة إلى نطاقات تواريخ الإقامة المتعددة التي تتداخل مع بعضها البعض، يتم تحديد نطاقات StayDates في نطاق مفتوح واحد. يمكنك الرجوع إلى أمثلة TaxFeeInfo.

للاطّلاع على أمثلة لسيناريوهات مختلفة متعلّقة بالضرائب، يُرجى الانتقال إلى الإرشادات. تتضمّن الأمثلة بعض أهم سيناريوهات الضرائب، بما في ذلك أدلة إرشادية حول:

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

تتناول الأقسام التالية إرشادات عامة ومثالاً أساسيًا وحالات عملية حول كيفية إضافة معلومات الضرائب وتعديلها لمساعدتك في البدء.

العناصر المطلوبة والاختيارية

تقدّم مرجع XML أوصافًا للعناصر المطلوبة والاختيارية. للحصول على تفاصيل حول السمات والعناصر الفرعية، يُرجى الاطّلاع على عناصر TaxFeeInfo وسماتها.

البنية والمخططات

استخدِم مثال TaxFeeInfo بناء الجملة كمرجع عند إنشاء الرسالة للتأكّد من اتّباع التنسيق الصحيح. يمكنك استخدام أداة XML تابعة لجهة خارجية، مثل xmllint، للتحقّق من صحة خلاصاتك باستخدام المخططات المنشورة قبل إرسالها إلى Google. بالنسبة إلى مخطط رسالة TaxFeeinfo، يمكنك الاطّلاع على مخططات إعلانات الفنادق.

الإرشادات

يتناول هذا القسم الإرشادات الشائعة والتعليمات الخاصة المتعلقة بتحديد الضرائب والرسوم.

الإجراءات

النافذة المرافِقة: استخدِم الإجراء overlay لاستبدال جميع الضرائب الخاصة بمكان إقامة. الإجراء overlay هو الإجراء التلقائي والإجراء الوحيد المتاح. سيتم إلغاء أي ضرائب ورسوم سابقة لهذا الموقع بعد تطبيق هذا التعديل.

للجمهور العام

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

مثال

يقدّم هذا القسم مثالاً أساسيًا على رسالة TaxFeeInfo باستخدام عناصر مطلوبة واختيارية. بعد إعداد ملفك، عليك إرساله إلى Google باستخدام رسالة POST إلى نقطة النهاية هذه:

https://www.google.com/travel/hotels/uploads/taxes

لمزيد من المعلومات حول كيفية إرسال الرسالة باستخدام طريقة POST، يُرجى الاطّلاع على إرسال الرسائل.

بالنسبة إلى السمة hotel_id، استخدِم معرّف الفندق الفريد الذي استخدمته ضمن نظامك لتحديد الموقع. يجب أن تتطابق هذه القيمة مع معرّف الفندق المحدّد باستخدام <id> في العنصر <listing> في خلاصة بيانات الفنادق. من الضروري أن تكون البيانات متسقة مع نظامك لضمان عرض Google لبياناتك بشكل صحيح.

يوضّح هذا المثال كيفية تحديد نسبة ضريبة تبلغ% 10 ومبلغ رسوم يبلغ 50 دولارًا أمريكيًا لأحد الفنادق مقابل إجمالي مدة الإقامة (وليس لكل ليلة):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

للاطّلاع على أمثلة حول إضافة ضرائب مرتبطة بالعمر وأمثلة أخرى، يُرجى مراجعة أمثلة على الضرائب.

طرق التنفيذ

يقدّم هذا القسم حلولاً لسيناريوهات قد تواجهها أثناء إعداد الضرائب والرسوم.

السيناريو 1: كيفية إضافة ضريبة ثابتة

يوضّح مثال الضريبة هذا كيفية تحديد ضريبة ثابتة لكل عقار.

الوصف

تريد تطبيق ضريبة ثابتة على الغرفة أو مدة الإقامة لكل فندق بدلاً من ضريبة بنسبة مئوية.

الحل

استخدِم amount بدلاً من percentage لإضافة خيار الضريبة الثابتة.

عيّنة

يوضّح هذا المثال كيفية إضافة ضريبة ثابتة باستخدام amount بدلاً من percentage:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

السيناريو 2: كيفية استهداف الضرائب باستخدام `ApplicableNights`

الوصف

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

الحل

استخدِم <ApplicableNights excluded="1"/> للتحكّم في الليالي التي يتم فيها تطبيق الضرائب.

عيّنة

يوضّح هذا النموذج كيفية استخدام ApplicableNights:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

السيناريو 3: كيفية استبدال الضرائب والرسوم القديمة بالجديدة

الوصف

تغيّرت الضرائب والرسوم الحالية ويجب استبدالها بضرائب ورسوم جديدة.

الحل

استخدِم الإجراء overlay لإزالة جميع الضرائب والرسوم الحالية.

عيّنة

يوضّح المثال التالي كيفية إزالة جميع الضرائب والرسوم الخاصة بمكان إقامة:

    <?xml version="1.0" encoding="UTF-8"?>
    <TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
                id="12345678"
                partner="partner_key">
      <Property action="overlay">
        <ID>Property_1</ID>
      </Property>
    </TaxFeeInfo>

السيناريو 4: كيفية تضمين الضرائب أو استبعادها في بلدان معيّنة

الوصف

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

الحل

استخدِم الخيارَين include أو exclude للسمة UserCountries type. استخدِم include لتطبيق الضريبة على البلد المُدرَج فقط أو استخدِم exclude لتطبيق الضريبة على جميع البلدان باستثناء البلد المُدرَج.

عيّنة

يوضّح المثال التالي كيفية تحديد الضرائب للمستخدمين خارج بلد الفندق (إسرائيل):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

السيناريو 5: كيفية تحديد الضريبة الشرائحية باستخدام الأقواس

الوصف

تريد إضافة شريحة ضريبة سلع وخدمات يتم تطبيقها استنادًا إلى الأسعار الليلية.

الحل

في هذا السيناريو، لنفترض أنّ شرائح ضريبة السلع والخدمات في البلد المستهدَف هي:

لا يتم تحصيل ضريبة إذا كان السعر الليلي أقل من 1,000 ريال سعودي أو مساويًا له.
‫12% ضريبة إذا كان السعر الليلي أكبر من 1,000 وأقل من أو يساوي 7,500
ضريبة بنسبة% 18 إذا كان السعر الليلي أكبر من 7500

عيّنة

يوضّح المثال التالي كيفية تحديد ضريبة شرائح مع أقواس:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

السيناريو 6: كيفية تحديد الضريبة والرسوم الخاضعة للضريبة

الوصف

تريد إضافة ضريبة، مثل ضريبة القيمة المضافة، ورسوم خدمة أخرى تنطبق أيضًا على هذه الضريبة.

الحل

يتضمّن هذا السيناريو مثالَين على حالات استخدام الرسوم الخاضعة للضريبة:

يتم تحديد كلّ من الضريبة والرسوم الخاضعة للضريبة كرسوم بنسبة مئوية.
الضريبة هي رسوم بنسبة مئوية، بينما الرسوم الخاضعة للضريبة هي مبلغ ثابت لكل إقامة.

أمثلة

الرسوم الخاضعة للضريبة كنسبة مئوية

في هذا المثال، تبلغ قيمة AmountBeforeTax 100 دولار أمريكي، وتبلغ ضريبة السلع والخدمات %18، وتبلغ رسوم الخدمة الإضافية% 5، ما يجعل إجمالي النسبة المئوية للرسوم الخاضعة للضريبة %5.9 (5*1.18)، وإجمالي مبلغ المعدّل 123.90 دولار أمريكي [= 118 دولار أمريكي (ضريبة السلع والخدمات بنسبة% 18) + 5.9 دولار أمريكي (رسوم الخدمة بنسبة% 5.9)].

يحدّد المقتطف التالي الضريبة (ضريبة السلع والخدمات) والرسوم الخاضعة للضريبة (رسوم الخدمة) كنسب مئوية:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

الرسوم الخاضعة للضريبة كمبلغ

في هذا المثال، تبلغ قيمة AmountBeforeTax 100 دولار أمريكي، وتبلغ ضريبة السلع والخدمات 18%، وتبلغ الرسوم الثابتة الإضافية 20 دولارًا أمريكيًا، ما يجعل إجمالي الرسوم الخاضعة للضريبة 23.60 دولارًا أمريكيًا (20 دولارًا أمريكيًا*1.18)، وإجمالي مبلغ المعدّل 141.60 دولارًا أمريكيًا [= 118 دولارًا أمريكيًا (ضريبة السلع والخدمات بنسبة% 18) + 23.60 دولارًا أمريكيًا (الرسوم الثابتة البالغة 20 دولارًا أمريكيًا)].

يحدّد المقتطف التالي الضريبة (ضريبة السلع والخدمات) كنسبة مئوية والرسوم الخاضعة للضريبة (رسوم الخدمة) كمبلغ ثابت:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

رسالة الضرائب والرسوم تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

نظرة عامة

طُرق إضافة الضرائب والرسوم

طُرق تحديد الضرائب

العناصر المطلوبة والاختيارية

البنية والمخططات

الإرشادات

الإجراءات

للجمهور العام

مثال

طرق التنفيذ

السيناريو 1: كيفية إضافة ضريبة ثابتة

الوصف

الحل

عيّنة

السيناريو 2: كيفية استهداف الضرائب باستخدام ApplicableNights

الوصف

الحل

عيّنة

السيناريو 3: كيفية استبدال الضرائب والرسوم القديمة بالجديدة

الوصف

الحل

عيّنة

السيناريو 4: كيفية تضمين الضرائب أو استبعادها في بلدان معيّنة

الوصف

الحل

عيّنة

السيناريو 5: كيفية تحديد الضريبة الشرائحية باستخدام الأقواس

الوصف

الحل

عيّنة

السيناريو 6: كيفية تحديد الضريبة والرسوم الخاضعة للضريبة

الوصف

الحل

أمثلة

الرسوم الخاضعة للضريبة كنسبة مئوية

الرسوم الخاضعة للضريبة كمبلغ

رسالة الضرائب والرسوم

السيناريو 2: كيفية استهداف الضرائب باستخدام `ApplicableNights`