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à indicate sul sito web. Per aggiungere dati su tasse e commissioni, utilizza il messaggio Tariffa (OTA_HotelRateAmountNotifRQ).

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

L'unica azione supportata per questo messaggio è overlay, che viene utilizzata per sostituire i dati su tasse e commissioni per ogni proprietà. È importante inviare aggiornamenti su tasse e commissioni in caso di modifiche.

Punto chiave: devi includere tutte le tasse e le commissioni che un utente deve pagare (IVA, tasse di soggiorno, tasse comunali e così via), anche se non sono state pagate al momento della prenotazione o non verranno corrisposte direttamente alla proprietà.

Metodi per aggiungere tasse e commissioni

Esistono due modi generali per aggiungere tasse e commissioni: nel primo metodo, devi specificare AmountAfterTax nel messaggio Tariffa e aggiungere le tasse e le commissioni inviando messaggi relativi alle tariffe che contengono sia le tariffe per notte di base (escluse tutte le tasse/commissioni) sia il totale delle tariffe per notte (incluse tutte le tasse/commissioni). Poiché queste tariffe sono per notte, questo approccio funziona solo per tasse/commissioni basate su percentuale o importi forfettari per notte e non è possibile utilizzare tasse/commissioni per soggiorno.

Il secondo metodo (preferito) prevede l'invio solo di tariffe per notte di base con tasse o commissioni nei messaggi relativi alle tariffe e l'utilizzo di TaxFeeInfo per indicare le tasse e le commissioni a livello di proprietà. Le singole tasse/commissioni possono comunque essere limitate a tipi di camera e piani tariffari specifici e/o applicabili a determinati intervalli di date.

Nota: questa pagina descrive e fa riferimento solo al metodo preferito di utilizzo di TaxFeeInfo e non al metodo per specificare AmountAfterTax nel messaggio Tariffa (OTA_HotelRateAmountNotifRQ).

Metodi per impostare le imposte

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

• Base = [stanza|persona]
• Ciclo = [soggiorno|notte]
• Tipo = [percent|amount]

Se il valore del campo Periodo è stay e Tipo è percent, Google applica tasse/commissioni per l'intero soggiorno, anche se una singola data nell'itinerario si sovrappone all'intervallo StayDates. Non puoi specificare l'applicazione di una tassa o commissione solo se TUTTE le date dell'itinerario si sovrappongono all'intervallo di date del soggiorno.

Per esempi di vari scenari di natura fiscale, consulta le istruzioni. Gli esempi riguardano alcuni dei principali scenari fiscali, incluse le istruzioni per:

• Imposta percentuale
• Imposta fissa applicata per proprietà
• Imposta percentuale applicata solo alle notti successive alla prima notte
• Metodo per sostituire le imposte precedenti con quelle nuove
• Includere o escludere le tasse per i paesi
• Imposta imposta slab con parentesi
• Imposta tasse e commissioni imponibili

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

Elementi obbligatori e facoltativi

Il riferimento XML fornisce le descrizioni degli elementi obbligatori e facoltativi. Per maggiori dettagli su attributi ed elementi secondari, consulta Elementi e attributi di TaxFeeInfo.

Sintassi e schemi

Utilizza l'esempio di sintassi TaxFeeInfo 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 dei messaggi TaxFeeinfo, consulta Schemi di Hotel Ads.

Linee guida

Questa sezione illustra le linee guida comuni e le istruzioni speciali per la definizione di tasse e commissioni.

Azioni

Overlay

Utilizza l'azione overlay per sostituire tutte le tasse di una proprietà. L'azione overlay è l'azione predefinita e l'unica azione supportata. Eventuali tasse e commissioni precedenti per questa proprietà verranno cancellate dopo l'applicazione di questo aggiornamento.

Generale

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

• Dopo aver calcolato tutte le tasse e 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 limitazioni, ad esempio:

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

  Questi vincoli sono facoltativi e non è necessario impostare tutti i tipi di vincolo; puoi lasciarli vuoti se sono applicabili a tutti.

• Invia un aggiornamento di TaxFeeInfo ogni volta che viene apportata una modifica 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 tramite 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 tasse e commissioni cambiano.

Per l'attributo hotel_id, utilizza l'ID hotel univoco utilizzato nel tuo sistema per identificare la proprietà. 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 visualizzi correttamente i dati.

Questo esempio mostra come impostare una percentuale fiscale 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>

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

Procedure

Questa sezione fornisce soluzioni per scenari che potrebbero verificarsi durante l'impostazione di tasse e commissioni.

Scenario 1: come aggiungere un'imposta fissa

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

Descrizione

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

Soluzione

Utilizza amount anziché percentage per aggiungere l'opzione di 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 il target delle imposte utilizzando ApplicableNights

Descrizione

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

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 la versione precedente con nuove tasse e commissioni

Descrizione

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

Soluzione

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

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

Esempio

Il seguente esempio mostra come rimuovere tutte le tasse/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 l'imposta applicabile per determinati paesi ed escluderla da altri. Ad esempio, è necessario escludere le imposte per una confederazione più piccola, con imposte non UE, e applicare le imposte in tutti gli altri paesi.

Soluzione

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

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 slab utilizzando le parentesi

Descrizione

Vuoi aggiungere un'imposta GST a slab applicata in base alle tariffe per notte.

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

Soluzione

Per questo scenario, supponi che gli scaglioni di imposta GST del paese di destinazione siano:

• Nessuna imposta 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 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 definire tasse e commissioni imponibili

Descrizione

Vuoi aggiungere un'imposta, ad esempio l'IVA, e un'altra commissione di servizio da applicare a questa imposta.

Soluzione

Questo scenario prende in considerazione due esempi di utilizzo delle imposte imponibili:

• Sia le imposte che le imposte imponibili sono definite come addebiti percentuali.
• La tassa è una percentuale, mentre la tariffa imponibile è un importo fisso per soggiorno.

Esempi

Commissione imponibile in percentuale

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

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

Commissione imponibile come importo

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

Lo snippet seguente definisce l'imposta (GST) in percentuale e la commissione imponibile (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>