Mensagem de classificação

Visão geral

A mensagem de tarifa (OTA_HotelRateAmountNotifRQ) define as taxas de ocupação noturna para cada tipo de quarto e combinação de plano de tarifa em intervalos de datas específicos. Como parte da mensagem de tarifa, o Google oferece suporte a preços baseados em ocupação, permitindo que diferentes tarifas por diária sejam especificadas com base no número máximo de ocupantes pretendidos.

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 tarifas e enviar uma mensagem de tarifa.

Comportamento da taxa de correspondência

À medida que os usuários solicitam ocupações específicas, a tarifa que eles veem depende de como você define os preços na sua mensagem de tarifa. Esta seção aborda como essas solicitações de usuários são correspondidas às suas tarifas, dependendo da ocupação da solicitação e das tarifas definidas.

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.

  • Solicitações de ocupações acima das definidas são consideradas impossíveis.

  • A precificação baseada em ocupação se aplica aos modelos de precificação por data e por período de permanência (LOS, na sigla em inglês) descritos abaixo. Isso significa que é possível especificar taxas 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 outros hóspedes e crianças usando AdditionalGuestAmounts ou ExtraGuestCharges que é aplicada até a capacidade definida para um quarto.

Benefícios e exemplos

Eficiência

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

Exemplo:as tarifas de um tipo de quarto e um plano de tarifa são as mesmas para ocupações de uma a quatro pessoas. Use a mensagem "Rate" para definir uma tarifa para ocupação máxima de 4 pessoas. Os usuários que pesquisarem ocupação individual, dupla e tripla vão ver a mesma tarifa. Os usuários que pesquisarem 5 ou mais não vão encontrar tarifas.

Controle

Taxas distintas para ocupações alternativas podem ser fornecidas explicitamente. Envie uma taxa diferente para cada valor de ocupação se quiser mais controle sobre como o Google corresponde às solicitações e às taxas de ocupação.

Exemplo:se as tarifas forem definidas para ocupações de 3 e 1 pessoa, as pesquisas de ocupação única vão mostrar a tarifa para uma pessoa, uma pesquisa de ocupação dupla vai mostrar a tarifa para três pessoas, e os usuários que pesquisarem para quatro ou mais pessoas não vão encontrar tarifas.

Para mais exemplos de vários cenários relacionados a taxas, consulte Tutoriais.

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 de classificação.

Sintaxe e esquemas

Use o exemplo de sintaxe de classificação como referência ao criar a mensagem de classificação 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 da mensagem de tarifa, consulte Esquemas dos anúncios de hotel.

Modelos de preços

Preços por data

Esse é o modelo de preços padrão usado na maioria das propriedades. O modelo de preços per-date se baseia na definição de tarifas que são somadas nas datas de estadia para chegar a um preço total. Nesse modelo, todas as tarifas em um elemento Rate são interpretadas como aplicáveis a um intervalo de datas de estadia especificado em <StatusApplicationControl>.

Preços com base na estadia

O modelo de preços baseado na duração da estadia (LOS, na sigla em inglês) é baseado em tarifas definidas para uma combinação de data de chegada e duração da estadia. As tarifas especificadas no modelo de preços baseado em LOS são diárias. Por exemplo, se você enviar uma tarifa de US $100 para uma estadia de 3 dias, o preço total será calculado como 3 x US$100=US$300.

Para usar o modelo de preços com base na LOS, especifique RatePlanType="26" nos elementos StatusApplicationControl. Você também precisa definir os atributos RateTimeUnit e UnitMultiplier nos elementos Rate do seu XML. Isso faz com que todas as tarifas no elemento Rate sejam aplicadas às estadias definidas pelas datas de chegada especificadas em <StatusApplicationControl> e pelo valor de LOS especificado para UnitMultiplier.

Você pode usar os dois modelos de preços por data e com base na duração da estadia em uma única conta, mas cada propriedade só pode usar um modelo de preços. Considere os seguintes pontos ao implementar preços com base na duração da estadia:

  • As tarifas para diferentes durações de estadia não são combinadas ao usar preços com base na duração da estadia. 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 especificada explicitamente.
  • A tarifa de uma noite na precificação com base em LOS não é usada como uma tarifa individual por noite na precificação por data.
  • Cada propriedade só pode usar preços com base na duração da estadia ou por data, dependendo de como as tarifas são representadas no seu sistema.

Para ativar os preços com base na duração da estadia na sua conta, faça a solicitação pelo TAM ou entre em contato com nossa equipe.

Diretrizes ou ações

Preços por data

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

  • 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 ocupações. Por exemplo, se você tiver especificado tarifas para quartos de ocupação individual e dupla e enviar uma atualização de tarifa Delta para o quarto de ocupação individual, a tarifa de ocupação dupla vai permanecer inalterada.

Overlay: exclua todas as tarifas por ocupação atuais para o tipo de quarto, o plano de tarifa e as datas especificadas em <StatusApplicationControl> e substitua por novas tarifas. Por exemplo, se você tiver especificado tarifas para quartos de ocupação individual e dupla e enviar uma atualização Overlay para um quarto de ocupação individual, o Google vai remover todas as tarifas anteriores (ocupação individual e dupla), e apenas a tarifa de ocupação individual vai permanecer após a atualização.

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

Preços com base na estadia

Delta: adiciona ou atualiza as tarifas por valor de LOS apenas para as combinações especificadas de tipo de quarto, plano de tarifas e datas de check-in 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 tarifas para LOS 1 e 2 e enviar uma atualização de tarifa Delta para LOS 1, as tarifas por ocupação de LOS 2 vão permanecer inalteradas.
  • Uma atualização de Delta substitui todas as taxas por ocupação armazenadas anteriormente para o período de estadia especificado. Por exemplo, se você especificou tarifas de ocupação única e dupla para a duração da estadia 1 e enviou uma atualização de tarifa Delta para a duração da estadia 1 com apenas uma tarifa de ocupação única, a tarifa de ocupação dupla será removida.

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

Remove: exclui todas as taxas por ocupação atuais para todas as LOS do tipo de quarto, plano de tarifa e datas de check-in especificadas em <StatusApplicationControl>.

Tributos

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

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

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

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

Exemplo

Nesta seção, apresentamos um exemplo básico de uma mensagem de taxa usando elementos obrigatórios e opcionais. Depois de preparar o arquivo, envie-o 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/POST a mensagem, consulte Envio de mensagens.

Para HotelCode, 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. Para <PackageID> e <RoomID>, use os mesmos IDs que você usa no seu sistema para planos de tarifas e tipos de quarto, respectivamente. A consistência com seu sistema é essencial 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 oferece soluções para cenários que podem ocorrer ao enviar mensagens de avaliação.

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

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

Descrição

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

Solução

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

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

Descrição

Antes, você definiu tarifas para 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 taxas de ocupação de uma determinada propriedade, tipo de quarto, plano de tarifa e datas. Nesse cenário, a ação Overlay listaria as taxas para 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 valor de ocupação mais alto compatível com o tipo de quarto e o plano de tarifas. Ele será usado automaticamente para ocupações menores. Ou seja, não é necessário repetir a mesma tarifa por noite para ocupações de 1 a 6 se elas forem iguais. Basta definir para 6.