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 abordam diretrizes gerais, um exemplo básico e instruções para começar a adicionar e atualizar taxas e enviar uma Classifique a mensagem.
Comportamento da taxa de correspondência
À medida que os usuários solicitam ocupações específicas, a tarifa exibida depende como você define os preços em sua mensagem de tarifação. 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. Você também pode definir cobranças por convidados 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 de tarifa, não é necessário definir um 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. Enviar uma tarifa diferente para cada valor de ocupação se quiser mais controle sobre O Google faz a correspondência entre as solicitações e 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-filho, consulte Elementos de taxa 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 taxa de US $100 para uma duração da estadia de 3, o preço total será calculado como 3xUS$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 preços com base na duração da estadia:
- 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 deDelta
para o quarto individual dois quartos, a tarifa de ocupação dupla não será alterada.
- As atualizações de taxas usam a ação
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 deOverlay
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 deDelta
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 deDelta
para a LOS 1 com apenas uma tarifa de ocupação única, a tarifa de ocupação dupla é removida.
- As atualizações de taxas usam a ação
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 doOverlay
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 emAmountAfterTax
.Em geral, o Google recomenda usar
TaxFeeInfo
em vez deAmountAfterTax
.Se possível, inclua
AmountBeforeTax
(mesmo que você especifiqueAmountAfterTax
), 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 ver exemplos de como adicionar, remover e atualizar taxas, consulte Taxa Exemplos.
Cenário 1: como mudar o preço por ocupação
Descrição
As tarifas por noite foram definidas anteriormente para apenas um quarto duplo (o que também é válido para ocupação única, mas a tarifa é mais barata para uma pessoa. ocupação.
Solução
Envie a nova tarifa de ocupação 1 usando a atualização padrão com escopo Delta
. 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.