Skip to main content

Kapitel 5 – Becharged Settings: Die zentrale Schaltstelle

Ziel dieses Kapitels

Die Becharged Settings enthältsind Mapping,die Druck,zentrale Schaltstelle der ERPNext-Lösung. Hier hinterlegen wir die Verbindung zu Gridware, die Zuordnung der Vertragstypen zu Artikeln, Druckformate, E-Mail, Hubject-KundeMail- und DATEV-Angaben sowie die Sync-Schaltflächen.Vorgaben für RFID-Kartenbestellungen.

Ohne gespeicherte Settings und eine gültige Authentifizierung laufen die Gridware-Aktionen nicht. Dieses Kapitel richtet sich an den operativen Betrieb: Welche Felder Sie pflegen, wann Sie welche Schaltfläche nutzen und woran Sie den Erfolg erkennen.

ÖffnenNach diesem Kapitel soll der Leser verstehen,

    wie die Settings geöffnet und gespeichert werden, welche Abschnitte fachlich zusammengehören, wann Authentifizierung, Vertragsabruf und Aggregation ausgelöst werden, welche Aktionen nur zur Reparatur gedacht sind, welche Schaltflächen in der aktuellen Oberfläche nicht mehr angeboten werden.

    5.1 Überblick und Zugriff

    Zweck

    Die Settings verbinden die technischen Gridware-Daten mit den kaufmännischen Prozessen in ERPNext. Sie steuern unter anderem:

      die API-Anmeldung bei Gridware, die Zuordnung von Vertragstyp und MwSt. zum Rechnungsartikel, den Standardkunden für Hubject-Roaming, Druckformate und Briefkopf, E-Mail-Vorlage, Ausweichkonto und DATEV-Adresse, den RFID-Kartenpreis und den Synchronisationsstand der Kartenbestellungen.

      5.2 Aufbau der Seite

      Die Seite gliedert sich in die folgenden Abschnitte (Reihenfolge wie im Formular):

        Allgemeine Einstellungen (oberer Bereich ohne eigenen Abschnittstitel) Gridware-Integration Gridware-Importeinstellungen Rechnungsdruck-Einstellungen Konfiguration der Vertragsartzuordnung RFID-Kartenbestellung

        Zusätzlich stehen oben am Formular Buttons bereit. Sie sind in Gruppen unterteilt:

        Gruppe Schaltflächen (deutsche Oberfläche) (ohne Gruppe) Authentifizieren Gridware Vertragsaktionen Verträge abrufen, Vertrag nach ID abrufen, Alle Vertragsparteien verknüpfen Kunden-Nutzung Nutzungsdaten aggregieren Lieferanten-Nutzung Lieferanten-Nutzungsdaten aggregieren Gridware Nutzungsaktionen Abruf fehlgeschlagener/ausstehender Transaktionen wiederholen

        Im Abschnitt RFID-Kartenbestellung liegt zusätzlich die Formularschaltfläche Vollständige Neusynchronisation.

        5.3 Allgemeine Einstellungen

        Der obere Bereich sammelt Firmen-, E-Mail- und Standardwerte, die später in Rechnungen, Stammdatenanlage und Hubject-Abrechnung greifen.

        Fachlicher Hintergrund

        Automatisch erzeugte Belege brauchen einen Ansprechpartner, eine Gesellschaft und – bei Hubject – einen zahlenden Kunden, weil Gridware dort oft keinen Endkunden liefert. E-Mails an DATEV dürfen den Kunden-E-Mail-Status nicht verfälschen.

        Feld Bedeutung BechargedEmail SettingsTemplate E-Mail-Vorlage für den Rechnungsversand. Fallback Email Account / Fallback-E-Mail-Konto Ausweichkonto, falls der angemeldete Benutzer kein eigenes E-Mail-Konto hat. DATEV Email / DATEV-E-Mail Adresse für DATEV-Uploads. Nachrichten an diese Adresse werden beim E-Mail-Status der Kundenrechnung nicht mitgezählt. Company / Firma Verweis auf die eigene Company in ERPNext. Default Hubject Roaming Customer / Standard-Hubject-Roaming-Kunde Standardkunde für Verträge vom Typ USAGE_HUBJECT_CPO_ROAMING (Suche)fachlich z. B. Grid & Co.). SpeichernPflicht vor dem Sync solcher Verträge. Default Customer Group Kundengruppe für Customer, die über die Gridware-API angelegt werden. Default User Benutzer, der als Ansprechpartner auf automatisch erzeugten Ausgangsrechnungen erscheint. Nicht den Administrator wählen. Default Supplier Group Lieferantengruppe für Supplier, die über die Gridware-API angelegt werden.
        Default User

        Auf manuell erstellten Belegen kommt der Ansprechpartner vom angemeldeten Benutzer. Bei automatisch erzeugten Ausgangsrechnungen würde sonst der Administrator auf dem Druck erscheinen. Deshalb hinterlegen Sie Änderungen,hier eine fachliche Person (z. B. die Sachbearbeitung).

        Default Hubject Roaming Customer

        Beim Hubject-Roaming rechnet becharged nicht den Endkunden ab, sondern die zwischengeschaltete Instanz (Grid & Co.). Der Lieferant am Vertrag bleibt der CPO. Fehlt das Feld, bricht die Synchronisation mit der Meldung ab: Standard-Hubject-Roaming-Kunde ist in den Becharged-Einstellungen nicht festgelegt.

        Wann pflegen?
          einmalig vor dem ersten produktiven Sync, nach Wechsel der Gesellschaft, des DATEV-Postfachs oder der zuständigen Sachbearbeitung, immer dann, wenn Hubject-Verträge neu hinzukommen und der Standardkunde noch leer ist.

          Erfolg: Die Felder sind gespeichert. Hubject-Verträge synchronisieren ohne die obige Fehlermeldung. Automatische Rechnungen zeigen den hinterlegten Default User, nicht Administrator.

          3a.4 Gridware-Integration

          Dieser Abschnitt enthält die Zugangsdaten zur Gridware-API und den aktuellen Anmeldestatus.

          Fachlicher Hintergrund

          Sämtliche Vertrags-, Parteien- und Nutzungsabrufe laufen über diese Verbindung. Die Anmeldung erzeugt ein Sitzungstoken. Ist die Sitzung abgelaufen, müssen Sie sich erneut authentifizieren, bevor Sie AktionenVerträge auslösen.oder Nutzungen holen.

          Feld Bedeutung Base URL Basisadresse der Gridware-API. Version API-Version. Im Formular ist derzeit nur 1.0 vorgesehen. Gridware Integration Enabled / Gridware-Integration aktiviert Zeigt, ob die Integration aktiv ist. Das Feld ist schreibgeschützt und wird durch die Authentifizierung gesetzt, nicht von Hand angehakt. Username Gridware-Benutzername (API-Konto). Password Gridware-Passwort. Nicht mit dem ERPNext-Anmeldepasswort verwechseln. Bearer Token / Bearer-Token Nach erfolgreicher Anmeldung gesetztes Sitzungstoken. Schreibgeschützt. Nicht kopieren, nicht weitergeben.
          Schaltfläche Authentifizieren

          Die Schaltfläche Authentifizieren verlangtprüft eindie gespeichertesgespeicherten Formular.Zugangsdaten gegen Gridware.

          3a.5 Gridware-Importeinstellungen

          Dieser Abschnitt Gridwaresteuert Importden Settingsälteren CSV-Weg (Consumption Data / Subscriptions), nicht den API-Abruf von Verträgen.

            Feld Bedeutung Consumption Invoice Trigger Day / Auslösetag der Verbrauchsrechnung Tag im Monat (1–31), an dem Verbrauchsrechnungen verarbeitet werden dürfen. Ohne Angabe gilt der 7. Consumption Data Item / Verbrauchsdaten-Artikel Artikel, der für importierte Verbrauchsdaten in die Rechnung übernommen wird. Is Consumption Data Imported / Verbrauchsdaten importiert:importiert nurNur setzen, wenn die CSV-Verbräuche fertigimportiert und zur Rechnungsstellung bereit sind.
            Wann setzen?

            Den Haken Verbrauchsdaten importiert erst nach einem vollständigen, geprüften CSV-Import setzen. Zusammen mit dem Stichtag steuert er, ob verbrauchsabhängige Abonnements Rechnungen erzeugen dürfen.

            Warnung: CSV-Import und rechnungsbereitAPI-Aggregation sind.nicht

            Consumptionunkontrolliert Invoicemischen. TriggerVor Day:einer parallelen Nutzung den Status der betroffenen Sätze prüfen (Uninvoiced / Invoiced). Sonst drohen Doppelabrechnungen oder Lücken.

            Erfolg: Am Stichtag im(oder Monatab (1–31).

            dem 7., falls leer) und bei gesetztem Haken können Consumption-Data-Rechnungen erzeugt werden. Ohne Haken bzw. vor dem Stichtag bleiben die verbrauchsabhängigen Abos stehen.

            3a.6 Rechnungsdruck-Einstellungen

            AbschnittHier Gridwarehinterlegen Integration

              Username, Password, Base URL, Gridware Integration Enabled Schaltfläche Authentifizieren. Bei Bedarf Dialog Zwei-Faktor-AuthentifizierungSie, mit Feldwelchem TOTP-CodeDruckformat Ausgangs- und Verify.Eingangsbelege sowie

              Abschnittdie InvoiceNutzungsanhänge Printerzeugt Settingswerden.

                Feld Bedeutung Sales Invoice Print Format / Druckformat Ausgangsrechnung Druckformat für Sales Invoice (Auswahl nur Formate dieses DocTypes). Consumption Data Print Format / Druckformat Verbrauchsdaten Anhang aus Consumption Data (CSV-Weg). Customer Usage Data Print Format / Druckformat Kundennutzungsdaten Anhang der Kundenrechnung aus aggregierten Ladevorgängen. Purchase Invoice Print Format / Druckformat Eingangsrechnung Druckformat für Purchase Invoice. Supplier Usage Data Print Format / Druckformat Lieferantennutzungsdaten Anhang des Lieferantenbelegs. Letter Head Briefkopf der Belege.

                Die konkreten Formatnamen (z. B. BCH Rechnung, Customer Usage Detail BCH Rechnung, BCH Einkaufsrechnung) liegen in ERPNext als Druckformate vor. In den Settings wählen Sie die jeweils gültige Zuordnung.

                Erfolg: Beim PDF-Download einer Kunden- oder Lieferantenrechnung erscheinen Rechnungskopf und der vorgesehene Nutzungsanhang mit dem hinterlegten Briefkopf.

                3a.7 Konfiguration der Vertragsartzuordnung

                Die Tabelle Vertragsartzuordnungen / Contract Type Mappings entscheidet, welcher Artikel auf der späteren Rechnung oder Lieferantenabrechnung erscheint.

                Fachlicher Hintergrund

                Jeder Gridware-Vertrag hat einen Contract Type und einen MwSt.-Satz. Die Abrechnungslogik sucht in dieser Tabelle die passende Zeile und setzt den Item Code. Die gültige Liste steht ausschließlich in den Settings, nicht in einer festen Dokumentationstabelle.

                Tabelle Contract Type Item Mapping
                Feld Bedeutung Contract Type / Vertragsart Vertragstyp aus Gridware, z. B. USAGE_POSTPAID, USAGE_HUBJECT_CPO_ROAMING. Pflicht. VAT Rate MwSt.-Satz in Prozent (z. B. 19, nicht 1900 und nicht 0,19). Pflicht. Item Code ERPNext-Artikel. Pflicht. Description / Beschreibung Freie Erläuterung der Zeile.

                Beispielzeilen (nur zur Orientierung – die produktive Liste pflegen Sie in den Settings):

                Vertragsart MwSt. % Item Code Beschreibung (Beispiel) USAGE_POSTPAID 19 M100055 Contract Charging USAGE_HUBJECT_CPO_ROAMING 19 M100053 Roaming Charging USAGE_ADHOC 19 M100034 Ad-hoc Charging USAGE_POSTPAID (Dienstwagen) 0 M100172 Company Car Charging
                Wann pflegen?
                  vor der ersten Aggregation von Customer Usage Data / Supplier Usage Data, wenn Gridware einen neuen Vertragstyp liefert, wenn sich der Artikelstamm ändert.

                  AbschnittOhne Contractpassende TypeZeile Mappingkann Configurationdie Aggregation keinen Artikel setzen. Prüfen Sie nach dem Speichern, dass jeder benötigte Vertragstyp und der zugehörige MwSt.-Satz eine Zeile hat.

                    Erfolg: 

                    Tabelle Contract Type Mappings DefaultIn Customer Group,Usage DefaultDetail bzw. Supplier GroupUsage DefaultDetail Usersteht (Ansprechpartnerje aufZeile Auto-Rechnungen,ein nichtexistierender Administrator)Item (#298,Code. #299) Default Hubject Roaming Customer / Standard-Hubject-Roaming-Kunde

                    Abschnitt RFID Card Order /

                    3a.8 RFID-Kartenbestellung

                    Dieser Abschnitt steuert Preis und Synchronisation der Ladekartenaufträge aus dem Kundenportal bzw. aus Gridware.

                      Feld Bedeutung Default Gridware Order Item / Standard-Gridware-Bestellartikel Artikel, der in den Sales Order zur RFID-Karte übernommen wird. RFID Card Price (excl. VAT) / RFID-Kartenpreis (exkl. USt.) –Nettopreis Pflichtje Karte. Pflichtfeld. Standardwert im Formular: 19,95. Last Sync Attempt / Letzter Synchronisierungsversuch Zeitpunkt des letzten inkrementellen Sync-Laufs (auch bei Fehlern). Schreibgeschützt. Dient als Lebenszeichen, dass der Job noch läuft. Sync Watermark / Synchronisations-Wasserzeichen Wird nur nach einem vollständig erfolgreichen inkrementellen Sync fortgeschrieben. Bei Fehlern bleibt es stehen, damit nichts stillschweigend übersprungen wird. Schreibgeschützt. Full Resync / Vollständige Neusynchronisation –Formularschaltfläche. nurSiehe zurWarnung Reparatur,unten. nicht im Monatsbetrieb Sync Watermark, Last Full Resync / Letzte vollständige Neusynchronisation Wird nur gesetzt, wenn eine vollständige Neusynchronisation ohne Fehler durchgelaufen ist. Schreibgeschützt.

                      Im Formular steht der Hinweis: Die vollständige Neusynchronisation holt jede Gridware-RFID-Kartenbestellung neu, ignoriert das Wasserzeichen und setzt bei Erfolg Wasserzeichen und „Letzte vollständige Neusynchronisation“ auf jetzt. Für den Alltag ist die Schaltfläche Bestellungen synchronisieren in der Liste Gridware RFID Card Order vorgesehen.

                      Warnung: Full Resync nur zur Reparatur

                      Vollständige Neusynchronisation ist aufwendig. Sie ist nur gedacht für:

                        die erstmalige Einrichtung dieser Funktion, ein stecken gebliebenes oder beschädigtes Wasserzeichen.

                        E-Mail

                        Im
                          Monatsbetrieb Emailnicht Template,verwenden. FallbackDer EmailAlltags-Sync Account,erfolgt DATEVüber EmailBestellungen

                          Schaltflächensynchronisieren in Bechargedder SettingsListe (echteder Namen)

                          RFID-Aufträge bzw. über den täglichen Hintergrundjob.

                          Erfolg im Alltag: Neue Portalbestellungen erscheinen als Gridware RFID Card Order, der Preis entspricht den Settings, ein Sales Order im Entwurf entsteht. Last Sync Attempt bewegt sich täglich.

                          3a.9 Schaltflächen – Gridware Vertragsaktionen

                          Die Oberflächefolgenden zeigtSchaltflächen diestehen deutschein Übersetzung,der wennGruppe vorhanden.Gridware Vertragsaktionen.

                          3a.9.1 Verträge abrufen

                          Was passiert: Es werden alle verfügbaren Gridware-Verträge geladen. Der Vorgang kann lange dauern und lässt sich nicht ohne Weiteres rückgängig machen.

                          GruppeWann: Erstmaliger Vollabzug oder bewusster Nachzug aller Verträge – nicht als tägliche Routine. Einzelne Verträge holen Sie mit GridwareVertrag Vertragsaktionennach ID abrufen.

                          Schritt für Schritt
                            Settings speichern und ggf. Authentifizieren. Verträge abrufen. – lädt alle Gridware-Verträge. Es erscheintöffnet einesich der Dialog Alle Verträge abrufen mit Warnung. Unter Authentifizierung erforderlich geben Sie müssen Ihr Passwort eingebenein und– das ERPNext-/Frappe-Anmeldepasswort des System Managers, nicht das Gridware-Passwort. Bestätigen und fortfahren. Hinweis: Vertragssynchronisation wurde in die Warteschlange gestellt. Überprüfen Sie die Hintergrundjobs für den Fortschritt.

                            Erfolg: Hintergrundjob läuft durch. In Gridware Contract erscheinen bzw. aktualisieren sich die Verträge. Anschließend können Parteien und Nutzungen nachgezogen werden.

                            3a.9.2 Vertrag nach ID abrufen

                            Was passiert: Ein einzelner Vertrag wird anhand der numerischen Gridware-Vertrags-ID geholt. Danach läuft der bekannte Synchronisationsprozess für diesen Vertrag (Parteien, Customer/Supplier, zugehörige Nutzungen).

                            Wann: Nachanlage eines einzelnen Vertrags in Gridware, Nacharbeit, Tests.

                            Schritt für Schritt
                              Kopieren Sie die Contract ID in Gridware. In den Settings: Vertrag nach ID abrufen. – Dialog FetchVertrag Contract fromvon Gridware abrufen, Feld Vertrags-ID. Vertrag abrufen. Der Job wird im Hintergrund eingereiht.

                              Erfolg: Ein Gridware Contract ID (Namenskreis GWC-…) existiert, Felder wie Vertragsnummer und Vertragstyp sind gefüllt. Über Alle Vertragsparteien verknüpfen können fehlende Customer-/Supplier-Links nachgezogen werden.

                              3a.9.3 Alle Vertragsparteien verknüpfen

                              Was passiert: Für alle Gridware Contracts, bei denen Supplier oder Customer noch fehlen, werden die Verknüpfungen zu Gridware Party, Customer und Supplier nachgezogen.

                              Wann: Nach einem Vertragsabruf, wenn an Verträgen noch Lücken in älterenden Texten:Parteifeldern „Fetchstehen. ContractDerselbe byVorgang ID“)läuft zusätzlich täglich automatisch.

                              Schritt für Schritt
                              1. Alle Vertragsparteien verknüpfen.
                              –Bestätigen setztSie: KundeDies wird Lieferanten und LieferantKunden anfür Verträgen,alle Gridware-Verträge abrufen und verknüpfen, die nochAktualisierungen Lückenbenötigen. habenDie (inErfolgsmeldung älterennennt Texten:die „LinkAnzahl allverarbeiteter Parties“).Verträge sowie verknüpfter Lieferanten und Kunden.

                              Erfolg: Am Vertrag sind Supplier und die Customer-Zeilen gesetzt. Gridware Parties mit Customer bzw. Supplier sind über die Connections erreichbar.

                              3a.10 Schaltflächen – Nutzungsaggregation

                              3a.10.1 Nutzungsdaten aggregieren

                              Gruppe Customer UsageKunden-Nutzung

                                Nutzungsdaten aggregieren –. Dialog Kunden-Nutzungsdaten aggregieren. Filter

                                Was passiert: Aus vollständigen Gridware Usages entstehen Customer Usage Data-Sätze je Kunde und Abrechnungszeitraum.

                                Wann: Nachdem Usages den Status Complete haben und bevor Kundenrechnungen erzeugt werden. Pending-Usages blockieren die Aggregation.

                                Schritt für Schritt
                                  Nutzungsdaten aggregieren. Optional Filter: Von Datum, Bis Datum, CustomerKunde. Dann Aggregation starten. (Hinweis: Kunden-Nutzungsdaten-Aggregation wurde in älterendie Texten:Warteschlange Button „Customer Usage Data“).gestellt.

                                  Erfolg: Es existieren Customer-Usage-Data-Sätze im Status Uninvoiced, Details sind gefüllt, Item Codes stammen aus der Vertragsartzuordnung.

                                  3a.10.2 Lieferanten-Nutzungsdaten aggregieren

                                  Gruppe Lieferanten-Nutzung. Dialog analog, Filter Lieferant statt Kunde.

                                  Was passiert: Aus denselben Usages entstehen Supplier Usage Data-Sätze je Lieferant und Zeitraum.

                                  Wann: Vor der Lieferantenabrechnung / Gutschrift. Mapping und gesetzter Supplier am Vertrag müssen stimmen. Bei Hubject bleibt der CPO der Lieferant; der Kunde auf der Gegenseite ist der Standard-Hubject-Kunde.

                                  Schritt für Schritt
                                  1. Lieferanten-Nutzungsdaten aggregieren.
                                  – analog, FilterOptional SupplierVon Datum, Bis Datum, Lieferant. Aggregation starten.

                                  Erfolg: (in älteren Texten: Button „Supplier Usage Data“).

                                  Data ist vorhanden, Totals nachvollziehbar, keine Pending-Usages mehr im Filter.

                                  3a.11 Abruf fehlgeschlagener/ausstehender Transaktionen wiederholen

                                  Gruppe Gridware Nutzungsaktionen.

                                  Was passiert: Der vorhandene Hintergrundjob für Failed und Pending Gridware Usages wird sofort angestoßen (derselbe Job, der täglich ohnehin läuft).

                                  Wann: Wenn Usages auf Pending oder Failed stehen und die Aggregation deshalb blockiert. Nicht als Ersatz für eine fehlende Authentifizierung.

                                  Schritt für Schritt
                                  1. Abruf fehlgeschlagener/ausstehender Transaktionen wiederholen.
                                  –Bestätigen holtSie Failedden Hinweis, dass Details zu allen fehlgeschlagenen und Pendingausstehenden Transaktionen erneut (#311)geholt werden. Meldung Geplanter Auftrag ausgelöst. Über Protokolle der geplanten Aufträge anzeigen den Verlauf prüfen. Usages aktualisieren: Status wechselt nach Complete.

                                  DieErfolg: alteKeine SammelaktionPending-Usages mehr im relevanten Zeitraum. Danach Aggregation erneut starten.

                                  3a.12 Tägliche Hintergrundjobs (ohne Klick)

                                  Unabhängig von den Schaltflächen laufen täglich unter anderem:

                                  Vorgang Bedeutung für den Betrieb Vertragsparteien nachziehen Entspricht fachlich DeleteAlle AllVertragsparteien Dataverknüpfen. ist in Kunde/Lieferant an Usages aktualisieren Übernimmt die Parteizuordnung vom Vertrag auf die Nutzungen. Failed/Pending Usage erneut holen Entspricht der aktuellenRetry-Schaltfläche. Oberfläche RFID-Aufträge synchronisieren Inkrementeller Sync anhand des Wasserzeichens – nicht aktiv.Full Resync. Abgelaufene Verträge und Vertragskunden setzen Gültigkeit anhand active_until nachziehen.

                                  Die Schaltflächen in den Settings sind der manuelle Weg, dieselben oder verwandte Vorgänge gezielt anzustoßen.

                                  3.14 Steuerlogik und Druckformate

                                  Am Artikel gibt es Tax Handling mit Standard Tax und Pass-through Item. Beim Einfügen in Angebot, Auftrag, Lieferschein, Rechnung oder Einkaufsbeleg setzt das System Steuerkategorie und Vorlage (#268, #269). Dienstwagen 0 %, sonst oft 19 %. Porto bleibt in der Regel 19 % (#210).

                                  Diese Druckformat-Namen stehen so im System:

                                  Druckformat Beleg
                                  BCH Rechnung Sales Invoice
                                  Customer Usage Detail BCH Rechnung Verbrauchsanhang Kundenrechnung
                                  Data Consumption BCH Rechnung Anhang aus Consumption Data
                                  BCH Gutschrift Sales Invoice (alte Gutschrift)
                                  BCH Einkaufsrechnung Purchase Invoice
                                  Supplier Usage Detail BCH Einkaufsrechnung Anhang Lieferantenbeleg
                                  BCH Mahnung Dunning
                                  BCH Angebot Quotation
                                  BCH Verkaufsauftrag Sales Order
                                  BCH Lieferschein Delivery Note
                                  BCH Einkausauftrag Purchase Order (Schreibweise so im System)
                                  BCH Zahlungsaufforderung Payment Request
                                  BCH Abonnement Subscription
                                  Stornorechnung Sales Invoice
                                  EGT Rechnung / EGT Gutschrift EGT-Belege
                                  BCH THG Gutschrift THG-Quote

                                  Tägliche Server-Images allein reichen nicht. Es gibt eine Nextcloud-Anbindung: Hinweis bei Fehler, Löschung nach 30 Tagen (#196, #197, #201, #279).