Mensagem de disponibilidade

Informações gerais

A Mensagem de disponibilidade (OTA_HotelAvailNotifRQ) define se um produto (tipo de quarto combinado com plano de tarifa) para um determinado itinerário pode ser vendido nas datas aplicáveis. Ao enviar uma mensagem de disponibilidade, você indica se a disponibilidade ou as restrições de um produto foram alteradas.

Importante :o inventário também pode ser atualizado usando o tipo de mensagem de disponibilidade, mas o tipo de mensagem de inventário (OTA_HotelInvCountNotifRQ) é o método preferido.

As seções a seguir abrangem diretrizes gerais, um exemplo básico e cenários de instruções para você começar a adicionar e atualizar a disponibilidade usando a mensagem de disponibilidade.

Restrição de disponibilidade por noite

Com a Mensagem de disponibilidade, é possível definir restrições que controlam a disponibilidade geral de uma reserva. Um tipo importante de restrição é a "disponibilidade noturna": se o produto pode ser vendido em uma data específica. Para que uma estadia (do check-in ao check-out) possa ser reservada, é preciso ter disponibilidade por noite em todas as datas, e todas as outras restrições de reserva e estadia precisam ser atendidas.

Observação :para mais informações sobre o conceito de disponibilidade e as diferenças entre inventário e disponibilidade, consulte Inventário versus disponibilidade.

Configurações de restrição

Por padrão, o RestrictionStatus para Restriction="Master" fica fechado. Em outras palavras, por padrão, há um "interromper venda" todas as noites.

Para ser vendido, um produto precisa ter <RestrictionStatus Restriction="Master" Status="Open"> em todas as combinações de produtos em todas as noites de uma estadia. É necessário enviar ao Google um Open explícito para cada produto ou alterar o padrão na Central para Hotéis. Para isso, acesse a página Preços > Configurações na Central para Hotéis e edite o campo "Disponibilidade padrão".

Outras restrições

Chegada/partida

Impede a venda de um itinerário de chegada ou partida na data especificada. É Open por padrão.

Tempo até a reserva mínimo e máximo

Requer que o itinerário seja comprado pelo menos ou no máximo um determinado número de dias antes da chegada.

Duração mínima e máxima da estadia

Restringe a duração da estadia de itinerários com essa data de chegada.

Estadia mínima e máxima (ou "Estadia")

Restringe a duração da estadia de itinerários que contêm essa data de estadia.

Padrão de duração da estadia

Permite controlar exatamente qual é a duração da estadia permitida para essa data de chegada.

Diretrizes gerais

• As restrições de disponibilidade são definidas por hotel, data, tipo de quarto e plano de tarifa.

• Um produto só poderá ser reservado se não houver restrições impostas aplicáveis à estadia (do check-in ao check-out) ou quando o usuário puder reservá-la.

• Envie ao Google uma atualização de mensagem de disponibilidade sempre que houver uma mudança nas restrições de disponibilidade do produto em datas específicas.

Exemplo

Nesta seção, mostramos um exemplo básico de uma mensagem de disponibilidade que usa elementos obrigatórios e opcionais. Depois de preparar o arquivo, será necessário enviá-lo ao Google por uma mensagem POST para este endpoint:

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

Para saber mais sobre como enviar/POSTar a mensagem, consulte Como enviar mensagens.

Importante :envie uma mensagem atualizada ao Google sempre que houver mudanças na disponibilidade.

Para HotelCode, use o ID exclusivo do hotel utilizado no sistema para identificar a propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> no feed de lista de hotéis. A consistência com seu sistema é fundamental para garantir que o Google exiba seus dados corretamente.

Este exemplo mostra como definir restrições de disponibilidade:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

Para mais exemplos, consulte Exemplos de disponibilidade.

Tutoriais

Esta seção fornece soluções para cenários que você pode encontrar ao enviar Mensagens de disponibilidade, especificamente detalhes sobre a restrição de disponibilidade à noite (também conhecida como "interrupção de vendas").

Cenário 1: como vender produtos em datas específicas

Descrição

Você quer disponibilizar a combinação de tipo de quarto e plano de tarifa (produto) em datas específicas.

Observação: por padrão, o Google trata os produtos como tendo a opção "Interromper venda" ativada (a disponibilidade por noite está fechada), mas você pode configurar se a restrição de disponibilidade noite será aberta ou fechada por padrão. É necessário enviar ao Google um Open explícito para cada produto ou alterar o padrão na Central para Hotéis.

Solução

Defina a restrição Master como Open e especifique as datas.

Exemplo

Esta amostra mostra como abrir a disponibilidade noturna de um produto por algumas semanas em março.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Observação :a restrição de disponibilidade por noite precisa ser Open (e o inventário precisa ser um número inteiro maior que 0 para o quarto) para mostrar o preço de um produto.

Para mais informações sobre como definir preços, consulte Solução de problemas de preços ausentes ou incompletos.

Cenário 2: como interromper a venda de produtos em datas específicas

Descrição

Você quer explicitamente interromper a venda de um produto (em vez de ficar sem inventário) em datas específicas.

Observação: se o produto estiver completamente desativado, porque o tipo de quarto, o plano de tarifa ou a combinação deles estiverem desativados, é recomendável usar a mensagem Transação (dados da propriedade) para remover o mapeamento do produto, já que ele não depende da data.

Solução

Defina a restrição Master como Close e especifique as datas.

Exemplo

Esta amostra mostra como "interromper a venda" ou fechar a disponibilidade noturna de um produto em datas especificadas.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>