Visão geral do ARI

A disponibilidade, as tarifas e o inventário (ARI) são um modo de transferência de preços que controla as diárias, a disponibilidade e o inventário, além de fornecer restrições sobre como eles podem ser combinados. A ARI também oferece flexibilidade para incluir tributos, taxas e promoções.

Ao contrário dos modos de entrega de preços baseados em itinerários, preços pull e alterados, os feeds da ARI não são consultados para preços ou itinerários específicos. Em vez disso, envie mensagens quando seu modelo de preços tiver dados novos ou alterados, como mudanças nos detalhes das tarifas, restrições e disponibilidade.

Vantagens

A ARI oferece os seguintes benefícios:

  • Eficiência da largura de banda: aumenta a eficiência da largura de banda ao reduzir o volume de dados que precisam ser transmitidos. Ao enviar dados do ARI todas as noites e apenas mudanças incrementais, o Google pode calcular preços e atualizações para uma ampla variedade de valores de compra antecipada e duração da estadia.

  • Nível de precisão do preço: melhora o nível de precisão do preço usando um modelo de evento de envio por mudança para fornecer atualizações em tempo real.

  • Maior cobertura de preços: alcança uma cobertura de preços mais alta (número de itinerários com preços) usando dados granulares combinados em vários itinerários.

  • Flexibilidade: permite mais flexibilidade ao oferecer promoções e pacotes.

  • Facilidade de uso: transmite dados de uma forma alinhada com a maneira como eles são armazenados no seu sistema, evitando a necessidade de calcular ou armazenar em cache os preços de muitos itinerários.

Tipos de mensagens de solicitação

As mensagens da ARI enviadas ao Google são chamadas de mensagens de "solicitação" da ARI. O Google retorna mensagens de "resposta" indicando sucesso ou falha.

O ARI segue os protocolos padrão de OpenTravel Alliance (OTA) para alguns dos principais tipos de mensagens de definição de disponibilidade e inventário.

A ARI usa as seguintes mensagens de solicitação:

  • Transaction (dados da propriedade). Define o tipo de quarto e as informações do pacote (plano de tarifa).

  • OTA_HotelRateAmountNotifRQ. Define os valores da taxa de ocupação por data ou com base na duração da estadia por produto (tipo de quarto e combinação de plano de tarifas) para intervalos de datas específicos.

  • OTA_HotelAvailNotifRQ. Define a disponibilidade e as restrições com base no tipo de quarto e nos planos de tarifas. O inventário também pode ser atualizado usando essa mensagem, mas OTA_HotelInvCountNotifRQ é preferível.

  • OTA_HotelInvCountNotifRQ. Define o inventário de quartos físicos ou o número de quartos disponíveis para venda.

  • TaxFeeInfo. (Opcional) Define tributos e taxas por propriedade. Essa mensagem não é necessária se AmountAfterTax estiver especificado na mensagem OTA_HotelRateAmountNotifRQ.

  • Promotions. (Opcional) Define tarifas promocionais para determinadas reservas, estadias e usuários.

  • RateModifications. (Opcional) Define regras de modificação de tarifa para determinadas reservas, estadias e usuários.

  • ExtraGuestCharges. (Opcional) Define como as tarifas devem ser configuradas para crianças e adultos extras.

Cada mensagem contém um subconjunto de informações que o Google usa para calcular os preços e a disponibilidade mostrados aos usuários quando eles pesquisam suas propriedades com datas específicas de check-in e check-out e ocupação desejada.

Para mais informações sobre a ARI, consulte a referência XML.

Mensagens push

Para atualizar o ARI e as informações da propriedade, envie as mensagens associadas sempre que os dados mudarem no seu sistema.

Siga estas diretrizes ao enviar mensagens:

  • Use a ferramenta de autoatendimento na página "Configurações de preços da Central para Hotéis" para adicionar ou atualizar seus endereços IP no nosso sistema.

  • Use o seguinte caminho de base para o endpoint:

    • https://www.google.com ou Host: www.google.com Port: 443

  • Envie mensagens usando o método HTTP POST.

  • Defina o cabeçalho Content-Type como application/xml.

  • Há uma taxa máxima de atualização no nível da conta de 400 mensagens por segundo. Se você exceder esse limite, um código de erro 6032 será retornado.

  • Use os caminhos a seguir, dependendo dos dados que estão sendo atualizados:

    • Transaction (dados da propriedade): /travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ: /travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ: /travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ: /travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo: /travel/hotels/uploads/taxes
    • Promotions: /travel/hotels/uploads/promotions
    • RateModifications: /travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

Para cada mensagem de solicitação recebida, o Google vai responder com um HTTP 200 OK se a conexão com o servidor for bem-sucedida e incluir um corpo com uma mensagem de resposta indicando se as atualizações foram aplicadas corretamente ou se encontraram avisos ou erros. Se o Google responder com um código de erro HTTP, reenvie a mensagem. Se o corpo da resposta HTTP contiver avisos ou erros, eles deverão ser corrigidos antes de reenviar a mensagem. Você também pode conferir os problemas encontrados em mensagens específicas na página "Status do feed" da Central para Hotéis.

Publicação ativa no Google (LoG)

Com o Live on Google (LoG), você pode mostrar seus hotéis nos sites do Google. Como o valor padrão de LoG para um hotel é true, todos os novos hotéis serão mostrados automaticamente no Google.

Use o LoG para ativar e desativar as propriedades nos anúncios e links sem custo financeiro para reserva na sua conta da Central para Hotéis, não importa o status do Google Ads ou se a propriedade tem tarifas no Google.

Há duas maneiras de definir o valor de LoG de um hotel: o Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

Para mais detalhes sobre o LoG, consulte a Ajuda da Central para Hotéis.

Como usar o Travel Partner API, you can do the following:

  • Confira o status das suas propriedades na Central para Hotéis ou use o endpoint hotelViews.list.

  • Recupere uma lista de todos os seus hotéis exibidos no Google usando o parâmetro filter com liveOnGoogle = TRUE no endpoint hotelViews.list.

  • Receba um resumo das propriedades de uma conta específica, incluindo o número de propriedades ativas no Google, usando hotelViews.summary.

Para mais informações sobre como definir o LoG usando a API, consulte o artigo hotelViews.list e a referência da API.