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

نظرة عامة

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

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

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

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

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

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

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

يمكنك ضبط الضرائب من خلال الخيارات التالية:

  • الأساس = [غرفة|شخص]
  • المدة = [إقامة|ليلة]
  • النوع = [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>

السيناريو الثالث: كيفية استبدال الضرائب والرسوم القديمة بأخرى جديدة

الوصف

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

الحل

يمكنك استخدام الإجراء 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) في البلد المستهدف هي:

  • لا يتم فرض ضريبة إذا كان سعر الليلة أقل من 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 دولار أمريكي، وضريبة السلع والخدمات (GST) بنسبة 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>

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

في هذا المثال، تبلغ القيمة السابقة 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>