پیام مالیات و هزینه

نمای کلی

پیام TaxFeeInfo مالیات ها و هزینه هایی را که برای کاربر هنگام رزرو ملک و بر اساس مقررات مالیاتی ملک که در وب سایت مشخص شده است اعمال می شود، تعریف می کند. برای افزودن داده‌های مالیات و هزینه، از پیام نرخ ( OTA_HotelRateAmountNotifRQ ) استفاده می‌کنید.

توجه: نوع پیام TaxFeeinfo توصیه می شود، و اگر AmountAfterTax در پیام Rate مشخص شده باشد، نیازی به آن نیست.

تنها اقدام پشتیبانی شده برای این پیام، overlay است که برای جایگزینی داده های مالیات و هزینه برای هر دارایی استفاده می شود. ارسال به‌روزرسانی‌های مالیاتی و هزینه‌ها هر زمان که تغییراتی وجود دارد، مهم است.

نکته کلیدی: شما باید کلیه مالیات ها و هزینه هایی را که کاربر باید بپردازد (مالیات بر ارزش افزوده، مالیات اقامت، مالیات شهری و غیره) درج کنید، حتی اگر در زمان رزرو پرداخت نشده باشد یا مستقیماً به ملک پرداخت نشده باشد.

روش های اضافه کردن مالیات و هزینه ها

دو روش کلی برای اضافه کردن مالیات و هزینه وجود دارد:

در روش اول، AmountAfterTax در پیام Rate مشخص می کنید. با ارسال پیام‌های نرخی که شامل نرخ‌های پایه شبانه (به استثنای همه مالیات‌ها و هزینه‌ها) و کل نرخ‌های شبانه (شامل همه مالیات‌ها و هزینه‌ها) است، مالیات‌ها و هزینه‌ها را اضافه می‌کنید. از آنجایی که این نرخ‌ها شبانه هستند، این رویکرد فقط برای مالیات‌ها و کارمزدهای مبتنی بر درصد یا مبالغ ثابتی که شبانه هستند کار می‌کند و نمی‌توان از مالیات و هزینه‌های هر اقامت استفاده کرد.

روش دوم (ترجیحی) این است که فقط نرخ‌های پایه شبانه مالیات و هزینه را در پیام‌های نرخ ارسال کنید و TaxFeeInfo برای انتقال مالیات و هزینه‌ها در سطح دارایی استفاده کنید. مالیات‌ها و هزینه‌های فردی هنوز هم می‌تواند به انواع اتاق‌ها و طرح‌های نرخی خاص، که برای محدوده‌های تاریخی خاصی اعمال می‌شوند، اعمال شود.

نکته کلیدی: محدودیت 300 مالیات و هزینه برای هر ملک وجود دارد. می توانید از پیام TaxFeeInfo برای حذف مالیات و هزینه از یک ملک استفاده کنید.

این صفحه فقط به روش ترجیحی استفاده از TaxFeeInfo و نه روش تعیین AmountAfterTax در پیام Rate ( OTA_HotelRateAmountNotifRQ ) اشاره می کند.

روش های تعیین مالیات

برای تعیین مالیات گزینه های زیر را دارید:

• اساس = [اتاق|نفر]
• دوره = [ اقامت | شب ]
• نوع = [درصد|مقدار]

وقتی دوره stay است و نوع percent است، Google مالیات و هزینه‌هایی را برای کل اقامت اعمال می‌کند، حتی اگر یک تاریخ در برنامه سفر با محدوده StayDates همپوشانی داشته باشد. فقط در صورتی نمی‌توانید اعمال مالیات و هزینه را مشخص کنید که همه تاریخ‌های برنامه سفر با محدوده تاریخ اقامت-تاریخ همپوشانی داشته باشند.

برای نمونه‌هایی از سناریوهای مختلف مرتبط با مالیات، به دستورالعمل‌ها مراجعه کنید. مثال‌ها برخی از سناریوهای مالیاتی برتر را پوشش می‌دهند، از جمله نحوه انجام:

• مالیات درصدی
• مالیات ثابت برای هر ملک اعمال می شود
• درصد مالیات فقط برای شب‌های بعد از شب اول اعمال می‌شود
• روش جایگزینی مالیات های قدیمی با جدید
• شامل یا حذف مالیات برای کشورها
• مالیات اسلب را با براکت تنظیم کنید
• تعیین مالیات و هزینه مشمول مالیات

