Mensagem fiscal e de tarifa

Informações gerais

A mensagem TaxFeeInfo define os tributos e as taxas aplicáveis a um usuário ao reservar uma propriedade e com base nas regulamentações fiscais da propriedade descritas no site. Para adicionar dados de tributos e taxas, use a mensagem de tarifa (OTA_HotelRateAmountNotifRQ).

A única ação compatível com esta mensagem é overlay, que é usada para substituir os dados de tributos e taxas de cada propriedade. É importante enviar atualizações de tributos e tarifas sempre que houver mudanças.

Métodos para adicionar tributos e taxas

Há duas maneiras gerais de adicionar tributos e taxas: no primeiro método, você especifica AmountAfterTax na mensagem de tarifa. Você adiciona os tributos/taxas enviando mensagens que contenham as tarifas básicas por noite (excluindo todos os tributos/taxas) e o total das diárias (incluindo todos os tributos/taxas). Como essas tarifas são diárias, essa abordagem funciona apenas para tributos/taxas baseadas em porcentagem ou valores fixos por noite. Não é possível usar tributos/taxas por estadia.

O segundo método (preferencial) é enviar apenas as taxas básicas exclusivas de tributos por noite nas mensagens de tarifas e usar TaxFeeInfo para transmitir esses valores no nível da propriedade. Os tributos/taxas individuais ainda podem ser definidos para tipos de quarto e planos de tarifa específicos e/ou aplicáveis a determinados períodos.

Métodos para definir tributos

Você tem as seguintes opções para definir impostos:

  • Base = [sala|pessoa]
  • Período = [ficar|noite]
  • Tipo = [porcentagem|valor]

Quando "Período" é stay e "Tipo" é percent, o Google aplica tributos/taxas por toda a estadia, mesmo que uma única data no itinerário se sobreponha ao intervalo StayDates. Não é possível especificar a aplicação de um tributo/taxa apenas se TODAS as datas no itinerário se sobrepuserem ao período das datas da estadia.

Para ver exemplos de várias situações relacionadas a tributos, consulte os Instruções. Os exemplos abrangem alguns dos principais cenários fiscais, incluindo instruções para:

  • Tributo percentual
  • Tributo fixo aplicado por propriedade
  • Tributo percentual aplicado apenas às noites após a primeira noite
  • Método para substituir tributos antigos por novos
  • Incluir ou excluir tributos para países
  • Definir tributo de slab entre colchetes
  • Definir tributos e taxa tributável

As seções a seguir abordam diretrizes gerais, um exemplo básico e cenários de instruções para você começar a adicionar e atualizar suas informações fiscais.

Elementos obrigatórios e opcionais

A referência XML fornece descrições dos elementos obrigatórios e opcionais. Para saber mais sobre atributos e elementos filhos, consulte Elementos e atributos do TaxFeeInfo.

Sintaxe e esquemas

Use o exemplo de sintaxe TaxFeeInfo como referência ao criar a mensagem para garantir que você está seguindo o formato correto. Você pode usar uma ferramenta XML de terceiros, como xmllint, para validar os feeds com os esquemas publicados antes de enviá-los ao Google. Para o esquema de mensagens TaxFeeinfo, consulte Esquemas de anúncios de hotel.

Diretrizes

Esta seção aborda as diretrizes comuns e instruções especiais para definir tributos e taxas.

Ações

Sobreposição
Use a ação overlay para substituir todos os tributos de uma propriedade. A ação overlay é a única ação compatível e padrão. Todos os tributos e taxas anteriores para essa propriedade serão apagados quando essa atualização for aplicada.

Geral

  • Cada Tax é avaliada e, se aplicável, calculada com base no valor de AmountBeforeTax especificado em BaseByGuestAmt.

  • Depois que todos os tributos e taxas aplicáveis são calculados, eles são adicionados ao preço base para formar o preço total.

  • A sintaxe para <Tax> e <Fee> é a mesma.

  • Tributos/taxas podem ter restrições, como:

    • Isso se aplica apenas a tipos de quarto e/ou planos de tarifa específicos.
    • Aplica-se somente a datas de estadia específicas.

    Essas restrições são opcionais, e você não precisa definir todos os tipos de restrição. Deixe-as em branco se forem aplicáveis a todos.

  • Envie uma atualização do TaxFeeInfo sempre que houver uma mudança nos tributos ou nas taxas.

Exemplo

Nesta seção, mostramos um exemplo básico de uma mensagem TaxFeeInfo usando elementos obrigatórios e opcionais. Depois de preparar o arquivo, será necessário enviá-lo ao Google por uma mensagem POST para este endpoint:

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

