# Fügt Support für Rechnungsposten-Metadaten und den Zeitraum in Abonnements und Zeitplänen hinzu

## Das ändert sich

Wir haben eine neue Möglichkeit eingeführt, die Felder `metadata` und `period` für [einmalige Rechnungsposten](https://docs.stripe.com/api/invoiceitems.md?api-version=2025-08-27.basil), die von [Abonnements](https://docs.stripe.com/api/subscriptions.md?api-version=2025-08-27.basil) und [Abonnementplänen](https://docs.stripe.com/api/subscription_schedules.md?api-version=2025-08-27.basil) generiert werden, anzupassen.

- Sie können `metadata` direkt anhängen, wenn Sie `add_invoice_items` konfigurieren. Damit entfällt die Notwendigkeit, diese Informationen später in nachfolgenden und separaten API-Aufrufen hinzuzufügen.

- Sie können benutzerdefinierte Daten für `period.start` und `period.end` festlegen, die die Standarddaten für den Rechnungsstellungszyklus eines Abonnements überschreiben. So können Sie die Zeiträume für die Revenue Recognition von einmaligen Abbuchungen genau steuern. Wir haben auch Zeitstempelindikatoren (wie `max_item_period_start` und `min_item_period_end` für Abonnements, `phase_start` und `phase_end` für Zeitpläne) aufgenommen. Auf diese Weise können Sie die Daten an wichtigen Zeitstempeln wie Rechnungsstellungszeiträumen für Abonnements oder Phasenterminen für Abonnementpläne ausrichten.

## Auswirkungen

Spezifizieren Sie das Feld `metadata` oder das Feld `period` für `add_invoice_items` über die folgenden API Endpoints:

- [Erstellen](https://docs.stripe.com/api/subscriptions/create.md?api-version=2025-08-27.basil) oder [aktualisieren Sie](https://docs.stripe.com/api/subscriptions/update.md?api-version=2025-08-27.basil) Abos.
- [Erstellen](https://docs.stripe.com/api/subscription_schedules/create.md?api-version=2025-08-27.basil) oder [aktualisieren Sie](https://docs.stripe.com/api/subscription_schedules/update.md?api-version=2025-08-27.basil) Zeitpläne.
- [Erstellen Sie](https://docs.stripe.com/api/invoices/create_preview.md?api-version=2025-08-27.basil) eine Vorschau-Rechnung, indem Sie die `schedule_details` angeben.

## Änderungen

#### REST API

#### Ruby

#### Python

#### PHP

Diese Änderung wirkt sich nicht auf das PHP SDK aus.

#### Java

#### Node.js

#### Gehen Sie zu

#### .NET

## Upgrade

#### REST API

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
   - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2025-08-27.basil`
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Ruby SDK auf [v15.5.0](https://github.com/stripe/stripe-ruby/releases/tag/v15.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Python

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Python SDK auf [v12.5.0](https://github.com/stripe/stripe-python/releases/tag/v12.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr PHP SDK auf [v17.6.0](https://github.com/stripe/stripe-php/releases/tag/v17.6.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Java

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Java SDK auf [v29.5.0](https://github.com/stripe/stripe-java/releases/tag/v29.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Node SDK auf [v18.5.0](https://github.com/stripe/stripe-node/releases/tag/v18.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### Go

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr Go SDK auf [v82.5.0](https://github.com/stripe/stripe-go/releases/tag/v82.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an.
1. Aktualisieren Sie Ihr .NET SDK auf [v48.5.0](https://github.com/stripe/stripe-dotnet/releases/tag/v48.5.0)
1. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version.
1. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version.
1. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md).
1. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version).

Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md).

## Zugehörige Änderungen

- [Fügt dem Konfigurationsobjekt des Kundenportals ein Namensfeld hinzu](https://docs.stripe.com/changelog/basil/2025-08-27/customer-portal-config-name.md)
- [Unterstützt Drittanbieter-Steuer-Apps für Abos mit flexiblem Abrechnungsmodus](https://docs.stripe.com/changelog/basil/2025-08-27/3p-tax.md)