Skip to content

GoBD Plugin

Claude edited this page Nov 20, 2026 · 7 revisions

English: GoBD plugin · Hintergrund: Ist YaBS GoBD-konforme Software?

GoBD-Konformitäts-Plugin

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.

Funktionen im Überblick

  • 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 mit SHA256(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).

Installation

  1. gobd-compliance.jar besorgen: Es liegt im Zip von YaBS im Ordner openyabs/plugins/ und ist ein eigener Download jedes Releases (für die Installationspakete .deb, .rpm, .msi, .dmg).
  2. 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.)
  3. 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

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.

Lebenszyklus einer Rechnung

1. Entwurf

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.

2. Festschreibung

Automatisch beim Export, über Plugins › GoBD: 1. Beleg festschreiben oder die Schaltfläche im Banner:

  1. 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 (Gutschriften ST-JJJJ-NNNNN). Das Jahr ist das des Rechnungsdatums.
  2. Status wird auf erledigt gesetzt, das Enddatum gesetzt, falls leer.
  3. Pflichtangaben (§ 14 Abs. 4 UStG): Nummer, Ausstellungsdatum, Leistungsdatum, Kontakt mit Straße und Ort, Beträge, mindestens eine Position. Fehlt etwas, wird nicht festgeschrieben.
  4. 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.
  5. Hash-Kette und Snapshots werden in gobd_document_lock gespeichert, der Vorgang als FINALIZED protokolliert, der geöffnete Beleg sofort gesperrt angezeigt.

3. Nach der Festschreibung

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 –

Nummern von Stornorechnungen

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.

Ausgaben und Eingangsbelege (GoBD Rz. 61–64)

  • Eingangsbelege werden in der Ausgaben-Ansicht verknüpft (Schaltfläche, Drag & Drop oder E-Rechnungs-Import) und byte-identisch mit SHA256SUMS im 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 BELEG mit „Beleg verknüpfen & festschreiben“.
  • Ausgaben mit archivierten Belegen dürfen nicht gelöscht werden.

Einnahmen aus E-Rechnungen

  • 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>/ mit SHA256SUMS und 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.

Bestand: Plugin später aktiviert oder zwischendurch aus

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_item und 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_STARTED mit 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.

Befehle und Suche

Im Menü Plugins und in Alles durchsuchen (Umschalt Umschalt):

  1. GoBD: 1. Beleg festschreiben – wählt eine noch nicht festgeschriebene Rechnung.
  2. GoBD: 2. Beleg stornieren (Stornorechnung) – erzeugt eine festgeschriebene Stornorechnung (Gutschrift mit denselben, positiven Beträgen; die Art mindert), setzt den Originalbeleg auf CANCELLED und verweist über cancels_document_id darauf. 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).
  3. 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.
  4. GoBD: 4. Betriebspruefer-Export (Z3 / IDEA ZIP) – siehe unten.
  5. 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.
  6. GoBD: 6. Eingangsbelege pruefen (SHA256SUMS) – nimmt noch nicht verkettete Belege zu Ausgaben und Einnahmen in die Ketten gobd_receipt / gobd_revenue_receipt auf und prüft Eingangs- und Einnahmenbelege gegen Datenbank, Hash-Kette und SHA256SUMS.
  7. GoBD: 7. ZUGFeRD / XRechnung als Einnahme importieren.
  8. 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) mit prev_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.
  9. 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.

Z3-Export (IDEA / GDPdU)

YaBS_GoBD_Z3_Export_<Jahr>_<Zeitstempel>.zip im Archivordner, für ein wählbares Prüfungsjahr:

  • index.xml und gdpdu-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.

Datenbanktabellen

  • 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_seq ist 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 (aus expense_receipts), mit dem gehashten Datensatz in record_data.
  • gobd_revenue_receipt – ebenso die Hash-Kette der Belege, die in YaBS mit Einnahmen verknüpft sind (aus revenue_receipts); sie stehen im Z3-Export unter belege/einnahmen/.
  • gobd_audit_log – fortlaufendes Protokoll mit Zeit, Benutzer, Objekt, Aktion, Alt-/Neuwert, Datei-Hash; jeder Eintrag ist über prev_hash / row_hash verkettet (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).

Organisatorische Hinweise

  1. Datensicherung: Archivordner, Belegordner und Datenbank regelmäßig sichern und über die Aufbewahrungsfristen (§ 147 Abs. 3 AO, § 14b UStG) aufbewahren.
  2. Zugriffsschutz: Direkte Schreibrechte auf die Datenbank außerhalb von YaBS (besonders auf die gobd_*-Tabellen und items) sperren oder überwachen.
  3. Verfahrensdokumentation: VERFAHRENSDOKUMENTATION_TECHNIK.txt beschreibt nur den technischen Teil; sie muss um die eigenen Abläufe, Verantwortlichkeiten und Freigaben ergänzt werden.

Clone this wiki locally