# Nutzung für Abrechnungszwecke aufzeichnen

Erfahren Sie, wie Sie die Nutzung für Ihre Kundinnen und Kunden aufzeichnen und melden.

> Wir haben die Funktionsweise der nutzungsbasierten Abrechnung aktualisiert. Weitere Informationen finden Sie in der [Dokumentation zur aktualisierten nutzungsbasierten Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based.md).
> 
> So läuft die [Migration](https://docs.stripe.com/billing/subscriptions/usage-based-legacy/migration-guide.md) ab.

Während jedes Abrechnungszeitraums müssen Sie die Nutzung an Stripe melden, damit den Kundinnen und Kunden die korrekten Beträge in Rechnung gestellt werden. Sie können Ihr eigenes System zum Erfassen des Nutzungsverhaltens verwalten und Stripe Nutzungsdaten für Abonnements bereitstellen.

Sie können Informationen zur Nutzung an Stripe weitergeben, indem Sie [Nutzungsdaten](https://docs.stripe.com/api.md#usage_record_create) mit einem Abonnementartikel, der genutzten Menge und einem Zeitstempel erstellen. Wie häufig Sie die Nutzung melden, bleibt Ihnen überlassen. Sie können den Code beispielsweise in einem Intervall (zum Beispiel alle 24 Stunden) für jedes nutzungsbasierte Abonnement ausführen. Am Ende des Abrechnungszeitraums berechnet Stripe automatisch den Gesamtpreis und erstellt [Rechnungen](https://docs.stripe.com/billing/invoices/subscription.md) für die gesamte Nutzung während des Abrechnungszeitraums.

#### curl

```bash
curl https://api.stripe.com/v1/subscription_items/{{SUBSCRIPTION_ITEM_ID}}/usage_records \
  -u <<YOUR_SECRET_KEY>>: \
  -X POST \
  -d quantity=100 \
  -d timestamp=1776224085 \
  -d action=increment
```

## Best Practices für die Aufzeichnung der Nutzung

- Sie müssen einen Teil Ihrer eigenen Geschäftslogik schreiben, bevor Sie die Nutzungsdaten erstellen. Rufen Sie einen Datensatz einer Kundin/eines Kunden aus Ihrer Datenbank ab und extrahieren Sie die Posten-ID und die Tagesnutzung des Stripe-Abonnements. Wenn Sie keine Abonnementposten-IDs speichern, rufen Sie das Abonnement ab und suchen Sie nach [Abonnementposten](https://docs.stripe.com/api/subscriptions/object.md#subscription_object-items).
- Mit [Idempotenz-Schlüsseln](https://docs.stripe.com/api/idempotent_requests.md) stellen Sie sicher, dass die Nutzung aufgrund von Latenz oder anderen Problemen nicht mehr als einmal gemeldet wird.
- Der `timestamp` muss innerhalb des aktuellen Abrechnungszeitraums liegen, andernfalls schlägt der Aufruf fehl.
- Der Standardwert für den Parameter `action` ist `increment`. Bei diesem Wert wird vorausgesetzt, dass der Preis mit `aggregate_usage=sum` konfiguriert ist und dass Sie die Nutzung in Echtzeit erfassen und mit dem aktuellen `timestamp` an Stripe übergeben.
- Der Wert `set` für den Parameter `action` ist für den Fall geeignet, dass Sie die Nutzung selbst zusammenfassen und den Preis mit `aggregate_usage=last_during_period` oder `aggregate_usage=last_ever` konfigurieren.
- Der Endpoint für die Nutzungsberichte verfügt über eine Ratenbegrenzung und die Stripe API hat eine Ratenbegrenzung von 100 Aufrufen pro Sekunde pro Konto. Auf Anfrage können wir diese Anzahl auf 200 Aufrufe pro Sekunde und Konto erhöhen. Wenn Sie eine Dienstleistung anbieten, von der Sie erwarten, dass sie dieses Limit überschreitet, sollten Sie Ihr Produkt in Beträge „bündeln“. Wenn Sie beispielsweise pro 1000 Anfragen abrechnen, sollten Sie Ihr Produkt auf „pro 1000 Transaktionen“ setzen und einen Nutzungsdatensatz pro 1000 senden.

### Uhrenfehler

Das Melden der Nutzung außerhalb des aktuellen Abrechnungszeitraums führt zu einem Fehler. Um Uhrenfehler zwischen Ihrem Server und den Stripe-Systemen auszugleichen, gewähren wir einen kurzen Kulanzzeitraum im Standard-Gruppierungsmodus (`aggregate_usage` = `sum`). Bei allen anderen Gruppierungsmodi muss der `timestamp` innerhalb des aktuellen Zeitraums liegen.

In den ersten Minuten jedes Abrechnungszeitraums können Sie die Nutzung melden, die in den letzten Minuten des vorherigen Zeitraums stattgefunden hat. Wenn die Rechnung für den vorherigen Zeitraum nicht finalisiert wurde, fügen wir die Nutzung zu dieser Rechnung hinzu. Andernfalls rechnen wir die Nutzung für den aktuellen Zeitraum ab. Nach dem Kulanzzeitraum können Sie die Nutzung aus dem vorherigen Abrechnungszeitraum nicht mehr melden.

Verlassen Sie sich nicht auf den Kulanzzeitraum, um Nutzung außerhalb eines Abrechnungszeitraums zu melden. Dieser ist nur gedacht, um eine mögliche Abweichung der Uhr zu berücksichtigen, und wir können ihn nicht garantieren.

## Aktuelle Nutzung abrufen

Um die Gesamtnutzung für den aktuellen Zeitraum zu prüfen, können Sie [eine Vorschau-Rechnung](https://docs.stripe.com/api/invoices/create_preview.md) für das Abonnement abrufen. Die Nutzung ist als `quantity` des [Rechnungspostens](https://docs.stripe.com/api.md#invoiceitems) für das `subscription_item` angegeben. Der Gesamtnutzungswert entspricht möglicherweise nicht der aktuellen Menge, da es zu geringfügigen Verzögerungen bei der Verarbeitung kommen kann.

```curl
curl https://api.stripe.com/v1/invoices/create_preview \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d subscription={{SUBSCRIPTION_ID}}
```