Messaggio inventario

Panoramica

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

Le seguenti sezioni descrivono le linee guida generali, un esempio di base e gli scenari pratici per iniziare ad aggiungere e aggiornare l'inventario e a inviare i messaggi relativi all'inventario.

Per esempi di vari scenari relativi all'inventario, consulta le istruzioni.

Elementi obbligatori e facoltativi

Il riferimento XML fornisce le descrizioni degli elementi obbligatori e facoltativi. Per informazioni dettagliate su attributi ed elementi secondari, consulta la sezione Elementi e attributi dello spazio pubblicitario.

Sintassi e schemi

Utilizza l'esempio di sintassi dell'inventario come riferimento quando crei il messaggio di Inventory 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 dei messaggi di inventario, consulta Schemi di Hotel Ads.

Linee guida

Utilizza le seguenti linee guida per un messaggio Inventory:

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

• Per mostrare il prezzo del piano tariffario e del numero di persone associati, il conteggio dell'inventario deve essere maggiore di 0 per tutte le notti del soggiorno.

• 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 avere sempre il valore 2 per essere valido poiché indica un conteggio di "disponibilità definita".

• Invia l'inventario aggiornato ogni volta che nel tuo sistema ha luogo una prenotazione o un annullamento per una camera.

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

Confronto tra inventario e disponibilità

L'inventario è il numero di camere prenotabili in base al conteggio fisico e la disponibilità indica se è possibile prenotare la combinazione di tipo di camera e piano tariffario. Per il feed ARI, la disponibilità e l'inventario possono variare in base a un insieme di date o al tipo di alloggio ed entrambi hanno tipi di messaggi corrispondenti. L'inventario e la disponibilità vengono determinati in base all'hotel, alla data e al tipo di camera, con l'aggiunta del piano tariffario in base alla disponibilità.

Non ci può essere "nessuna disponibilità" anche in presenza di inventario, dato che quest'ultimo è indipendente 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, ad esempio, se ogni notte ha una tariffa definita, l'inventario per il tipo di camera associato e la limitazione della disponibilità è aperta. In secondo luogo, esiste la limitazione 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 "interrompi vendita".

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

Nota: se una camera è esaurita, gli eventuali piani tariffari associati a quella camera non potranno più essere venduti.

Esempio

Questa sezione fornisce un esempio di base di un messaggio di Inventory utilizzando 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 la sezione Push dei messaggi.

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

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. Per <RoomID>, utilizza lo stesso ID utilizzato nell'impianto per i tipi di camera. La coerenza con il sistema è fondamentale per garantire che Google visualizzi correttamente i dati.

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

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 ulteriori esempi, consulta gli esempi di inventario.

Procedure

Questa sezione fornisce uno scenario che potresti riscontrare durante l'invio di un messaggio di Inventory.

Scenario: come bloccare la prenotazione di stanze

Descrizione

Devi indicare che non ci sono stanze rimanenti che possono essere prenotate per questo tipo di camera in un insieme specifico di date, solitamente perché sono esaurite.

Soluzione

Imposti <InvCount Count> su un valore 0 e aggiungi l'intervallo di date desiderato.

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 numero dell'inventario di una camera è 0 per una qualsiasi notte di un soggiorno, il soggiorno non può essere prenotato per nessun prodotto associato alla 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>