Valuta messaggio

Panoramica

Il messaggio Tariffa (OTA_HotelRateAmountNotifRQ) definisce le tariffe di occupazione notturna per ogni combinazione di tipo di camera e piano tariffario per intervalli di date specifici. Nell'ambito del messaggio relativo alla tariffa, Google supporta i prezzi basati sull'occupazione, consentendo di specificare tariffe per notte diverse in base al numero massimo di occupanti previsto.

Le sezioni seguenti trattano linee guida generali, un esempio di base e scenari pratici per iniziare ad aggiungere e aggiornare le tariffe e inviare un messaggio relativo alle tariffe.

Comportamento del tasso di corrispondenza

Quando gli utenti richiedono occupazioni specifiche, la tariffa visualizzata dipende da come definisci i prezzi nel messaggio Tariffe. Questa sezione illustra come queste richieste degli utenti vengono abbinate alle tue tariffe in base all'occupazione della richiesta e alle tariffe che definisci.

Principi chiave

  • Una tariffa definita per un'occupazione specifica si applica a tutte le occupazioni inferiori, se non diversamente definito.

  • Le richieste di occupazione superiori a quelle definite non sono considerate possibili.

  • I prezzi basati sull'occupazione si applicano sia ai modelli di prezzo per data sia a quelli basati sulla durata del soggiorno descritti di seguito. Ciò significa che puoi specificare le tariffe per ogni occupazione. Se non esiste una tariffa per un'occupazione specifica, viene utilizzata la tariffa per l'occupazione successiva più alta. Puoi anche definire addebiti per ospiti e bambini aggiuntivi utilizzando AdditionalGuestAmounts o ExtraGuestCharges, che viene applicato fino alla capacità definita per una camera.

Vantaggi ed esempi

Efficienza

Per più occupazioni con lo stesso importo della tariffa, non è necessario impostare una tariffa per ogni occupazione. Puoi semplificare i messaggi impostando solo il valore di occupazione più elevato supportato dal tipo di camera e dal piano tariffario. Gli utenti vedranno questa tariffa per ogni occupazione inferiore o uguale al valore che hai impostato.

Esempio: le tariffe per un tipo di camera e un piano tariffario sono le stesse per occupazioni da una a quattro persone. Utilizza il messaggio Rate per impostare una tariffa per l'occupazione massima di 4 persone. Gli utenti che cercano una, due o tre persone vedranno la stessa tariffa. Gli utenti che cercano 5 o più stelle non vedranno le tariffe.

Controllo

È possibile fornire tariffe distinte per occupazioni alternative in modo esplicito. Invia una tariffa diversa per ogni valore di occupazione se vuoi avere un maggiore controllo sul modo in cui Google associa le richieste alle tariffe di occupazione.

Esempio: se le tariffe sono definite per 3 e 1 persone, le ricerche per una persona mostreranno la tariffa per una persona, una ricerca per due persone mostrerà la tariffa per tre persone e gli utenti che cercano per 4 o più persone non vedranno le tariffe.

Per altri esempi di vari scenari relativi alle tariffe, consulta la sezione Procedure.

Elementi obbligatori e facoltativi

Il documento XML Reference fornisce le descrizioni degli elementi obbligatori e facoltativi. Per informazioni dettagliate sugli attributi e sugli elementi secondari, consulta Elementi e attributi della tariffa.

Sintassi e schemi

Utilizza l'esempio di sintassi della tariffa come riferimento quando crei il messaggio relativo alla tariffa 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 Tariffa, consulta Schemi di Hotel Ads.

Modelli di prezzo

Prezzi per data

Questo è il modello di prezzo standard utilizzato per la maggior parte delle proprietà. Il modello di prezzi per-date si basa sull'impostazione di tariffe che vengono sommate in base alle date del soggiorno per ottenere un prezzo totale. In questo modello, tutte le tariffe nell'elemento Rate vengono interpretate come applicabili a un intervallo di date del soggiorno specificato in <StatusApplicationControl>.

Prezzi basati sulla durata del soggiorno

