Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Übersicht
Billing
Steuer
    Übersicht
    Jetzt starten
    Funktionsweise von Stripe Tax
    Einrichten
    Verwendung der Settings API
    Tests
    Nach Zahlungsablauf integrieren
    Payment Links
    Checkout
    Invoicing
    Abonnements
    Preislistenabonnements
    Nutzerdefinierte Zahlungsintegration
    Payment Intents APIs
    Mit Stripe Connect integrieren
    Übersicht
    Tax für Software-Plattformen
    Tax für Marktplätze
    Einhaltung Ihrer Vorschriften
    Ihre Pflichten im Blick behalten
    Jetzt anmelden
      Verwendung der Registrations API
      Stripe für die Registrierung nutzen
      Taxually zur Registrierung verwenden
    Steuer berechnen
    Bericht
    Steuer-Apps von Drittanbietern
    Steuererklärung und -abführung
    Steuerreferenz
    Produktsteuercodes
    Unterstützte Länder
    FAQ
Berichte
Daten
Start-up-Gründung
StartseiteUmsatzTaxRegister

Verwenden der Registrations API zum Verwalten von Steuerregistrierungen

Erfahren Sie, wie Sie aktive Steuerregistrierungen hinzufügen, planen und überprüfen.

Seite kopieren

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. Sie können auch Stripe für die Registrierung nutzen oder sich selbst registrieren. 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.

Command Line
cURL
curl -G https://api.stripe.com/v1/tax/registrations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d status=active \ -d limit=3

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.

Command Line
cURL
curl https://api.stripe.com/v1/tax/registrations \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d country=IE \ -d "country_options[ie][type]"=oss_union \ -d active_from=now

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.

Anforderung an die Adresse des Hauptsitzes

Um eine Steuerregistrierung hinzuzufügen, muss das verbundene Konto zunächst eine Firmensitzadresse einrichten. Ohne eine definierte Hauptsitzadresse wird ein invalid_request_error mit einer Meldung über die Festlegung Ihrer Hauptsitzadresse ausgelöst.

Verwenden Sie die Tax Settings API, um eine Hauptsitzadresse als Plattform hinzuzufügen:

Command Line
cURL
curl https://api.stripe.com/v1/tax/settings \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d "head_office[address][country]"=DE

Es können standortspezifische Validierungen und Fehler auftreten. Einzelheiten hierzu finden Sie in unserem Leitfaden für Steuereinstellungen.

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.

Command Line
cURL
curl https://api.stripe.com/v1/tax/registrations/taxreg_NkyGPRPytKq66j \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -H "Stripe-Account:
{{CONNECTED_ACCOUNT_ID}}
"
\ -d expires_at=now

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", ... }

OptionalSteuerregistrierung für die Einzelhandelsliefergebühr hinzufügen
Serverseitig

Siehe auch

  • Verwenden Sie die Settings API, um Stripe Tax zu konfigurieren
  • Stripe Tax mit Connect verwenden
War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc