Messaggio tariffa

Panoramica

Il messaggio Tariffa (OTA_HotelRateAmountNotifRQ) definisce le tariffe per il numero di notti per ogni combinazione di tipo di camera e piano tariffario per intervalli di date specifici. Nell'ambito del messaggio Tariffa, Google supporta prezzi basati sul numero di persone, consentendo di specificare diverse tariffe per notte in base al numero massimo di persone previste.

Le sezioni seguenti illustrano linee guida generali, un esempio di base e scenari di istruzioni per iniziare ad aggiungere e aggiornare tariffe e a inviare un messaggio tariffario.

Comportamento del tasso di corrispondenza

Poiché gli utenti richiedono un numero di persone specifico, la tariffa visualizzata dipende da come vengono definiti i prezzi nel messaggio relativo alle tariffe. Questa sezione spiega come le richieste degli utenti vengono associate alle tue tariffe in base al numero di persone della richiesta e le tariffe che definisci.

Principi chiave

  • Una tariffa definita per un numero specifico di persone si applica a tutte le sistemazioni con un numero di persone minore, se non diversamente definito.

  • Le richieste relative al numero di persone al di sopra di quelle definite sono considerate non possibili.

  • I prezzi basati sul numero di persone si applicano sia ai prezzi per data sia ai modelli di prezzi basati sulla lunghezza del soggiorno descritti di seguito. Ciò significa che puoi specificare le tariffe per ogni persona. Se non esiste una tariffa per un numero di persone specifico, viene utilizzata quella relativa al numero più alto di persone successivo. Puoi anche definire degli addebiti per altri ospiti e bambini utilizzando AdditionalGuestAmounts o ExtraGuestCharges che viene applicato fino alla capacità definita per una camera.

Vantaggi ed esempi

Efficienza

Nel caso di più numeri con lo stesso importo della tariffa, non è necessario impostare una tariffa per ogni numero. Puoi semplificare i messaggi impostando solo il valore per il numero di persone più alto supportato dal tipo di camera e dal piano tariffario. Gli utenti vedranno quella tariffa per ogni numero di persone inferiore o uguale al valore impostato.

Esempio: le tariffe di un tipo di camera e di un piano tariffario sono le stesse per il numero di persone da uno a quattro. Utilizza il messaggio Tariffa per impostare una tariffa per il numero massimo di 4 persone. Gli utenti che cercano una, due o tre persone vedranno la stessa tariffa. Gli utenti che cercano 5 e più non vedranno le tariffe.

Controlli

Le tariffe distinte per il numero di persone alternative possono essere fornite esplicitamente. Invia una tariffa diversa per ogni valore del numero di persone se vuoi un maggiore controllo su come Google abbina le richieste alle tariffe.

Esempio: se vengono definite le tariffe per il numero di persone 3 e 1, le ricerche per una sola persona mostreranno la tariffa per singole persone, una ricerca per due persone mostrerà la tariffa per tre persone e gli utenti che cercano un numero di persone da 4 in su non visualizzeranno le tariffe.

Per altri esempi di vari scenari relativi alle tariffe, consulta le istruzioni.

Elementi obbligatori e facoltativi

Il campo Riferimento XML fornisce descrizioni degli elementi obbligatori e facoltativi. Per maggiori dettagli su attributi ed elementi secondari, consulta la sezione 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 utilizzare 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 relativi alle tariffe, consulta gli schemi di Hotel Ads.

Modelli di prezzo

Prezzi per data

Si tratta del modello di determinazione del prezzo standard utilizzato per la maggior parte delle strutture. Il modello di determinazione del prezzo per-date si basa sull'impostazione delle tariffe che vengono sommate per le date del soggiorno per arrivare a un prezzo totale. In questo modello, tutte le tariffe all'interno di un elemento Rate vengono interpretate come applicabili a un intervallo di date del soggiorno specificato in <StatusApplicationControl>.

Prezzi basati sulla lunghezza del soggiorno

Il modello di prezzi basato sulla durata del soggiorno si basa sulle tariffe impostate per una combinazione di data di arrivo e durata del soggiorno. Le tariffe specificate nel modello di prezzi basato su LS sono su base giornaliera. Ad esempio, se invii una tariffa di 100 $per una durata di un soggiorno di 3 persone, il prezzo totale viene calcolato come 3x100$=300 $.

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

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

  • Le tariffe per durate diverse del soggiorno non sono combinate se si utilizzano i prezzi basati sulla lunghezza del soggiorno. Ad esempio, una tariffa per la lunghezza del soggiorno pari a 3 non viene combinata con una durata del soggiorno pari a 1 per ottenere una tariffa della durata di 4. La tariffa LOS pari a 4 deve essere specificata esplicitamente.
  • La tariffa di 1 notte nei prezzi basati sulla lunghezza del soggiorno non viene utilizzata come tariffa per notte individuale nei prezzi per data.
  • Ogni proprietà deve utilizzare solo prezzi basati sulla lunghezza del soggiorno o prezzi per data, a seconda di come le tariffe sono rappresentate nel tuo sistema.

