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

نظرة عامة

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

ملاحظة: ننصح باستخدام نوع الرسالة TaxFeeinfo، وهو ليس مطلوبًا إذا تم تحديد AmountAfterTax في رسالة السعر.

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

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

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

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

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

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

نقطة رئيسية: هناك حدّ أقصى يبلغ 300 ضريبة ورسوم لكلّ موقع. يمكنك استخدام TaxFeeInfo رسالة لإزالة الضرائب والرسوم من موقع.

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

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

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

• Basis = [room|person]
• الفترة = [stay|night]
• النوع = [النسبة المئوية|المبلغ]

عندما تكون الفترة هي 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

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

ملاحظة مهمة: أرسِل إلى Google رسالة TaxFeeInfo معدَّلة في كل مرة تتغيّر فيها الضرائب والرسوم.

بالنسبة إلى السمة 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>

ملاحظة: إذا لم يتم تحديد <Currency> ولكن تم تحديد <Amount>، ستتم ضبط قيمة <Currency> تلقائيًا على عملة السعر الأساسي.

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

طرق التنفيذ

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

السيناريو 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 لإزالة جميع الضرائب والرسوم الحالية.

ملاحظة: يكون الإجراء 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) يتم تطبيقها استنادًا إلى الأسعار الليلية.

ملاحظة: في هذا السيناريو، استخدِم Brackets (مجموعة من أقواس الضرائب غير المتداخلة) لضبط هذا الخيار.

الحل

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

• لا يتم تحصيل ضريبة إذا كان السعر الفندقي لليلة أقل من أو يساوي 1000.
• ضريبة بنسبة %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 دولار أمريكي، وضريبة السلع والخدمات ‏(GST)‏ ‎18%، ورسوم إضافية ثابتة تبلغ ‏20 دولار أمريكي، ما يجعل إجمالي الرسوم الخاضعة للضريبة ‏23.60 دولار أمريكي (‎20*1.18)، وإجمالي السعر ‏141.60 دولار أمريكي [= 118 دولار أمريكي (ضريبة السلع والخدمات بنسبة %18) + 23.60 دولار أمريكي (رسوم ثابتة تبلغ 20 دولار أمريكي)].

تحدِّد المقتطفة التالية الضريبة (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>