Classifique a mensagem

Visão geral

A Mensagem de tarifa (OTA_HotelRateAmountNotifRQ) define as tarifas de ocupação por noite para cada combinação de tipo de quarto e plano de tarifa para períodos específicos. Como parte da mensagem de tarifa, o Google aceita preços com base na ocupação, permitindo que diferentes tarifas por noite sejam especificadas de acordo com o número máximo de ocupantes pretendidos.

As seções a seguir abordam diretrizes gerais, um exemplo básico e exemplos de instruções para você começar a adicionar e atualizar tarifas e enviar uma mensagem de tarifa.

Comportamento da taxa de correspondência

Conforme os usuários solicitam ocupações específicas, a taxa exibida depende de como você define os preços na mensagem de tarifa. Nesta seção, abordamos como essas solicitações de usuários são correspondidas às suas tarifas, dependendo da ocupação da solicitação e das tarifas que você definir.

Princípios-chave

  • Uma tarifa definida para uma ocupação específica se aplica a todas as ocupações menores, a menos que definido de outra forma.

  • As solicitações de ocupações acima daquelas definidas não são consideradas possíveis.

  • Os preços baseados na ocupação se aplicam aos preços por data e aos modelos de preços baseados em LOS descritos abaixo. Isso significa que você pode especificar tarifas para cada ocupação. Se não houver uma tarifa para uma ocupação específica, será usada a tarifa para a próxima ocupação mais alta. Também é possível definir cobranças para hóspedes e crianças adicionais usando AdditionalGuestAmounts ou ExtraGuestCharges, que é aplicado até a capacidade definida para um quarto.

Benefícios e exemplos

Eficiência

Para várias ocupações com o mesmo valor, não é necessário definir uma tarifa para cada uma delas. Você pode simplificar suas mensagens definindo apenas o maior valor de ocupação aceito pelo tipo de quarto e pelo plano de tarifa. Os usuários vão ver essa tarifa para cada ocupação menor ou igual ao valor definido.

Exemplo:as tarifas para um tipo de quarto e um plano de tarifa são as mesmas para ocupações de um a quatro. Use a mensagem de tarifa para definir uma tarifa para ocupação máxima de quatro pessoas. A mesma tarifa vai aparecer para os usuários que pesquisarem ocupação única, dupla e tripla. Os usuários que pesquisarem cinco ou mais não vão visualizar as tarifas.

Controle

Tarifas distintas para ocupações alternativas podem ser fornecidas explicitamente. Envie uma taxa diferente para cada valor de ocupação se você quiser ter mais controle sobre como o Google faz a correspondência entre solicitações e taxas de ocupação.

Exemplo:se as tarifas forem definidas para as ocupações 3 e 1, as pesquisas de ocupação única vão mostrar a diária, uma pesquisa de ocupação dupla vai mostrar a taxa de ocupação tripla, e os usuários que pesquisam 4 ou mais não vão ter acesso às taxas.

Para mais exemplos de vários cenários relacionados a taxas, consulte as Instruções.

Elementos obrigatórios e opcionais

A Referência XML fornece descrições dos elementos obrigatórios e opcionais. Para mais detalhes sobre atributos e elementos filhos, consulte Elementos e atributos de taxa.

Sintaxe e esquemas

Use o exemplo Sintaxe de taxa como referência ao criar a Mensagem de taxa 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 mensagens de tarifa, consulte Esquemas de anúncios de hotéis.

Modelos de preços

Preços por data

Esse é o modelo de preço padrão usado para a maioria das propriedades. O modelo de preços per-date é baseado nas taxas de definição que são somadas ao longo das datas de estadia para chegar ao preço total. Nesse modelo, todas as tarifas em um elemento Rate são interpretadas como aplicadas a um período de estadia especificado em <StatusApplicationControl>.

Preços com base na estadia

