تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

نظرة عامة

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

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

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

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

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

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

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

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

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

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

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

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

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

الحل

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

لا يتم تحصيل ضريبة إذا كان السعر الفندقي لليلة أقل من أو يساوي 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 دولار أمريكي)].

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

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