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
ouExtraGuestCharges
, 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 deDelta
para o quarto individual, a tarifa de ocupação dupla permanece inalterada.
- As atualizações de taxa usam a ação
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 deOverlay
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 taxaDelta
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 deDelta
para a LOS 1 com apenas uma única taxa de ocupação, a taxa de ocupação dupla será removida.
- As atualizações de taxa usam a ação
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 deOverlay
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 noAmountAfterTax
.Em geral, o Google recomenda usar
TaxFeeInfo
em vez deAmountAfterTax
.Se possível, inclua
AmountBeforeTax
(mesmo que você especifiqueAmountAfterTax
), 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.