Classifique a mensagem

Visão geral

A mensagem de tarifa (OTA_HotelRateAmountNotifRQ) define o período taxas de ocupação para cada combinação de tipo de quarto e plano de tarifa em uma data específica. intervalos. Como parte da mensagem de tarifação, o Google aceita preços baseados em ocupação, permitindo que diferentes valores noturnos sejam especificados com base no número máximo de ocupantes pretendidos.

As seções a seguir abrangem 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 exibida depende de como você define os preços na mensagem de tarifa. Esta seção aborda como essas solicitações de usuários são correspondidas com suas tarifas dependendo da ocupação de seus solicitação e as tarifas definidas.

Princípios-chave

  • Uma tarifa definida para uma ocupação específica se aplica a todas as ocupações menores, salvo definição contrária.

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

  • Os preços baseados em ocupação se aplicam aos preços por data e baseados na duração da estadia. os modelos de preços 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, a tarifa para a próxima ocupação mais alta é usada. Também é possível definir cobranças para outros hóspedes e crianças 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 de tarifa, não é necessário definir uma tarifa para cada ocupação. Você pode simplificar suas mensagens definindo apenas o o maior valor de ocupação compatível com o tipo de quarto e o plano de tarifa. Os usuários verão essa tarifa para cada ocupação menor ou igual à do conjunto .

Exemplo:as tarifas para um tipo de quarto e plano de tarifa são as mesmas para ocupações de um a quatro. Use a mensagem "Tarifa" para definir uma taxa para o uma ocupação de 4 pessoas. Usuários que pesquisam quartos individuais, duplos e triplos terá a mesma taxa. Os usuários que pesquisarem 5 ou mais não vão ter acesso às tarifas.

Controle

Tarifas distintas para ocupações alternativas podem ser fornecidas explicitamente. Envie uma taxa diferente para cada valor de ocupação se quiser ter mais controle sobre como o Google combina solicitações com as taxas de ocupação.

Exemplo:se as tarifas forem definidas para as ocupações 3 e 1, apenas uma ocupação. as pesquisas vão mostrar as tarifas para solteiros, uma pesquisa por ocupações duplas mostrará a taxa de ocupação tripla, e usuários que pesquisam 4 ou mais não verão e as taxas de desempenho.

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

Elementos obrigatórios e opcionais

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

Sintaxe e esquemas

Use a sintaxe de taxa. exemplo como uma referência ao criar a mensagem "Tarifa" para garantir você está seguindo o formato correto.

Você pode usar uma ferramenta XML de terceiros, como o xmllint, para validar seus feeds com os esquemas publicados antes de enviá-los ao Google. Para a mensagem "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 na maioria das propriedades. O per-date o modelo de preços baseia-se na definição de tarifas, que são somadas nas datas de estadia para para chegar a um preço total. Neste modelo, todas as tarifas em um elemento Rate são interpretada como aplicável a um intervalo de datas de estadia especificadas no <StatusApplicationControl>.

Preços com base na estadia

O modelo de preços com base na duração da estadia se baseia nas tarifas definidas para uma data de chegada e duração da estadia. Taxas especificadas no O modelo de preços com base na estadia é por dia. Por exemplo, se você enviar uma tarifa de US$ 100 para uma duração de 3 dias, o preço total será calculado como 3 x US$ 100 = US$ 300.

Você pode fazer uso do modelo de preços com base na duração da estadia especificando RatePlanType="26" em elementos StatusApplicationControl. Você também precisa defina os atributos RateTimeUnit e UnitMultiplier nos elementos Rate da sua XML Isso faz com que todas as tarifas no elemento Rate especificado sejam aplicadas às estadias definido pelas datas de chegada especificadas em <StatusApplicationControl> e as Valor da estadia especificado para UnitMultiplier.

Você pode usar os modelos de preços por data e com base na duração da estadia em um único No entanto, cada propriedade deve usar somente um modelo de preços. Considere os seguintes pontos ao implementar a precificação baseada na LOS:

  • As tarifas para diferentes durações de estadia não são combinadas para uso com base na estadia. preços. Por exemplo, uma taxa de estadia de 3 não é combinada com uma estadia de 1 para definir o preço da estadia de 4. A taxa de estadia de 4 deve ser explicitamente especificado.
  • A tarifa de uma diária nos preços baseados na estadia não é usada como um valor de diária individual no preço por data.
  • Cada propriedade deve usar apenas preços baseados na estadia ou por data preços, dependendo de como as tarifas são representadas no sistema.

