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

نظرة عامة

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

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

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

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

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

طُرق ضبط الضرائب

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

  • الأساس = [room|person]
  • المدة الزمنية = [إقامة|ليلة]
  • النوع = [percent|amount]

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

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

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

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

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

يوفّر مرجع 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: كيفية ضبط ضريبة الشرائح باستخدام الأقواس

الوصف

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

الحلّ

في هذا السيناريو، لنفترض أنّ الأقواس الضريبية لضريبة السلع والخدمات (GST) في البلد المستهدَف هي:

  • ليست هناك ضريبة إذا كان سعر الليلة أقل من أو يساوي 1000.
  • ضريبة بقيمة 12% إذا كان معدّل الإقامة في الليلة أكبر من 1000 وأقل من أو يساوي 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: كيفية إعداد الضريبة والرسوم المطبَّقة

الوصف

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

الحلّ

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

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

أمثلة

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

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

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

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

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

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

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

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