Kapitel 2 – Fachliche Grundlagen und Systemarchitektur
Ziel dieses Kapitels
Dieses Kapitel vermittelt die grundlegenden Fachbegriffe und Zusammenhänge des becharged ERPNext-Systems. Nach dem Lesen dieses Kapitels sollte jeder neue Mitarbeiter die wichtigsten Datenobjekte, Vertragsarten und deren Zusammenspiel verstehen.
Die beschriebenen Begriffe bilden die Grundlage für alle weiteren Kapitel dieser Dokumentation.
2.1 Glossar
API (Application Programming Interface)
Eine API ermöglicht den automatischen Datenaustausch zwischen Gridware und ERPNext. Sämtliche Stammdaten, Vertragsinformationen sowie Verbrauchsdaten werden über definierte REST-Schnittstellen synchronisiert.
Billing Period
Die Billing Period definiert den Abrechnungszeitraum, für den Verbrauchsdaten gesammelt und fakturiert werden.
Beispiele:
- Januar 2026
- Februar 2026
Die Billing Period dient als gemeinsame Grundlage für Customer Usage Data, Supplier Usage Data sowie die spätere Rechnungsstellung.
Gridware
Gridware ist das führende System für die technische Verwaltung der Ladeinfrastruktur.
Gridware verwaltet unter anderem:
- Organisationen
- Personen
- Verträge
- Ladevorgänge
- Zahlungsmethoden
- Ladepunkte
ERPNext übernimmt diese Informationen über verschiedene APIs.
ERPNext
ERPNext ist das führende kaufmännische System.
Hier erfolgen unter anderem:
- Stammdatenverwaltung
- Rechnungsstellung
- Lieferantenabrechnung
- Zahlungsverwaltung
- SEPA
- Mahnwesen
- DATEV Export
Gridware Party
Eine Gridware Party repräsentiert einen Vertragspartner innerhalb von Gridware.
Je nach Anwendungsfall handelt es sich dabei um:
- eine Organisation
- eine natürliche Person
Während der Synchronisation wird die Gridware Party automatisch einem Customer oder Supplier in ERPNext zugeordnet.
Gridware Contract
Der Gridware Contract bildet den zentralen Vertrag zwischen den beteiligten Parteien.
Er enthält unter anderem:
- Vertragsart
- Contract Giver/Lieferant
- zugehörige Kunden
- Zahlungsinformationen
- Billing-Konfiguration
Alle späteren Abrechnungsprozesse basieren auf diesem Vertrag.
Gridware Usage
Gridware Usage beschreibt einen einzelnen Ladevorgang bzw. eine abrechnungsrelevante Nutzung.
Jeder Datensatz enthält beispielsweise:
- Ladepunkt
- Zeitraum
- Energiemenge
- Vertragsreferenz
- Status
Diese Daten bilden die Grundlage für sämtliche Abrechnungen.
Customer Usage Data
Customer Usage Data stellt die aggregierte Abrechnungseinheit eines Kunden innerhalb einer Billing Period dar.
Mehrere einzelne Gridware Usages werden zu einem Customer Usage Data zusammengefasst.
Das Customer Usage Data dient als Grundlage für die Erstellung einer Sales Invoice.
Supplier Usage Data
Supplier Usage Data bildet die entsprechende Aggregation für Lieferanten.
Es dient als Grundlage für die Erstellung einer Gutschrift per Purchase Invoice.
Sales Invoice
Die Sales Invoice ist die Kundenrechnung.
Purchase Invoice
Die Purchase Invoice dient der Lieferantenabrechnung.
SEPA Mandate
Ein SEPA Mandate berechtigt becharged zum Einzug der offenen Forderungen per Lastschrift.
Die Mandate werden über Gridware synchronisiert und in ERPNext verwaltet.
Payment Entry
Payment Entries dokumentieren Zahlungsein- und -ausgänge innerhalb von ERPNext.
Contract Type
Der Contract Type beschreibt das Geschäftsmodell eines Vertrages.
Der Contract Type steuert maßgeblich die spätere Abrechnungslogik.
2.2 Vertragsarten (Contract Types)
Die Vertragsart definiert den fachlichen Ablauf der späteren Abrechnung.
Je nach Contract Type unterscheiden sich:
- Rechnungslogik
- beteiligte Parteien
- Lieferantenabrechnung
- Steuersätze
- Artikel
- Druckformate
USAGE_POSTPAID
Beschreibung
Der Standardvertrag für klassische End-Kundenabrechnungen. Hier wird häufig die Zahlungsart "SEPA-Lastschrift" für die Kunden verwendet.
COMPANY CAR
Beschreibung
Bei Firmenfahrzeugen ist der Rechnungsempfänger das Unternehmen, der Lieferant ist immer der Mitarbeiter, weil er/sie die Wallbox Zuhause installiert hat. Es handelt sich hier um einen Erstattungsprozess mit durchlaufendem Posten.
USAGE_HUBJECT_CPO_ROAMING
Beschreibung
Roaming-Verträge für externe Ladeverbünde. Da teilweise kein direkter Endkunde existiert und dieser vom Drittanbieter abgerechnet werden, wird ein definierter Standardkunde (Grid & Co.) für die Abrechnung von becharged verwendet.
USAGE_ADHOC
Beschreibung
Spontane, öffentliche Ladevorgänge ohne klassischen Vertragsprozess.
Diese Vorgänge werden nicht über die normale Rechnungslogik verarbeitet, sondern direkt über Gridware.
Besonderheiten
- keine Customer Usage Rechnung
- direkte Zahlungsabwicklung über Payter, PayPal
- keine Subscription
2.3 Entity Relationship Modell
Ziel des Datenmodells
Das Entity Relationship Modell beschreibt die wichtigsten Geschäftsobjekte des Systems sowie deren Beziehungen untereinander.
Es dient als Grundlage für das Verständnis sämtlicher Geschäftsprozesse.
Das vollständige ER-Modell:
