Diese Seite wurde von der Cloud Translation API übersetzt.

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 anfallen und die auf den auf der Website beschriebenen Steuervorschriften der Unterkunft basieren. Zum Hinzufügen von Steuer- und Gebührendaten verwenden Sie die Ratenmitteilung (OTA_HotelRateAmountNotifRQ).

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

Weitere Informationen zum Senden von Steuern und Gebühren sowie zu den spezifischen Preisdetails für Ihre Tarife finden Sie in der Steuern- und Gebührenrichtlinie.

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 Ratenbenachrichtigung an. Sie fügen die Steuern und Gebühren hinzu, indem Sie Ratenbenachrichtigungen senden, die sowohl die Basispreise pro Übernachtung (ohne alle Steuern und Gebühren) als auch die Gesamtpreise pro Übernachtung (einschließlich aller Steuern und Gebühren) enthalten. Da diese Preise pro Übernachtung gelten, funktioniert dieser Ansatz nur für prozentuale Steuern und Gebühren oder Pauschalbeträge pro Übernachtung. Steuern und Gebühren pro Aufenthalt können nicht verwendet werden.

Bei der zweiten (bevorzugten) Methode werden in den Preisnachrichten nur die Basispreise pro Nacht ohne Steuern und Gebühren gesendet. Steuern und Gebühren werden auf Unterkunftsebene über TaxFeeInfo angegeben. 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.

Auf dieser Seite wird nur die bevorzugte Methode zur Verwendung von TaxFeeInfo beschrieben und darauf verwiesen, nicht die Methode zur Angabe von AmountAfterTax in der Nachricht „Rate message“ (OTA_HotelRateAmountNotifRQ).

Methoden zum Festlegen von Steuern

Sie haben folgende Möglichkeiten, Steuern festzulegen:

Basis = [Raum|Person]
Zeitraum = [Aufenthalt|Übernachtung]
Typ = [percent|amount]

Wenn „Zeitraum“ auf stay und „Typ“ auf percent festgelegt ist, wendet Google Steuern und Gebühren für den gesamten Aufenthalt an, auch wenn sich nur ein Datum im Reiseplan mit dem Zeitraum StayDates überschneidet. Sie können nicht festlegen, dass eine Steuer und Gebühr nur angewendet werden, wenn sich ALLE Daten im Reiseplan mit dem Aufenthaltszeitraum überschneiden. Bei mehreren Aufenthaltszeiträumen, die sich überschneiden, werden die StayDates-Bereiche in einem einzelnen offenen Bereich angegeben. TaxFeeInfo-Beispiele

Beispiele für verschiedene steuerbezogene Szenarien finden Sie in den Anleitungen. Die Beispiele decken einige der wichtigsten Steuerszenarien ab, darunter Anleitungen für:

Pauschale Steuer und prozentuale Steuer pro Unterkunft
Prozentuale Steuer, die nur auf Nächte nach der ersten Nacht angewendet wird
Methode zum Ersetzen alter durch neue Steuern
Steuern für Länder ein- oder ausschließen
Staffelsteuer mit Spannen festlegen
Steuer und steuerpflichtige Gebühr 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 finden Sie Beschreibungen der erforderlichen und optionalen Elemente. Weitere Informationen zu Attributen und untergeordneten Elementen finden Sie unter TaxFeeInfo-Elemente und -Attribute.

Syntax und Schemas

Verwenden Sie das TaxFeeInfo-Syntaxbeispiel als Referenz, wenn Sie die Nachricht erstellen, 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 speziellen 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 Standardaktion und die einzige unterstützte Aktion. Alle vorherigen Steuern und Gebühren für diese Unterkunft werden gelöscht, sobald diese Aktualisierung angewendet wird.

Allgemein

Jeder Tax-Wert wird ausgewertet und gegebenenfalls auf Grundlage des in BaseByGuestAmt angegebenen AmountBeforeTax-Betrags berechnet.
Nachdem alle anfallenden Steuern und Gebühren berechnet wurden, werden sie dem Basispreis hinzugefügt, um den Gesamtpreis zu bilden.
Die Syntax für <Tax> und <Fee> ist identisch.
Für Steuern und Gebühren können Einschränkungen gelten, 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 jede Art von Einschränkung festlegen. 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 mit einer POST-Nachricht an diesen Endpunkt an Google senden:

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

