Was sind Kundengruppen?
Kundengruppen sind eines der einfachsten, aber mächtigsten Konzepte in BillingEngine. Eine Gruppe ist ein benannter Container, dem Sie Kunden zuweisen. Preisregeln zielen dann auf diese Gruppen ab — so bestimmen Sie, wer welche Preisliste erhält.
Typische Verwendungszwecke von Gruppen:
- Kundensegmentierung — VIP, Standard, Startup, Enterprise
- Geografische Segmentierung — Kunden in verschiedenen Regionen mit unterschiedlichen Tarifen
- Projektgruppen — temporäre Gruppen für Aktionen oder Pilotprogramme
- Vertragsgruppen — Kunden mit Sonderverträgen, die spezifische Preislisten erfordern
Erstellen einer Gruppe
POST /api/v1/groups
Content-Type: application/json
{
"name": "VIP-Kunden",
"description": "Kunden mit monatlichem Umsatz über 50.000 EUR"
}
Kunden Gruppen zuweisen
Ein Kunde kann gleichzeitig Mitglied mehrerer Gruppen sein. Das ermöglicht flexible Kombinationen — ein Kunde kann gleichzeitig in der “VIP”-Gruppe und in der “Sommer-Aktion 2026”-Gruppe sein.
POST /api/v1/groups/{groupId}/customers
Content-Type: application/json
{ "customer_id": "uuid-des-kunden" }
Einen Kunden aus einer Gruppe entfernen:
DELETE /api/v1/groups/{groupId}/customers/{customerId}
Gruppen und Preisregeln
Eine Gruppe an sich berechnet nichts — sie ist nur ein Container. Die eigentliche Arbeit leisten Preisregeln, die über group_id auf die Gruppe verweisen. Wenn die Engine einen Datensatz bewertet, prüft sie, ob der Kunde zur in der Regel angegebenen Gruppe gehört.
POST /api/v1/pricing-rules
Content-Type: application/json
{
"name": "VIP-Kunden — Retail-Preise 2026",
"code": "VIP-RETAIL-2026",
"billing_category": "retail",
"price_list_id": "uuid-vip-preisliste",
"group_id": "uuid-vip-gruppe",
"priority": 100,
"valid_from": "2026-01-01"
}
Beispiel: Segmentierungsarchitektur
Gruppen:
VIP-Kunden → Regeln mit Priorität 100+
Standard → Regeln mit Priorität 10
Startup-Programm → Regeln mit Priorität 50
Temporäre Gruppen für Aktionen
Gruppen sind das ideale Werkzeug für zeitlich begrenzte Aktionen:
- Gruppe
"Sommer-Aktion 2026"erstellen - Regel mit hoher Priorität auf diese Gruppe ausrichten
- Ausgewählte Kunden hinzufügen
- Nach der Aktion: Kunden aus der Gruppe entfernen oder Gruppe löschen
Gruppen vs. direkte Kundenzuweisung
Eine Preisregel kann über customer_id auch direkt auf einen bestimmten Kunden abzielen — ohne Gruppe. Das ist für individuelle Einzelfallvereinbarungen oder Ausnahmen geeignet.
Gruppen sind für die meisten Fälle die bessere Wahl:
- Skalierbarkeit — einen neuen Kunden zur Gruppe hinzuzufügen ist sofort erledigt, keine neue Regel nötig
- Konsistenz — alle Kunden in einer Gruppe erhalten identische Konditionen aus derselben Regel
- Übersichtlichkeit — klare Logik: Gruppe X → Regel Y → Preisliste Z
- Prüfbarkeit — aus einem bewerteten Eintrag ist ersichtlich, über welche Gruppe die Regel ausgelöst wurde
Direktes customer_id auf einer Regel ist nur für wirklich individuelle Fälle geeignet. Für die Segmentierung verwenden Sie Gruppen.
Best Practices
Klare Segmentierungsstrategie. Überlegen Sie vor dem Erstellen von Gruppen, wie Sie Kunden segmentieren möchten.
Gruppen dokumentieren. Das description-Feld vollständig nutzen — beschreiben, wer zur Gruppe gehört und warum.
Mitgliedschaften regelmäßig überprüfen. Kunden, die nicht mehr zur Gruppe gehören, erhalten möglicherweise falsche Preise.
Leere Gruppen entfernen. Leere Gruppen verunreinigen die Konfiguration unnötig.
Fazit
Kundengruppen sind ein einfacher, aber leistungsstarker Segmentierungsmechanismus. In Kombination mit Preisregeln ermöglichen sie die Modellierung beliebig komplexer Preisstrategien ohne doppelte Konfiguration. Kapitel 4 konzentriert sich auf Kunden selbst.