Verwenden der Registrations API zum Verwalten von Steuerregistrierungen
Unternehmen müssen sich dort registrieren, wo sie einer Steuerpflicht unterliegen. Mit der Tax Registration API können Sie Steuerregistrierungen über eine API anstelle des Dashboards abrufen und konfigurieren. Durch das Hinzufügen Ihrer Registrierungen in Stripe, wird die Steuerberechnung und -erhebung für Ihre über Stripe durchgeführten Transaktionen aktiviert.
Wann und wie sich ein Unternehmen für die Steuererhebung registrieren muss, hängt vom Standort ab. Erfahren Sie mehr über die Steuererhebung an verschiedenen Standorten.
- Connect-Plattform: Als Plattform können Sie diese API verwenden, um die Registrierungen Ihrer verbundenen Konten zu verwalten oder die aktiven Registrierungen eines Kontos zu überprüfen.
- Direkte Nutzung: Mit dieser API können Sie Ihre Registrierungen verwalten und prüfen.
Alle Steuerregistrierungen für Ihre verbundenen Konten auflisten
Um eine Liste der Steuerregistrierungen Ihrer verbundenen Konten zu erhalten, führen Sie einen Aufruf zum Auflisten der Registrierungen durch. Mit dem Parameter status
und den Optionen active
, expired
oder scheduled
können Sie Ihre Antwort filtern.
Wenn Ihre verbundenen Konten keinen Zugriff auf das Stripe-Dashboard haben, kann Ihre Plattform eine Benutzeroberfläche bereitstellen, über die diese ihre Steuerregistrierungen verwalten können. Diese Funktionalität können Sie über den Registrierungs-Endpoint implementieren.
Steuerregistrierungen für Ihr verbundenes Konto hinzufügen
Wenn der Plattform eine Steuerpflicht und Registrierung des verbundenen Kontos bekannt ist, können Sie einen Aufruf zum Erstellen einer Registrierung durchführen, indem Sie den Stripe-Account
-Header mit dem Wert der ID des verbundenen Kontos verwenden, um die Registrierung für das verbundene Konto hinzuzufügen oder zu planen.
In diesem Fall wird ein tax.registration
-Objekt im verbundenen Konto erstellt.
{ "object": "tax.registration", "active_from": 1669249440, "country": "IE", "country_options": { "ie": { "type": "oss_union" } }, "livemode": false, "status": "active", ... }
Alternativ können Sie verbundene Konten mit Zugriff auf das Stripe-Dashboard (z. B. Standard-Konten) anweisen, dort Stripe Tax einzurichten. Dies umfasst auch das Hinzufügen von Steuerregistrierungen.
Eine Steuerregistrierung für Ihr verbundenes Konto aktualisieren und ablaufen lassen
Sie können eine erstellte Registrierung nicht mehr löschen, aber Sie können sie beenden, indem Sie expires_at
auf einen Zeitpunkt einstellen, zu dem die Registrierung nicht mehr aktiv ist. Aktualisieren Sie die Registrierungen mit einem Aufruf zum Aktualisieren der Registrierung mithilfe des Stripe-Konto-Headers mit einem Wert der verbundenen Konto-ID.
In diesem Fall läuft die Registrierung sofort ab. Steuerberechnungen, die nach expires_at
für das verbundene Konto durchgeführt werden, verwenden diese Registrierung nicht.
{ "object": "tax.registration", "active_from": 1669248000, "created": 1669219200, "expires_at": 1669334400, "livemode": false, "status": "active", ... }