Weitere Informationen zum PUSH- oder POST-Vorgang für die Nachricht finden Sie unter Nachrichten pushen.

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

In diesem Beispiel wird gezeigt, wie Sie für eine Unterkunft einen Steuersatz von 10% und einen Gebührenbetrag von 50 $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>

Beispiele für das Hinzufügen altersbezogener 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: Pauschale Steuer 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 anwenden und keine prozentuale Steuer.

Lösung

Verwenden Sie amount anstelle von percentage, um die Option für die Pauschalsteuer hinzuzufügen.

Beispiel

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

<?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 Pauschalsteuer nur auf Nächte nach der ersten Nacht anwenden. Beispiel: Für die tägliche Nutzung einer bestimmten Annehmlichkeit, die in der ersten Nacht ausgeschlossen ist, fällt eine obligatorische Gebühr an, da der Gast bzw. die Gäste diese Annehmlichkeit nicht nutzen konnten.

Lösung

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

Beispiel

Dieses Beispiel zeigt, wie ApplicableNights verwendet wird:

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

Mit der Aktion overlay werden alle vorhandenen Steuern und Gebühren entfernt.

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, für andere jedoch ausschließen. Sie müssen beispielsweise Steuern für eine kleinere Konföderation mit Nicht-EU-Steuern ausschließen, während alle anderen Länder besteuert werden.

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 mit Ausnahme des aufgeführten Landes anzuwenden.

Beispiel

Das folgende Beispiel zeigt, wie Steuern für Nutzer außerhalb des Hotelstandorts (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: Slab-Steuer mit Staffelung festlegen

Beschreibung

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

Lösung

Angenommen, die GST-Steuerklassen des Ziellands sind:

Keine Steuern, wenn der Übernachtungspreis höchstens 1.000 beträgt
12% Steuern, wenn der Übernachtungspreis über 1.000 liegt und höchstens 7.500 beträgt
18% Steuern, wenn der Übernachtungspreis über 7.500 liegt

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine Slab-Steuer mit Staffelung festlegen:

<?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: Steuern und steuerpflichtige Gebühren 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 Beispielanwendungsfälle für steuerpflichtige Gebühren betrachtet:

Sowohl die Steuer als auch die steuerpflichtige Gebühr werden als prozentuale Gebühren definiert.
Die Steuer ist ein Prozentsatz, während die steuerpflichtige Gebühr ein Pauschalbetrag pro Aufenthalt ist.

Beispiele

Steuerpflichtige Gebühr als Prozentsatz

In diesem Beispiel beträgt die AmountBeforeTax 100 $, die GST-Steuer 18 % und die zusätzliche Servicegebühr 5 %. Der gesamte steuerpflichtige Gebührenprozentsatz beträgt also 5,9% (5*1,18) und der Gesamtbetrag 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-Steuer 18 % und die zusätzliche Pauschalgebühr 20 $. Die steuerpflichtige Gesamtgebühr beträgt also 23,60 $ (20 $ × 1,18) und der Gesamtbetrag des Preises 141,60 $ [= 118 $ (18% GST) + 23,60 $ (20 $ Pauschalgebühr)].

Im folgenden Snippet wird die Steuer (GST) in Prozent 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>

Steuer- und Gebührenmitteilung Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Übersicht

Methoden zum Hinzufügen von Steuern und Gebühren

Methoden zum Festlegen von Steuern

Erforderliche und optionale Elemente

Syntax und Schemas

Richtlinien

Aktionen

Allgemein

Beispiel

Anleitungen

Szenario 1: Pauschale Steuer hinzufügen

Beschreibung

Lösung

Beispiel

Szenario 2: Steuern mit ApplicableNights ausrichten

Beschreibung

Lösung

Beispiel

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

Beschreibung

Lösung

Beispiel

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

Beschreibung

Lösung

Beispiel

Szenario 5: Slab-Steuer mit Staffelung festlegen

Beschreibung

Lösung

Beispiel

Szenario 6: Steuern und steuerpflichtige Gebühren festlegen

Beschreibung

Lösung

Beispiele

Steuerpflichtige Gebühr als Prozentsatz

Steuerpflichtige Gebühr als Betrag

Steuer- und Gebührenmitteilung

Szenario 2: Steuern mit `ApplicableNights` ausrichten