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