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 taxas noturnas, a disponibilidade e o inventário, além de fornecer 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ário, preços pull e alterados, os feeds ARI não são consultados para 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 de taxas, restrições e disponibilidade.

Vantagens

O ARI oferece os seguintes benefícios:

  • Eficiência da largura de banda: aumenta a eficiência da largura de banda, reduzindo o volume de dados que precisa ser transmitido. Ao enviar dados ARI por noite 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 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 combinados em vários itinerários.

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

  • Facilidade de uso: transmite dados de forma alinhada com a 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 mensagem de solicitação

As mensagens de ARI enviadas ao Google são chamadas de mensagens de "solicitação" ARI. Consequentemente, 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 para definir a disponibilidade e o inventário.

O 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 (combinação de tipo de quarto e plano de tarifas) 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 esta mensagem, mas é preferível usar OTA_HotelInvCountNotifRQ.

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

  • TaxFeeInfo (opcional). Define tributos e taxas por propriedade. Essa mensagem não é obrigatória se AmountAfterTax for especificado na mensagem OTA_HotelRateAmountNotifRQ.

  • Promotions (opcional). Define taxas promocionais para determinados usuários, estadias e reservas.

  • 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 ocupação desejada.

Para mais informações sobre 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 forem alterados no sistema.

Siga estas diretrizes 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 em 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 de atualização máxima no nível da conta de 400 mensagens por segundo. Se você exceder esse limite, será retornado um código de erro 6032.

  • 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 incluirá um corpo com uma mensagem de resposta indicando se as atualizações foram aplicadas corretamente ou se foram encontrados 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 do reenvio da mensagem. Você também pode conferir os problemas encontrados em mensagens específicas na página "Status do feed" na Central para Hotéis.

Publicação ativa no Google (LoG)

O recurso "Ao vivo no Google" (LoG, na sigla em inglês) permite exibir seus hotéis em sites do Google. Como o valor padrão do LoG de um hotel é true, todos os novos hotéis serão exibidos automaticamente no Google.

Use a LoG para ativar e desativar suas propriedades em anúncios e links sem custo financeiro para reserva na sua conta da Central para Hotéis, seja qual for o status do Google Ads ou se a propriedade tem tarifas no Google. Isso se aplica apenas a hotéis, e não 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 hotéis mostrados no Google usando o parâmetro filter com liveOnGoogle = TRUE no endpoint hotelViews.list.

  • Use hotelViews.summary para ver 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 LoG usando a API, consulte o artigo hotelViews.list e a Referência da API.