Сообщение о налогах и сборах

Обзор

Сообщение TaxFeeInfo определяет налоги и сборы, которые применяются к пользователю при бронировании объекта недвижимости и основаны на налоговых правилах объекта недвижимости, изложенных на веб-сайте. Чтобы добавить данные о налогах и сборах, вы используете сообщение о ставке ( OTA_HotelRateAmountNotifRQ ).

Единственное поддерживаемое действие для этого сообщения — overlay , которое используется для замены данных о налогах и сборах для каждого объекта недвижимости. Важно отправлять обновления о налогах и сборах при каждом изменении.

Способы добавления налогов и сборов

Существует два основных способа добавления налогов и сборов:

В первом методе вы указываете AmountAfterTax в сообщении о ставке; вы добавляете налоги и сборы, отправляя сообщения о тарифах, которые содержат как базовые тарифы за ночь (без учета всех налогов и сборов), так и общие ставки за ночь (включая все налоги и сборы). Поскольку эти ставки указаны за ночь, этот подход работает только для налогов и сборов, основанных на процентах, или фиксированных сумм, которые рассчитываются за ночь. Налоги и сборы за проживание использовать нельзя.

Второй (предпочтительный) метод — отправлять в сообщениях о тарифах только базовые ставки за ночь без учета налогов и сборов и использовать TaxFeeInfo для передачи налогов и сборов на уровне объекта размещения. Отдельные налоги и сборы по-прежнему могут быть привязаны к конкретным типам номеров и тарифным планам, которые применимы к определенным диапазонам дат.

На этой странице описан и ссылается только на предпочтительный метод использования TaxFeeInfo , а не на метод указания AmountAfterTax в сообщении о ставке ( OTA_HotelRateAmountNotifRQ ).

Методы установления налогов

У вас есть следующие возможности установить налоги:

  • Базис = [комната|человек]
  • Период = [проживание|ночь]
  • Тип = [процент|сумма]

Если Period — это stay , а Type — 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

Дополнительные сведения о том, как отправить/POST сообщение, см. в разделе Отправка сообщений .

В качестве атрибута 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 и меньше или равна 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>