Visão geral do ARI

"Disponibilidade, taxas e inventário" (ARI, na sigla em inglês) é um modo de transferência de preços que controla as diárias, a disponibilidade e o inventário, além de impor restrições sobre como eles podem ser combinados. O ARI também oferece flexibilidade para incluir tributos, taxas e promoções.

Ao contrário dos modos de entrega de preços com base em itinerários, os preços pull e alterados, os feeds de ARI não são consultados em busca de preços ou itinerários específicos. Em vez disso, você envia mensagens quando o modelo de preços tem dados novos ou alterados, como alterações nos detalhes, restrições e disponibilidade das taxas.

Vantagens

O ARI oferece os seguintes benefícios:

  • Eficiência de largura de banda: aumenta a eficiência da largura de banda ao reduzir o volume de dados que precisam ser transmitidos. Ao enviar dados 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.

  • 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: usa dados granulares combinados em vários itinerários para alcançar uma cobertura de preço maior (número de itinerários com preços).

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

  • Facilidade de uso: transmite dados de maneira alinhada com o armazenamento 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 de ARI enviadas ao Google são chamadas de mensagens de "solicitação" de ARI. Posteriormente, 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 a disponibilidade e o inventário.

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

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

  • OTA_HotelRateAmountNotifRQ. Define os valores da taxa de ocupação por data ou com base em LOS por produto (combinação de tipo de quarto e plano de tarifa) para períodos específicos.

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

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

  • TaxFeeInfo (opcional): define tributos e taxas por propriedade. Essa mensagem não será necessária se AmountAfterTax for especificado na mensagem OTA_HotelRateAmountNotifRQ.

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

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

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

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 específicas de check-in e check-out e a ocupação desejada.

Para saber mais sobre o 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 de configurações de preço da Central para Hotéis para adicionar ou atualizar seus endereços IP no nosso sistema.

  • Use o caminho base a seguir 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.

  • A taxa de atualização máxima 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 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 responderá com um HTTP 200 OK se a conexão com o servidor for bem-sucedida e vai incluir um corpo com uma mensagem de resposta indicando se as atualizações foram aplicadas 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 precisarão ser corrigidos antes de reenviar a mensagem. Você também pode ver 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 recurso Publicação ativa no Google (LoG, na sigla em inglês), você pode mostrar seus hotéis nos sites do Google. Como o valor padrão da LoG para um hotel é true, todos os novos hotéis vão aparecer automaticamente no Google.

Use a LoG para ativar e desativar as propriedades em 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. Isso se aplica apenas a hotéis, e não a aluguéis por temporada.

Há duas maneiras de definir o valor da 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 saber mais sobre como definir o LoG usando a API, consulte o artigo hotelViews.list e a Referência da API.