Messaggio relativo a tasse e commissioni

Panoramica

Il messaggio TaxFeeInfo definisce le tasse e le commissioni applicabili a un utente al momento della prenotazione di una proprietà e in base alle normative fiscali della proprietà delineate sul sito web. Per aggiungere i dati sulle tasse e sulle commissioni, utilizza il messaggio Rate (OTA_HotelRateAmountNotifRQ).

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

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

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

Metodi per aggiungere tasse e commissioni

Esistono due modi generali per aggiungere tasse e commissioni:

Nel primo metodo, specifichi AmountAfterTax nel messaggio Tariffa e aggiungi le tasse e le commissioni inviando messaggi Tariffa contenenti 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 tasse e commissioni su base percentuale o per importi fissi per notte e non è possibile utilizzare tasse e commissioni per soggiorno.

Il secondo metodo (preferito) consiste nell'inviare solo le tariffe notturne di base esclusive di tasse e commissioni nei messaggi sulle tariffe e nell'utilizzare TaxFeeInfo per trasmettere le tasse e le commissioni a livello di proprietà. Le singole tasse e commissioni possono comunque essere limitate a tipi di camere 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 le tasse e le commissioni da una proprietà.

Questa pagina descrive e fa riferimento solo al metodo preferito per l'utilizzo di TaxFeeInfo e non al metodo per specificare AmountAfterTax nel messaggio di valutazione (OTA_HotelRateAmountNotifRQ).

Metodi per impostare le imposte

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

• Basis = [room|person]
• Periodo = [soggiorno|notte]
• Tipo = [percentuale|importo]

Se il periodo è stay e il tipo è 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 nell'itinerario si sovrappongono all'intervallo di date del soggiorno.

Per esempi di vari scenari relativi alle imposte, consulta la sezione Istruzioni. Gli esempi coprono alcuni dei principali scenari fiscali, tra cui le istruzioni per:

• Imposta percentuale
• Imposta fissa applicata per proprietà
• Imposta percentuale applicata solo alle notti successive alla prima
• Metodo per sostituire le tasse precedenti con quelle nuove
• Includi o escludi le imposte per i paesi
• Impostare l'imposta a scaglioni con parentesi
• Impostare l'imposta e la commissione soggetta a imposta

Le seguenti sezioni illustrano le linee guida generali, un esempio di base e gli scenari illustrativi 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 maggiori dettagli sugli attributi e sugli elementi secondari, consulta Elementi e attributi di TaxFeeInfo.

Sintassi e schemi

Utilizza l'esempio di TaxFeeInfo sintassi 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 imposte e commissioni.

Azioni

Overlay

Utilizza l'azione overlay per sostituire tutte le imposte di una proprietà. L'azione overlay è predefinita e l'unica supportata. Eventuali tasse e 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.

• Una volta calcolate, tutte le imposte e le commissioni applicabili vengono aggiunte al prezzo di 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 applica solo a tipi di camere e piani tariffari specifici.
  • Si applica solo a date di soggiorno specifiche.

  Questi vincoli sono facoltativi e non è necessario impostare ogni tipo di vincolo. Puoi lasciarli vuoti se sono applicabili a tutti.

• Invia un aggiornamento TaxFeeInfo ogni volta che si verifica una variazione di tasse o commissioni.

Esempio

Questa sezione fornisce un esempio base di messaggio TaxFeeInfo che utilizza elementi obbligatori e facoltativi. Una volta 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 inviare/pubblicare il messaggio, consulta Inviare messaggi.

Punto chiave: invia a Google un messaggio TaxFeeInfo aggiornato ogni volta che le imposte e le commissioni cambiano.

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> del feed elenco hotel. La coerenza con il sistema è fondamentale per garantire che Google mostri correttamente i tuoi dati.

Questo esempio mostra come impostare una percentuale di tasse del 10% e un importo di commissione di 50 $ per una proprietà per il soggiorno totale (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 è specificato <Amount>, il valore di <Currency> predefinito è la valuta del tasso di base.

Per esempi di aggiunta di imposte correlate all'età e altri esempi, consulta la sezione Esempi di imposte.

Procedure

Questa sezione fornisce soluzioni per gli scenari che potresti riscontrare durante l'impostazione di imposte 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 ogni proprietà anziché una tassa percentuale.

Soluzione

Utilizza amount anziché percentage per aggiungere l'opzione relativa all'imposta fissa.

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 imposte utilizzando ApplicableNights

Descrizione

Vuoi applicare una tassa sulla tariffa fissa solo alle notti successive alla prima. Ad esempio, è prevista una tariffa obbligatoria per l'utilizzo giornaliero di un determinato servizio, che viene esclusa dalla prima notte, quando l'ospite non avrebbe avuto la possibilità di utilizzare quel particolare comfort.

Soluzione

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

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 attuali tasse e commissioni sono cambiate e devono essere sostituite con nuove.

Soluzione

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

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

Esempio

L'esempio seguente mostra come rimuovere tutte le tasse e le commissioni 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 imposte per determinati paesi ed escluderle in un altro. Ad esempio, devi escludere le imposte per una confederazione più piccola con imposte non UE, applicando invece 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 indicato o exclude per applicarla a tutti i paesi tranne quello indicato.

Esempio

Il seguente esempio mostra come impostare le imposte 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 le 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 aliquote fiscali non sovrapposte) per impostare questa opzione.

Soluzione

Per questo scenario, supponiamo che le fasce di imposta 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 è superiore a 7500.

Esempio

L'esempio seguente mostra come impostare un'imposta slab tra 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 le tasse e le commissioni soggette a tassazione

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 casi d'uso di esempio delle commissioni soggette a tassazione:

• Sia l'imposta sia la tariffa soggetta a imposta sono definite come addebiti percentuali.
• L'imposta è un addebito percentuale, mentre la tariffa tassabile è un importo fisso per soggiorno.

Esempi

Commissione imponibile in percentuale

In questo esempio, AmountBeforeTax è pari a 100 $, l'imposta GST è pari al 18% e la commissione di servizio aggiuntiva è pari al 5%, pertanto la percentuale totale delle commissioni imponibili è pari al 5,9% (5 * 1,18) e l'importo totale della tariffa è pari a 123,90 $ [= 118 $ (18% di GST) + 5,9 $ (commissione di servizio del 5,9%)].

Il seguente snippet definisce l'imposta (GST) e la tariffa tassabile (commissione 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>

Imponibile come importo

In questo esempio, AmountBeforeTax è pari a 100 $, l'imposta GST è del 18% e la commissione aggiuntiva a tariffa fissa è di 20 $. Di conseguenza, la commissione tassabile totale è pari a 23,60 $ (20 $ * 1,18) e l'importo totale della tariffa è pari a 141,60 $ [= 118 $ (18% di GST) + 23,60 $ (tariffa fissa di 20 $)].

Lo snippet seguente definisce l'imposta (GST) in percentuale e la commissione tassabile (commissione di servizio) come importo fisso:

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