Para ativar os preços baseados na estadia na sua conta, faça a solicitação pelo seu TAM ou entre em contato conosco.

Diretrizes ou ações

Preços por data

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

  • As atualizações de taxas usam a ação Delta por padrão.
  • Uma atualização do Delta não muda as taxas armazenadas anteriormente para outros ou ocupação. Por exemplo, se você especificou tarifas para uma ou quartos com ocupação dupla e enviar uma atualização de tarifa de Delta para o quarto individual dois quartos, a tarifa de ocupação dupla não será alterada.

Overlay: exclui todas as tarifas por ocupação para o tipo de quarto. e as datas especificadas em <StatusApplicationControl>, substituindo com novas taxas. Por exemplo, se você especificou tarifas para uma ou quartos de ocupação dupla e enviar uma atualização de Overlay para ocupação única. quarto, o Google removerá todas as tarifas anteriores (individual e dupla) ocupações), e apenas a tarifa de ocupação única será mantida após a atualização.

Remove: exclui todas as tarifas por ocupação 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 taxas por valor da estadia apenas para o valor especificado combinações de tipo de quarto, plano de tarifa e datas de check-in especificadas <StatusApplicationControl>. Substitui todas as tarifas por ocupação associadas com os valores atualizados da estadia.

  • As atualizações de taxas usam a ação Delta por padrão.
  • Uma atualização do Delta não muda as taxas armazenadas anteriormente para outros períodos de permanência. Por exemplo, se você especificar taxas para a estadia 1 e 2, e enviar uma atualização de Delta para a LOS 1 e depois as tarifas por ocupação da LOS 2 permanecem inalteradas.
  • Uma atualização do Delta substitui todas as taxas por ocupação armazenadas anteriormente em a duração da estadia especificada. Por exemplo, se você especificar valores únicos e tarifas de ocupação dupla para a LOS 1 e enviar uma atualização de tarifa de Delta para a LOS 1 com apenas uma tarifa de ocupação única, a tarifa de ocupação dupla é removida.

Overlay: excluir todas as tarifas por ocupação existentes para a estadia, o quarto tipo, plano de tarifação e datas de check-in especificadas em <StatusApplicationControl> e substituí-las por novas taxas. Por exemplo, se você especificou taxas para LOS 1 e 2, e você enviar uma atualização do Overlay para a LOS 1, o Google removerá todas as tarifas anteriores (ambos LOS 1 e 2) e apenas a taxa LOS 1 permanecerá após a atualização.

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

Com relação a impostos

Se os tributos e as taxas forem simples, o valor total pode ser especificado usando AmountAfterTax: Tributos complexos, como os tributos e taxas aplicáveis por estadia (em vez de por noite) não pode ser representada 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, EUA) mostram o sem tributos por padrão.

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

Exemplo

Esta seção fornece um exemplo básico de uma mensagem de tarifação usando os atributos elementos opcionais. Depois de preparar o arquivo, é necessário 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 mensagens por push/POST, consulte Como enviar mensagens push.

Para HotelCode, utilize o ID de hotel exclusivo usado no seu sistema para identificando a propriedade. Esse valor precisa corresponder ao ID do hotel especificado <id> no elemento <listing> no Feed de lista de hotéis. Para <PackageID> e <RoomID>, use os mesmos IDs que você para uso no seu sistema para planos de tarifas e tipos de quarto (respectivamente). Consistência com seu sistema é fundamental para garantir que o Google esteja exibindo seus preços e dados.

Este exemplo mostra como definir tarifas 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 durante o envio Avalie as mensagens.

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

As diárias eram definidas apenas para ocupação dupla (que também se aplica a 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 de escopo Delta padrão. Essa nova não afeta a tarifa de ocupação 2.

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

Descrição

Você definiu tarifas para as ocupações de 1 a 4, mas agora só ocupação 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 caso, a ação Overlay 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 para um grupo com menos pessoas. Neste situação, você pode simplificar suas mensagens enviando somente 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 a maior ocupação valor compatível com o tipo de quarto e o plano de tarifa. Ele automaticamente usa esse valor para ocupações menores. Ou seja, não é preciso repetir a mesma Diária para ocupações de 1 a 6 anos se todas forem iguais; basta definir como 6.