Messaggio di disponibilità

Panoramica

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

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

Limitazione disponibilità notturna

Il messaggio Disponibilità consente di definire limitazioni che controllano la disponibilità complessiva di una prenotazione. Un tipo degno di limitazione è la "disponibilità notturna", ovvero se il prodotto può essere venduto in una data specifica. Affinché un soggiorno (dal check-in al check-out) sia prenotabile, deve essere presente una disponibilità a notte in tutte le date e devono essere rispettate tutte le altre limitazioni relative a prenotazioni e soggiorno.

Impostazioni delle limitazioni

Per impostazione predefinita, RestrictionStatus per Restriction="Master" è chiuso. In altre parole, per impostazione predefinita, c'è un "interrompi vendita" ogni notte.

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

Altre limitazioni

Arrivo/partenza
Impedisce che la vendita di un itinerario arrivi o parte nella data specificata. Il valore predefinito è Open.
Compensazione minima e massima della prenotazione
Richiede che l'itinerario venga acquistato almeno o al massimo un determinato numero di giorni prima dell'arrivo.
Durata del soggiorno minima e massima
Limita la durata del soggiorno per gli itinerari con questa data di arrivo.
Soggiorno minimo e massimo in avanti (o "resta attraverso")
Limita la durata del soggiorno per gli itinerari che contengono questa data del soggiorno.
Pattern di durata del soggiorno
Offre il controllo esatto delle durate del soggiorno consentite per la data di arrivo.

Linee guida generali

  • I limiti di disponibilità si basano su hotel, data, tipo di camera e piano tariffario.

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

  • Invia a Google un aggiornamento del messaggio di disponibilità ogni volta che viene apportata una modifica alle limitazioni di disponibilità per il prodotto in date specifiche.

Esempio

Questa sezione fornisce un esempio 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 la sezione Push dei messaggi.

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

Questo esempio mostra come impostare 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, consulta gli esempi di disponibilità.

Procedure

Questa sezione fornisce soluzioni agli scenari che potrebbero verificarsi durante l'invio di messaggi sulla disponibilità, in particolare dettagli sui limiti di disponibilità notturna (chiamati anche "interrompi vendita").

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.

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 nel mese 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>

Per saperne di più su come impostare i prezzi, consulta la sezione Risolvere i problemi relativi ai prezzi mancanti o incompleti.

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

Descrizione

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

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 nelle date specificate.

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