Messaggio di disponibilità

Panoramica

Il messaggio Disponibilità (OTA_HotelAvailNotifRQ) definisce se un prodotto (tipo di camera combinato con il piano tariffario) per un determinato itinerario può essere venduto per le date applicabili. Quando invii un messaggio di disponibilità, indichi se la disponibilità o le limitazioni per un prodotto sono cambiate.

Punto chiave :l'inventario può essere aggiornato anche utilizzando il tipo di messaggio Disponibilità, ma il tipo di messaggio Inventario (OTA_HotelInvCountNotifRQ) è il metodo preferito.

Le sezioni seguenti trattano linee guida generali, un esempio di base e scenari pratici per iniziare ad aggiungere e aggiornare la disponibilità utilizzando il messaggio sulla disponibilità.

Limitazione della disponibilità notturna

Il messaggio Disponibilità ti consente di definire limitazioni che controllano la disponibilità generale di una prenotazione. Un tipo di limitazione degno di nota è la "disponibilità notturna": se il prodotto può essere venduto in una determinata data. Affinché un soggiorno (dal check-in al check-out) sia prenotabile, deve essere disponibile ogni notte in tutte le date e devono essere soddisfatte tutte le altre restrizioni relative a prenotazione e soggiorno.

Nota: per saperne di più sul concetto di disponibilità e sulle differenze tra inventario e disponibilità, consulta Inventario e disponibilità.

Impostazioni delle limitazioni

Per impostazione predefinita, RestrictionStatus per Restriction="Master" è chiuso. In altre parole, per impostazione predefinita, ogni notte viene applicato uno "stop alla vendita".

Per essere vendibile, un prodotto deve avere <RestrictionStatus Restriction="Master" Status="Open"> per tutte le combinazioni di prodotti in tutte le notti di un soggiorno. Devi inviare a Google un Open esplicito per ogni prodotto o modificare il valore predefinito in Hotel Center. Per farlo, vai alla pagina Prezzi > Impostazioni in Hotel Center e modifica il campo "Disponibilità predefinita".

Altre limitazioni

Arrivo/Partenza

Impedisce la vendita di un itinerario con arrivo o partenza nella data specificata. È Open per impostazione predefinita.

Offset minimo e massimo della prenotazione

Richiede che l'itinerario venga acquistato almeno o al massimo un determinato numero di giorni prima dell'arrivo.

Durata minima e massima del soggiorno

Limita la durata del soggiorno per gli itinerari con questa data di arrivo.

Soggiorno minimo e massimo in avanti (o "soggiorno")

Limita la durata del soggiorno per gli itinerari che includono questa data di soggiorno.

Modello di durata del soggiorno

Consente di controllare con precisione le durate del soggiorno consentite per questa data di arrivo.

Linee guida generali

• Le limitazioni di disponibilità sono identificate da hotel, data, tipo di camera e piano tariffario.

• Un prodotto è prenotabile solo se non sono state imposte limitazioni che si applicano al soggiorno (dal check-in al check-out) o al periodo in cui l'utente può prenotare il soggiorno.

• Invia a Google un aggiornamento del messaggio Disponibilità ogni volta che si verifica una modifica alle limitazioni di disponibilità del prodotto in date specifiche.

Esempio

Questa sezione fornisce un esempio di base di un messaggio di disponibilità che utilizza elementi obbligatori e facoltativi. Dopo aver preparato il file, dovrai inviarlo a Google tramite un messaggio POST a questo endpoint:

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

Per scoprire di più su come eseguire il push/POST del messaggio, consulta Push dei messaggi.

Punto chiave :invia a Google un messaggio aggiornato ogni volta che la disponibilità cambia.

Per HotelCode, utilizza l'ID hotel univoco che hai utilizzato nel tuo sistema per identificare la struttura. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> nel feed elenco hotel. La coerenza con il tuo sistema è fondamentale per garantire che Google visualizzi correttamente i tuoi dati.

Questo esempio mostra come impostare le limitazioni di disponibilità:

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

Per altri esempi, vedi la pagina degli esempi di disponibilità.

Procedure

Questa sezione fornisce soluzioni a scenari che potresti incontrare durante l'invio di messaggi di disponibilità, in particolare dettagli sulla limitazione della disponibilità notturna (nota anche come "stop sell").

Scenario 1: come vendere prodotti in date specifiche

Descrizione

Vuoi rendere disponibile la combinazione di tipo di camera e piano tariffario (prodotto) in date specifiche.

Nota :per impostazione predefinita, Google considera i prodotti con l'opzione "interrompi vendite" attiva (la disponibilità notturna è chiusa), ma puoi configurare se la limitazione della disponibilità notturna è aperta o chiusa per impostazione predefinita. Devi inviare a Google un Open esplicito per ogni prodotto o modificare l'impostazione predefinita in Hotel Center.

Soluzione

Imposta la limitazione Master su Open e specifica le date.

Esempio

Questo esempio mostra come aprire la disponibilità notturna di un prodotto per alcune settimane di marzo.

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

Nota: la limitazione della disponibilità notturna deve essere Open (e l'inventario deve essere un numero intero maggiore di 0 per la camera) per mostrare il prezzo di un prodotto.

Per ulteriori informazioni su come impostare i prezzi, consulta Risoluzione dei problemi relativi a prezzi mancanti o incompleti.

Scenario 2: come interrompere la vendita di prodotti in date specifiche

Descrizione

Vuoi interrompere esplicitamente la vendita di un prodotto (anziché esaurire l'inventario) in date specifiche.

Nota :se il prodotto è completamente disattivato perché il tipo di camera, il piano tariffario o la loro combinazione sono disattivati, è preferibile utilizzare il messaggio Transaction (Property Data) per annullare la mappatura del prodotto, poiché non dipende dalla data.

Soluzione

Imposta la limitazione Master su Close e specifica le date.

Esempio

Questo esempio mostra come "interrompere la vendita" o chiudere la disponibilità notturna di un prodotto in date specifiche.

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