Usage & Billing Operations prüfen

Diese Seite richtet sich an Administratoren und fachliche Verantwortliche, die gemeldete Nutzung im Browser prüfen und abrechnungsfähig konfigurieren. Nach Abschluss wissen Sie, wie externe Quellen Nutzung melden, wie Workspace daraus bewertete Positionen bildet und wie Finance später die rechtlich relevante Rechnung erzeugt.

Nutzen Sie Usage & Billing für SaaS-Verbrauch, Maschinenlaufzeiten, Compute-Ressourcen, API-Aufrufe, Sensor- oder Monitoring-Daten. Für technische API-Details und Payload-Beispiele nutzen Sie Usage & Billing per API integrieren.

Der wichtigste Grundsatz lautet:

> Workspace misst Nutzung, bewertet Nutzung und erzeugt abrechenbare Positionen. > Finance erzeugt die rechtlich relevante Rechnung.

Gesamtfluss

Usage & Billing arbeitet als kontrollierte Kette. Externe Systeme senden nicht direkt Rechnungen, sondern melden Nutzung und Ressourcen. Workspace prüft, aggregiert und bewertet diese Nutzung. Erst danach entsteht eine Abrechnungsanforderung, die als geprüfter Übergabepunkt an Finance dient.

Konfigurationsmodell

Konfigurieren Sie Usage & Billing in mehreren Stufen. Jede Stufe hat eine klare Aufgabe und bleibt im selben Mandantenkontext.

Abrechnungsmodelle wählen

Usage & Billing unterstützt subscriptiongebundene, rein nutzungsbasierte und hybride Modelle. Sie entscheiden das Modell über die Metered Resource. Die Metered Resource muss auf eine gemessene Service-Variante zeigen, wenn die spätere Übergabe an Finance möglich sein soll. Diese Variante definiert den Messvertrag; die Metered Resource bindet ihn an konkrete Quelle, Kunde, Vertrag und Preis.

Wenn in einem Monat keine bewertete Nutzung anfällt, entsteht kein Billing Request. Workspace erzeugt keine automatische Null-Euro-Rechnung. Ob Finance eine separate 0-Euro-Rechnung erzeugt, ist eine Finance-Entscheidung und nicht Teil von Usage & Billing.

Externe Systeme anbinden

Modellieren Sie ein externes System zuerst als Usage Source. Für Maschinen, Sensoren und Industrieanlagen ist oft ein Gateway oder Aggregator die passende Quelle: Das Gateway sammelt lokale Ereignisse, normalisiert sie und sendet Batches an Workspace.

Für eine vermietete Maschine, VM oder USV-Konfiguration gehen Sie so vor:

1. Legen Sie eine Usage Source für das sendende System oder Gateway an.
2. Rotieren Sie ein Ingest Credential und hinterlegen Sie Key und Secret im sendenden System.
3. Begrenzen Sie allowedSubjects auf die erlaubten Nutzungsarten.
4. Lassen Sie das System Ressourcen deklarieren, zum Beispiel compute_vm, machine_capacity, ups oder sensor_cluster.
5. Aktivieren Sie jede fachlich abrechenbare Resource Declaration als Metered Resource.
6. Legen Sie eine Produktfamilie an, die Services und Measurement erlaubt, und markieren Sie die passende Produktvariante als Service und als gemessen.
7. Pflegen Sie den Messvertrag über usage.meter_kind, usage.pricing_unit, usage.measurement_category und usage.allowed_subjects.
8. Ordnen Sie die Metered Resource dieser Service-Variante, einem Abrechnungssubjekt, optional einem Abonnement und einer Abrechnungsvereinbarung zu.
9. Konfigurieren Sie Preisfelder: Einzelpreis, Freimenge, Mindestbetrag, Höchstbetrag, Preiseinheit und Währung.
10. Lassen Sie das externe System Usage Events mit stabiler externer Ereignis-ID und Zeitraum senden.

Beispiel für eine fachliche Konfiguration:

{
  "sourceKey": "factory-gateway-berlin",
  "allowedSubjects": {
    "subjects": [
      "machine.runtime.hour",
      "compute.cpu.minute",
      "compute.memory.gib_hour",
      "ups.battery.monitored_hour"
    ]
  },
  "meteredResource": {
    "resourceRef": "vm-prod-17",
    "resourceType": "compute_vm",
    "serviceVariantId": "0190f1e0-0000-7000-9000-000000000001",
    "billingArrangementKey": "managed-compute",
    "rateCardKey": "standard-2026",
    "unitPriceNet": "0.0200",
    "includedQuantity": "1000",
    "maximumAmountNet": "99.0000",
    "pricingUnit": "minute",
    "currency": "EUR"
  }
}

Die zugehörige Service-Variante kann zum Beispiel diese Attribute tragen:

{
  "usage": {
    "meter_kind": "flow",
    "pricing_unit": "minute",
    "measurement_category": "compute",
    "allowed_subjects": [
      "compute.cpu_core_minute",
      "compute.storage_gib_hour",
      "network.tcp_gb"
    ],
    "requires_billing_subject": true,
    "requires_usage_contract": true
  }
}

