Messaggio inventario

Panoramica

Il messaggio di inventario (OTA_HotelInvCountNotifRQ) definisce il conteggio dell'inventario (numero di stanze fisiche) disponibili per la prenotazione per una camera specifica di testo. Quando invii un messaggio di inventario, devi indicare il numero delle stanze sono disponibili in una determinata data. Se non sono disponibili stanze di questo tipo, i prodotti relativi a quel tipo di camera e a quella data non verranno visualizzati.

Le seguenti sezioni trattano le linee guida generali, un esempio di base e le procedure per iniziare ad aggiungere e aggiornare l'inventario e a inviare Messaggi di inventario.

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

Elementi obbligatori e facoltativi

Il riferimento XML fornisce le descrizioni degli elementi obbligatori e facoltativi. Per maggiori dettagli sugli attributi e sugli elementi secondari, consulta la sezione Elementi dello spazio pubblicitario e attributi.

Sintassi e schemi

Utilizza la scheda Inventario di esempio riferimento al momento della creazione del messaggio di inventario per assicurarti di seguire è nel 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 l'inventario consulta la sezione Schemi di Hotel Ads.

Linee guida

Attieniti alle seguenti linee guida per un messaggio di inventario:

• L'inventario è suddiviso per hotel, data e tipo di camera.

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

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

• Per essere valido, CountType deve avere sempre il valore 2 perché indica un conteggio della "disponibilità definita".

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

di Gemini Advanced.

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

Confronto tra inventario e disponibilità

L'inventario è il numero di stanze prenotabili in base al conteggio fisico e la disponibilità indica se la combinazione di tipo di camera e piano tariffario è possono essere prenotati. Per il feed ARI, la disponibilità e l'inventario possono variare in base per un gruppo di date o tipo di alloggio ed entrambi hanno le tipi di messaggi. Inventario e disponibilità sono suddivise per hotel, data e camera tipo, con l'aggiunta di un piano tariffario per la disponibilità.

Potrebbe esserci "nessuna disponibilità" anche se esiste un inventario e disponibilità sono indipendenti l'uno dall'altro.

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

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

Nota: se una camera è esaurita, tutti i piani tariffari associati a quella camera possono non saranno più venduti.

Esempio

Questa sezione fornisce un esempio base di messaggio Inventory che utilizza 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 Pushing messaggi.

Punto chiave: invia a Google un messaggio aggiornato sull'inventario ogni volta che il tuo inventario modifiche, ad esempio quando si verificano prenotazioni e cancellazioni.

Per HotelCode, utilizza l'ID hotel univoco usato nel sistema per che identifica la proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> in <listing> nel Feed elenco hotel. Per <RoomID>, utilizza lo stesso ID utilizzato nel sistema per tipi di camera. La coerenza con il sistema è fondamentale per garantire che Google mostra correttamente i tuoi 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 stanze 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 Inventario esempi.

Procedure

Questa sezione illustra uno scenario che potresti riscontrare durante l'invio di una Messaggio di inventario.

Scenario: come bloccare la prenotazione delle stanze

Descrizione

Devi indicare che non ci sono stanze rimanenti che possono essere prenotate questo tipo di camera in un determinato gruppo di date, spesso perché esauriti.

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 es. le prime settimane di gennaio).

Nota: se il numero di inventario per una camera è 0 per qualsiasi notte di un soggiorno, non è possibile prenotare il soggiorno 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>