Il modello di prezzi basato sulla durata del soggiorno si basa sulle tariffe stabilite per una combinazione di data di arrivo e durata del soggiorno. Le tariffe specificate nel modello di determinazione del prezzo basato sulla lunghezza del soggiorno sono giornaliere. Ad esempio, se invii una tariffa di 100 € per una durata del soggiorno di 3 giorni, il prezzo totale viene calcolato come 3 x 100 €=300 €.

Puoi utilizzare il modello dei prezzi basato sulla durata del soggiorno specificando RatePlanType="26" negli elementi StatusApplicationControl. Devi anche impostare gli attributi RateTimeUnit e UnitMultiplier sugli elementi Rate nel tuo XML. In questo modo, tutte le tariffe nell'elemento Rate specificato si applicano ai soggiorni definiti dalle date di arrivo specificate in <StatusApplicationControl> e dal valore di durata del soggiorno specificato per UnitMultiplier.

Puoi utilizzare entrambi i modelli di prezzo basati sulla data e sulla durata del soggiorno in un unico account, tuttavia ogni proprietà deve utilizzare un solo modello di prezzo. Quando implementi i prezzi basati sulla durata del soggiorno, tieni presente quanto segue:

  • Le tariffe per durate diverse del soggiorno non vengono combinate quando si utilizza la tariffazione basata sulla lunghezza del soggiorno. Ad esempio, una tariffa per durata del soggiorno di 3 non viene combinata con una durata del soggiorno di 1 per calcolare il prezzo di una tariffa per durata del soggiorno di 4. La tariffa per la durata del soggiorno di 4 deve essere specificata in modo esplicito.
  • La tariffa per una notte nella determinazione del prezzo basata sulla durata del soggiorno non viene utilizzata come tariffa per notte individuale nella determinazione del prezzo per data.
  • Ogni proprietà deve utilizzare solo i prezzi basati sulla lunghezza del soggiorno o i prezzi per data, a seconda di come vengono rappresentate le tariffe nel tuo sistema.

Per attivare i prezzi basati sulla durata del soggiorno nel tuo account, invia la richiesta tramite il tuo TAM o contattaci.

Linee guida o azioni

Prezzi per data

Delta: aggiungi o aggiorna le tariffe in base al numero di persone solo per le combinazioni specificate di tipo di camera, piano tariffario e date del soggiorno specificate in <StatusApplicationControl>.

  • Gli aggiornamenti delle tariffe utilizzano l'azione Delta per impostazione predefinita.
  • Un aggiornamento di Delta non modifica le tariffe memorizzate in precedenza per altre occupazioni. Ad esempio, se hai specificato le tariffe per le camere singole e doppie e invii un aggiornamento della tariffa Delta per la camera singola, la tariffa per la camera doppia rimane invariata.

Overlay: elimina tutte le tariffe esistenti in base al numero di persone per tipo di camera, piano tariffario e date specificate in <StatusApplicationControl> e sostituiscile con nuove tariffe. Ad esempio, se hai specificato le tariffe per le camere singole e doppie e invii un aggiornamento Overlay per la camera singola, Google rimuoverà tutte le tariffe precedenti (sia per le camere singole che per quelle doppie) e dopo l'aggiornamento rimarrà solo la tariffa per la camera singola.

Remove: elimina tutte le tariffe esistenti in base al numero di persone per tipo di camera, piano tariffario e date specificate in <StatusApplicationControl>.

Prezzi basati sulla durata del soggiorno

Delta: aggiungi o aggiorna le tariffe per valore di durata del soggiorno solo per le combinazioni specificate di tipo di camera, piano tariffario e date di check-in specificate in <StatusApplicationControl>. Sostituisce tutte le tariffe per occupazione associate ai valori di durata del soggiorno aggiornati.

  • Gli aggiornamenti delle tariffe utilizzano l'azione Delta per impostazione predefinita.
  • Un aggiornamento Delta non modifica le tariffe precedentemente memorizzate per altre durate del soggiorno. Ad esempio, se hai specificato le tariffe per LOS 1 e 2 e invii un aggiornamento della tariffa Delta per LOS 1, le tariffe per occupazione di LOS 2 rimangono invariate.
  • Un aggiornamento Delta sovrascrive tutte le tariffe per occupazione memorizzate in precedenza per la durata del soggiorno specificata. Ad esempio, se hai specificato le tariffe per una e due persone per la durata del soggiorno 1 e invii un aggiornamento della tariffa Delta per la durata del soggiorno 1 con una sola tariffa per una persona, la tariffa per due persone viene rimossa.

