Mensagem fiscal e de tarifa

Visão geral

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

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

Para mais informações sobre como enviar tributos e taxas, bem como os detalhes específicos de preços para suas tarifas, consulte a política de tributos e taxas.

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. Para adicionar os tributos e taxas, envie mensagens de tarifa que contenham as diárias básicas (sem tributos e taxas) e as diárias totais (com tributos e taxas). Como essas taxas são diárias, essa abordagem só funciona para tributos e taxas baseados em porcentagem ou valores fixos por noite. Tributos e taxas por estadia não podem ser usados.

O segundo método (preferencial) é enviar apenas as tarifas básicas noturnas sem tributos e taxas nas mensagens de tarifa e usar TaxFeeInfo para informar tributos e taxas no nível da propriedade. Os tributos e taxas individuais ainda podem ser definidos para tipos de quarto e planos de tarifa específicos, que são aplicáveis a determinados períodos.

Esta página descreve e se refere apenas ao método preferido de usar TaxFeeInfo, e não ao método de especificar AmountAfterTax na mensagem de classificação (OTA_HotelRateAmountNotifRQ).

Métodos para definir tributos

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

  • Base = [sala|pessoa]
  • Período = [stay|night]
  • Tipo = [percent|amount]

Quando o período é stay e o tipo é percent, o Google aplica tributos e taxas para toda a estadia, mesmo que uma única data no itinerário se sobreponha ao período StayDates. Não é possível especificar a aplicação de um tributo e uma taxa somente se TODAS as datas do itinerário se sobrepuserem ao período da estadia. Para vários períodos de datas de estadia que se sobrepõem, os intervalos de StayDates são especificados em um único intervalo aberto. Consulte os exemplos de TaxFeeInfo.

Para exemplos de vários cenários relacionados a tributos, consulte Instruções. Os exemplos abordam alguns dos principais cenários fiscais, incluindo instruções sobre como:

  1. Tributo fixo e tributo percentual aplicados por propriedade
  2. Tributo percentual aplicado apenas às noites após a primeira
  3. Método para substituir tributos antigos por novos
  4. Incluir ou excluir tributos para países
  5. Definir tributos progressivos com faixas
  6. Definir tributos e taxas tributáveis

As seções a seguir abordam diretrizes gerais, um exemplo básico e cenários de como fazer para 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 detalhes 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 seus feeds com os esquemas publicados antes de enviá-los ao Google. Para o esquema de mensagem TaxFeeinfo, consulte Esquemas de anúncios de hotéis.

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 padrão e a única compatível. Todos os tributos e taxas anteriores dessa propriedade serão removidos quando a atualização for aplicada.

Geral

  • Cada Tax é avaliado e, se aplicável, calculado 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 de <Tax> e <Fee> é a mesma.

  • Os tributos e taxas podem ter restrições, como:

    • Aplicável somente a tipos de quarto e planos de tarifas específicos.
    • Válido apenas para datas de estadia específicas.

    Essas restrições são opcionais, e você não precisa definir todos os tipos. Deixe em branco se for aplicável a todos.

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

Exemplo

Nesta seção, fornecemos um exemplo básico de uma mensagem TaxFeeInfo usando elementos obrigatórios e opcionais. Depois de preparar o arquivo, envie-o ao Google usando uma mensagem POST para este endpoint:

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

Para saber mais sobre como enviar/POST a mensagem, consulte Envio de mensagens.

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

Este exemplo mostra como definir uma porcentagem de tributo 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 conferir exemplos de tributos relacionados à idade e outros exemplos, consulte Exemplos de tributos.

Tutoriais

Esta seção oferece soluções para cenários que podem ocorrer ao definir tributos e taxas.

Cenário 1: como adicionar um tributo fixo

Este exemplo mostra como definir um tributo fixo por propriedade.

Descrição

Você quer aplicar um tributo fixo para o quarto ou a estadia por propriedade, em vez de uma porcentagem.

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. Por exemplo, há uma taxa obrigatória para o uso diário de uma determinada comodidade que é excluída da primeira noite, em que os hóspedes não teriam tido 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 e taxas atuais mudaram 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 e 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

Você precisa incluir o tributo para alguns países e excluir para outros. Por exemplo, você precisa excluir tributos de uma confederação menor com tributos de fora da UE e 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 imposto por faixa com intervalos

Descrição

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

Solução

Para este cenário, suponha que as faixas de tributo IBS do país de destino sejam:

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

Exemplo

O exemplo a seguir mostra como definir um tributo por faixa com 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 taxas tributáveis

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 porcentagem, enquanto a taxa tributável é 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 taxa de serviço adicional de 5%, o que resulta em uma porcentagem total de taxa tributável de 5,9% (5*1,18) e um valor total de US $123,90 [= US $118 (18% de IBS) + US$ 5,9 (5,9% de taxa de serviço)].

O snippet a seguir define o tributo (IBS) e a taxa tributável (taxa 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 IBS de 18% e uma taxa fixa adicional de US $20, o que resulta em uma taxa tributável total de US $23,60 (US$ 20*1,18) e um valor total de US $141,60 [= US $118 (18% de IBS) + US $23,60 (taxa fixa de US$ 20)].

O snippet a seguir define o tributo (IBS) em porcentagem e a 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>