Para saber mais sobre como enviar/POSTar a mensagem, consulte Como enviar mensagens.

Para o atributo hotel_id, use o ID do hotel exclusivo utilizado no sistema para identificar a propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> no feed de lista de hotéis. A consistência com o sistema é fundamental para garantir que o Google esteja exibindo seus dados corretamente.

Este exemplo mostra como definir uma porcentagem de tributos de 10% e um valor de taxa de US $50 para uma propriedade para a estadia total (não por noite):

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

Para ver como adicionar tributos relacionados à idade, consulte Exemplos fiscais.

Tutoriais

Nesta seção, apresentamos soluções para cenários que você pode encontrar ao definir tributos e taxas.

Cenário 1: como adicionar um tributo fixo

Este exemplo de tributo mostra como definir um tributo fixo por propriedade.

Descrição

Você quer aplicar um tributo fixo para o quarto/estadia por propriedade, em vez de um tributo percentual.

Solução

Use amount em vez de percentage para adicionar a opção de tributo fixo.

Exemplo

Este exemplo mostra como adicionar um tributo fixo usando amount em vez de 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>

Cenário 2: como segmentar tributos usando ApplicableNights

Descrição

Você quer aplicar um tributo de taxa fixa apenas às noites após a primeira noite. Por exemplo, há uma taxa obrigatória para o uso diário de uma determinada comodidade que é excluída da primeira noite, quando os hóspedes não teriam a chance de usar essa comodidade específica.

Solução

Use <ApplicableNights excluded="1"/> para controlar quais noites têm tributos aplicados.

Exemplo

Este exemplo mostra como usar 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>

Cenário 3: como substituir tributos e taxas antigos por novos

Descrição

Os tributos/taxas atuais foram alterados e precisam ser substituídos por novos.

Solução

Use a ação overlay para remover todos os tributos e taxas atuais.

Exemplo

O exemplo a seguir mostra como remover todos os tributos/taxas de uma propriedade:

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

Cenário 4: como incluir ou excluir tributos para países

Descrição

É necessário incluir o tributo para determinados países e excluir o tributo de outros. Por exemplo, é necessário excluir os tributos de uma confederação menor com tributos fora da UE e, ao mesmo tempo, tributar todos os outros países.

Solução

Use as opções include ou exclude para UserCountries type. Use include para aplicar o tributo apenas ao país listado ou exclude para aplicar o tributo a todos os países, exceto o listado.

Exemplo

O exemplo a seguir mostra como definir tributos para usuários fora do país do hotel (Israel):

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

Cenário 5: como definir o tributo de slab entre colchetes

Descrição

Você quer adicionar um tributo slab do IBS aplicado com base nas diárias.

Solução

Nesse cenário, suponha que as faixas de tributos do IBS do país de destino sejam:

  • Não há tributos se a diária for menor ou igual a 1.000.
  • Tributo de 12% se a tarifa diária for maior que 1.000 e menor ou igual a 7.500.
  • Tributo de 18% se a diária for maior que 7.500.

Exemplo

O exemplo a seguir mostra como definir um tributo slab entre colchetes:

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

Cenário 6: como definir tributos e taxa tributável

Descrição

Você quer adicionar um tributo, como o IVA, e outra taxa de serviço que também se aplica a esse tributo.

Solução

Este cenário considera dois exemplos de casos de uso de taxas tributáveis:

  • O tributo e a taxa tributável são definidos como cobranças percentuais.
  • O tributo é uma cobrança percentual, e a tributação é um valor fixo por estadia.

Exemplos

Taxa tributável em porcentagem

Este exemplo tem um AmountBeforeTax de US $100, um IBS de 18% e uma cobrança de serviço adicional de 5%, totalizando a porcentagem total da taxa tributável de 5,9% (5*1,18) e o valor total da taxa de US $123,90 [= US $118 (18% GST) + US$ 5,9 (5,9% de cobrança de serviço)].

O snippet a seguir define o tributo (IBS) e a taxa tributável (cobrança de serviço) como porcentagens: 

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

Taxa tributável como valor

Este exemplo tem um AmountBeforeTax de US$ 100, um tributo do IBS de 18% e uma taxa fixa adicional de US$ 20, totalizando a taxa tributável total de US$ 23,60 (US$ 20*1,18) e o valor total da taxa de US$ 141,60 [= US$ 118 (18% GST) + US$ 23,60) (US$ 23,60) (US$ 23,60).

O snippet a seguir define o tributo (IBS) em porcentagem e taxa tributável (taxa de serviço) como um valor de taxa fixa: 

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