Schritt für Schritt Anleitungen

Handhabung der Einstellungen
Öffnen Sie die globale Suche und geben Sie Becharged Settings ein.
Die Seite öffnet sich direkt. Speichern Sie Änderungen, bevor Sie Aktionen auslösen.
Die Bearbeitung ist der Rolle System Manager vorbehalten.
Ungespeicherte Änderungen verhindern die Schaltfläche Authentifizieren. Es erscheint die Meldung: Bitte speichern Sie das Formular vor der Authentifizierung.
Authentifizieren der Gridware API 
Tragen Sie Base URL, Username und Password ein.
Speichern. Ungespeicherte Formulare werden abgelehnt.
Klicken Sie Authentifizieren.
Warten Sie auf die Meldung Authentifizierung erfolgreich! Die Seite lädt neu.
Falls Gridware 2FA verlangt, öffnet sich der Dialog Zwei-Faktor-Authentifizierung:
Feld TOTP-Code – sechsstelliger Code aus der Authenticator-App,
Schaltfläche Überprüfen.
Prüfen Sie danach: Gridware-Integration aktiviert ist gesetzt, Bearer-Token ist gefüllt.
Fehlen Pflichtangaben, erscheint: Bitte geben Sie Benutzername, Passwort und Basis-URL ein, bevor Sie sich authentifizieren.
Erfolg: Grüne Erfolgsmeldung, Formular neu geladen, Token vorhanden. Spätere Vertragsaktionen laufen ohne Nicht bei Gridware authentifiziert.
Hinweis: Zugangsdaten gehören nur in dieses Formular. Eine abgelaufene Sitzung erkennt man an Authentifizierung abgelaufen. Bitte erneut authentifizieren.
Stammdaten aus Gridware holen
Gridware mit respektivem Vertrag öffnen und die ID kopieren
Öffnen Sie Becharged Settings und speichern Sie.
Klicke auf "Gridware Vertragsaktionen"
Einzelvertrag: Klicken Sie Vertrag nach ID abrufen. Tragen Sie die Contract ID aus Gridware ein (nicht die ERPNext-Nummer GWC-…). Bestätigen. Meldung: Job ist in der Warteschlange.
Alle Verträge: Klicken Sie Verträge abrufen. Unter Authentifizierung erforderlich geben Sie Ihr Passwort ein – das ERPNext-/Frappe-Anmeldepasswort des System Managers, nicht das Gridware-Passwort. Bestätigen und fortfahren.
Klicken Sie "Alle Vertragsparteien verknüpfen (Link all Parties)" mit etwa 2-3 Minuten Zeitverzögerung, um alle ERPNext-Parteien zuverlässig zu verbinden.
Danach werden automatisch Gridware Parties mit Customer & Supplier & Contact & Address sowie die Usages erstellt.
Im Gridware Sync Log Status Success / Failed / Partial prüfen (Log Type Data Sync).
Beendete Verträge
Ein täglicher Job setzt abgelaufene Verträge und Vertragskunden um. Zusätzlich:
In Gridware das Vertragsende setzen.
Sync erneut (einzelne ID oder alle).
Status / Active Until prüfen.
Verarbeitung von Ladevorgängen
Transaktions-Liste prüfen
Öffnen Sie Gridware Usage.
Filtern Sie nach Periode, Kunde oder Status (Pending, Complete, Failed).
Öffnen Sie einen Satz. Prüfen Sie ID, Zeiten, kWh, Ladepunkt, Kosten, Vertrag, Kunde, Lieferant, Parties.
Status Complete ist die Voraussetzung für die Aggregation.
 Fehlgeschlagene Vorgänge nachholen
