Messaggio relativo a tasse e commissioni

Panoramica

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

L'unica azione supportata per questo messaggio è overlay, che viene utilizzata per sostituire i dati relativi a tasse e commissioni per ogni struttura. È importante inviare gli aggiornamenti di tasse e commissioni ogni volta che vengono apportate modifiche.

Per saperne di più su come inviare tasse e commissioni, nonché sui dettagli specifici dei prezzi per le tue tariffe, consulta le Norme relative a 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 Rate; aggiungi le tasse e le commissioni inviando messaggi relativi alle tariffe 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 per notte, questo approccio funziona solo per le tasse e le commissioni basate su percentuale o per gli importi fissi per notte e non è possibile utilizzare le tasse e le commissioni per soggiorno.

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

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

Metodi per impostare le tasse

Hai le seguenti opzioni per impostare le tasse:

  • Basis = [room|person]
  • Period = [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 vengono specificati in un unico intervallo aperto. Consulta gli esempi di TaxFeeInfo.

Per esempi di vari scenari relativi alle tasse, consulta le procedure. Gli esempi riguardano alcuni dei principali scenari fiscali, tra cui le procedure per:

  1. Tassa fissa e tassa percentuale applicate per struttura
  2. Tassa percentuale applicata solo alle notti successive alla prima notte
  3. Metodo per sostituire le vecchie tasse con le nuove
  4. Includere o escludere le tasse per i paesi
  5. Impostare la tassa con aliquote differenziate con scaglioni
  6. Impostare la tassa e la tariffa imponibile

Le sezioni seguenti riguardano le linee guida generali, un esempio di base e scenari di procedure per iniziare ad aggiungere e aggiornare i dati fiscali.

Elementi obbligatori e facoltativi

Il riferimento XML fornisce descrizioni degli elementi obbligatori e facoltativi. Per i dettagli su attributi ed elementi secondari, consulta TaxFeeInfo Elementi & Attributi.

Sintassi e schemi

Utilizza l'esempio di sintassi di TaxFeeInfo come riferimento quando crei il messaggio per assicurarti di seguire il formato corretto. Puoi utilizzare uno strumento XML di terze parti, ad esempio xmllint, per convalidare i feed con gli schemi pubblicati prima di inviarli a Google. Per lo schema dei messaggi 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 di una struttura. L'azione overlay è l'azione predefinita e l'unica azione supportata. Una volta applicato questo aggiornamento, tutte le tasse e le commissioni precedenti per questa struttura verranno cancellate.

Generale

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

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

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

  • Le tasse e le commissioni possono avere vincoli, ad esempio:

    • Si applicano solo a tipi di camera e piani tariffari specifici.
    • Si applicano solo a date di 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 saperne di più su come eseguire il push/POST del messaggio, consulta la sezione Eseguire il push dei messaggi.

Per l'attributo hotel_id, 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 di schede di 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 tariffa 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>

Per esempi di aggiunta di tasse correlate all'età e altri esempi, consulta Esempi di tasse.

Procedure

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

Scenario 1: come aggiungere una tassa fissa

Questo esempio di tassa mostra come impostare una tassa fissa per struttura.

Descrizione

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

Soluzione

Utilizza amount anziché percentage per aggiungere l'opzione della tassa fissa.

Esempio

Questo esempio mostra come aggiungere una tassa 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 una tariffa fissa solo alle notti successive alla prima notte. Ad esempio, è prevista una commissione obbligatoria per l'uso quotidiano di un determinato servizio escluso dalla prima notte, in cui 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 le 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.

Esempio

Il seguente esempio mostra come rimuovere tutte le tasse e le commissioni per una struttura:

    <?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 la tassa per determinati paesi ed escluderla da un altro. Ad esempio, devi escludere le tasse per una confederazione più piccola con tasse non UE, tassando tutti gli altri paesi.

Soluzione

Utilizza le opzioni include o exclude per UserCountries type. Utilizza include per applicare la tassa solo al paese elencato o utilizza exclude per applicare la tassa 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 la tassa con aliquote differenziate con scaglioni

Descrizione

Vuoi aggiungere una tassa GST con aliquote differenziate applicata in base alle tariffe per notte.

Soluzione

Per questo scenario, supponiamo che gli scaglioni d'imposta GST del paese di destinazione siano:

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

Esempio

Il seguente esempio mostra come impostare una tassa con aliquote differenziate con scaglioni:

<?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 la tassa e la commissione imponibile

Descrizione

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

Soluzione

Questo scenario considera due esempi di casi d'uso di commissioni imponibili:

  • Sia la tassa sia la commissione imponibile sono definite come addebiti percentuali.
  • La tassa è un addebito percentuale, mentre la commissione imponibile è un importo fisso per soggiorno.

Esempi

Commissione imponibile come percentuale

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

Il seguente snippet definisce la tassa (GST) e la commissione imponibile (addebito di 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>

Commissione imponibile come importo

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

Il seguente snippet definisce la tassa (GST) in percentuale e la commissione imponibile (addebito 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>