Verwenden der Registrations API zum Verwalten von Steuerregistrierungen

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

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.

Steuerregistrierung hinzufügen

Fügen Sie, nachdem Sie sich bei den lokalen Steuerbehörden registriert haben, die Registrierung zu Stripe Tax hinzu, indem Sie einen Aufruf zum Erstellen einer Registrierung durchführen:

In diesem Fall erstellt Stripe das Objekt tax.registration :

{
  "object": "tax.registration",
  "active_from": 1669249440,
  "country": "IE",
  "country_options": {
    "ie": {
      "type": "oss_union"
    }
  },
  "livemode": false,
  "status": "active",
  ...
}

Anforderung an die Adresse des Hauptsitzes

Um eine Steuerregistrierung hinzuzufügen, müssen Sie 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 Adresse des Hauptsitzes hinzuzufügen:

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

Eine Steuerregistrierung aktualisieren und ablaufen lassen

Sie können eine Steuerregistrierung in Stripe Tax nicht löschen. Wenn Sie sich bei den lokalen Steuerbehörden abmelden und die Steuererhebung an diesem Standort einstellen müssen, lassen Sie die Registrierung ablaufen. Um eine Steuerregistrierung ablaufen zu lassen, legen Sie deren Zeitstempel expires_at fest, indem Sie einen Aufruf zum Aktualisieren der Registrierung durchführen:

In diesem Fall läuft die Registrierung sofort ab. Steuerberechnungen, die nach expires_at durchgeführt werden, verwenden diese Registrierung nicht.

{
  "object": "tax.registration",
  "active_from": 1669248000,
  "created": 1669219200,
  "expires_at": 1669334400,
  "livemode": false,
  "status": "active",
  ...
}

Listen Sie alle Ihre Steuerregistrierungen auf

Sie können alle Ihre Steuerregistrierungen anzeigen, die einen Aufruf zum Auflisten der Registrierungen durchführen. Mit dem Parameter status können Sie nur nach active, expired oder scheduled Steuerregistrierungen filtern:

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

Um die Einzelhandelsliefergebühr zu berechnen, müssen Sie eine Steuerregistrierung in Colorado (USA) oder in Minnesota (USA) mit dem Registrierungstyp state_retail_delivery_fee hinzufügen.

Nach Hinzufügen der Steuerregistrierung wird die Einzelhandelsliefergebühr für die Steuerberechnung erhoben, wenn der verkaufte Artikel die Anforderungen der verschiedenen Bundesstaaten erfüllt. Die Gebühr fällt in Minnesota beispielsweise für Bestellungen über 100 USD an.

Sehen Sie in der Dokumentation nach, ob die Einzelhandelsliefergebühr anfällt: