Repository navigation
GoBD Plugin
English: GoBD plugin · Hintergrund: Ist YaBS GoBD-konforme Software?
Das GoBD-Plugin (ID groovy.gobd-compliance, Version 2.0) ergänzt YaBS um technische Schutzmechanismen für die GoBD (Grundsätze zur ordnungsmäßigen Führung und Aufbewahrung von Büchern, Aufzeichnungen und Unterlagen in elektronischer Form sowie zum Datenzugriff). Es ist ein Java-Plugin und liegt YaBS als plugins/gobd-compliance.jar bei (Quelltext).
Ein Plugin allein macht die Buchführung nicht GoBD-konform: Dazu gehören auch Datensicherung, Zugriffsschutz und die betriebliche Verfahrensdokumentation (siehe Organisatorische Hinweise). Diese Seite ersetzt keine steuerliche oder rechtliche Beratung.
- Festschreibung beim Export: Wird eine Rechnung, Gutschrift, Anzahlungs- oder Abschlagsrechnung als PDF, ZUGFeRD oder XRechnung erzeugt, schreibt das Plugin sie automatisch fest (abschaltbar). Aufträge, Angebote und Bestätigungen sind nie betroffen.
- Unveränderbarkeit: Festgeschriebene Belege und ihre Positionen sind gegen Änderungen steuerrelevanter Felder sowie gegen Löschen und Papierkorb gesperrt – in der Oberfläche und beim Speichern.
- Offene-Posten-Workflow: Zahlungsstatus, Teilzahlungen und Mahnstufen bleiben änderbar und werden protokolliert.
- Kein neuer Ausdruck festgeschriebener Belege: Drucken, PDF, Vorschau und E-Rechnung öffnen bei festgeschriebenen Rechnungen die archivierte Datei, statt eine neue zu erzeugen.
- Stammdaten- und Positions-Snapshots zum Zeitpunkt der Festschreibung.
-
SHA-256-Hash-Ketten über Festschreibungen, Einnahmen, Eingangsbelege und das Audit-Log:
SHA256(Datensatz ‖ "\n" ‖ vorheriger Hash), Startwert 64 Nullen. Der Datensatz enthält den SHA-256 der Archivdatei und die steuerrelevanten Daten (Nummer, Datum, Kontakt, Beträge, Steuer, Positionen); die Prüfung findet so auch Änderungen direkt in der Datenbank. Ältere Festschreibungen (vor Version 2 der Kette) bleiben mitSHA256(Datei-Bytes ‖ vorheriger Hash)prüfbar. - Stornorechnungen statt Bearbeitung – Nummer im eigenen Nummernformat Stornorechnung (siehe unten).
-
Eingangsbelege zu Ausgaben und E-Rechnungen als Einnahmen (ZUGFeRD / XRechnung), byte-identisch archiviert mit
SHA256SUMS. - Prüferzugriff: Z1-Prüferansicht in YaBS (nur lesend) und Z3-Export für IDEA (GDPdU).
-
gobd-compliance.jarbesorgen: Es liegt im Zip von YaBS im Ordneropenyabs/plugins/und ist ein eigener Download jedes Releases (für die Installationspakete .deb, .rpm, .msi, .dmg). - Einstellungen › Plugin-Manager › Java-Plugin importieren... und die Datei wählen – oder sie auf den Plugin-Manager ziehen. (Nicht über Klassische Plugins (Datenbank): dort erkennt YaBS das Jar und installiert es ebenfalls in der Plugin-Liste.)
- Nach dem Start meldet die Statuszeile:
GoBD-Konformitaets-Plugin (v2.0.0) vollstaendig geladen.
Die Datenbanktabellen (gobd_document_lock, gobd_audit_log, gobd_receipt, gobd_income_lock) legt das Plugin beim Start an bzw. erweitert sie.
Umstieg vom Groovy-Skript gobd_compliance.groovy: Das Jar hat dieselbe ID. Einstellungen, Archivordner und Datenbanktabellen bleiben erhalten. Beim Installieren des Jars wird das laufende Skript ersetzt und als gobd_compliance.groovy.replaced aufbewahrt; es wird nicht mehr geladen.
Benötigt YaBS 2.0.10 oder neuer.
Einstellungen › Plugins › GoBD-Konformitaet:
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Rechnungen beim Export automatisch festschreiben | an | Schreibt Rechnungen beim Erzeugen von PDF / ZUGFeRD / XRechnung fest. Aus: Festschreiben nur über den Befehl oder die Schaltfläche im Banner. |
| Revisionssicherer GoBD-Archivordner | <Plugin-Datenordner>/gobd-archive |
Ziel aller archivierten Originalbelege (nach Jahren) und der Z3-Exporte. |
| E-Rechnungen aus Überwachungsordner automatisch importieren | aus | Prüft alle 15 Sekunden den Überwachungsordner und importiert neue ZUGFeRD-PDFs / XRechnung-XMLs als festgeschriebene Einnahmen. |
| Überwachungsordner | leer | Ordner für den automatischen Einnahmen-Import. |
Solange eine Rechnung nicht festgeschrieben ist, kann sie beliebig bearbeitet oder gelöscht werden. Die Ansicht zeigt das Badge GoBD: Entwurf (offen) und ein Banner mit „Jetzt GoBD-festschreiben“. Neue Entwürfe werden als DRAFT_CREATED protokolliert.
Automatisch beim Export, über Plugins › GoBD: 1. Beleg festschreiben oder die Schaltfläche im Banner:
-
Nummer: Ohne endgültige Nummer (leer,
ENTWURF…,DRAFT…) vergibt das Plugin die nächste Nummer im Nummernformat der Belegart (Systemsteuerung › Formate); ist dort keines festgelegt,RE-JJJJ-NNNNN(GutschriftenST-JJJJ-NNNNN). Das Jahr ist das des Rechnungsdatums. - Status wird auf erledigt gesetzt, das Enddatum gesetzt, falls leer.
- Pflichtangaben (§ 14 Abs. 4 UStG): Nummer, Ausstellungsdatum, Leistungsdatum, Kontakt mit Straße und Ort, Beträge, mindestens eine Position. Fehlt etwas, wird nicht festgeschrieben.
-
Archiv: Die zuletzt erzeugte Datei (ZUGFeRD-PDF oder XRechnung-XML) wird schreibgeschützt nach
<Archivordner>/<Jahr>/kopiert; ohne Datei schreibt das Plugin ein XML mit den Belegdaten. -
Hash-Kette und Snapshots werden in
gobd_document_lockgespeichert, der Vorgang alsFINALIZEDprotokolliert, der geöffnete Beleg sofort gesperrt angezeigt.
Die Ansicht zeigt GoBD FESTGESCHRIEBEN (bzw. GoBD STORNIERT), ein Banner mit „Originalbeleg öffnen“ und „Stornorechnung erstellen“, und sperrt Kunde, Anschrift, Nummer, Datum, Beschreibung und Positionen.
| Bereich | Verhalten | Audit-Log |
|---|---|---|
| Steuerrelevante Daten (Beträge, Steuern, Rabatte, Datum, Nummer, Beschreibung, Kunde, Positionen) | gesperrt | BLOCKED_EDIT |
| Löschen / Papierkorb (Beleg oder Position) | gesperrt | BLOCKED_DELETE |
| Manuell auf „Storniert“ setzen | gesperrt (Hinweis auf Stornorechnung) | BLOCKED_MANUAL_CANCEL |
| Zahlungsstatus, Teilzahlungen | erlaubt | PAYMENT_STATUS_CHANGED |
| Mahnstufe | erlaubt | DUNNING_CHANGED |
| Kundenstammdaten | erlaubt, mit Alt-/Neu-Werten | MASTERDATA_CHANGED |
| Drucken, PDF, Vorschau, E-Rechnung | öffnen die archivierte Datei | – |
Stornorechnungen haben in Systemsteuerung › Formate ein eigenes Nummernformat Stornorechnung – frei wählbar wie jedes andere (z. B. ST-[YEAR]-00001, STORNO-2026-001 oder ein eigener Nummernkreis je Benutzer). Gesetzlich spricht nichts dagegen: § 14 Abs. 4 Nr. 4 UStG verlangt nur eine fortlaufende Nummer aus einer oder mehreren Zahlenreihen, die die Rechnung einmalig kennzeichnet; das Format ist frei. Gezählt wird ab der letzten Stornorechnung, vergebene Nummern werden übersprungen. Ohne eigenes Format erhalten Stornorechnungen ST-JJJJ-NNNNN.
- Eingangsbelege werden in der Ausgaben-Ansicht verknüpft (Schaltfläche, Drag & Drop oder E-Rechnungs-Import) und byte-identisch mit
SHA256SUMSim Belegordner abgelegt – nicht als BLOB in der Datenbank. Prüfen auch außerhalb von YaBS:sha256sum -c SHA256SUMS. - Ausgaben mit Beleg: Badge
GoBD BELEGABLAGE (n); Beträge, Steuer, Konto und Belegentfernung sind gesperrt, Zahlungsstatus und Zahlungsdatum bleiben buchbar. Ohne Beleg:GoBD: OHNE BELEGmit „Beleg verknüpfen & festschreiben“. - Ausgaben mit archivierten Belegen dürfen nicht gelöscht werden.
- Plugins › GoBD: 7. ZUGFeRD / XRechnung als Einnahme importieren (oder der Überwachungsordner) liest Rechnungsnummer (BT-1), Ausstellungsdatum (BT-2), Fälligkeit (BT-9), Partner, Netto (BT-109), Brutto (BT-112) und Steuersatz (BT-119) und legt eine festgeschriebene Einnahme an. Fehlen Pflichtfelder, wird abgelehnt.
- Die Originaldatei wird nach
<Archivordner>/einnahmen/<Jahr>/mitSHA256SUMSund eigener Hash-Kette (gobd_income_lock) archiviert. - Dubletten (gleiche Datei oder gleiche Belegnummer) werden abgelehnt.
- In der Einnahmen-Ansicht ohne Beleg verknüpft „ZUGFeRD / Beleg verknüpfen“ eine Datei mit der vorhandenen Einnahme.
YaBS wird oft jahrelang ohne das Plugin genutzt, oder das Plugin wird ausgeschaltet und wieder eingeschaltet. Für die Zeit, in der es nicht lief, kann das Plugin nichts nachträglich absichern – es behauptet das auch nicht. Stattdessen versiegelt es bei jedem Start den Bestand und dokumentiert alles, was ohne das Plugin geschah:
- Beim Start berechnet das Plugin im Hintergrund für jeden steuerrelevanten Datensatz einen SHA-256-Hash: Rechnungen, Gutschriften, Anzahlungs- und Abschlagsrechnungen mit Positionen, Einnahmen, Ausgaben, Belege zu Ausgaben und Einnahmen, ältere Audit-Log-Einträge ohne Hash und ältere Festschreibungen. Es vergleicht sie mit dem zuletzt bekannten Stand (
gobd_seal_state). - Erste Aktivierung: Der gesamte Bestand wird mit dem heutigen Datum versiegelt. Die Versiegelung sagt ausdrücklich, dass der Schutz ab diesem Zeitpunkt gilt; nichts wird rückdatiert.
-
Neustart nach einer Pause (Plugin aus, andere Arbeitsplätze ohne Plugin, Änderungen per SQL): Jeder seitdem geänderte oder gelöschte Datensatz wird mit altem und neuem Inhalt in
gobd_seal_itemund in der Hash-Kette des Audit-Logs festgehalten (CHANGED_WITHOUT_PLUGIN,DELETED_WITHOUT_PLUGIN). Der ursprüngliche Inhalt bleibt feststellbar (GoBD Rz. 58). YaBS zeigt das beim Start als Meldung an. Neu hinzugekommene Datensätze werden versiegelt. -
Während das Plugin läuft, folgt es jedem Speichern. Ändert jemand einen versiegelten Altbestand-Datensatz (z. B. eine alte, nie festgeschriebene Rechnung), wird das nicht verhindert, aber mit altem Inhalt protokolliert (
SEALED_RECORD_CHANGED). Für neue Belege gilt die Festschreibung. - Jede Versiegelung ist ein Glied einer eigenen Hash-Kette (
gobd_seal) und ein Eintrag im Audit-Log, mit Zeitraum ohne Plugin, Anzahlen und einem Hash über den gesamten Bestand. Das geschieht bei jedem Start erneut, beliebig oft. - Start und Stopp des Plugins stehen im Audit-Log:
PLUGIN_STARTEDmit Version, Benutzer und Einstellungen (Archivordner, Festschreibung beim Export, Einnahmen-Import),PLUGIN_STOPPED. Endete die vorige Sitzung ohne Stopp (Absturz), vermerkt der nächste Start das. - GoBD: 3. Archiv-Integritaet pruefen prüft auch die Kette der Versiegelungen und meldet Datensätze, die seit der letzten Versiegelung außerhalb des Plugins geändert wurden. GoBD: 9. Bestand jetzt versiegeln versiegelt sofort.
In der Verfahrensdokumentation festhalten: seit wann das Plugin aktiv ist (erste Versiegelung) und dass Datensätze aus der Zeit davor ab diesem Zeitpunkt geschützt sind. Ohne Gewähr – im Zweifel mit der Steuerberatung abstimmen.
Im Menü Plugins und in Alles durchsuchen (Umschalt Umschalt):
- GoBD: 1. Beleg festschreiben – wählt eine noch nicht festgeschriebene Rechnung.
-
GoBD: 2. Beleg stornieren (Stornorechnung) – erzeugt eine festgeschriebene Stornorechnung (Gutschrift mit denselben, positiven Beträgen; die Art mindert), setzt den Originalbeleg auf
CANCELLEDund verweist übercancels_document_iddarauf. Die stornierte Rechnung ist auch der Bezug der Stornorechnung auf dem Beleg (<item.correctedinvoice>) und in der E-Rechnung (Typ 381, BT-25/BT-26). - GoBD: 3. Archiv-Integritaet pruefen – prüft im Hintergrund alle Archivdateien, die Hash-Ketten der Rechnungen und Einnahmen gegen Archiv und Datenbank sowie die Kette des Audit-Logs; gemeldet werden alle Probleme, nicht nur das erste.
- GoBD: 4. Betriebspruefer-Export (Z3 / IDEA ZIP) – siehe unten.
- GoBD: 5. Pruefer-Ansicht oeffnen (Z1 Read-Only Tab) – vier Tabs (Ausgangsrechnungen & Stornos, importierte Einnahmen, Ausgaben & Eingangsbelege, Audit-Protokoll) mit Jahresfilter; ein Doppelklick öffnet den Originalbeleg.
-
GoBD: 6. Eingangsbelege pruefen (SHA256SUMS) – nimmt noch nicht verkettete Belege zu Ausgaben und Einnahmen in die Ketten
gobd_receipt/gobd_revenue_receiptauf und prüft Eingangs- und Einnahmenbelege gegen Datenbank, Hash-Kette undSHA256SUMS. - GoBD: 7. ZUGFeRD / XRechnung als Einnahme importieren.
-
GoBD: 8. Audit-Log als Textdatei oeffnen – schreibt das vollständige Audit-Log (alle Jahre) als UTF-8-Textdatei nach
<Archivordner>/audit-log/und öffnet sie im Texteditor des Systems (auch über die Schaltfläche „Audit-Log als Textdatei“ in der Prüfer-Ansicht). Eine Zeile je Eintrag (;-getrennt) mitprev_hash/row_hash; Kopfzeilen erklären die Berechnung, am Ende stehen Kettenende und Prüfergebnis. So lässt sich die Kette auch außerhalb von YaBS nachrechnen. - GoBD: 9. Bestand jetzt versiegeln – versiegelt den Bestand sofort und meldet, was ohne das Plugin geändert oder gelöscht wurde (siehe oben).
Die Suche findet festgeschriebene Belege und Einnahmen über ihre Nummer; ein Klick öffnet den Originalbeleg.
YaBS_GoBD_Z3_Export_<Jahr>_<Zeitstempel>.zip im Archivordner, für ein wählbares Prüfungsjahr:
-
index.xmlundgdpdu-01-09-2004.dtd– Beschreibung für den Import in IDEA, -
rechnungen.csv,rechnungspositionen.csv,kunden.csv,audit_log.csv, -
ausgaben.csv,eingangsbelege.csv,einnahmen.csv, -
belege/,belege/eingangsbelege/,belege/einnahmen/– die Originalbelege, -
VERFAHRENSDOKUMENTATION_TECHNIK.txt– die technischen Sperr-, Snapshot- und Hash-Mechanismen.
-
gobd_document_lock– je festgeschriebenem Beleg:document_id,chain_seq,document_number,status(FINALIZED/CANCELLED),finalized_at,finalized_by,customer_snapshot,positions_snapshot,archive_path,artifact_format,sha256_hash,prev_sha256_hash,cancels_document_id,hash_version,file_sha256,record_data(der gehashte Datensatz).chain_seqist eindeutig: zwei Arbeitsplätze können die Kette nicht verzweigen. -
gobd_income_lock– je importierter Einnahme: Originaldatei, Archivpfad, Datei-SHA-256, Ketten-Hash, Finanz-Snapshot,hash_version,record_data. -
gobd_receipt– Hash-Kette der Eingangsbelege zu Ausgaben (ausexpense_receipts), mit dem gehashten Datensatz inrecord_data. -
gobd_revenue_receipt– ebenso die Hash-Kette der Belege, die in YaBS mit Einnahmen verknüpft sind (ausrevenue_receipts); sie stehen im Z3-Export unterbelege/einnahmen/. -
gobd_audit_log– fortlaufendes Protokoll mit Zeit, Benutzer, Objekt, Aktion, Alt-/Neuwert, Datei-Hash; jeder Eintrag ist überprev_hash/row_hashverkettet (gelöschte oder geänderte Einträge fallen bei der Prüfung auf). -
gobd_seal,gobd_seal_state,gobd_seal_item– die Bestandsversiegelungen (Hash-Kette), der zuletzt bekannte Hash je Datensatz mit Inhalt, und die ohne Plugin geänderten oder gelöschten Datensätze mit altem und neuem Inhalt.
Grenze der Hash-Ketten: Wer Datenbank und Archiv kontrolliert, kann eine Kette vollständig neu berechnen. Dagegen hilft nur, den letzten Hash außerhalb festzuhalten (z. B. im Z3-Export an den Steuerberater oder per qualifiziertem Zeitstempel).
- Datensicherung: Archivordner, Belegordner und Datenbank regelmäßig sichern und über die Aufbewahrungsfristen (§ 147 Abs. 3 AO, § 14b UStG) aufbewahren.
-
Zugriffsschutz: Direkte Schreibrechte auf die Datenbank außerhalb von YaBS (besonders auf die
gobd_*-Tabellen unditems) sperren oder überwachen. -
Verfahrensdokumentation:
VERFAHRENSDOKUMENTATION_TECHNIK.txtbeschreibt nur den technischen Teil; sie muss um die eigenen Abläufe, Verantwortlichkeiten und Freigaben ergänzt werden.
![]()
Download installation packages here!
Deutsch
- Dokumentation (DE)
- Beschreibung
- Hinweise und Neuerungen
- Datenbank
- E-Rechnung
- Kleinunternehmer
- Datenschutz (DSGVO)
- Journal
- GoBD
- SEPA-Lastschrift
- Kontaktliste
- QR-Code
- Dateinamen
- Shopify
- Kasse und TSE
- Vorlagen
- Spaltendefinition
- Skripte
Plugins (DE)
- Plugins (Übersicht)
- DATEV-Export
- GoBD-Plugin
- Heilpraktiker-Plugin
- Kfz-Werkstatt-Plugin
- Vereinsverwaltung-Plugin
- ScriptOnSavePlugin
- Plugins schreiben
English
- Documentation (EN)
- Notes and changes
- Database
- Journal
- Small business VAT exemption
- Data protection (GDPR)
- SEPA direct debit
- Contact list
- QR code
- File name defaults
- Shopify
- Cash register and TSE
- Templates
- Scripts
Plugins (EN)