بخش‌های زیر دستورالعمل‌های کلی، یک مثال اساسی و سناریوهای چگونگی شروع کار با افزودن و به‌روزرسانی اطلاعات مالیاتی را پوشش می‌دهند.

عناصر مورد نیاز و اختیاری

مرجع XML توضیحاتی در مورد عناصر مورد نیاز و اختیاری ارائه می دهد. برای جزئیات بیشتر در مورد ویژگی ها و عناصر فرزند، به عناصر و ویژگی های TaxFeeInfo مراجعه کنید.

نحو و طرحواره

هنگام ایجاد پیام از مثال TaxFeeInfo Syntax به عنوان مرجع استفاده کنید تا مطمئن شوید که از فرمت صحیح پیروی می کنید. می‌توانید از یک ابزار XML شخص ثالث مانند xmllint برای تأیید اعتبار فیدهای خود با طرح‌واره‌های منتشر شده قبل از ارسال آنها به Google استفاده کنید. برای طرح پیام TaxFeeinfo ، به طرح‌های تبلیغات هتل مراجعه کنید.

رهنمودها

این بخش دستورالعمل های رایج و دستورالعمل های ویژه برای تعیین مالیات و هزینه ها را پوشش می دهد.

اقدامات

پوشش

از عمل overlay برای جایگزینی همه مالیات‌های یک ملک استفاده کنید. عمل overlay پیش‌فرض و تنها اقدامی است که پشتیبانی می‌شود. پس از اعمال این به‌روزرسانی، هرگونه مالیات و هزینه‌های قبلی برای این دارایی پاک می‌شود.

ژنرال

• هر Tax بر اساس مقدار AmountBeforeTax که در BaseByGuestAmt مشخص شده است، ارزیابی و در صورت امکان محاسبه می شود.

• پس از محاسبه همه مالیات ها و هزینه های قابل اعمال، آنها به قیمت پایه اضافه می شوند تا قیمت کل را تشکیل دهند.

• نحو برای <Tax> و <Fee> یکسان است.

• مالیات ها و هزینه ها می توانند محدودیت هایی داشته باشند، مانند:

  • فقط برای انواع اتاق ها و برنامه های نرخ خاص اعمال می شود.
  • فقط برای تاریخ های اقامت خاص اعمال می شود.

  این محدودیت ها اختیاری هستند و لازم نیست هر نوع محدودیتی را تنظیم کنید. اگر برای همه قابل اجرا باشد، می‌توانید آن‌ها را خالی بگذارید.

• هر زمان که تغییری در مالیات یا کارمزد ایجاد شد، یک به‌روزرسانی TaxFeeInfo ارسال کنید.

مثال

این بخش یک مثال اساسی از پیام TaxFeeInfo با استفاده از عناصر مورد نیاز و اختیاری را ارائه می دهد. هنگامی که فایل خود را آماده کردید، باید آن را با استفاده از یک پیام POST به این نقطه پایانی به Google ارسال کنید:

https://www.google.com/travel/hotels/uploads/taxes

برای کسب اطلاعات بیشتر در مورد نحوه فشار دادن/پست کردن پیام، به ارسال پیام‌ها مراجعه کنید.

نکته کلیدی: هر بار که مالیات ها و هزینه های شما تغییر می کند، یک پیام TaxFeeInfo به روز به Google ارسال کنید.

برای ویژگی 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: چگونه یک مالیات ثابت اضافه کنیم

این مثال مالیاتی نحوه تعیین مالیات ثابت برای هر ملک را نشان می دهد.

توضیحات

شما می خواهید به جای مالیات درصدی، یک مالیات ثابت برای اتاق یا اقامت در هر ملک اعمال کنید.

راه حل

برای اضافه کردن گزینه مالیات ثابت به جای percentage از amount استفاده کنید.

نمونه

این نمونه نحوه اضافه کردن مالیات ثابت را با استفاده از 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% مالیات اگر نرخ شبانه بیشتر از 1000 و کمتر یا مساوی 7500 باشد.
• 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) می کند. % GST) + 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 درصد GST) می کند. ) + 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>