Messaggio sull'inventario

Panoramica

Il messaggio Inventario (OTA_HotelInvCountNotifRQ) definisce i conteggi dell'inventario (numero di camere fisiche) che possono essere prenotate per tipi di camera specifici. Quando invii un messaggio di inventario, indichi quante camere di quel tipo sono disponibili in una determinata data. Se non sono disponibili stanze di quel tipo, i prodotti che includono quel tipo di stanza e quella data non verranno visualizzati.

Le sezioni seguenti trattano linee guida generali, un esempio di base e scenari pratici per iniziare ad aggiungere e aggiornare l'inventario e inviare messaggi di inventario.

Per esempi di vari scenari relativi all'inventario, consulta la sezione Procedure.

Elementi obbligatori e facoltativi

Il riferimento XML fornisce descrizioni degli elementi obbligatori e facoltativi. Per informazioni dettagliate sugli attributi e sugli elementi secondari, vedi Elementi e attributi dell'inventario.

Sintassi e schemi

Utilizza l'esempio di sintassi dell'inventario come riferimento quando crei il messaggio dell'inventario per assicurarti di seguire il formato corretto.

Puoi utilizzare uno strumento XML di terze parti come xmllint per convalidare i tuoi feed con gli schemi pubblicati prima di inviarli a Google. Per lo schema del messaggio Inventario, consulta Schemi di Hotel Ads.

Linee guida

Segui queste indicazioni per un messaggio Inventory:

• L'inventario è organizzato in base a hotel, data e tipo di camera.

• Il conteggio dell'inventario deve essere superiore a 0 per tutte le notti del soggiorno per mostrare il prezzo per il piano tariffario e l'occupazione associati.

• Se il conteggio dell'inventario è uguale a 0, le camere non saranno disponibili per la prenotazione per l'ID camera e l'intervallo di date specificati.

• CountType deve sempre avere il valore 2 per essere valido, in quanto indica un conteggio di "disponibilità certa".

• Invia l'inventario aggiornato ogni volta che nel tuo sistema si verifica una prenotazione o una cancellazione di una camera.

Nota: invia i conteggi dell'inventario delle camere utilizzando OTA_HotelInvCountNotifRQ (metodo consigliato) o il metodo alternativo che utilizza l'attributo <BookingLimit> del messaggio OTA_HotelAvailNotifRQ.

Inventario e disponibilità

L'inventario è il numero di camere prenotabili in base al conteggio fisico e la disponibilità indica se la combinazione di tipo di camera e piano tariffario può essere prenotata. Per l'ARI, la disponibilità e l'inventario possono variare in base a un insieme di date o al tipo di struttura ricettiva ed entrambi hanno tipi di messaggio corrispondenti. L'inventario e la disponibilità sono identificati in base a hotel, data e tipo di camera, con l'aggiunta del piano tariffario per la disponibilità.

Può verificarsi una situazione di "nessuna disponibilità" anche quando è presente inventario, poiché inventario e disponibilità sono indipendenti l'uno dall'altro.

Esistono due concetti di disponibilità. Innanzitutto, c'è la disponibilità complessiva di un prodotto per un determinato soggiorno, che è influenzata da fattori quali se ogni notte ha una tariffa definita, l'inventario per il tipo di camera associato e se la limitazione della disponibilità è aperta. In secondo luogo, esiste la restrizione specifica per un prodotto in una determinata data, rappresentata da <RestrictionStatus Restriction="Master" Status="Open"/> in OTA_HotelAvailNotifRQ, e la chiusura di questa disponibilità è nota come "stop alla vendita".

L'inventario deve essere un numero intero maggiore di 0 per la camera e la limitazione della disponibilità deve essere aperta per mostrare il prezzo di un prodotto.

Nota: se una camera è esaurita, i piani tariffari associati non possono più essere venduti.

Esempio

Questa sezione fornisce un esempio di base di un messaggio di inventario 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_inv_count_notif

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

Punto chiave :invia a Google un messaggio di inventario aggiornato ogni volta che l'inventario cambia, ad esempio quando si verificano prenotazioni e cancellazioni.

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

Nota: <CountType=2> è l'unica opzione valida, in quanto indica un conteggio di "disponibilità certa".

Questo esempio mostra come impostare l'inventario per 13 camere prenotabili per il mese di dicembre:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Per altri esempi, consulta la sezione Esempi di inventario.

Procedure

Questa sezione fornisce uno scenario che potresti incontrare durante l'invio di un messaggio di inventario.

Scenario: come impedire la prenotazione delle stanze

Descrizione

Devi indicare che non sono rimaste camere prenotabili per questo tipo di camera in un insieme specifico di date, in genere perché sono esaurite.

Soluzione

Imposta <InvCount Count> su un valore 0 e aggiungi l'intervallo di date che ti interessa.

Esempio

Questo esempio mostra come utilizzare InvCount per impostare l'inventario su 0 per la camera e le date specificate (ad esempio, le prime settimane di gennaio).

Nota: se il conteggio dell'inventario per una camera è 0 per una notte del soggiorno, il soggiorno non può essere prenotato per nessun prodotto associato a quella camera.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>