Steuer- und Gebührenmitteilung

Überblick

Die TaxFeeInfo-Nachricht definiert die Steuern und Gebühren, die für einen Nutzer bei der Buchung einer Unterkunft anfallen, gemäß den auf der Website beschriebenen Steuervorschriften. Zum Hinzufügen von Steuer- und Gebührendaten verwenden Sie die Preisnachricht (OTA_HotelRateAmountNotifRQ).

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

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, bei Änderungen Aktualisierungen zu Steuern und Gebühren zu senden.

Wichtiger Hinweis :Sie müssen alle Steuern und Gebühren angeben, die ein Nutzer zahlen muss (MwSt., Aufenthaltssteuer, Stadtsteuer usw.), auch wenn diese nicht bei der Buchung oder nicht direkt an die Unterkunft gezahlt 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. Sie fügen die Steuern/Gebühren hinzu, indem Sie Preisnachrichten senden, die sowohl die Basispreise pro Nacht (ohne alle Steuern/Gebühren) als auch den Gesamtpreis pro Nacht (einschließlich aller Steuern/Gebühren) enthalten. Da diese Preise pro Nacht gelten, funktioniert dieser Ansatz nur für prozentbasierte Steuern/Gebühren oder Pauschalbeträge pro Nacht. Steuern/Gebühren pro Aufenthalt können nicht verwendet werden.

Die zweite (bevorzugte) Methode besteht darin, in den Preisnachrichten nur Basispreise für die Basis von Steuern bzw. Gebühren zu senden und TaxFeeInfo zur Übertragung von Steuern/Gebühren auf Unterkunftsebene zu verwenden. Die individuellen Steuern/Gebühren können weiterhin bestimmten Zimmertypen und Preisplänen zugeordnet und/oder für bestimmte Zeiträume gelten.

Hinweis: Auf dieser Seite wird nur die bevorzugte Methode zur Verwendung von TaxFeeInfo beschrieben und nicht auf die Methode zur Angabe von AmountAfterTax in der Preisnachricht (OTA_HotelRateAmountNotifRQ).

Methoden zum Festlegen von Steuern

Sie haben folgende Möglichkeiten, Steuern festzulegen:

• Basis = [Raum|Person]
• Zeitraum = [Aufenthalt|Nacht]
• Typ = [percent|amount]

Wenn für den Zeitraum stay und für den Typ percent festgelegt ist, wendet Google Steuern und Gebühren für den gesamten Aufenthalt an, auch wenn sich ein einzelnes Datum im Reiseplan mit dem Zeitraum StayDates überschneidet. Sie können die Anwendung von Steuern oder Gebühren nur dann angeben, wenn sich ALLE Datumsangaben im Reiseplan mit dem Zeitraum für die Aufenthaltsdaten überschneiden.

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

• Steuern (%)
• Pauschalsteuer pro Property
• Steuer in Prozent, die nur für Nächte nach der ersten Nacht gilt
• Methode zum Ersetzen alter Steuern durch neue Steuern
• Steuern für Länder ein- oder ausschließen
• Steuergruppe mit Klammern festlegen
• Steuer- und Steuergebühr festlegen

In den folgenden Abschnitten werden allgemeine Richtlinien, ein einfaches Beispiel und Szenarien erläutert, die Ihnen den Einstieg in das Hinzufügen und Aktualisieren von Steuerinformationen erleichtern.

Erforderliche und optionale Elemente

Die XML-Referenz enthält 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 beim Erstellen der Nachricht das Beispiel für die TaxFeeInfo-Syntax als Referenz, damit das richtige Format eingehalten wird. 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. Informationen zum Nachrichtenschema TaxFeeinfo finden Sie unter Schemas für Hotelanzeigen.

Richtlinien

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

Aktionen

Overlay

Mit der Aktion overlay können Sie alle Steuern für eine Immobilie ersetzen. Die Aktion overlay ist die Standardaktion und die einzige unterstützte Aktion. Alle früheren Steuern und Gebühren für diese Unterkunft werden gelöscht, sobald diese Aktualisierung angewendet wird.

Allgemein

• Jeder Tax wird ausgewertet und gegebenenfalls basierend auf dem AmountBeforeTax-Betrag berechnet, der in BaseByGuestAmt angegeben wurde.

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

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

• Bei Steuern und Gebühren kann es zu folgenden Einschränkungen kommen:

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

  Diese Einschränkungen sind optional und Sie müssen nicht jede Art von Einschränkung festlegen. Sie können sie leer lassen, wenn sie für alle gelten.

• Bei Änderungen an Steuern oder Gebühren bitte TaxFeeInfo aktualisieren.

Beispiel

Dieser Abschnitt enthält ein einfaches Beispiel für eine TaxFeeInfo-Nachricht mit erforderlichen und optionalen Elementen. Nachdem Sie Ihre Datei vorbereitet haben, müssen Sie sie über eine POST-Nachricht an diesen Endpunkt an Google senden:

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

