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, tarifas e inventário (ARI, na sigla em inglês).

O ARI é um modo de transferência de preços que controla diárias, disponibilidade e 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.

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

Preços com base na estadia

Com os preços LOS-based, você pode especificar tarifas por data de check-in e duração da estadia, em vez de por data da estadia. Quando você especifica um elemento <StatusApplicationControl> para preços com base na duração da estadia, os atributos @Start e @End significam um intervalo de datas de check-in para as quais as tarifas de duração da estadia são válidas.

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

Para ativar os preços com base no LOS na sua conta, entre em contato com seu TAM ou fale com a gente.

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

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

  • 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 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 é obrigató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 mostrados aos usuários quando eles pesquisam suas propriedades com datas específicas de check-in e check-out e ocupação.

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

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

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