Visão geral do ARI

O modo de transferência de preços para inventário, tarifas e disponibilidade (ARI) controla as tarifas por diária, a disponibilidade e o inventário, além de fornecer restrições sobre como elas podem ser combinadas. O ARI também oferece flexibilidade para incluir impostos, 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 de ARI não são consultados para preços ou itinerários específicos. Em vez disso, envie mensagens quando o modelo de preços tiver dados novos ou alterados, como mudanças nos detalhes de tarifas, restrições e disponibilidade.

Vantagens

O ARI oferece os seguintes benefícios:

  • Eficiência de largura de banda: aumenta a eficiência da largura de banda reduzindo o volume de dados que precisam ser transmitidos. Ao enviar dados diários de ARI e somente mudanças incrementais, o Google pode calcular preços e atualizações para uma ampla gama 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 push-on-change para fornecer atualizações em tempo real.

  • Maior cobertura de preços: alcança uma cobertura de preços maior (número de itinerários com preços) usando dados granulares que são combinados em vários itinerários.

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

  • Facilidade de uso: transmite dados de maneira alinhada à forma como eles são armazenados no 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 ARI enviadas ao Google são chamadas de mensagens de "solicitação". O Google retornará 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 para definir 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 de ocupação por data ou por LOS por produto (combinação de tipo de quarto e plano de diárias) para períodos 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 é a opção preferida.

  • OTA_HotelInvCountNotifRQ: define o inventário físico de quartos ou o número de quartos disponíveis para venda.

  • TaxFeeInfo. (Opcional) Define os tributos e as taxas por propriedade. Essa mensagem não é necessária se AmountAfterTax for 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 adicionais.

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

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

Mensagens push

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

Siga as diretrizes a seguir ao enviar mensagens:

  • Use a ferramenta de autoatendimento na página de 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 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 de 400 mensagens por segundo no nível da conta. Se você exceder esse limite, um código de erro 6032 será retornado.

  • Use os seguintes caminhos, 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 ou se houve 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 precisarão ser corrigidos antes de reenviar a mensagem. Também é possível conferir problemas encontrados para mensagens específicas na página "Status do feed" da Central para Hotéis.

Publicação ativa no Google (LoG)

Com o recurso "No ar no Google" (LoG, na sigla em inglês), 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 exibidos automaticamente no Google.

Use a Publicação ativa no Google 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.

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

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

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