Steuer- und Gebührenmitteilung

Übersicht

Die TaxFeeInfo-Nachricht definiert die Steuern und Gebühren, die für einen Nutzer bei der Buchung einer Unterkunft gelten, und basiert auf den auf der Website beschriebenen Steuerbestimmungen der Unterkunft. Verwenden Sie die Preismitteilung (OTA_HotelRateAmountNotifRQ), um Steuer- und Gebührendaten hinzuzufügen.

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 bei Änderungen Steuer- und Gebührenaktualisierungen senden.

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 Grundpreise 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 Basis-Nachtpreise mit Steuern und Gebühren exklusiver Preise zu senden und TaxFeeInfo zu verwenden, um Steuern und Gebühren auf Unterkunftsebene zu übertragen. Die individuellen Steuern und Gebühren können weiterhin für bestimmte Zimmertypen und Preispläne gelten, die für bestimmte Zeiträume gelten.

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.

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

  • Prozentuale Steuer
  • Pauschalsteuer pro Unterkunft
  • Prozentuale Steuer, die nur auf die Nächte nach der ersten Nacht angewendet wird
  • Methode zum Ersetzen alter durch neue Steuern
  • Steuern für Länder ein- oder ausschließen
  • Stufensteuer mit Klammern festlegen
  • Steuern 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 werden die erforderlichen und optionalen Elemente beschrieben. Weitere Informationen zu Attributen und untergeordneten Elementen findest du unter TaxFeeInfo-Elemente und Attribute.

Syntax und Schemas

Orientieren Sie sich beim Erstellen der Nachricht am 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 vorherigen Steuern und Gebühren für diese Unterkunft werden nach der Anwendung dieser 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 und 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

Dieser Abschnitt enthält ein grundlegendes Beispiel für eine TaxFeeInfo-Nachricht mit erforderlichen und optionalen Elementen. Nachdem du deine Datei vorbereitet hast, musst du sie mithilfe einer POST-Nachricht an diesen Endpunkt an Google senden:

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

Weitere Informationen zum Übertragen von Nachrichten per Push oder POSTEN finden Sie unter Nachrichten senden.

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 dafür, dass 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>

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 für die 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 Pauschalsteuer nur für Nächte nach der ersten Nacht berechnen. Beispielsweise fällt eine obligatorische Gebühr für die tägliche Nutzung einer bestimmten Ausstattung an, die ab der ersten Übernachtung ausgeschlossen ist, wenn die Gäste diese Ausstattung nicht nutzen konnten.

Lösung

Mit <ApplicableNights excluded="1"/> können Sie festlegen, für welche Nächte Steuern anfallen.

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.

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 musst du Steuern für eine kleinere Konföderation mit Nicht-EU-Steuern ausklammern und gleichzeitig 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 angegebene Land anzuwenden, oder exclude, um die Steuer auf alle Länder außer dem angegebenen 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.

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 die AmountBeforeTax 100 $, eine GST von 18 % und eine zusätzliche Servicegebühr von 5 %. Das ergibt einen steuerbaren Gesamtprozentsatz von 5,9% (5*1,18) und einen Gesamtpreis von 123,90 $ [= 118 $ (18% GST) + 5,9 $ (Servicegebühr von 5,9 %)].

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>