# Benutzerdefinierte Objekte

Definieren Sie Ihre eigenen Datenmodelle in Stripe.

Benutzerdefinierte Objekte ermöglichen es Ihnen, Ihre eigenen Datenmodelle in Stripe zu definieren, sodass Stripe widerspiegelt, wie Ihr Unternehmen arbeitet. Ihr Unternehmen verfügt möglicherweise über Daten, die nicht zu den Stripe-Standardobjekte passen, wie z. B. Lieferungen, Reservierungen oder Geräte. Definieren Sie diese in Stripe neben den Kundinnen und Kunden, Abonnements, Rechnungen und anderen Stripe-Daten, auf die sie sich beziehen. Behalten Sie Ihr bestehendes Aufzeichnungssystem bei und übernehmen Sie nur das, was Ihre Stripe-Integration benötigt, oder machen Sie benutzerdefinierte Objekte zum Aufzeichnungssystem für diese Daten. Mit benutzerdefinierten Objekten können Sie Folgendes tun:

- **Definieren Sie Ihr Unternehmen auf Stripe**: Stellen Sie Ihre Geschäftseinheiten, deren Beziehungen und ihren Lifecycle als typisierte Ressourcen dar. Referenzieren Sie Stripe-Objekte wie [Kunde/Kundin](https://docs.stripe.com/api/customers/object.md), [Rechnung](https://docs.stripe.com/api/invoices/object.md) und [Abonnement](https://docs.stripe.com/api/subscriptions/object.md) direkt aus Ihren eigenen Objekten.
- **Definieren Sie Ihre Daten im Code**: Beschreiben Sie Ihre Objekte in TypeScript und verpacken Sie sie in einer [Stripe-App](https://docs.stripe.com/stripe-apps.md). Wenn Sie die App hochladen, erstellt Stripe die API-Endpoints für Ihre Objekte, und Sie können aus Ihren Definitionen ein typisiertes SDK generieren.
- **Bauen Sie auf Ihren Daten auf**: Durchsuchen Sie Ihre Datensätze, reagieren Sie mit Ereignissen und [Workflows](https://docs.stripe.com/workflows.md) auf Änderungen und erstellen Sie mit [Stripe Apps](https://docs.stripe.com/stripe-apps.md) Ihre eigenen Ansichten Ihrer Datensätze im Dashboard.
- **Reduzieren Sie die Backend-Komplexität**: Speichern und verwalten Sie Ihre Geschäftsdaten zusammen mit Ihren Stripe-Daten über eine konsistente API, ohne eine separate Datenbank betreiben zu müssen, nur um diese zu speichern.

Benutzerdefinierte Objekte befinden sich in der [privaten Vorschau](https://docs.stripe.com/release-phases.md).

### Sie möchten frühzeitigen Zugriff auf benutzerdefinierte Objekte erhalten?

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/custom-objects" \
  -d '{"email": "EMAIL", "preview": "custom_objects_private_preview"}'
```

## Das können Sie entwickeln

Benutzerdefinierte Objekte eignen sich für Unternehmen, deren Daten über die Stripe-Standardobjekte hinausgehen. Zum Beispiel:

- **Hardwarebasierte Abonnements**: Verfolgen Sie Geräte, wo sie installiert sind, und verfolgen Sie ihren Lifecycle neben den Abonnements, über die sie abgerechnet werden.
- **Reservierungen und Buchungen**: Bewahren Sie Reservierungen und Gästepräferenzen neben den Zahlungen und Rechnungen auf, die sie erklären.
- **Lieferungen und Ausführung**: Verfolgen Sie Lieferungen und den Lieferstatus neben den Rechnungen, die damit erfüllt werden.
- **Kundenanfragen und Follow-ups**: Verfolgen Sie Stornierungs- und Rückerstattungsanfragen und verwenden Sie Workflows, um die Stripe-Änderungen vorzunehmen, die sie nach sich ziehen.
- **Operations-Dashboards in Stripe**: Erstellen Sie eine ganzseitige App, die Ihrem Team einen zentralen Ort im Dashboard bietet, um dort mit Ihren Datensätzen und den von ihnen referenzierten Stripe-Objekten zu arbeiten.

Weitere Beispiele und Anleitungen dazu, wann benutzerdefinierte Objekte verwendet werden sollten, finden Sie unter [Use Cases für benutzerdefinierte Objekte](https://docs.stripe.com/custom-objects/use-cases.md).

## Funktionsweise benutzerdefinierter Objekte

Sie definieren Ihre Objekte einmal und arbeiten dann in in allen Bereichen von Stripe mit deren Datensätzen:

1. **Definieren Sie Ihr Objekt**: Erstellen Sie eine Objektdefinition mit den Feldern, die Ihr Unternehmen benötigt. Sie definieren Objekte im Code und verpacken sie in einer Stripe-App.
2. **Arbeiten Sie mit Datensätzen**: Erstellen, abrufen, aktualisieren, listen, durchsuchen und löschen Sie Datensätze über die `/v2/extend/objects/<plural_name>` API. Sie können auch ein typisiertes SDK aus Ihren Definitionen generieren.
3. **Reagieren Sie auf Änderungen**: Jede Objektdefinition sendet Ereignisse, wenn sich ihre Datensätze ändern. Verwenden Sie diese, um Workflows zu starten oder Ihre anderen Systeme zu aktualisieren.
4. **Im Dashboard anzeigen**: Zeigen Sie Ihre Definitionen an und betrachten, durchsuchen und filtern Sie Ihre Datensätze im Stripe-Dashboard.

## Was in der privaten Vorschau verfügbar ist

In der privaten Vorschau können Sie Folgendes tun:

- Benutzerdefinierte Objekte im Code definieren und in einer Stripe-App verpacken, mit typisierten Feldern, Validierung und Referenzen
- Datensätze über die API erstellen, abrufen, aktualisieren, auflisten, durchsuchen und löschen
- Ein typisiertes Node.js-SDK aus Ihren Definitionen generieren
- Neue Versionen der Definitionen Ihrer benutzerdefinierten Objekte veröffentlichen, wenn sich Ihr Schema ändert
- Ereignisse für jede Objektdefinition erhalten, wenn sich deren Datensätze ändern
- Benutzerdefinierte Objekte in Workflows verwenden, sowohl als Auslöser als auch als Schritte, die Datensätze erstellen und aktualisieren
- Mit Stripe-Apps Dashboard-Ansichten und ganzseitige Apps für Ihre Datensätze erstellen
- Ihre Definitionen anzeigen und Ihre Datensätze im Dashboard betrachten, durchsuchen und filtern (das Dashboard ist in der privaten Vorschau schreibgeschützt)

Während der privaten Vorschau funktionieren benutzerdefinierte Objekte innerhalb eines einzigen Stripe-Kontos. Sie unterstützen keine kontoübergreifende Freigabe. Weitere Einschränkungen finden Sie unter [Limits und Einschränkungen](https://docs.stripe.com/custom-objects/limitations.md).

## Nächste Schritte

- [So funktionieren benutzerdefinierte Objekte](https://docs.stripe.com/custom-objects/how-it-works.md)
- [Mit benutzerdefinierten Objekten loslegen](https://docs.stripe.com/custom-objects/get-started.md)
- [Benutzerdefinierte Objekte definieren](https://docs.stripe.com/custom-objects/define.md)
