Wie eine Buchungsplattform die Kurtaxe über eine API einbindet

Eine Buchungsplattform bindet die Kurtaxe ein, indem sie ihre Objekte einmalig über die LocationTax API registriert. Dann sendet sie pro Buchung die Buchungsdaten und erhält den berechneten Betrag zurück. Die Steuerlogik, die Tarifdatenbank und die Wartung dahinter liegen auf der Trippz-Seite. Ihre Plattform sendet eine Anfrage und zeigt einen Betrag an.

Wie sieht die Integration der LocationTax API konkret aus?

Die LocationTax API ist die fertige Engine. Trippz übernimmt die Berechnung, und Objektdaten werden auf Trippz-Servern gespeichert und verwaltet. Ihre eigene Datenbank braucht also keine Tarifwerte, keine Tarif-Historie und keine Liste mit Gemeinde-Ausnahmen, die Sie aktuell halten müssen.

Es gibt keine separate Integration pro Land, keine Mapping-Tabelle pro Gemeinde auf Ihrer Seite und kein zweites Datenmodell für Märkte, in denen die Steuer anders funktioniert. Jede Jurisdiktion, die Trippz abdeckt, läuft über denselben Vertrag. Das hält die Integration als einmalige Arbeit und verhindert ein dauerhaftes internes Projekt.

Warum ist die Logik hinter den Kurtaxe-Sätzen das Schwierigste?

Die Kurtaxe wird lokal festgelegt. Eine nationale Regierung entscheidet selten darüber. Die Gemeinden tun das, jede nach ihrem eigenen Zeitplan, jede mit ihrer eigenen Bemessungsgrundlage. Manche erheben einen Prozentsatz des Zimmerpreises, manche einen festen Betrag pro Person pro Nacht, manche variieren den Betrag je nach Saison, Sternekategorie oder Unterkunftsart. Auch die Befreiungen unterscheiden sich: Kinder unter einer bestimmten Altersgrenze, Geschäftsreisende, Aufenthalte über einer maximalen Anzahl an Nächten.

Die Sätze ändern sich auch ohne Vorwarnung und ohne zentrale Bekanntmachung. Ein Gemeinderat stimmt über eine Erhöhung ab, und niemand schickt Ihrem Produkt-Team eine E-Mail. Das über ein Portfolio von Märkten hinweg zu überwachen, ist eine Vollzeitstelle, dauerhaft. Trippz überwacht jede Jurisdiktion, die es abdeckt, und überträgt Satz-Änderungen automatisch, sobald sie veröffentlicht werden. Die nächste Gemeinde-Änderung zu erfassen, ist also kein Job, den Ihre Plattform besetzen muss.

Wo sitzen die API-Aufrufe in Ihrem Buchungsablauf?

Die Integration hat drei bewegliche Teile, und nur einer davon läuft bei jeder Buchung.

Die Objekt-Registrierung erfolgt einmal pro Objekt, nicht einmal pro Anfrage. Sie senden Ihre Objekte ein, jedes wird der richtigen Steuer-Jurisdiktion zugeordnet, und die anwendbaren Sätze werden aufgelöst, bevor ein Gast überhaupt sucht.

Der Aufruf pro Buchung ist derjenige, der ständig läuft. Sie übergeben die Buchungsdaten und erhalten ein vollständiges Steuer-Angebot zurück, das jede anwendbare Kurtaxe abdeckt. Innerhalb von Millisekunden, da die Sätze bei der Registrierung bereits aufgelöst wurden.

Ein Webhook deckt ab, was dazwischen passiert. Wenn eine Gemeinde einen Satz ändert, der eines Ihrer registrierten Objekte betrifft, werden Sie direkt benachrichtigt. So veraltet der Satz hinter Ihrem Preis nie unbemerkt.

Wenn Sie das zurückgegebene Angebot der Buchung zuordnen, erhalten Sie ein nachvollziehbares Protokoll darüber, was berechnet wurde, wann und nach welcher Regel. Auf dieses Protokoll greifen Sie zurück, wenn ein Gastgeber oder eine Behörde fragt, wie ein bestimmter Betrag zustande kam.

Was muss Ihr Engineering-Team nicht mehr pflegen?

Die Kurtaxe-Berechnung intern aufzubauen bedeutet, drei Dinge zu bauen und alle drei am Leben zu erhalten: eine Tarifdatenbank, eine Berechnungs-Engine, die jede lokale Bemessungsgrundlage und Befreiung abdeckt, und einen Monitoring-Prozess, der Gemeinde-Änderungen erfasst, bevor Ihre Gäste den falschen Betrag zahlen. Die ersten beiden sind ein abgrenzbares Engineering-Projekt. Das dritte endet nie, und es ist das, das unbemerkt kaputt geht.

Die Einbindung über die LocationTax API streicht alle drei von Ihrer Roadmap. Jede Berechnung läuft gegen geprüfte, aktuelle lokale Regeln, und Korrektheit wird zur Lieferanten-Verpflichtung statt zum Dauerthema im Sprint Planning. Trippz ist SOC1 Type 2 und SOC2 Type 2 zertifiziert und DSGVO-konform.

Was brauchen Sie vor dem Go-Live?

Vor der Integration der LocationTax API brauchen Sie einen Standort-Identifier pro Objekt, der genau genug ist, um die richtige Gemeinde aufzulösen. Sie brauchen einen Platz im Buchungsdatensatz, um den zurückgegebenen Steuerbetrag zu speichern, und eine Entscheidung, wo im Gast-Flow die Steuer angezeigt wird. Das ist die komplette Liste der Voraussetzungen auf Ihrer Seite.

Das Onboarding beginnt mit einem Formular und ohne Verpflichtung. Sie geben Ihren Use Case und Ihre Objektanzahl an. Berechtigte Accounts werden für den Sandbox-Zugang geprüft, und ein kommerzielles Angebot folgt auf einen Call, bevor Produktions-Zugangsdaten ausgestellt werden. Die Preisgestaltung läuft pro verbundenem Objekt, also skaliert sie mit Ihrem Portfolio und nicht mit Ihrem Buchungsvolumen.

Für einen genaueren Blick darauf, wie eine solche Steuer-Engine von Anfang bis Ende funktioniert, siehe was eine Kurtaxe-API ist.

Ob Sie eine Buchungsplattform, ein PMS oder einen Channel-Manager betreiben: Die Entscheidung ist dieselbe. Die Kurtaxe-Logik selbst pflegen oder LocationTax die Arbeit abnehmen lassen. Trippz für Plattformen.