# Produktsteuercode-Auswahl

Erlauben Sie verbundenen Konten, Produkte mit einem Steuercode zu klassifizieren.

Mit der Komponente zur Auswahl von Produktsteuercodes können Ihre verbundenen Konten ihre Produkte klassifizieren. Verbundene Konten interagieren in der Regel mit dieser Komponente auf der Produktseite auf Ihrer Plattform. Diese Komponente eignet sich sowohl für [Softwareplattformen](https://docs.stripe.com/tax/tax-for-platforms.md) als auch für [Marktplätze](https://docs.stripe.com/tax/tax-for-marketplaces.md) zur Integration in deren Nutzeroberflächen. Verbundene Konten können mithilfe der Produktsteuercodeauswahl den entsprechenden Steuercode für jedes Produkt auswählen. Entweder die Plattform oder die verbundenen Konten können für die Steuererhebung haftbar gemacht werden.

Wenn Sie eine Plattform sind, die Stripe Tax integriert, müssen Sie für Stripe Tax den Steuercode eines Produkts angeben, um die Steuern korrekt zu berechnen.

Die Komponente zur Auswahl von Produktsteuercodes verwendet die [Tax Codes API](https://docs.stripe.com/api/tax_codes.md), um alle verfügbaren Steuercodes anzuzeigen. Wenn ein verbundenes Konto einen neuen Produktsteuercode auswählt, wird ein Ereignis-Handler aufgerufen, den Sie überwachen können. Verwenden Sie dies, um den Steuercode eines Produkts auf Ihrer Plattform zu aktualisieren. Alle Steuercodes in dieser Komponente werden in [alle Sprachen, die in Connect eingebettete Komponenten unterstützen](https://docs.stripe.com/connect/get-started-connect-embedded-components.md?platform=web#localization), übersetzt.

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 zur Auswahl von Produktsteuercodes integrieren

Aktivieren Sie beim Erstellen einer [Kontositzung](https://docs.stripe.com/api/account_sessions/create.md) die Komponente zur Auswahl von Produktsteuercodes, indem Sie `product_tax_code_selector` im Parameter `components` angeben.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-03-25.preview; embedded_connect_beta=v2;" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[product_tax_code_selector][enabled]=true"
```

Nachdem die Kontositzung erstellt und [Connect.js initialisiert wurde](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#account-sessions), rendern Sie die Komponente zur Auswahl von Produktsteuercodes im Frontend:

#### React

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

return (
  <ConnectComponentsProvider connectInstance={stripeConnectInstance}>
    <div>
      <h2>Tax code</h2>
      <ConnectProductTaxCodeSelector
        // Optional
        // onTaxCodeSelect={(id: string | null, {analyticsName: string} | null) => {console.log({id, analyticsName})}}
        // hideDescription={false}
        // disabled={false}
        // initialTaxCode={"txcd_99999999"}
       />
    </div>
  </ConnectComponentsProvider>
);
```

#### HTML + JS

| Methode              | Typ                                                           | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                              | Standard        | Erforderlich oder optional |
| -------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | -------------------------- |
| `setOnTaxCodeSelect` | `(id: string | null, {analyticsName: string} | null) => void` | Eine Rückruf-Funktion, die die ID und den Namen des Steuercodes akzeptiert, wenn die Nutzerin oder der Nutzer einen auswählt, oder `null`, wenn die Nutzerin oder der Nutzer ihre bzw. seine Auswahl löscht. Verwenden Sie das Feld `analyticsName` nur zu Analysezwecken, da sein Wert geändert oder entfernt werden kann. Rufen Sie [Steuercode abrufen](https://docs.stripe.com/api/tax_codes/retrieve.md) auf, um Details zum Steuercode zu erhalten. | nicht definiert | Optional                   |
| `setHideDescription` | `boolean`                                                     | Legen Sie den Wert auf „true“ fest, um die Steuercodebeschreibung in der Auswahl des Produktsteuercodes auszublenden.                                                                                                                                                                                                                                                                                                                                     | false           | Optional                   |
| `setDisabled`        | `boolean`                                                     | Legen Sie den Wert auf „true“ fest, um das Dropdown-Menü für die Auswahl des Produktsteuercodes zu deaktivieren.                                                                                                                                                                                                                                                                                                                                          | false           | Optional                   |
| `setInitialTaxCode`  | `string`                                                      | Legen Sie einen der von Stripe [unterstützten Steuercodes](https://docs.stripe.com/tax/tax-codes.md) fest, z. B. `txcd_10000000`, um automatisch einen anfänglichen Steuercode auszuwählen.                                                                                                                                                                                                                                                               | nicht definiert | Optional                   |

#### React

| React-Eigenschaft | Typ                                                           | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                              | Standard        | Erforderlich oder optional |
| ----------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | -------------------------- |
| `onTaxCodeSelect` | `(id: string | null, {analyticsName: string} | null) => void` | Eine Rückruf-Funktion, die die ID und den Namen des Steuercodes akzeptiert, wenn die Nutzerin oder der Nutzer einen auswählt, oder `null`, wenn die Nutzerin oder der Nutzer ihre bzw. seine Auswahl löscht. Verwenden Sie das Feld `analyticsName` nur zu Analysezwecken, da sein Wert geändert oder entfernt werden kann. Rufen Sie [Steuercode abrufen](https://docs.stripe.com/api/tax_codes/retrieve.md) auf, um Details zum Steuercode zu erhalten. | nicht definiert | Optional                   |
| `hideDescription` | `boolean`                                                     | Legen Sie den Wert auf „true“ fest, um die Steuercodebeschreibung in der Auswahl des Produktsteuercodes auszublenden.                                                                                                                                                                                                                                                                                                                                     | false           | Optional                   |
| `disabled`        | `boolean`                                                     | Legen Sie den Wert auf „true“ fest, um das Dropdown-Menü für die Auswahl des Produktsteuercodes zu deaktivieren.                                                                                                                                                                                                                                                                                                                                          | false           | Optional                   |
| `initialTaxCode`  | `string`                                                      | Legen Sie einen der von Stripe [unterstützten Steuercodes](https://docs.stripe.com/tax/tax-codes.md) fest, z. B. `txcd_10000000`, um automatisch einen anfänglichen Steuercode auszuwählen.                                                                                                                                                                                                                                                               | nicht definiert | Optional                   |

## Frühzeitigen Zugriff anfordern (Private Vorschau)

Melden Sie sich an oder [registrieren Sie sich für Stripe](https://dashboard.stripe.com/register), um Zugang zu dieser Vorschau der eingebetteten Komponente von Connect anzufragen.

## 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)
- [Tax für Marktplätze](https://docs.stripe.com/tax/tax-for-marketplaces.md)