Steuer- und Gebührenmitteilung

Übersicht

In der TaxFeeInfo-Nachricht werden die Steuern und Gebühren definiert, die für einen Nutzer bei der Buchung einer Unterkunft gelten. Sie basieren auf den Steuervorschriften der Unterkunft, die auf der Website aufgeführt sind. Verwenden Sie die Preismitteilung (OTA_HotelRateAmountNotifRQ), um Steuer- und Gebührendaten hinzuzufügen.

Hinweis: Der Nachrichtentyp TaxFeeinfo wird empfohlen, ist aber nicht erforderlich, wenn AmountAfterTax in der Preisnachricht angegeben ist.

Die einzige für diese Nachricht unterstützte Aktion ist overlay. Damit werden die Steuer- und Gebührendaten für jede Unterkunft ersetzt. Es ist wichtig, dass Sie bei Änderungen Steuer- und Gebührenaktualisierungen senden.

Wichtig :Sie müssen alle Steuern und Gebühren angeben, die ein Nutzer zahlen muss (Mehrwertsteuer, Aufenthaltssteuer, Stadtsteuer usw.), auch wenn diese nicht zum Zeitpunkt der Buchung oder nicht direkt an die Unterkunft bezahlt werden.

Methoden zum Hinzufügen von Steuern und Gebühren

Es gibt zwei allgemeine Möglichkeiten, Steuern und Gebühren hinzuzufügen:

Bei der ersten Methode geben Sie AmountAfterTax in der Preisnachricht an. Die Steuern und Gebühren fügen Sie hinzu, indem Sie Preisnachrichten senden, die sowohl die Basispreise pro Übernachtung (ohne Steuern und Gebühren) als auch die Gesamtpreise pro Übernachtung (einschließlich Steuern und Gebühren) enthalten. Da es sich bei diesen Preisen um Übernachtungspreise handelt, funktioniert dieser Ansatz nur für prozentuale Steuern und Gebühren oder Pauschalbeträge, die pro Übernachtung berechnet werden. Steuern und Gebühren pro Aufenthalt können nicht verwendet werden.

Die zweite (bevorzugte) Methode besteht darin, in den Preisnachrichten nur die Preise ohne Steuern und Gebühren zu senden und TaxFeeInfo zu verwenden, um Steuern und Gebühren auf Unterkunftsebene anzugeben. Die einzelnen Steuern und Gebühren können weiterhin auf bestimmte Zimmertypen und Preispläne beschränkt werden, die für bestimmte Zeiträume gelten.

Wichtiger Hinweis: Pro Unterkunft sind nur bis zu 300 Einträge für Steuern und Gebühren zulässig. Mit der TaxFeeInfo-Nachricht können Sie Steuern und Gebühren von einer Property entfernen.

Auf dieser Seite wird nur die bevorzugte Methode zur Verwendung von TaxFeeInfo beschrieben und darauf verwiesen. Die Angabe von AmountAfterTax in der Preisnachricht (OTA_HotelRateAmountNotifRQ) wird nicht behandelt.

Methoden zum Festlegen von Steuern

Sie haben folgende Möglichkeiten, Steuern festzulegen:

• Basis = [room|person]
• Zeitraum = [stay|night]
• Typ = [Prozentsatz|Betrag]

Wenn „Zeitraum“ auf stay und „Typ“ auf percent festgelegt ist, erhebt Google Steuern und Gebühren für den gesamten Aufenthalt, auch wenn sich ein einzelnes Datum im Reiseplan mit dem Zeitraum StayDates überschneidet. Sie können nicht angeben, dass Steuern und Gebühren nur angewendet werden, wenn sich ALLE Datumsangaben im Reiseplan mit dem Zeitraum der Aufenthaltsdaten überschneiden. Bei mehreren Datumsbereichen für Aufenthalte, die sich überschneiden, werden die StayDates-Bereiche in einem einzigen offenen Bereich angegeben. Weitere Informationen finden Sie in den Beispielen für TaxFeeInfo.

Beispiele für verschiedene steuerbezogene Szenarien finden Sie in den Anleitungen. Die Beispiele umfassen einige der häufigsten Steuerszenarien, darunter Anleitungen für:

1. Pauschalsteuer und prozentualer Steuersatz, der pro Unterkunft angewendet wird
2. Der Prozentsatz der Steuer wird nur auf die Nächte nach der ersten Nacht angewendet.
3. Methode zum Ersetzen alter durch neue Steuern
4. Steuern für Länder ein- oder ausschließen
5. Steuersatz mit Steuerabständen festlegen
6. Steuern und steuerpflichtige Gebühren festlegen

