Verbrauch
Überblick
Nutzungsbasierte Abrechnung berechnet, was tatsächlich verbraucht wurde: API-Aufrufe, Stunden, Gigabyte, Arbeitsplätze. Jede Meldung ist eine Verbrauchszeile mit Kunde, Größe, Menge und Zeitpunkt. Offene Zeilen fließen beim nächsten Lauf je Größe zusammengefasst in die Abrechnungs-Vorschau des Kunden; danach stehen sie auf Abgerechnet.
Normalerweise kommen die Zeilen über die Schnittstelle herein — aus dem System, das den Verbrauch misst. Von Hand erfasst wird, was nachgetragen werden muss. Die Seite steht im Menü als Unterpunkt von Abrechnung.
Kernaufgaben
Verbrauch prüfen. Die Liste zeigt Zeitpunkt, Kunde, Größe mit Beschreibung, Menge mit Einheit, Einzelpreis und Status Offen oder Abgerechnet. Filtern lässt sich nach Kunde, Größe, Abgerechnet und Bezug. Steht statt eines Preises Preis aus dem Plan, gilt der Preis des Abrechnungsplans.
Verbrauch erfassen. Verbrauch erfassen legt eine Zeile von Hand an. Pflicht sind Kunde, Größe und Menge.
Korrigieren. Eine Verbrauchszeile lässt sich nach dem Erfassen weder ändern noch löschen — auch nicht über die Schnittstelle. Eine zu viel erfasste Menge gleichen Sie mit einer negativen Zeile derselben Größe aus.
Zur Abrechnung. Zu den Abrechnungen führt zur Liste der Vorschauen.
Felder im Detail
Verbrauch erfassen
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kunde customerId | ja | bestehender Kunde | Wem der Verbrauch berechnet wird. |
Größe metric | ja | Text, max. 60 Zeichen, z. B. api_calls | Der abgerechnete Wert. Zeilen derselben Größe werden in der Vorschau zusammengefasst — schreiben Sie sie deshalb immer gleich. |
Einheit unit | nein | Text, max. 50 Zeichen | Stunden, Stück, GB … Steht in der Liste neben der Menge. |
Menge quantity | ja | Zahl mit bis zu vier Nachkommastellen, nicht 0 | Wie viel verbraucht wurde. Ein negativer Wert korrigiert eine zu viel erfasste Menge. |
Einzelpreis (netto) unitPriceAmount | nein | Betrag | Preis je Einheit. Leer = es gilt der Preis des Abrechnungsplans. |
Zeitpunkt occurredAt | nein | Datum und Uhrzeit; leer = jetzt | Entscheidet, in welche Abrechnungsperiode die Zeile fällt. |
Bezug subjectType | nein | Lizenz, Vertrag, Auftrag oder ohne | Worauf sich der Verbrauch bezieht. |
Bezugs-Kennung subjectRef | nein | Text, max. 100 Zeichen | Welche Lizenz, welcher Vertrag oder Auftrag gemeint ist. |
Fremd-Referenz externalRef | nein | Text, max. 100 Zeichen | Kennung im meldenden System. Dieselbe Referenz legt keine zweite Zeile an; die Schnittstelle liefert dann die bestehende zurück. So darf ein System eine Meldung gefahrlos wiederholen. |
Beschreibung description | nein | Text, max. 255 Zeichen | Steht in der Liste unter der Größe. |
Nur über Schnittstelle und Automation
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
brandId | Marke; leer = ohne Marke | Marke der Zeile. Setzen darf sie nur, wer in dieser Marke Abrechnungen verwalten darf. |
Einstellungen & Rechte
- Modul
module.finance. - Sehen:
finance.billing.view. Erfassen:finance.recurring.manage— ohne es fehlt der
Knopf Verbrauch erfassen.
- Schnittstelle:
POST /api/v1/usage-records(mitexternalRefwiederholbar),
GET /api/v1/usage-records mit den Filtern customerId, brandId, metric, billed, subjectType, subjectRef, from und to.
FAQ & Fehlerbilder
**Eine Zeile steht noch auf Offen.** Sie wird erst beim nächsten Abrechnungslauf ihres Kunden verrechnet; maßgeblich ist ihr Zeitpunkt.
Eine Meldung kam zweimal, steht aber nur einmal da. So gewollt, wenn beide dieselbe Fremd-Referenz tragen.
Die Menge ist falsch. Nicht ändern — mit einer negativen Zeile ausgleichen.
„customerId, metric und quantity sind erforderlich." Beim Einliefern über die Schnittstelle fehlt eines der drei Pflichtfelder.