Weitere Informationen zum Übertragen/POSTen von Nachrichten finden Sie unter Nachrichten per Push übertragen.

Wichtiger Hinweis :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 Konsistenz mit Ihrem System ist wichtig, damit Google Ihre Daten korrekt anzeigt.

In diesem Beispiel wird gezeigt, wie Sie für eine Unterkunft einen Steuerprozentsatz von 10% und eine Gebühr von 50 $für den Gesamtaufenthalt (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 altersabhängiger Steuern und weitere Beispiele finden Sie unter Steuerbeispiele.

Anleitungen

Dieser Abschnitt enthält Lösungen für Szenarien, die beim Festlegen von Steuern und Gebühren auftreten können.

Szenario 1: Pauschalsteuer hinzufügen

Dieses Steuerbeispiel zeigt, wie Sie eine Pauschalsteuer pro Property festlegen.

Beschreibung

Sie möchten für das Zimmer/Aufenthalt pro Unterkunft eine Pauschalsteuer anstelle einer prozentualen Steuer anwenden.

Lösung

Verwenden Sie amount statt percentage, um die Pauschalsteuer hinzuzufügen.

Beispiel

Dieses Beispiel zeigt, wie Sie eine Pauschalsteuer hinzufügen, indem Sie amount statt 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: Mit ApplicableNights ein Targeting auf Steuern festlegen

Beschreibung

Sie möchten eine Pauschalsteuer nur auf die Nächte nach der ersten Nacht anwenden. Es wird beispielsweise eine obligatorische Gebühr für die tägliche Nutzung einer bestimmten Ausstattung erhoben, die von der ersten Nacht ausgeschlossen ist, wenn die Gäste diese Ausstattung nicht nutzen dürfen.

Lösung

Mit <ApplicableNights excluded="1"/> können Sie festlegen, auf welche Nächte 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/Gebühren haben sich geändert und müssen durch neue ersetzt werden.

Lösung

Mit der Aktion overlay können Sie alle vorhandenen Steuern und Gebühren entfernen.

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

Beispiel

Im folgenden Beispiel sehen Sie, wie alle Steuern/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 angeben und für andere Länder 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 Option include oder exclude für UserCountries type. Verwenden Sie include, um die Steuer nur auf das angegebene 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: Pauschalsteuer mit Klammern festlegen

Beschreibung

Sie möchten eine GST-Steuergruppe hinzufügen, die auf Übernachtungspreisen angewendet wird.

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

Lösung

Angenommen, die GST-Steuergruppen des Ziellandes lauten wie folgt:

• Keine Steuern, wenn der Übernachtungspreis kleiner oder gleich 1.000 ist.
• 12% Steuern, wenn der Übernachtungspreis größer als 1.000 und kleiner oder gleich 7.500 ist.
• 18% Steuern, wenn der Übernachtungspreis über 7.500 liegt.

Beispiel

Im folgenden Beispiel wird gezeigt, wie Sie eine Steuergruppe mit Klammern 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: Steuer und zu versteuernde Gebühr festlegen

Beschreibung

Sie möchten eine Steuer (z. B. die Umsatzsteuer) und eine weitere Servicegebühr hinzufügen, die ebenfalls für diese Steuer gilt.

Lösung

In diesem Szenario werden zwei beispielhafte Anwendungsfälle für steuerpflichtige Gebühren betrachtet:

• Die Steuern und die zu versteuernde Gebühr werden als prozentuale Gebühren definiert.
• Die Steuer wird als prozentualer Anteil berechnet, während die zu versteuernde Gebühr ein Pauschalbetrag pro Aufenthalt ist.

Beispiele

Zu versteuernde Gebühr in Prozent

In diesem Beispiel beträgt AmountBeforeTax 100 $, eine GST von 18 % und eine Servicegebühr von 5 % zusätzlich. Der Gesamtsteuersatz beträgt 5,9 % (5*1,18) und der Gesamtpreis 123,90 $ [= 118 $ (18 % GST) + 5,9 % (Servicegebühr von 5,9 %).]

Im folgenden Snippet werden die Steuern (GST) und die zu versteuernde Gebühr (Servicegebühr) in Prozent 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

Dieses Beispiel hat einen AmountBeforeTax-Wert von 100 $, eine GST-Steuer von 18 % und eine zusätzliche Pauschalgebühr von 20 $, sodass sich die zu versteuernde Gesamtgebühr von 23,60 $ (20 $*1,18) ergibt und der Gesamtbetrag von 141,60 $ [= 118 $ (18% GST) + 23,60 $Pauschalsatz (20 $).

Im folgenden Snippet wird die Steuer (GST) in Prozent und die steuerpflichtige Gebühr (Servicegebühr) als Pauschalpreis 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>