Mensagem de disponibilidade

Visão geral

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 mudaram.

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

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

Restrição de disponibilidade noturna

A mensagem de disponibilidade permite definir restrições que controlam a disponibilidade geral de uma reserva. Um tipo notável 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, é necessário ter disponibilidade de pernoite em todas as datas e atender a todas as outras restrições de reserva e estadia.

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

Configurações de restrição

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

Para ser vendável, um produto precisa ter <RestrictionStatus Restriction="Master" Status="Open"> para 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 mudar o padrão na Central para Hotéis. Para fazer 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 com chegada ou partida na data especificada. Ele é Open por padrão.

Intervalo mínimo e máximo de reserva

Exige 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 para itinerários com essa data de chegada.

Estadia mínima e máxima para frente (ou "estadia contínua")

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

Padrão de duração da estadia

Oferece controle exato sobre quais durações de estadia são permitidas para esta 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ó pode ser reservado se não houver restrições impostas que se apliquem à estadia (do check-in ao check-out) ou ao período em que o usuário pode fazer a reserva.

• 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, apresentamos um exemplo básico de uma mensagem de disponibilidade usando elementos obrigatórios e opcionais. Depois de preparar o arquivo, envie-o ao Google com uma mensagem POST para este endpoint:

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

Para saber mais sobre como enviar/POST a mensagem, consulte Envio de mensagens.

Importante: envie ao Google uma mensagem atualizada sempre que a disponibilidade mudar.

Para HotelCode, use o ID exclusivo do hotel que você usou no seu sistema para identificar a propriedade. Esse valor precisa corresponder ao ID do hotel especificado usando <id> no elemento <listing> do feed de lista de hotéis. A consistência com seu sistema é fundamental para garantir que o Google mostre 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 oferece soluções para cenários que você pode encontrar ao enviar mensagens de disponibilidade, especificamente detalhes sobre a restrição de disponibilidade noturna (também conhecida como "parar de vender").

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 se a opção "interromper venda" estivesse ativada (a disponibilidade noturna está fechada), mas é possível configurar se a restrição de disponibilidade noturna está aberta ou fechada por padrão. Você precisa enviar ao Google um Open explícito para cada produto ou mudar o padrão na Central para Hotéis.

Solução

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

Exemplo

Este exemplo 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 noturna precisa ser Open e o inventário precisa ser um número inteiro maior que 0 para o quarto. Assim, o preço de um produto será mostrado.

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

Cenário 2: como parar de vender produtos em datas específicas

Descrição

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

Observação: se o produto estiver completamente desativado porque o tipo de quarto, o plano de tarifas ou a combinação deles está desativada, é preferível usar a mensagem de 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

Este exemplo mostra como "interromper a venda" ou fechar a disponibilidade noturna de um produto em datas específicas.

<?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>