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

Обзор

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

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

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

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

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

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

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

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

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

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

Если Period — stay , а Type — percent , Google применяет налоги и сборы за все пребывание, даже если одна дата в маршруте перекрывается с диапазоном StayDates . Вы не можете указать применение налога и сбора только в том случае, если ВСЕ даты в маршруте перекрываются с диапазоном дат stay-dates. Для нескольких диапазонов дат пребывания, которые перекрываются друг с другом, диапазоны StayDates указываются в одном открытом диапазоне. См. примеры TaxFeeInfo .

Примеры различных налоговых сценариев см. в разделе How-tos . Примеры охватывают некоторые из основных налоговых сценариев, включая How-tos для:

  1. Фиксированный налог и процентный налог, применяемый к каждому объекту недвижимости
  2. Процентный налог применяется только к ночам после первой ночи.
  3. Метод замены старых налогов новыми
  4. Включить или исключить налоги для стран
  5. Установить налог на плиту с помощью скобок
  6. Установить налог и налогооблагаемую плату

В следующих разделах рассматриваются общие рекомендации, базовый пример и практические сценарии, которые помогут вам начать добавлять и обновлять налоговую информацию.

Обязательные и необязательные элементы

Ссылка 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> в фиде Hotel List. Согласованность с вашей системой имеет решающее значение для обеспечения корректного отображения ваших данных 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%, если стоимость за ночь больше 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>