Эта страница переведена с помощью Cloud Translation API.

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

Обзор

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

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

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

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

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

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

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

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

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

Для настройки налогов у вас есть следующие варианты:

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

Если в поле Period указано stay , а в поле Type — percent , Google применяет налоги и сборы ко всему периоду пребывания, даже если хотя бы одна дата в маршруте совпадает с диапазоном StayDates . Нельзя указать применение налога и сбора только в том случае, если ВСЕ даты в маршруте совпадают с диапазоном дат 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

Чтобы узнать больше о том, как отправить/загрузить сообщение (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 в целевой стране следующие:

Налог не взимается, если стоимость номера за ночь составляет менее или равна 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% плата за обслуживание)].

В следующем фрагменте кода налог (НДС) и облагаемая налогом плата (плата за обслуживание) указаны в процентах:

<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 долларов фиксированной ставки)].

В следующем фрагменте кода налог (НДС) выражен в процентах, а налогооблагаемая плата (плата за обслуживание) – в виде фиксированной суммы:

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