Overlay: elimina tutte le tariffe esistenti in base al numero di persone per durata del soggiorno, tipo di camera, piano tariffario e date di check-in specificate in <StatusApplicationControl> e sostituiscile con nuove tariffe. Ad esempio, se hai specificato tariffe per LOS 1 e 2 e invii un aggiornamento Overlay per LOS 1, Google rimuoverà tutte le tariffe precedenti (sia LOS 1 che 2) e dopo l'aggiornamento rimarrà solo la tariffa LOS 1.

Remove: elimina tutte le tariffe esistenti in base al numero di persone per tutte le durate del soggiorno del tipo di camera, del piano tariffario e delle date di check-in specificate in <StatusApplicationControl>.

Relativi alle imposte

Se le tasse e le commissioni sono semplici, l'importo totale può essere specificato utilizzando AmountAfterTax. Le tasse complesse, ad esempio quelle che si applicano per soggiorno (anziché per notte), non possono essere rappresentate in AmountAfterTax.

In generale, Google consiglia di utilizzare TaxFeeInfo anziché AmountAfterTax.

Se possibile, devi includere AmountBeforeTax (anche se specifichi AmountAfterTax), poiché alcune impostazioni internazionali (ad esempio, Stati Uniti) mostrano il prezzo al lordo delle imposte per impostazione predefinita.

Tutte le tasse e le commissioni che un utente deve pagare (IVA, tassa di soggiorno, spese di pulizia, tassa comunale e così via) devono essere incluse, anche se non vengono pagate al momento della prenotazione o non vengono pagate direttamente alla struttura.

Esempio

Questa sezione fornisce un esempio di base di un messaggio Tariffa che utilizza elementi obbligatori e facoltativi. Dopo aver preparato il file, devi inviarlo a Google utilizzando un messaggio POST al seguente endpoint: https://www.google.com/travel/hotels/uploads/property_data

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 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. Per <PackageID> e <RoomID>, utilizza gli stessi ID che utilizzi nel tuo sistema per i piani tariffari e i tipi di camera (rispettivamente). La coerenza con il tuo sistema è fondamentale per garantire che Google mostri correttamente i tuoi prezzi e i tuoi dati.

Questo esempio mostra come impostare le tariffe utilizzando un'azione Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Procedure

Questa sezione fornisce soluzioni a scenari che potresti incontrare durante l'invio di messaggi di valutazione.

Per esempi su come aggiungere, rimuovere e aggiornare le tariffe, consulta Esempi di tariffe.

Scenario 1: come modificare i prezzi per occupazione

Descrizione

In precedenza, le tariffe per notte erano definite solo per l'occupazione doppia (che si applica anche all'occupazione singola), ma ora esiste una tariffa più economica per l'occupazione singola.

Soluzione

Invia la nuova tariffa per una persona utilizzando l'aggiornamento con ambito Delta predefinito. Questo nuovo valore non influisce sulla tariffa per occupazione 2.

Scenario 2: come sostituire le tariffe per occupazione per una proprietà

Descrizione

In precedenza hai definito le tariffe per le occupazioni da 1 a 4, ma ora sono valide solo le occupazioni 1 e 2.

Soluzione

Utilizza NotifType="Overlay" per sostituire tutte le tariffe in base al numero di persone per una determinata proprietà, tipo di camera, piano tariffario e data o date. In questo scenario, l'azione Overlay elencherebbe le tariffe per le occupazioni 1 e 2.

Scenario 3: come impostare la stessa tariffa per più valori di numero di persone

Descrizione

Una tariffa per una determinata occupazione può essere venduta a un gruppo con meno persone. In questo scenario, puoi semplificare i tuoi messaggi inviando solo l'aggiornamento della tariffa per l'occupazione massima applicabile.

Soluzione

Se hai lo stesso prezzo per più occupazioni, imposta il valore di occupazione più alto supportato dal tipo di camera e dal piano tariffario, che verrà utilizzato automaticamente per le occupazioni inferiori. ovvero non è necessario ripetere la stessa tariffa notturna per le occupazioni da 1 a 6 se sono tutte uguali; è sufficiente impostarla per 6.