O modelo de preços com base em LOS (duração da estadia) considera as tarifas definidas para uma combinação de data de chegada e duração da estadia. As taxas especificadas no modelo de preços com base em LOS são por dia. Por exemplo, se você enviar uma tarifa de US $100 para uma duração da estadia de três, o preço total será calculado como 3 x US$100=US$300.

É possível usar o modelo de preços baseado em LOS especificando RatePlanType="26" nos elementos StatusApplicationControl. Também é necessário definir os atributos RateTimeUnit e UnitMultiplier nos elementos Rate do XML. Isso faz com que todas as tarifas no elemento Rate especificado sejam aplicadas a estadias definidas pelas datas de chegada especificadas em <StatusApplicationControl> e pelo valor da LOS especificado para UnitMultiplier.

Você pode usar modelos de preços por data e baseados em LOS em uma única conta. No entanto, cada propriedade deve usar um único modelo de preços. Tenha os seguintes pontos em mente ao implementar preços com base em LOS:

  • As tarifas para durações diferentes de estadia não são combinadas ao usar preços com base na LOS. Por exemplo, uma taxa de LOS de 3 não é combinada com uma LOS de 1 para precificar uma taxa de LOS de 4. A taxa de LOS de 4 precisa ser explicitamente especificada.
  • A tarifa de uma noite no preço com base na estadia não é usada como uma diária individual no preço por data.
  • Cada propriedade só deve usar preços com base em LOS ou por data, dependendo de como as taxas são representadas no sistema.

Para ativar os preços com base na estadia na sua conta, faça a solicitação pelo seu TAM ou fale com a gente.

Diretrizes ou ações

Preços por data

Delta: adicione ou atualize as tarifas por ocupação apenas para as combinações especificadas de tipo de quarto, plano de tarifa e datas de estadia especificadas em <StatusApplicationControl>.

  • As atualizações de taxa usam a ação Delta por padrão.
  • Uma atualização de Delta não muda as tarifas armazenadas anteriormente para outras ocupações. Por exemplo, se você especificou tarifas para quartos individuais e duplos e envia uma atualização de tarifa de Delta para o quarto individual, a tarifa de ocupação dupla permanece inalterada.

Overlay: exclui todas as tarifas por ocupação existentes para o tipo de quarto, o plano de tarifa e as datas especificadas em <StatusApplicationControl> e as substitui por novas tarifas. Por exemplo, se você tiver especificado tarifas para quartos individuais e duplos e enviar uma atualização de Overlay para um quarto de ocupação única, o Google removerá todas as tarifas anteriores (ocupações simples e duplas) e somente a tarifa de ocupação única permanecerá após a atualização.

Remove: exclui todas as tarifas por ocupação existentes para o tipo de quarto, o plano de tarifa e as datas especificadas em <StatusApplicationControl>.

Preços com base na estadia

Delta: adicione ou atualize tarifas por valor de LOS apenas para as combinações especificadas de tipo de quarto, plano de tarifa e datas de check-in especificadas em <StatusApplicationControl>. Substitui todas as taxas por ocupação associadas aos valores de LOS atualizados.

  • As atualizações de taxa usam a ação Delta por padrão.
  • Uma atualização de Delta não altera as tarifas armazenadas anteriormente para outras durações de estadia. Por exemplo, se você tiver especificado taxas para a LOS 1 e 2 e enviar uma atualização da taxa Delta para a LOS 1, as taxas por ocupação da LOS 2 permanecerão inalteradas.
  • Uma atualização de Delta substitui todas as taxas por ocupação armazenadas anteriormente para a duração de estadia especificada. Por exemplo, se você tiver especificado tarifas de ocupação única e dupla para a LOS 1 e enviar uma atualização de taxa de Delta para a LOS 1 com apenas uma única taxa de ocupação, a taxa de ocupação dupla será removida.