In den folgenden Abschnitten finden Sie allgemeine Richtlinien, ein einfaches Beispiel und Anleitungen, die Ihnen den Einstieg in das Hinzufügen und Aktualisieren Ihrer Steuerinformationen erleichtern.

Erforderliche und optionale Elemente

In der XML-Referenz werden die erforderlichen und optionalen Elemente beschrieben. Weitere Informationen zu Attributen und untergeordneten Elementen finden Sie unter TaxFeeInfo Elemente und Attribute.

Syntax und Schemas

Orientieren Sie sich beim Erstellen der Nachricht an dem Beispiel für die TaxFeeInfo-Syntax, um sicherzustellen, dass Sie das richtige Format verwenden. Sie können ein XML-Tool eines Drittanbieters wie xmllint verwenden, um Ihre Feeds mit den veröffentlichten Schemas zu validieren, bevor Sie sie an Google senden. Das TaxFeeinfo-Nachrichtenschema finden Sie unter Schemas für Hotelanzeigen.

Richtlinien

In diesem Abschnitt werden die allgemeinen Richtlinien und spezielle Anweisungen zum Festlegen von Steuern und Gebühren behandelt.

Aktionen

Overlay

Mit der Aktion overlay können Sie alle Steuern für eine Property ersetzen. Die Aktion overlay ist die Standard- und die einzige unterstützte Aktion. Alle bisherigen Steuern und Gebühren für diese Unterkunft werden nach der Aktualisierung gelöscht.

Allgemein

• Jede Tax wird ausgewertet und gegebenenfalls basierend auf dem in BaseByGuestAmt angegebenen AmountBeforeTax-Betrag berechnet.

• Nachdem alle anwendbaren Steuern und Gebühren berechnet wurden, werden sie zum Basispreis addiert, um den Gesamtpreis zu bilden.

• Die Syntax für <Tax> und <Fee> ist identisch.

• Steuern und Gebühren können Einschränkungen unterliegen, z. B.:

  • Gilt nur für bestimmte Zimmertypen und Preispläne.
  • Gilt nur für bestimmte Aufenthaltsdaten.

  Diese Einschränkungen sind optional. Sie müssen nicht für jeden Typ festgelegt werden. Sie können sie leer lassen, wenn sie für alle gelten.

• Senden Sie ein TaxFeeInfo-Update, wenn sich Steuern oder Gebühren ändern.

Beispiel

In diesem Abschnitt finden Sie ein einfaches Beispiel für eine TaxFeeInfo-Nachricht mit erforderlichen und optionalen Elementen. Nachdem Sie die Datei vorbereitet haben, müssen Sie sie per POST-Nachricht an diesen Endpunkt an Google senden:

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

Weitere Informationen zum Pushen/POSTen von Nachrichten finden Sie unter Nachrichten pushen.

Wichtig: Senden Sie Google jedes Mal eine aktualisierte TaxFeeInfo-Nachricht, wenn sich Ihre Steuern und Gebühren ändern.

Verwenden Sie für das Attribut hotel_id die eindeutige Hotel-ID, die Sie in Ihrem System zur Identifizierung der Unterkunft verwendet haben. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. Die Übereinstimmung mit Ihrem System ist entscheidend, damit Ihre Daten bei Google korrekt angezeigt werden.

In diesem Beispiel wird gezeigt, wie Sie einen Steuersatz von 10% und eine Gebühr von 50 $für eine Unterkunft für den gesamten Aufenthalt (nicht pro Nacht) festlegen:

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

Hinweis: Wenn <Currency> nicht angegeben ist, aber <Amount>, wird der Wert für <Currency> standardmäßig auf die Währung des Basiszinssatzes festgelegt.

Beispiele für das Hinzufügen altersabhängiger Steuern und weitere Beispiele finden Sie unter Steuerbeispiele.

Anleitungen

In diesem Abschnitt finden Sie Lösungen für Szenarien, die beim Festlegen von Steuern und Gebühren auftreten können.

Szenario 1: Pauschalsteuer hinzufügen

In diesem Steuerbeispiel wird gezeigt, wie Sie eine Pauschalsteuer pro Unterkunft festlegen.

Beschreibung

Sie möchten eine Pauschalsteuer für das Zimmer oder den Aufenthalt pro Unterkunft anstelle einer prozentualen Steuer erheben.

Lösung

Verwenden Sie amount anstelle von percentage, um die Option „Pauschalsteuer“ hinzuzufügen.

Beispiel

In diesem Beispiel wird gezeigt, wie Sie eine Pauschalsteuer hinzufügen, indem Sie amount anstelle von percentage verwenden:

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

Szenario 2: Steuern mit ApplicableNights ausrichten

Beschreibung

