Messaggio relativo a tasse e commissioni

Panoramica

Il messaggio TaxFeeInfo definisce le tasse e le commissioni applicabili a un utente quando prenota una proprietà e in base alle normative fiscali della proprietà descritte sul sito web. Per aggiungere i dati relativi a imposte e commissioni, utilizza il messaggio Tariffa (OTA_HotelRateAmountNotifRQ).

Nota: il tipo di messaggio TaxFeeinfo è consigliato e non è obbligatorio se AmountAfterTax è specificato nel messaggio relativo alla tariffa.

L'unica azione supportata per questo messaggio è overlay, che viene utilizzata per sostituire i dati relativi a tasse e commissioni per ogni proprietà. È importante inviare aggiornamenti di tasse e commissioni ogni volta che si verificano modifiche.

Punto chiave: devi includere tutte le tasse e le commissioni che un utente deve pagare (IVA, tassa di soggiorno, tassa comunale e così via), anche se non vengono pagate al momento della prenotazione o non vengono pagate direttamente alla struttura.

Per ulteriori informazioni su come inviare tasse e commissioni, nonché sui dettagli specifici dei prezzi per le tue tariffe, consulta le norme su tasse e commissioni.

Metodi per aggiungere tasse e commissioni

Esistono due modi generali per aggiungere tasse e commissioni:

Nel primo metodo, specifichi AmountAfterTax nel messaggio Tariffa; aggiungi le tasse e le commissioni inviando messaggi Tariffa che contengono sia le tariffe base per notte (escluse tutte le tasse e le commissioni) sia le tariffe totali per notte (incluse tutte le tasse e le commissioni). Poiché queste tariffe sono giornaliere, questo approccio funziona solo per le tasse e le commissioni basate su una percentuale o per gli importi fissi giornalieri. Non è possibile utilizzare le tasse e le commissioni per soggiorno.

Il secondo metodo (preferito) consiste nell'inviare solo le tariffe base per notte escluse tasse e commissioni nei messaggi relativi alle tariffe e utilizzare TaxFeeInfo per comunicare tasse e commissioni a livello di struttura. Le tasse e le commissioni individuali possono comunque essere limitate a tipi di camera e piani tariffari specifici, applicabili a determinati intervalli di date.

Punto chiave: esiste un limite di 300 tasse e commissioni per proprietà. Puoi utilizzare il messaggio TaxFeeInfo per rimuovere tasse e commissioni da una proprietà.

Questa pagina descrive e si riferisce solo al metodo preferito di utilizzo di TaxFeeInfo e non al metodo di specifica di AmountAfterTax nel messaggio di valutazione (OTA_HotelRateAmountNotifRQ).

Metodi per impostare le imposte

Per impostare le tasse, hai a disposizione le seguenti opzioni:

• Basis = [room|person]
• Periodo = [stay|night]
• Type = [percent|amount]

Quando Period è stay e Type è percent, Google applica tasse e commissioni per l'intero soggiorno anche se una singola data dell'itinerario si sovrappone all'intervallo StayDates. Non puoi specificare l'applicazione di una tassa e di una commissione solo se TUTTE le date dell'itinerario si sovrappongono all'intervallo di date del soggiorno. Per più intervalli di date del soggiorno che si sovrappongono, gli intervalli StayDates sono specificati in un unico intervallo aperto. Fai riferimento agli esempi di TaxFeeInfo.

Per esempi di vari scenari relativi alle imposte, consulta la sezione Procedure. Gli esempi coprono alcuni degli scenari fiscali più comuni, tra cui le procedure per:

1. Tassa fissa e percentuale applicata per proprietà
2. Tassa percentuale applicata solo alle notti successive alla prima notte
3. Metodo per sostituire le vecchie tasse con quelle nuove
4. Includere o escludere le imposte per i paesi
5. Impostare l'imposta a scaglioni con parentesi
6. Impostare l'imposta e la commissione imponibile

