Esta página foi traduzida pela API Cloud Translation.

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 para o as datas em vigor. Ao enviar uma mensagem de Disponibilidade, você indica se a disponibilidade ou as restrições de um produto tiverem sido alteradas.

As seções a seguir abordam diretrizes gerais, um exemplo básico e instruções para começar a adicionar e atualizar a disponibilidade usando o Mensagem de disponibilidade.

Restrição de disponibilidade por noite

A mensagem de disponibilidade permite definir restrições que controlam o disponibilidade de uma reserva. Um tipo notável de restrição é "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 haver diárias disponibilidade em todas as datas, e todas as outras restrições de reserva e estadia precisam ser atendidas.

Configurações de restrição

Por padrão, RestrictionStatus para Restriction="Master" é fechado. Em outras as palavras-chave, por padrão, existe um "pare de vender" todas as noites.

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

Outras restrições

Chegada/partida: Impede a venda de um itinerário que chegue ou parta na data especificada. Ele é Open por padrão.
Compensação mínima e máxima da reserva: Exige que o itinerário seja comprado pelo menos ou no máximo um determinado número dias antes da chegada.
Duração da estadia mínima e máxima: Restringe a duração da estadia para itinerários que têm 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: Dá controle exato da duração da estadia permitida na 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 aplicáveis na estadia (do check-in ao check-out) ou quando o usuário pode reservar a estadia.
Enviar ao Google uma atualização de mensagem de disponibilidade sempre que houver uma mudança no restrições de disponibilidade do produto em datas específicas.

Exemplo

Esta seção fornece um exemplo básico de uma mensagem de disponibilidade usando os parâmetros e elementos opcionais. Depois de preparar seu arquivo, você precisará enviá-lo para Google por meio de uma mensagem POST para este endpoint:

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

Para saber mais sobre como enviar a mensagem por push/POST, consulte Push .

Para HotelCode, utilize o ID de hotel exclusivo usado no seu sistema para identificando a propriedade. Esse valor precisa corresponder ao ID do hotel especificado <id> no elemento <listing> na Feed de lista de hotéis. A consistência com o sistema é essencial para garantir O Google está exibindo 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 Disponibilidade exemplos.

Tutoriais

Esta seção fornece soluções para cenários que podem ser encontrados durante o envio Mensagens de disponibilidade, com detalhes específicos sobre a disponibilidade por noite (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.

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 alguns semanas de 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>

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

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

Descrição

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

Solução

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

Exemplo

Esse exemplo mostra como "parar de vender" ou feche a disponibilidade noturna para um produto nas 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>