# Batch-Aufträge

Mehrere API-Anfragen asynchron mit einem einzigen Datei-Upload verarbeiten.

Mit der Batch Jobs API können Sie Massenvorgänge an Stripe-Ressourcen durchführen. Anstatt für jeden Vorgang einen einzelnen API-Aufruf zu tätigen&nbsp;– was zu Begrenzungen führen kan&nbsp; –, können Sie eine Datei mit all Ihren Vorgängen hochladen und diese von Stripe asynchron verarbeiten lassen. Nutzen Sie Batch-Jobs für einmalige Migrationen, Massenaktualisierungen oder alle Vorgänge, bei denen zahlreiche Ressourcen verarbeitet werden müssen.

## Wann Sie Batch-Aufträge verwenden sollten

Batch-Aufträge funktionieren gut für:

- **Massenmigrationen**: Verschieben großer Mengen von Abonnements in neue Abrechnungsmodi.
- **Massenaktualisierungen**: Gleichzeitige Aktualisierung mehrerer Konten oder Abonnements.

Batch-Aufträge eignen sich nicht für:

- Vorgänge, die eine sofortige synchrone Antwort erfordern.
- Echtzeitverarbeitung mit engen zeitlichen Anforderungen.
- Eine einzige API-Anfrage.
- Sequentielle Abläufe, bei denen eine Anforderung vom Ergebnis einer anderen abhängt, wie beispielsweise das Anlegen von Kundinnen und Kunden und anschließend das Anlegen von Abonnements für diese. Führen Sie stattdessen jeden Schritt als separaten Batch-Job aus. Weitere Informationen finden Sie unter [Verwandte Objekte über Batches hinweg anlegen](https://docs.stripe.com/batch-api/create.md#create-related-objects-across-batches).
- Mehrere Aktualisierungen desselben Objekts in einem einzigen Stapel. Bei Stapelverarbeitung ist die Verarbeitungsreihenfolge nicht garantiert, sodass der Endzustand des Objekts nicht vorhersehbar ist.

## So funktioniert die Stapelverarbeitung

Jede Stapelverarbeitung durchläuft vier Schritte, die im Abschnitt [Ausführen einer Stapelverarbeitung](https://docs.stripe.com/batch-api/create.md) ausführlich behandelt werden:

1. [Erstellen Sie einen Batch-Auftrag](https://docs.stripe.com/batch-api/create.md#create-a-batch-job) und geben Sie den Ziel-API-Endpoint an.
2. [Laden Sie die Eingabedatei](https://docs.stripe.com/batch-api/create.md#upload-the-input-file) zusammen mit Ihren Anfragen hoch.
3. [Überwachen Sie den Auftragsstatus](https://docs.stripe.com/batch-api/create.md#monitor-job-status) über Webhooks oder Abfragen.
4. [Ergebnisse herunterladen](https://docs.stripe.com/batch-api/create.md#download-the-results).

## Unterstützte Endpoints

Die Batch Jobs-API unterstützt viele Endpoints in verschiedenen Stripe-Ressourcen. Jeder Batch-Auftrag zielt auf einen einzelnen Endpoint ab und alle Anfragen im Stapel werden an diesen Endpoint gesendet.

Eine vollständige Liste der verfügbaren Endpoints finden Sie unter [Unterstützte Endpoints](https://docs.stripe.com/batch-api/supported-endpoints.md).

## Einschränkungen

Prüfen Sie die folgenden Einschränkungen:

- Eingabedateien dürfen maximal 5&nbsp;GB groß sein. Sollten Sie eine größere Datei verarbeiten müssen, teilen Sie diese bitte in mehrere Stapelverarbeitungen auf.

- Die Stapelverarbeitung unterstützt ausschließlich JSONL-Dateien (JSON mit Zeilenumbrüchen). Die Stapelverarbeitung akzeptiert keine CSV-Dateien oder andere Formate.

- Anfragen in einem Stapel dürfen nur die Methoden `POST` oder `DELETE` verwenden. Stapelaufträge unterstützen die Methode `GET` nicht.

- Alle Anfragen in einem Batch müssen auf denselben API-Endpoint abzielen.

- Bei Batch-Aufträgen ist die Verarbeitungsreihenfolge nicht garantiert, und die Ergebnisdatei folgt nicht der Reihenfolge der Eingabedatei. Verwenden Sie das Feld `ID`, um jedes Ergebnis der entsprechenden Anfrage zuzuordnen.

- Stapelverarbeitungen haben eine maximale Verarbeitungsdauer von 7&nbsp;Tagen. Aufträge, die dieses Limit überschreiten, wechseln in den Status `Timeout`, wobei Teilergebnisse verfügbar sind.

- Stapelverarbeitungen haben ein Standardlimit von 2 Millionen Zeilen pro Durchlauf, wobei für einige [unterstützte Endpoints](https://docs.stripe.com/batch-api/supported-endpoints.md) niedrigere Limits gelten. Vorgänge, die das Limit ihres Endpoints überschreiten, schlagen bei der Validierung fehl und verarbeiten keine Anfragen. Um mehr Daten zu verarbeiten, [teilen Sie die Arbeitslast in sequenzielle Stapelverarbeitungen auf](https://docs.stripe.com/batch-api/best-practices.md#split-large-workloads). Wenn Sie mehr Kapazität benötigen, wenden Sie sich an den [Stripe-Support](https://support.stripe.com/contact).

- Die Ergebnisse stehen 30&nbsp;Tage nach Abschluss des Auftrags zum Download bereit. Jedes Mal, wenn Sie die Stapelverarbeitung abrufen, gibt Stripe eine neue Download-URL zurück.

- Die Upload-URL läuft 5&nbsp;Minuten nach der Erstellung des Auftrags ab. Nach Ablauf dieser Frist wechselt der Auftrag in den Status `upload_timeout` und Sie müssen einen neuen Auftrag erstellen.

- Sie müssen die Eingabedatei mit einer HTTP-`PUT`-Anfrage an die Upload-URL hochladen. Die URL akzeptiert keine anderen Methoden, wie beispielsweise `POST`.