Le sezioni seguenti trattano linee guida generali, un esempio di base e scenari pratici per iniziare ad aggiungere e aggiornare i tuoi dati fiscali.

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 TaxFeeInfo.

Sintassi e schemi

Utilizza l'esempio di TaxFeeInfosintassi come riferimento quando crei il messaggio 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 TaxFeeinfo, consulta Schemi di Hotel Ads.

Linee guida

Questa sezione illustra le linee guida comuni e le istruzioni speciali per l'impostazione di tasse e commissioni.

Azioni

Overlay

Utilizza l'azione overlay per sostituire tutte le tasse per una proprietà. L'azione overlay è l'unica supportata ed è quella predefinita. Tutte le tasse e le commissioni precedenti per questa proprietà verranno eliminate una volta applicato questo aggiornamento.

Generale

• Ogni Tax viene valutato e, se applicabile, calcolato in base all'importo AmountBeforeTax specificato in BaseByGuestAmt.

• Dopo aver calcolato tutte le tasse e le commissioni applicabili, queste vengono aggiunte al prezzo di base per formare il prezzo totale.

• La sintassi per <Tax> e <Fee> è la stessa.

• Tasse e commissioni possono avere vincoli, ad esempio:

  • Si applica solo a tipi di camere e piani tariffari specifici.
  • Si applica solo a date del soggiorno specifiche.

  Questi vincoli sono facoltativi e non devi impostare ogni tipo di vincolo; puoi lasciarli vuoti se sono applicabili a tutti.

• Invia un aggiornamento TaxFeeInfo ogni volta che vengono apportate modifiche a tasse o commissioni.

Esempio

Questa sezione fornisce un esempio di base di un messaggio TaxFeeInfo che utilizza elementi obbligatori e facoltativi. Dopo aver preparato il file, dovrai inviarlo a Google utilizzando un messaggio POST a questo endpoint:

https://www.google.com/travel/hotels/uploads/taxes

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 TaxFeeInfo aggiornato ogni volta che le tasse e le commissioni cambiano.

Per l'attributo hotel_id, 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'elemento <listing> nel feed elenco hotel. La coerenza con il tuo sistema è fondamentale per garantire che Google visualizzi correttamente i tuoi dati.

Questo esempio mostra come impostare una percentuale di imposta del 10% e un importo della commissione di 50 $per una struttura per l'intero soggiorno (non per notte):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Nota: se <Currency> non è specificato, ma <Amount> è specificato, allora il valore di <Currency> è impostato per impostazione predefinita sulla valuta del tasso base.

Per esempi di aggiunta di imposte correlate all'età e altri esempi, vedi Esempi di imposte.

Procedure

Questa sezione fornisce soluzioni a scenari che potresti incontrare durante l'impostazione di tasse e commissioni.

Scenario 1: come aggiungere un'imposta fissa

Questo esempio di imposta mostra come impostare un'imposta fissa per proprietà.

Descrizione

Vuoi applicare una tassa fissa per la camera o il soggiorno per proprietà anziché una tassa percentuale.

Soluzione

Utilizza amount anziché percentage per aggiungere l'opzione di imposta forfettaria.

Esempio

Questo esempio mostra come aggiungere un'imposta fissa utilizzando amount anziché percentage:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scenario 2: come scegliere come target le tasse utilizzando ApplicableNights

Descrizione

Vuoi applicare un'imposta a tariffa fissa solo alle notti successive alla prima. Ad esempio, è prevista una tariffa obbligatoria per l'utilizzo giornaliero di un determinato servizio che è escluso dalla prima notte, durante la quale gli ospiti non avrebbero avuto la possibilità di utilizzare quel particolare servizio.

Soluzione

Utilizza <ApplicableNights excluded="1"/> per controllare a quali notti vengono applicate le tasse.

Esempio