Für Sensoren, Maschinen und Workspace-interne Nutzung bleibt das Muster gleich: Ändern Sie Kategorie, Einheit und Subjects, nicht den Abrechnungsprozess.

Robuste Datensammlung

Behandeln Sie die Ingest-API wie einen Maschinenpfad. Sie darf unter Last nicht von manueller Bedienung abhängen.

• Nutzen Sie Batches statt Einzelevents, wenn das sendende System viele Events erzeugt.
• Setzen Sie pro Quelle ein Rate Limit, das zur erwarteten Last passt.
• Verwenden Sie stabile externe Ereignis-IDs, damit Wiederholungen prüfbar bleiben.
• Senden Sie Zeiträume mit periodStart und periodEnd, wenn die Nutzung eine Dauer beschreibt.
• Nutzen Sie dimensions für prüfbare Zusatzinformationen wie Workspace, Modell, Maschine, Standort, Tarif oder Sensorgruppe.
• Lassen Sie Gateways lokal puffern, wenn das Netz oder Workspace temporär nicht erreichbar ist.
• Prüfen Sie Ingest Receipts regelmäßig auf Duplikate, abgelehnte Events und Rate-Limit-Situationen.

Für hohe Volumina bleibt PostgreSQL der MVP-Speicher. Erst wenn Events dauerhaft in sehr großer Menge anfallen, wird ein spezialisiertes Event- oder Analytics-Backend wie ClickHouse relevant.

Operationsbereich öffnen

1. Melden Sie sich im Zielmandanten an.
2. Öffnen Sie im Hauptmenü Handel > Nutzung & Abrechnung. Alternativ öffnen Sie die Suche und geben Nutzung & Abrechnung ein.
3. Prüfen Sie zuerst Ressourcenmeldungen.
4. Öffnen Sie danach Nutzungsressourcen, Eingangsprotokolle, Nutzungsereignisse, Aggregate, Abrechnungsanforderungen, Nutzungsnachweise und Finance-Entwürfe.
5. Öffnen Sie Handel > Nutzung & Abrechnung > Konfiguration > Abrechnungsperioden, wenn Sie Perioden schließen oder wieder öffnen.

Resource Declaration aktivieren

Aktivieren Sie eine Resource Declaration erst, wenn die gemeldete Ressource fachlich abrechenbar ist.

1. Öffnen Sie eine Resource Declaration mit Status pending.
2. Prüfen Sie Quelle, resourceRef, resourceType, Name und Metadaten.
3. Starten Sie die Aktivierung.
4. Setzen Sie Abrechnungssubjekt, optionales Abonnement, Abrechnungsvereinbarung, Preiskarte, Preisfelder, Freimenge, Mindestbetrag, Cap, Preiseinheit und Währung.
5. Speichern Sie die Aktivierung.

Workspace erstellt oder verlinkt danach eine Metered Resource im selben Mandanten und in derselben Usage Source. Erst die Metered Resource enthält die Billing-Zuordnung und Preislogik.

Nutzung und Übergabe prüfen

Prüfen Sie den weiteren Ablauf in dieser Reihenfolge:

Ein Usage Finance Draft ist keine Rechnung. Er übergibt bewertete Nutzung an Finance. Finance erstellt später den Rechnungsentwurf oder die rechtlich relevante Rechnung.

JSON-Snapshots prüfen

Usage & Billing speichert Audit-Snapshots an den Übergängen. Diese Snapshots sind bewusst nicht als normaler Freitext gedacht. Prüfen Sie sie im JSON-Code-Editor des Detaildialogs:

• financeHandoffSnapshot auf der Abrechnungsanforderung zeigt die geplante Übergabe an Finance.
• ratingSnapshot auf einer Position zeigt, wie Menge, Freimenge, Preis, Mindestbetrag und Cap bewertet wurden.
• sourceBillingRequest auf Nutzungsnachweisen und Finance-Entwürfen zeigt den Quellzustand der Abrechnungsanforderung.
• linesSnapshot zeigt die geprüften Positionen.
• financeTargetSnapshot zeigt die Zielstruktur für Finance.

Wenn ein Snapshot fachlich falsch wirkt, korrigieren Sie nicht den Snapshot. Korrigieren Sie Quelle, Metered Resource, Preisfelder oder Periodenstatus über die vorgesehenen Bedien- und API-Pfade und erzeugen Sie die betroffenen Folgeobjekte neu.

Status einordnen

Fehlerbilder prüfen

Grenzen

Usage & Billing erzeugt keine automatische Null-Euro-Rechnung für Monate ohne Nutzung. Ohne bewertete Events entsteht kein Billing Request.

Ändern Sie Bestandsdaten nicht direkt in der Datenbank. Korrigieren Sie Source, Metered Resource, Preisfelder oder Periodenstatus über die vorgesehenen Bedien- und API-Pfade.