# Steuerregistrierungen

Erfahren Sie, wie Sie verbundenen Konten erlauben, ihre Steuerregistrierungen für Stripe Tax zu verwalten.

Die Komponente für Steuerregistrierungen gibt Ihren verbundenen Konten die Kontrolle über ihre Steuerkonformität. Ihre verbundenen Konten interagieren mit dieser Komponente, indem sie ihre Steuerregistrierungen direkt in Ihrer Plattform verwalten. Diese Komponente ist für [Softwareplattformen](https://docs.stripe.com/tax/tax-for-platforms.md) geeignet, was bedeutet, dass Ihre verbundenen Konten steuerpflichtig sind.

Wenn Sie eine Plattform sind, die Stripe Tax integriert, müssen Sie Informationen über die [Registrierungen Ihrer verbundenen Konten bei den Steuerbehörden](https://docs.stripe.com/tax/registering.md) in den jeweiligen Zuständigkeitsbereichen erfassen. Ihre verbundenen Konten müssen sich bei ihren Steuerbehörden registrieren, bevor sie ihre Steuerregistrierungen auf Ihrer Plattform hinzufügen können. Um Steuern für Ihre Plattform korrekt zu berechnen und einzuziehen, müssen Sie die Steuerregistrierungen Ihrer verbundenen Konten erfassen.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

Die Komponente für Steuerregistrierungen verwendet die [Tax Registrations API](https://docs.stripe.com/tax/registrations-api.md), um eine Liste der Steuerregistrierungen für Ihre verbundenen Konten anzuzeigen. Um Steuern auf ihre Zahlungen an einem Standort zu berechnen, müssen verbundene Konten ihre Steuerregistrierung mit der Komponente für Steuerregistrierungen hinzufügen. Wenn das verbundene Konto die Steuerberechnung an einem bestimmten Ort einstellen möchte, kann es die Steuerregistrierung in der Komponente beenden.

## Anforderungen

- Ihre Integration muss dem [Leitfaden für Softwareplattformen](https://docs.stripe.com/tax/tax-for-platforms.md) für [Tax für Connect](https://docs.stripe.com/tax/connect.md) folgen. Dies bedeutet, dass Ihre verbundenen Konten zum Steuereinzug verpflichtet sind.
- Falls noch nicht vorhanden, rendern Sie die [Komponente für Steuereinstellungen](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md). Sie benötigen sowohl die Komponente für Steuereinstellungen als auch die Komponente für Steuerregistrierungen, um die Steuerkonformität Ihrer verbundenen Konten zu kontrollieren.

## Komponente für Steuerregistrierungen integrieren

Aktivieren Sie [beim Erstellen einer Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) die Steuerregistrierungen, indem Sie `tax_registrations` im `components`-Parameter angeben.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[tax_registrations][enabled]=true"
```

Nachdem die Kontositzung erstellt und [ConnectJS initiiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), können Sie die Steuerregistrierungskomponente im Frontend anzeigen:

#### React

```jsx
// Include this React component
import {
  ConnectTaxRegistrations,
  ConnectComponentsProvider,
} from "@stripe/react-connect-js";

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax Registrations</h2>
      <ConnectTaxRegistrations
        // Optional
        // displayCountries={["US", "CA", "DE"]}
        // onAfterTaxRegistrationAdded={({id: registrationId}) => console.log({registrationId})}
        // onAfterTaxRegistrationExpired={({id: registrationId}) => console.log({registrationId})}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| Methode                            | Typ                      | Beschreibung                                                                                                                                                                                                                                                                 | Standard                                      |
| ---------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| `setDisplayCountries`              | `string[]`               | Array mit [zweistelligen Ländercodes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), aus denen das verbundene Konto [für eine neue Steuerregistrierung auswählen kann](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options). | nicht definiert (alle Länder zugelassen)      |
| `setOnAfterTaxRegistrationAdded`   | `({id: string}) => void` | Callback wird mit einem Objekt ausgeführt, das die neu hinzugefügte Steuerregistrierungs-ID enthält                                                                                                                                                                          | nicht definiert (keine erforderliche Methode) |
| `setOnAfterTaxRegistrationExpired` | `({id: string}) => void` | Rückruf, der mit einem Objekt ausgeführt wird, das die Steueridentifikationsnummer der vom Nutzer beendeten Registrierung enthält                                                                                                                                            | nicht definiert (keine erforderliche Methode) |

#### React

| React-Eigenschaft               | Typ                      | Beschreibung                                                                                                                                                                                                                                                                 | Standard                                      | Erforderlich oder optional |
| ------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | -------------------------- |
| `displayCountries`              | `string[]`               | Array mit [zweistelligen Ländercodes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), aus denen das verbundene Konto [für eine neue Steuerregistrierung auswählen kann](https://docs.stripe.com/api/tax/registrations/object.md#tax_registration_object-country_options). | nicht definiert (alle Länder zugelassen)      | optional                   |
| `onAfterTaxRegistrationAdded`   | `({id: string}) => void` | Rückruf mit der neu hinzugefügten Steuerregistrierungs-ID ausgeführt                                                                                                                                                                                                         | nicht definiert (keine erforderliche Methode) | optional                   |
| `onAfterTaxRegistrationExpired` | `({id: string}) => void` | Rückruf, der mit einem Objekt ausgeführt wird, das die Steueridentifikationsnummer der vom Nutzer beendeten Registrierung enthält                                                                                                                                            | nicht definiert (keine erforderliche Methode) | optional                   |

## Beschränkungen

Die folgenden Funktionen sind im Dashboard und in der API verfügbar, werden jedoch derzeit von der Komponente Steuerregistrierungen nicht unterstützt:

- Planen von Start- und Enddaten für Registrierungen. Sie können Registrierungen nur sofort erstellen oder beenden.
- Angeben der Verkaufssteuerwahlen für US-Bundesstaaten beim Erstellen von Steuerregistrierungen.

## See also

- [Tax für Connect](https://docs.stripe.com/tax/connect.md)
- [Tax für Softwareplattformen](https://docs.stripe.com/tax/tax-for-platforms.md)
- [Komponente für Steuereinstellungen](https://docs.stripe.com/connect/supported-embedded-components/tax-settings.md)