Questo esempio mostra come utilizzare ApplicableNights:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scenario 3: come sostituire le vecchie tasse e commissioni con quelle nuove

Descrizione

Le tasse e le commissioni attuali sono cambiate e devono essere sostituite con quelle nuove.

Soluzione

Utilizza l'azione overlay per rimuovere tutte le tasse e le commissioni esistenti.

Nota: l'azione overlay è l'azione predefinita se non specificata, il che significa che è possibile sostituire tutte le tasse e le commissioni per ogni proprietà e non è possibile aggiungere in modo incrementale nuove tasse/commissioni.

Esempio

L'esempio seguente mostra come rimuovere tutte le tasse e le tariffe per una proprietà:

    <?xml version="1.0" encoding="UTF-8"?>
    <TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
                id="12345678"
                partner="partner_key">
      <Property action="overlay">
        <ID>Property_1</ID>
      </Property>
    </TaxFeeInfo>

Scenario 4: come includere o escludere le tasse per i paesi

Descrizione

Devi includere le tasse per alcuni paesi ed escluderle per altri. Ad esempio, devi escludere le imposte per una confederazione più piccola con imposte non UE, mentre applichi le imposte a tutti gli altri paesi.

Soluzione

Utilizza le opzioni include o exclude per UserCountries type. Utilizza include per applicare l'imposta solo al paese elencato o utilizza exclude per applicare l'imposta a tutti i paesi tranne quello elencato.

Esempio

Il seguente esempio mostra come impostare le tasse per gli utenti al di fuori del paese dell'hotel (Israele):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scenario 5: come impostare l'imposta a scaglioni con parentesi

Descrizione

Vuoi aggiungere un'imposta GST con aliquote differenziate applicata in base alle tariffe per notte.

Nota: per questo scenario, utilizza Brackets (insieme di scaglioni fiscali non sovrapposti) per impostare questa opzione.

Soluzione

Per questo scenario, supponiamo che le fasce fiscali GST del paese di destinazione siano:

• Nessuna tassa se la tariffa per notte è minore o uguale a 1000.
• Tassa del 12% se la tariffa per notte è maggiore di 1000 e minore o uguale a 7500.
• Tassa del 18% se la tariffa per notte è maggiore di 7500.

Esempio

Il seguente esempio mostra come impostare un'imposta a scaglioni con parentesi:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scenario 6: come impostare tasse e commissioni imponibili

Descrizione

Vuoi aggiungere un'imposta come l'IVA e un'altra commissione di servizio applicabile anche a questa imposta.

Soluzione

Questo scenario prende in considerazione due esempi di casi d'uso di commissioni tassabili:

• Sia la tassa che la commissione imponibile sono definite come addebiti percentuali.
• L'imposta è un addebito percentuale, mentre la commissione tassabile è un importo fisso per soggiorno.

Esempi

Commissione tassabile in percentuale

Questo esempio ha un AmountBeforeTax di 100 $, un'imposta GST del 18% e una commissione di servizio aggiuntiva del 5%, il che porta la percentuale totale della commissione imponibile al 5,9% (5*1,18) e l'importo totale della tariffa a 123,90 $ [= 118 $ (18% GST) + 5,9 $ (commissione di servizio del 5,9%)].

Il seguente snippet definisce l'imposta (GST) e la commissione imponibile (addebito del servizio) come percentuali:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Tariffa imponibile come importo

Questo esempio ha un AmountBeforeTax di 100 $, un'imposta GST del 18% e una commissione forfettaria aggiuntiva di 20 $, il che porta la commissione imponibile totale a 23,60 $ (20 $*1,18) e l'importo totale della tariffa a 141,60 $ [= 118 $ (18% di GST) + 23,60 $ (20 $ di tariffa forfettaria)].

Il seguente snippet definisce l'imposta (GST) in percentuale e la commissione imponibile (commissione di servizio) come importo a tariffa fissa:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>