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

نظرة عامة

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

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

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

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

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

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

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

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

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

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

  • الأساس = [غرفة|شخص]
  • الفترة = [إقامة|ليلة]
  • النوع = [percent|amount]

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

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

  1. الضريبة الثابتة والضريبة المئوية المطبّقة على كل مكان
  2. تُطبَّق الضريبة المئوية فقط على الليالي التي تلي الليلة الأولى
  3. طريقة استبدال الضرائب القديمة بالضرائب الجديدة
  4. تضمين الضرائب أو استبعادها في البلدان
  5. تحديد الضريبة الشرائحية باستخدام الأقواس
  6. تحديد الضريبة والرسوم الخاضعة للضريبة

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

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

يقدّم مرجع 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

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

بالنسبة إلى السمة 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 إذا كان السعر الليلي أكبر من 7,500.

عيّنة

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

<?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>