Overlay: exclui todas as tarifas por ocupação existentes para a LOS, tipo de quarto, plano de tarifa e datas de check-in especificadas em <StatusApplicationControl> e as substitui por novas tarifas. Por exemplo, se você tiver especificado taxas para a LOS 1 e 2 e enviar uma atualização de Overlay para a LOS 1, o Google removerá todas as taxas anteriores (ambas 1 e 2), e somente a taxa da LOS 1 permanecerá após a atualização.

Remove: exclua todas as tarifas por ocupação existentes para toda a LOS do tipo de quarto, do plano de tarifa e das datas de check-in especificadas em <StatusApplicationControl>.

Relacionado a tributos

Se os tributos e as tarifas forem simples, o valor total poderá ser especificado usando AmountAfterTax. Tributos complexos, como tributos e taxas aplicáveis por estadia (em vez de por noite), não podem ser representados no AmountAfterTax.

Em geral, o Google recomenda usar TaxFeeInfo em vez de AmountAfterTax.

Se possível, inclua AmountBeforeTax (mesmo que você especifique AmountAfterTax), já que determinados locais (por exemplo, EUA) exibem o preço sem tributos por padrão.

Todos os tributos e taxas que um usuário precisa pagar (IVA, tributo de estadia, taxas de limpeza, tributo municipal etc.) precisam ser incluídos, mesmo que não sejam pagos no momento da reserva ou não sejam pagos diretamente na propriedade.

Exemplo

Nesta seção, você verá um exemplo básico de uma mensagem de tarifa usando elementos obrigatórios e opcionais. Depois de preparar seu arquivo, você precisa enviá-lo ao Google usando uma mensagem POST para o seguinte endpoint: https://www.google.com/travel/hotels/uploads/property_data

Para saber mais sobre como enviar/POSTar a mensagem, consulte Enviar mensagens por push.

Para HotelCode, use o ID do hotel exclusivo usado no seu sistema para identificar a propriedade. Esse valor precisa corresponder ao ID de hotel especificado usando <id> no elemento <listing> no feed de lista de hotéis. Para <PackageID> e <RoomID>, use os mesmos IDs que você usa no seu sistema para planos de tarifa e tipos de quarto (respectivamente). A consistência com seu sistema é fundamental para garantir que o Google mostre seus preços e dados corretamente.

Este exemplo mostra como definir taxas usando uma ação Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Tutoriais

Esta seção fornece soluções para cenários que podem ser encontrados ao enviar mensagens de tarifação.

Para exemplos de como adicionar, remover e atualizar taxas, consulte Exemplos de taxas.

Cenário 1: como mudar o preço por ocupação

Descrição

Antes, as diárias eram definidas apenas para ocupação dupla (o que também se aplica à ocupação única), mas agora há uma tarifa mais barata para uma.

Solução

Envie a nova taxa de ocupação 1 usando a atualização padrão com escopo Delta. Esse novo valor não afeta a tarifa de ocupação 2.

Cenário 2: como substituir as taxas por ocupação de uma propriedade

Descrição

Você já definiu as tarifas para as ocupações de 1 a 4, mas agora apenas as ocupações 1 e 2 são válidas.

Solução

Use NotifType="Overlay" para substituir todas as tarifas de ocupação de uma determinada propriedade, tipo de quarto, plano de tarifa e datas. Nesse cenário, a ação Overlay listaria as tarifas para as ocupações 1 e 2.

Cenário 3: como definir a mesma tarifa para várias ocupações

Descrição

Uma tarifa para uma determinada ocupação pode ser vendida a um grupo com menos pessoas. Nesse cenário, você pode simplificar suas mensagens enviando apenas a atualização da taxa para a ocupação máxima aplicável.

Solução

Se você tiver o mesmo preço para várias ocupações, defina o maior valor de ocupação aceito pelo tipo de quarto e pelo plano de tarifa. Esse valor será usado automaticamente para ocupações mais baixas. Ou seja, não é necessário repetir a mesma tarifa noturna para as ocupações de 1 a 6, caso elas sejam todas iguais. Basta definir para 6.