Per abilitare i prezzi basati sulla lunghezza del soggiorno sul tuo account, presenta la richiesta tramite il 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 specifiche 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 altri persone. Ad esempio, se hai specificato tariffe per camere a una o due persone e invii un aggiornamento della tariffa di Delta per la camera singola, la tariffa per due persone 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 tariffe per camere a una o due persone e invii un aggiornamento di Overlay per una camera singola, Google rimuoverà tutte le tariffe precedenti (sia per una persona che per due persone) e dopo l'aggiornamento rimarrà solo la tariffa per una persona.

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 lunghezza del soggiorno

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

  • Gli aggiornamenti delle tariffe utilizzano l'azione Delta per impostazione predefinita.
  • Un aggiornamento di Delta non modifica le tariffe memorizzate in precedenza per altre durata 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 LOS 2 per numero di persone rimangono invariate.
  • Un aggiornamento di Delta sovrascrive tutte le tariffe in base al numero di persone memorizzate in precedenza per la durata del soggiorno specificata. Ad esempio, se hai specificato tariffe per un singolo e doppio per LOS 1 e invii un aggiornamento della tariffa di Delta per LOS 1 con una sola tariffa per il numero di persone, questa viene rimossa.

Overlay: elimina tutte le tariffe esistenti in base al numero di persone per 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 di Overlay per LOS 1, Google rimuoverà tutte le tariffe precedenti (entrambe le tariffe per LOS 1 e 2) e rimarrà solo la tariffa per LOS 1 dopo l'aggiornamento.

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

Fiscale

Se le tasse e le commissioni sono semplici, l'importo totale può essere specificato utilizzando AmountAfterTax. In AmountAfterTax non è possibile rappresentare tasse complesse, come quelle applicabili a soggiorno e non a notte.

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

Se possibile, devi includere AmountBeforeTax (anche se specifichi AmountAfterTax) poiché determinate località (ad esempio gli 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 pagate direttamente alla proprietà.

Esempio

Questa sezione fornisce un esempio base di un messaggio tariffario 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, vedi Push dei messaggi.

Per HotelCode, utilizza l'ID hotel univoco che hai utilizzato all'interno del tuo sistema per identificare la proprietà. Questo valore deve corrispondere all'ID hotel specificato utilizzando <id> nell'elemento <listing> del feed elenco hotel. Per <PackageID> e <RoomID>, utilizza (rispettivamente) gli stessi ID che utilizzi all'interno del tuo sistema per i piani tariffari e i tipi di camera. La coerenza con il sistema è fondamentale per garantire che Google mostri correttamente i prezzi e i 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 agli scenari che potresti riscontrare durante l'invio di messaggi relativi alle tariffe.

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

Scenario 1: come modificare il prezzo in base al numero di persone

Descrizione

Le tariffe per notte erano precedentemente definite solo per due persone (e si applica anche a una persona), ma ora è disponibile una tariffa più bassa per le singole persone.

Soluzione

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

Scenario 2: come sostituire le tariffe in base al numero di persone di una proprietà

Descrizione

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

Soluzione

Utilizza NotifType="Overlay" per sostituire tutte le tariffe relative al numero di persone per una proprietà, un tipo di camera, un piano tariffario e una data/e specifici. In questo scenario, l'azione Overlay elencherebbe le tariffe per le fasce di numero di persone 1 e 2.

Scenario 3: come impostare la stessa tariffa per più numeri

Descrizione

La tariffa per un determinato numero di persone può essere venduta a un gruppo con meno persone. In questo scenario, puoi semplificare i messaggi inviando solo l'aggiornamento della tariffa per il numero massimo applicabile.

Soluzione

Se hai lo stesso prezzo per più persone, imposta il valore per il numero di persone più alto supportato dal tipo di camera e dal piano tariffario. Questo valore verrà utilizzato automaticamente per il numero di persone più basso. Ciò significa che non è necessario ripetere la stessa tariffa per notte per un numero di persone da 1 a 6 persone; è sufficiente impostarla per 6 persone.