Bei Transaktionen mit dem Status "Failed" kann die API erneut angestoßen werden: 
Becharged Settings → Abruf fehlgeschlagener/ausstehender Transaktionen wiederholen.
Bestätigen.
Optional: View Scheduled Job Logs / Protokolle der geplanten Aufträge anzeigen.
Denselben Job führt das System täglich automatisch aus.
Customer Usage Data aggregieren
Voraussetzungen: Alle Stammdaten sind geladen und verknüpft. Der Vertrag, Lieferanten und Kunden sowie Transaktionen sind per API geladen. In den Einstellungen müssen die korrekten Artikel auf den Vertrag gemappt sein. Alle relevanten Gridware Usage der Periode sind Complete. Gibt es Pending, bricht die Aggregation mit einer Fehlermeldung ab. Consumption Billing Period existiert als 
MM/YYYY (z. B. 
03/2026); fehlt sie, legt die App sie beim Speichern an.
Öffnen Sie die Becharged Settings.
Klicken Sie auf den Button Nutzungsdaten aggregieren (Customer Usage Data).
Dialog Kunden-Nutzungsdaten aggregieren: Wählen Sie den jeweiligen Kunden aus und setzen Sie Von Datum / Bis Datum. 
Aggregation starten. Customer Usage Data mit aggregierten Transaktionen wird für den jeweiligen Kunden erstellt.
Öffnen Sie den DocType Customer Usage Data, wählen Sie das jeweilige Dokument (Namensmuster 
CUD-…).
Klicken Sie auf den Button Create Sales Invoice.
Eine Rechnung mit dem Gesamtbetrag wird als Entwurf erstellt.
Im Druckformat finden Sie die Rechnung mit Anhang (BCH Rechnung + Customer Usage Detail BCH Rechnung).
Dienstwagen-Fall: 
Lieferanten bekommen Dienstwagen-Rechnungen - teilweise von mehreren Mitarbeitenden. Diese sollen alle für den Abrechnungszeitraum gebündelt und in einer Rechnung abgebildet werden. Im Druckformat ist klar erkennbar, welche Transaktionen zu welchem Mitarbeitenden gehören. Alle Transaktionen sind zu einem Rechnungsbetrag zusammengefasst.
Manuelle Rechnungsstellung an Kunden
Aus einem Customer Usage Data Datensatz wird anschließend eine Sales Invoice erzeugt.
CUD öffnen, Status Uninvoiced.
Create Sales Invoice. (Für reines 
USAGE_ADHOC erscheint sie nicht.)
Es öffnet sich eine Sales Invoice (Entwurf):
Customer aus dem CUD
Billing Period (Month/Year)
Link Customer Usage Data
SEPA Mandate Reference, falls am Kunden hinterlegt
Positionen je Gruppe aus Vertragstyp + MwSt. + Artikel, Menge 1, Betrag = Periodensumme der Gruppe
Tax Handling der Artikel prüfen.
Header Text Template wählen, falls der Text noch der Vorlage entsprechen soll. Der Text darf danach manuell bleiben und darf beim Speichern nicht vom Default überschrieben werden (#106, #107).
Entwurf prüfen, dann Buchen (Submit). Danach PDF über Download PDF.
CUD-Status wechselt auf Draft Invoice bzw. Invoiced.
Existiert schon eine Rechnung zum CUD, kommt: Sales Invoice already exists for this Customer Usage Data.
Dabei werden die einzelnen Gridware Usages übernommen, die Summen berechnet, die Verbrauchsdaten für den Rechnungsanhang vorbereitet und die spätere Zahlungsabwicklung angestoßen.
Supplier Usage Data aggregieren
Voraussetzungen: Lieferant existiert. Bei Doppelrolle muss Is Supplier greifen. Bankverbindung am Lieferanten, wenn später SEPA Credit Transfer genutzt wird. Usages Complete, Vertrag und Supplier gesetzt. Mapping in Contract Type Mappings.
Öffnen Sie die Becharged Settings.
Klicken Sie auf den Button Lieferanten-Nutzungsdaten aggregieren („Supplier Usage Data“).
Filtern Sie nach Abrechnungszeitraum (Von Datum / Bis Datum) und optional Supplier.
Aggregation starten. Zusammenfassung aller Transaktionen aus allen Verträgen wird für den Lieferanten als Supplier Usage Data erstellt.
Öffnen Sie Supplier Usage Data. Prüfen Sie Is Reimbursement: beim Dienstwagen eine SUD je Mitarbeiter, nicht je Arbeitgeber.
Klicken Sie auf den Button Create Purchase Invoice.
Rechnung mit den Summen pro Vertrag wird erstellt.
Im Druckformat befinden sich die Rechnung sowie der Anhang mit Transaktionen kategorisiert pro Vertrag (eine Detailseite je Vertragstyp).
Dienstwagen-Ausnahmefall:
Datensätze werden mit dem Hinweis "is reimbursement" markiert und werden gesondert von anderen Lieferanten Transaktionen ausgewiesen.
Mitarbeiter = Lieferant, Arbeitgeber = Kunde. Deshalb SUD pro Mitarbeiter, CUD pro Arbeitgeber, keine Mischung mit Postpaid/Ad-hoc/EMP
Erstellung der Lieferantenrechnung
SUD öffnen, Status Uninvoiced.
Create Purchase Invoice (nur wenn noch keine PI hängt).
Entwurf prüfen: Supplier, Billing Period, Link Supplier Usage Data, Positionen je Vertragstyp/MwSt./Artikel.
Steuer- und Aufwandskonten am Lieferantenstammsatz.
Prüfen, buchen. Download PDF erzeugt das kombinierte PDF (Beleg + Anhang je Vertragstyp).
Send Email wie bei der Kundenrechnung, mit Vorlage aus den Settings.
Rechnungsstellung
SEPA-Lastschrift erstellen
Neues SEPA Direct Debit anlegen und Company sowie Bank Account auswählen. Die Gläubigerdaten werden aus diesen Stammdaten übernommen.
Get Direct Debit Entries auswählen und nach Billing Period sowie Payment Terms Template filtern.
ERPNext lädt die passenden gebuchten Sales Invoices. Berücksichtigt werden Rechnungen mit gültigem Mandat, einem Betrag größer 0 und solche, die noch nicht Bestandteil eines gebuchten Direct Debits sind.
Direct Debit Entries prüfen: Kunde, Mandat, IBAN, Rechnung, Betrag und Mandate signed on.
Über Generate XML die SEPA-Datei erzeugen. Die Datei wird unter XML File hinterlegt; der Inhalt ist zusätzlich unter SEPA XML Content sichtbar.
Über Validate XML die Datei prüfen. Bei einem Schemafehler darf der Beleg nicht gebucht werden.
SEPA Direct Debit buchen. Der Collection Status wechselt auf Submitted to Bank. Zu diesem Zeitpunkt werden noch keine Payment Entries erzeugt.
Die XML-Datei herunterladen und über das Online-Banking an die Bank übergeben.
Zahlungseingang bestätigen
Die Payment Entries werden erst erstellt, nachdem der tatsächliche Einzug durch die Bank bestätigt wurde – typischerweise einige Tage später.
das gebuchte SEPA Direct Debit öffnen
je Zahlung Payment Received sowie das Bank Booking Date setzen.
Alternativ kann Mark All Received verwendet werden.
Anschließend Confirm Received Payments ausführen. Nach Bestätigung erzeugt ERPNext die entsprechenden Payment Entries mit dem Bankbuchungsdatum.
Der Status des SEPA Direct Debits wechselt abhängig vom Ergebnis auf: Partially Reconciled oder Reconciled. Die Bestätigung lässt sich nicht automatisch rückgängig machen.
SEPA-Überweisung an Lieferanten
Für die Auszahlung an Lieferanten wird SEPA Credit Transfer verwendet.
Neues SEPA Credit Transfer anlegen.
Execution Date, Company und Company Bank Account setzen.
Über Fetch Invoices die relevanten Belege anhand von Billing Period und Payment Terms Template laden.
Credit Transfer Entries mit Purchase Invoice, Lieferant, Betrag und IBAN prüfen.
Über Generate XML die SEPA-Datei erzeugen.
Beleg buchen und XML über Download XML für die Bank bereitstellen.
Der Status durchläuft:
Draft → Submitted to Bank → Reconciled
Auch auf Lieferantenseite müssen die benötigten Bank- beziehungsweise Mandatsinformationen entsprechend hinterlegt sein.
Kundenportal
RFID-Karte bestellen (Kundenportal)
Web-Formular
Titel: Ladekarte bestellen
Adresse: Pfad 
/ladekarte-bestellen
Einleitungstext: Preis €19.95 per card + VAT
Schaltfläche Bestellen
Schritt-für-Schritt für den Besteller
Seite 
/ladekarte-bestellen öffnen.
Benutzerkonto = Gridware-E-Mail.
Lieferadresse: Street, House Number, Zip Code, City, Country, optional Additional Info.
Order Summary: Price (excl. VAT) – der Preis kommt vom Server, nicht aus dem Browser (#318). Menge ist fachlich immer 1.
Bestellen.
Erfolg: Ihre Bestellung für die Ladekarte wurde übermittelt. Reload darf keinen zweiten Gridware-Auftrag erzeugen 
Unbekannte oder inaktive E-Mail: Es konnte kein aktives Gridware-Benutzerkonto … gefunden werden. Kein Auftrag . Genau eine aktive Person zur E-Mail ist Pflicht.
RFID-Auftrag in ERPNext bearbeiten
Liste Gridware RFID Card Order öffnen.
Sync Orders (Alltags-Sync). From Date nur für Nachziehen. Dialog Start Sync.
Full Resync in den Settings nur bei kaputtem Watermark.
Datensatz prüfen:
Order Source: ERPNext Web Form oder Gridware Direct
Gridware State: New, In Progress, Completed, Rejected (sonst Anzeige Not Synced)
Gridware Order ID(s), Party, Customer
Sales Order-Link
Fehlt der Auftrag: Create Sales Order.
Nach Insert legt die App den Sales Order automatisch als Entwurf an, sofern Kunde da ist (#313). Bei Rejected wird der Auftrag storniert.
Danach Standard: Karte aktivieren, versenden, ggf. SEPA.
Unbekannte Kunden werden als Party + Customer nachgezogen (#287).
Ausbau (Backlog): Preis abhängig vom Lieferanten, „invoiced to“, Lieferschein, Neukunden über 
/order (#296, #319, #236).
Full Resync (nur Reparatur)
Prüfen Sie, ob der Alltags-Sync (Bestellungen synchronisieren) bereits ausreicht.
Nur wenn das Wasserzeichen nachweislich hängt: in den Settings Vollständige Neusynchronisation klicken.
Bestätigen Sie den Warnhinweis.
Warten Sie auf: Vollständige Neusynchronisation wurde in die Warteschlange gestellt.
Erfolg: Letzte vollständige Neusynchronisation ist gesetzt, Hintergrundjob ohne Fehler.