# 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](https://docs.stripe.com/api/tax/registrations.md) 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](https://docs.stripe.com/tax/use-stripe-to-register.md) nutzen oder sich selbst registrieren. [Erfahren Sie mehr über die Steuererhebung an verschiedenen Standorten](https://docs.stripe.com/tax/supported-countries.md). - **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. # Connect-Plattform > This is a Connect-Plattform for when tax-integration is connect-platform. View the full page at https://docs.stripe.com/tax/registrations-api?tax-integration=connect-platform. ## 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](https://docs.stripe.com/api/tax/registrations/all.md) durch. Mit dem Parameter `status` und den Optionen `active`, `expired` oder `scheduled` können Sie Ihre Antwort filtern. ```curl curl -G https://api.stripe.com/v1/tax/registrations \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_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 Sie den Status der Steuerregistrierung eines verbundenen Kontos kennen, können Sie dessen Registrierung in Stripe hinzufügen, indem Sie einen Aufruf zum [Erstellen einer Registrierung](https://docs.stripe.com/api/tax/registrations/create.md) durchführen und die ID des verbundenen Kontos als `Stripe-Konto`-Header angeben. ```curl curl https://api.stripe.com/v1/tax/registrations \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_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. ```json { "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](https://docs.stripe.com/tax/set-up.md) 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](https://docs.stripe.com/tax/settings-api.md), um eine Hauptsitzadresse als Plattform hinzuzufügen: ```curl curl https://api.stripe.com/v1/tax/settings \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_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](https://docs.stripe.com/tax/settings-api.md?tax-integration=connect-platform#validations-and-errors). ## Eine Steuerregistrierung für Ihr verbundenes Konto aktualisieren und ablaufen lassen Sie können die Steuerregistrierung eines verbundenen Kontos in Stripe Tax nicht löschen. Wenn sich ein verbundenes Konto bei den lokalen Steuerbehörden abmeldet und die Steuererhebung an diesem Standort einstellen muss, läuft die Registrierung ab. Um die Steuerregistrierung eines verbundenen Kontos ablaufen zu lassen, legen Sie dessen Zeitstempel `expires_at` fest, indem Sie einen Aufruf zum [Aktualisieren der Registrierung](https://docs.stripe.com/api/tax/registrations/update.md#tax_registration_update-expires_at) durchführen und die ID des verbundenen Kontos als `Stripe-Konto`-Header angeben. ```curl curl https://api.stripe.com/v1/tax/registrations/taxreg_NkyGPRPytKq66j \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d expires_at=now ``` In diesem Fall läuft die Registrierung sofort ab. [Steuerberechnungen](https://docs.stripe.com/api/tax/calculations.md), die nach `expires_at` für das verbundene Konto durchgeführt werden, verwenden diese Registrierung nicht. ```json { "object": "tax.registration", "active_from": 1669248000, "created": 1669219200,"expires_at": 1669334400, "livemode": false, "status": "active", ... } ``` ## Optional: Steuerregistrierung für die Einzelhandelsliefergebühr hinzufügen [Serverseitig] Um die Einzelhandelsliefergebühr für Ihr verbundenes Konto zu berechnen, müssen Sie eine Steuerregistrierung in Colorado (USA) oder in Minnesota (USA) mit dem Registrierungstyp `state_retail_delivery_fee` hinzufügen. Sie müssen diese Registrierung zu Ihrem verbundenen Konto hinzufügen. ```curl curl https://api.stripe.com/v1/tax/registrations \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d country=US \ -d "country_options[us][state]=CO" \ -d "country_options[us][type]=state_retail_delivery_fee" \ -d active_from=now ``` 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: - [Einzelhandelsliefergebühr – Colorado](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=colorado#other-taxes) - [Einzelhandelsliefergebühr – Minnesota](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=minnesota#other-taxes) ## See also - [Verwenden Sie die Settings API, um Stripe Tax zu konfigurieren](https://docs.stripe.com/tax/settings-api.md) - [Stripe Tax mit Connect verwenden](https://docs.stripe.com/tax/connect.md) # Direkte Nutzung > This is a Direkte Nutzung for when tax-integration is direct. View the full page at https://docs.stripe.com/tax/registrations-api?tax-integration=direct. ## 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](https://docs.stripe.com/api/tax/registrations/create.md) durchführen: ```curl curl https://api.stripe.com/v1/tax/registrations \ -u "<>:" \ -d country=IE \ -d "country_options[ie][type]=oss_union" \ -d active_from=now ``` In diesem Fall erstellt Stripe das Objekt `tax.registration` : ```json { "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](https://docs.stripe.com/tax/settings-api.md), um eine Adresse des Hauptsitzes hinzuzufügen: ```curl curl https://api.stripe.com/v1/tax/settings \ -u "<>:" \ -d "head_office[address][country]=DE" ``` Es können standortspezifische Validierungen und Fehler auftreten. Einzelheiten dazu finden Sie in unserem [Leitfaden für Steuereinstellungen](https://docs.stripe.com/tax/settings-api.md?tax-integration=direct#validations-and-errors). ## 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](https://docs.stripe.com/api/tax/registrations/update.md#tax_registration_update-expires_at) durchführen: ```curl curl https://api.stripe.com/v1/tax/registrations/taxreg_NkyGPRPytKq66j \ -u "<>:" \ -d expires_at=now ``` In diesem Fall läuft die Registrierung sofort ab. [Steuerberechnungen](https://docs.stripe.com/api/tax/calculations.md), die nach `expires_at` durchgeführt werden, verwenden diese Registrierung nicht. ```json { "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](https://docs.stripe.com/api/tax/registrations.md) durchführen. Mit dem Parameter `status` können Sie nur nach `active`, `expired` oder `scheduled` Steuerregistrierungen filtern: ```curl curl -G https://api.stripe.com/v1/tax/registrations \ -u "<>:" \ -d status=active \ -d limit=3 ``` ## Optional: Steuerregistrierung 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. ```curl curl https://api.stripe.com/v1/tax/registrations \ -u "<>:" \ -d country=US \ -d "country_options[us][state]=CO" \ -d "country_options[us][type]=state_retail_delivery_fee" \ -d active_from=now ``` 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: - [Einzelhandelsliefergebühr – Colorado](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=colorado#other-taxes) - [Einzelhandelsliefergebühr – Minnesota](https://docs.stripe.com/tax/supported-countries/united-states/collect-tax.md?tax-jurisdiction-united-states=minnesota#other-taxes) ## See also - [Verwenden Sie die Settings API, um Stripe Tax zu konfigurieren](https://docs.stripe.com/tax/settings-api.md) - [Stripe für die Registrierung nutzen](https://docs.stripe.com/tax/use-stripe-to-register.md)