Sie möchten eine Steuer mit Pauschalgebühr nur auf die Nächte nach der ersten Nacht anwenden. Beispiel: Es fällt eine obligatorische Gebühr für die tägliche Nutzung einer bestimmten Ausstattung an, die für die erste Übernachtung nicht gilt, da die Gäste diese Ausstattung an diesem Tag nicht nutzen können.

Lösung

Mit <ApplicableNights excluded="1"/> können Sie festlegen, für welche Übernachtungen Steuern erhoben werden.

Beispiel

Hier ein Anwendungsbeispiel für 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>

Szenario 3: Alte Steuern und Gebühren durch neue ersetzen

Beschreibung

Die aktuellen Steuern und Gebühren haben sich geändert und müssen durch neue ersetzt werden.

Lösung

Verwenden Sie die Aktion overlay, um alle vorhandenen Steuern und Gebühren zu entfernen.

Hinweis: Die Aktion overlay ist die Standardaktion, wenn keine andere angegeben ist. Das bedeutet, dass Sie nur alle Steuern und Gebühren für jede Unterkunft ersetzen können und keine neuen Steuern/Gebühren hinzufügen können.

Beispiel

Im folgenden Beispiel wird gezeigt, wie alle Steuern und Gebühren für eine Unterkunft entfernt werden:

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

Szenario 4: Steuern für Länder ein- oder ausschließen

Beschreibung

Sie müssen die Steuer für bestimmte Länder einbeziehen und für ein anderes Land ausschließen. Beispielsweise müssen Sie Steuern für eine kleinere Konföderation mit Steuern außerhalb der EU ausschließen, während Sie alle anderen Länder besteuern.

Lösung

Verwenden Sie die Optionen include oder exclude für UserCountries type. Verwenden Sie include, um die Steuer nur auf das aufgeführte Land anzuwenden, oder exclude, um die Steuer auf alle Länder außer dem aufgeführten Land anzuwenden.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Steuern für Nutzer außerhalb des Hotellandes (Israel) festgelegt werden:

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

Szenario 5: Stufensteuer mit Steuerabständen festlegen

Beschreibung

Sie möchten eine Steuer gemäß der indischen GST-Steuergruppe hinzufügen, die basierend auf Übernachtungspreisen angewendet wird.

Hinweis: Verwenden Sie für dieses Szenario die Brackets (eine Reihe nicht überschneidender Steuerklassen), um diese Option festzulegen.

Lösung

Angenommen, die GST-Steuersatzgruppen des Ziellandes sind in diesem Szenario:

• Keine Steuern, wenn der Übernachtungspreis höchstens 1.000 beträgt
• 12% Steuern, wenn der Übernachtungspreis größer als 1.000 ist und höchstens 7.500 beträgt
• 18% Steuern, wenn der Übernachtungspreis über 7.500 liegt

Beispiel

Im folgenden Beispiel wird gezeigt, wie eine Stufensteuer mit Steuersätzen festgelegt wird:

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

Szenario 6: Steuer und steuerpflichtige Gebühr festlegen

Beschreibung

Sie möchten eine Steuer wie die Mehrwertsteuer und eine weitere Servicegebühr hinzufügen, die auch für diese Steuer gilt.

Lösung

In diesem Szenario werden zwei Anwendungsfälle für steuerpflichtige Gebühren berücksichtigt:

• Sowohl die Steuer als auch die steuerpflichtige Gebühr werden als Prozentsatz angegeben.
• Die Steuer ist ein Prozentsatz, während die steuerpflichtige Gebühr ein fester Betrag pro Aufenthalt ist.

Beispiele

Steuerpflichtige Gebühr als Prozentsatz

In diesem Beispiel beträgt der AmountBeforeTax 100 $, die GST 18 % und die zusätzliche Servicegebühr 5 %. Der Gesamtprozentsatz der steuerpflichtigen Gebühr beträgt somit 5,9% (5 × 1,18) und der Gesamtpreis 123,90 $ [= 118 $ (18% GST) + 5,9 $ (5,9% Servicegebühr)].

Im folgenden Snippet werden die Steuer (GST) und die steuerpflichtige Gebühr (Servicegebühr) als Prozentsätze definiert:

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

Steuerpflichtige Gebühr als Betrag

In diesem Beispiel beträgt der AmountBeforeTax 100 $, die GST 18 % und die zusätzliche Pauschalgebühr 20 $. Die steuerpflichtige Gebühr beträgt somit 23,60 $ (20 $ × 1,18) und der Gesamtpreis 141,60 $ (118 $ + 23,60 $).

Im folgenden Snippet wird die Steuer (GST) als Prozentsatz und die steuerpflichtige Gebühr (Servicegebühr) als Pauschalbetrag definiert:

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