Referência XML de disponibilidade, taxas e inventário (ARI)

Este guia de referência XML fornece conteúdo de referência detalhado e exemplos de código para as diferentes mensagens, elementos e atributos disponíveis para feeds de disponibilidade, taxas e inventário (ARI, na sigla em inglês).

O ARI é um modo de transferência de preços que controla as tarifas, a disponibilidade e o inventário por noite, 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.

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

Preços com base na estadia

O preço de LOS-based permite especificar tarifas por data de check-in e duração da estadia, em vez de data por estadia. Quando você especifica um elemento <StatusApplicationControl> para preços com base em LOS, os atributos @Start e @End significam um intervalo de datas de check-in a que as taxas de LOS se aplicam.

Embora não haja mais tarifas por noite ao usar os preços com base na estadia, todos os outros recursos de ARI (inventário, disponibilidade, regras, promoções etc.) ainda podem ser aplicados a essas tarifas e são especificados por noite. Isso significa que, se os sistemas estiverem mais alinhados com um sistema de preços baseado em LOS, você ainda poderá aproveitar o conjunto avançado de recursos de ARI, além da eficiência de largura de banda concedida com o uso das atualizações noturnas de disponibilidade e restrição.

Para ativar os preços com base em estadia na sua conta, fale com seu Gerente técnico de contas ou fale conosco.

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

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

  • 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 é preferível usar OTA_HotelInvCountNotifRQ.

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

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

  • Promotions (opcional). Define taxas 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 de check-in e check-out e ocupação específicas.

Histórico de revisões da referência XML do ARI

A tabela a seguir lista as atualizações da documentação somente para mudanças de recursos.

Data Mudou
14 de agosto de 2020 Versão inicial.
21 de outubro de 2020 O tipo de mensagem "Promoções" foi adicionado.
17 de novembro de 2020 Para mensagens de transações (dados de propriedade), atualizamos o endpoint e adicionamos o atributo action aos elementos dePropertyDataSet.
24 de novembro de 2020 Para mensagens de transações (dados da propriedade), foram adicionados os elementos <AllowablePackageIDs> e <AllowableRoomIDs>.
4 de fevereiro de 2021 Mensagens de resposta adicionadas.
25 de fevereiro de 2021 Adição de OTA_HotelInvCountNotifRQ
21 de outubro de 2020 Adicionado o tipo de mensagem "Modificações de tarifa".