Systembeschreibung GoBD-Modus
Verfahrensdokumentation: technischer Teil für Kunden von Paperarchive
Version 2.1, Stand 06.10.2026
Die GoBD verlangen von jedem Unternehmen eine eigene Verfahrensdokumentation. Diese Systembeschreibung liefert den Teil, den nur ich als Hersteller beschreiben kann: was Paperarchive technisch tut, wenn ein Space im GoBD-Modus betrieben wird, und was es nicht tut.
Paperarchive unterstützt die GoBD-konforme Archivierung. Ob deine Buchführung und Aufbewahrung insgesamt den GoBD entspricht, hängt von deinem ganzen Verfahren ab. Paperarchive ist nicht zertifiziert und kein Buchhaltungssystem.
Für deinen eigenen Teil gibt es eine Vorlage zum Ausfüllen: Muster-Verfahrensdokumentation
Allgemeine Angaben
| System | Paperarchive, cloudbasierte Dokumentenverwaltung (Web-App, iOS- und Android-App, API) |
| Hersteller und Betreiber | Marcel Klein, Paperarchive, Auf der Weide 3, 58840 Plettenberg |
| Version | 2.1 |
| Stand | 06.10.2026 |
| Bezug | GoBD (BMF-Schreiben vom 28.11.2019, BStBl I S. 1269, in der jeweils geltenden Fassung), § 147 AO, § 257 HGB, § 14b UStG |
1. Allgemeine Beschreibung
Geltungsbereich
- Die GoBD-Regeln gelten nur in Spaces, für die du den GoBD-Modus eingeschaltet hast. Ein Space ist ein getrennter Bereich in deinem Konto, zum Beispiel "Business" neben "Privat".
- Datei-Hash (SHA-256) und Änderungsprotokoll laufen für alle Dokumente. Archivierung, Aufbewahrungsfristen, Sperren, Löschschutz und die monatliche Integritätsprüfung gibt es nur im GoBD-Modus.
Rollen
| Rolle | Aufgabe |
|---|---|
| Hersteller und Betreiber (Marcel Klein) | Entwicklung, Betrieb, Überwachung, diese Beschreibung. Paperarchive wird von einer Person betrieben. |
| Space-Inhaber (Kunde) | Schaltet den GoBD-Modus ein, verantwortet Erfassung, Vollständigkeit, Kontrolle der Angaben, eigene Verfahrensdokumentation und Zugriffe. |
| Admin, Bearbeiter, Leser | Mitglieder eines geteilten Space mit den Rechten ihrer Rolle. |
| Prüfer | Befristeter Lesezugriff für eine Außenprüfung. |
Originale und erkannte Angaben
Paperarchive speichert Originaldateien und erkennt daraus Angaben wie Titel, Datum, Absender, Kategorie, Betrag, Fälligkeit und Referenznummer. Maßgeblich für die Aufbewahrung ist die Originaldatei. Die erkannten Angaben sind Index- und Hilfsdaten für Suche, Fristen und Export.
2. Erfassung
| Weg | Was ankommt | Hinweise |
|---|---|---|
| Upload in der Web-App | Die Datei, wie sie hochgeladen wird | Höchstens 50 MB pro Datei |
| Kamera-Erfassung (Web-App, iOS, Android) | In der Regel ein PDF aus den aufgenommenen Seiten | Die Bilder werden verkleinert und komprimiert. Die so erzeugte Datei ist das Original; Paperarchive prüft die Bildqualität nicht. |
| E-Mail an die persönliche Upload-Adresse | Anhänge als eigene Dokumente; eine E-Mail ohne verwertbaren Anhang als .eml-Dokument | Rohnachricht bis 25 MB, Absender-Allowlist optional |
| Google Drive, Dropbox | Dateien aus einem gewählten Ordner | Höchstens 50 MB; keine XML-Dateien und E-Mails |
| REST-API | Datei per API-Schlüssel | Höchstens 50 MB; Dateityp wird anhand des Inhalts geprüft |
Angenommene Formate
- Web-Upload: PDF, JPG, PNG, GIF, WebP, TIFF, BMP, HEIC/HEIF, Office-Dokumente (DOCX, DOC, XLSX, XLS, PPTX, PPT, ODT, ODS, ODP) und XML, wenn es eine E-Rechnung ist.
- E-Mail-Anhänge: PDF, JPG, PNG, GIF, BMP, WebP, HEIC/HEIF und XML-E-Rechnungen. Office-Anhänge werden per E-Mail nicht übernommen.
- REST-API: PDF, JPEG, PNG, TIFF, HEIC/HEIF, Office-Dokumente und XML-E-Rechnungen.
- Google Drive und Dropbox: dieselbe Liste wie die Verarbeitung, ohne XML und E-Mails; sie enthält auch SVG, das der Web-Upload nicht annimmt.
- XML wird nur als E-Rechnung angenommen (UBL Invoice/CreditNote oder CII CrossIndustryInvoice). Passwortgeschützte PDFs werden abgelehnt.
E-Rechnungen und E-Mails
- XRechnung (XML): Die XML-Datei ist das Original und bleibt unverändert. Paperarchive erzeugt eine PDF-Ansicht nur zur Anzeige. Betrag, Daten, Absender und Zahlungsdaten stammen aus den Rechnungsdaten. Der Download liefert die XML-Datei.
- ZUGFeRD / Factur-X: Das PDF ist das Original und bleibt unverändert. Die eingebettete Rechnungs-XML wird ausgelesen, ihre Werte ersetzen die erkannten Werte.
- E-Mail ohne Anhang: Die Rohnachricht wird unverändert als .eml gespeichert und zur Anzeige in ein PDF umgewandelt.
- Quell-E-Mail im GoBD-Space: Landen Anhänge einer E-Mail in einem GoBD-Space, speichert Paperarchive zusätzlich die Rohnachricht einmal pro Inhalt und verknüpft sie mit jedem daraus entstandenen Dokument. Bringt später eine weitere E-Mail einen Anhang, der im Space schon vorhanden ist, entsteht kein neues Dokument: Die neue E-Mail wird als weitere Quell-E-Mail mit dem vorhandenen Dokument verknüpft und wie die erste aufbewahrt, geschützt und exportiert.
Space und Duplikate
Der Space ergibt sich aus den Upload-Angaben, sonst aus dem bestehenden Dokument, sonst aus dem Standard-Space. Beim E-Mail-Eingang bestimmen das Space-Kürzel in der Adresse oder Regeln nach Absender und Betreff den Space. Hat eine Datei denselben SHA-256-Hash wie ein vorhandenes Dokument desselben Nutzers, legt Paperarchive kein zweites Dokument an; bei einem Upload in einen GoBD-Space zählt nur ein Dokument im selben Space, eine Kopie in einem anderen Space ist kein Duplikat. Eine E-Mail, deren Absenderprüfung (SPF, DKIM, DMARC) fehlschlägt, wird im GoBD-Space nicht verworfen: Sie bleibt in Quarantäne erhalten und erhält einen Eingabe-nötig-Hinweis zur Prüfung.
3. Verarbeitung
Jeder Upload legt einen Dokumenteintrag an und startet die Verarbeitung in sieben Stufen:
- Prüfung: SHA-256 der gespeicherten Datei berechnen, mit dem Hash der App vergleichen (falls vorhanden), Duplikatprüfung, Hash speichern, Space zuordnen, Größe, Typ und Passwortschutz prüfen.
- Konvertierung: Office-Dokumente in PDF (LibreOffice), HEIC in JPEG, XML-Rechnungen und E-Mails in eine PDF-Ansicht. Die Umwandlung wird neben dem Original gespeichert; das Original bleibt unverändert.
- Malware-Scan mit ClamAV. Bei einem Befund wird die Datei gelöscht und die Verarbeitung abgebrochen.
- Texterkennung: Bei PDFs mit vollständiger Textebene lokal, sonst über Google Cloud Vision am EU-Endpunkt (eu-vision.googleapis.com), bis zu 100 Seiten, mit Inhaltsprüfung (SafeSearch). E-Rechnungen und E-Mails bringen ihren Text mit.
- KI-Analyse über Azure OpenAI (Germany West Central, EU Data Zone): Titel, Datum, Kategorie, Absender, Betrag, Fälligkeit, Referenznummer, strukturierte Angaben und ein Ereignis (Rechnung, Beleg, Vertrag usw.). Im GoBD-Space gilt ab dem Hochladen eine vorläufige Aufbewahrungsfrist (Ende des Upload-Jahres plus 10 Jahre); bei der Archivierung wird sie einmal durch die Frist der Belegart ersetzt.
- Tagging: optionale Themen-Tags, bricht die Verarbeitung nie ab.
- Abgleich: Embeddings für die Suche (Azure OpenAI, EU Data Zone) und ähnliche Dokumente.
Danach setzt Paperarchive den Status auf abgeschlossen und archiviert das Dokument im GoBD-Space (siehe Abschnitt 4). In Produktion startet die API nicht, wenn ein KI- oder OCR-Anbieter fehlt oder Dokumentdaten außerhalb der EU verarbeitet würden.
Jeder Verarbeitungslauf wird mit Auslöser, Status, Dauer je Stufe und bei Fehlern Stufe und Fehlercode protokolliert. Ein fehlgeschlagenes Dokument kann erneut verarbeitet werden. Im GoBD-Space wird ein fehlgeschlagenes Dokument nicht automatisch archiviert und braucht eine Entscheidung (siehe Abschnitt 4).
Unsichere Angaben erzeugen einen Eingabe-nötig-Hinweis zur Bestätigung. Im GoBD-Space wird ein Dokument ohne offenen Hinweis direkt nach der Verarbeitung archiviert; ein Dokument mit offenem Eingabe-nötig-Hinweis erst, nachdem es geprüft wurde, spätestens 10 Tage nach dem Hochladen. Bis dahin lässt sich das Dokument noch bearbeiten, in den Papierkorb verschieben, löschen, aufteilen, zusammenführen und in einen anderen Space verschieben; jeder Schritt steht im Änderungsprotokoll. Nach der Archivierung können nur der Inhaber oder ein Admin des Spaces Indexdaten korrigieren, mit Pflichtbegründung und über die Korrekturfunktion: Dokumentdatum, Absender, Kategorie, Referenznummer, strukturierte Angaben und die Werte des Ereignisses (Betrag, Währung, Fälligkeit, Referenznummer, Typ, Zeitraum, Skonto); ein fehlendes Ereignis lässt sich ergänzen. Die Web-App bietet im Bearbeitungsformular Datum, Absender, Kategorie und Fälligkeit an. Das Änderungsprotokoll behält alten Wert, neuen Wert und Begründung. Nie korrigierbar sind die Datei und ihre abgeleiteten Dateien, die Hashes, der Erfassungszeitpunkt, Archivierungsdatum und -grund, das Fristende, der Space und wer hochgeladen hat. Maßgeblich bleibt die Originaldatei.
4. Archivierung und Aufbewahrung
Wann archiviert wird
- Archiviert wird erst, wenn die Verarbeitung abgeschlossen ist und ein SHA-256-Hash des Originals vorliegt. Direkt vor dem Archivieren prüft Paperarchive die gespeicherte Originaldatei gegen diesen Hash. Bei einer Abweichung wird das Dokument nicht archiviert und der Inhaber des Spaces benachrichtigt.
- Automatisch am Ende einer erfolgreichen Verarbeitung, wenn das Dokument in einem GoBD-Space liegt und keinen offenen Eingabe-nötig-Hinweis hat. Dokumente mit offenem Hinweis werden archiviert, nachdem sie geprüft wurden, spätestens 10 Tage nach dem Hochladen.
- Manuell über das Menü eines Dokuments oder als Sammelaktion (Rolle Admin oder Inhaber). Beim Einschalten des GoBD-Modus bietet die App an, vorhandene Dokumente zu archivieren.
- Ein stündlicher Lauf archiviert fertig verarbeitete Dokumente, die nicht sofort archiviert wurden, etwa nach einer Prüfung oder nachträglich in den GoBD-Space verschobene Dokumente (sie erhalten beim Verschieben die vorläufige Frist), sobald sie 6 Stunden alt sind; mit offenem Eingabe-nötig-Hinweis wie oben.
- Achtung: Fehlgeschlagene Uploads und Dokumente, deren Verarbeitung fehlgeschlagen ist, werden nicht automatisch archiviert. Sie brauchen eine Entscheidung: Verarbeitung erneut starten oder das Dokument ausdrücklich mit schriftlicher Begründung archivieren (Inhaber oder Admin). Auch ein Dokument, das nach 10 Tagen noch nicht verarbeitet ist, wird nicht automatisch archiviert; der Inhaber erhält jede Woche einen Hinweis in der App, bis es verarbeitet oder ausdrücklich archiviert ist. Die ausdrückliche Archivierung und ihre Begründung werden protokolliert.
- Jede Archivierung wird mit ihrem Grund protokolliert: nach der Verarbeitung, stündliche Prüfung, nach bestätigter Prüfung, an der 10-Tage-Grenze mit offener Frage, manuell, durch DATEV-Export, ausdrücklich für ein unvollständiges Dokument.
- Bis zur Archivierung können Nutzer im GoBD-Space das Original und die daraus abgeleiteten Dateien nicht ändern oder löschen; das kann nur die Verarbeitung von Paperarchive selbst (Umwandlung, Aufteilen, Zusammenführen).
- Archivierungszeitpunkt, archivierende Person und Fristende werden in einem Schritt geschrieben. Die Archivierung lässt sich nicht rückgängig machen.
- Beim Einschalten des GoBD-Modus erhält jedes Dokument des Spaces eine Aufbewahrungsfrist. Ausschalten lässt sich der GoBD-Modus nicht, solange Dokumente in der Aufbewahrung liegen oder eine Löschsperre aktiv ist. Löschen lässt sich ein GoBD-Space nur, wenn er keine archivierten Dokumente enthält und keine Löschsperre aktiv ist: Archivierte Dokumente mit abgelaufener Frist müssen vorher in den Papierkorb, nie archivierte Dokumente wandern in den Space, den der Inhaber wählt. Die App weist vor dem Einschalten darauf hin. Jedes Ein- und Ausschalten wird protokolliert.
Was gesperrt ist
Die Sperren liegen als Trigger in der Datenbank und gelten für App, API und auch für den internen Service-Zugang der API. Der einzige Weg daran vorbei ist die Kontolöschung, nach ausdrücklicher Bestätigung der Aufbewahrung für die eigenen GoBD-Spaces; archivierte Uploads in GoBD-Spaces anderer Inhaber und Uploads unter einer Löschsperre werden dabei nicht gelöscht, sondern an diesen Inhaber übertragen (siehe Abschnitt 11). Eine aktive Löschsperre blockiert diese Kontolöschung, bis die Sperre aufgehoben oder der Space übergeben ist.
- Dokument: Textinhalt, Titel, Dateiname, Dokumentdatum, Erfassungszeitpunkt, Absender und Kategorie (auch die gespeicherten Namen von Absender und Kategorie), Referenznummer, strukturierte Angaben, Hash-Felder, Datei, Verweise auf die Dateipfade, Archivierungsangaben mit Grund, Aufbewahrungsfrist und der Zeitpunkt einer Übertragung an den Inhaber des Spaces. Ein fehlendes Ereignis wird nur über die Korrektur verknüpft. Ein archiviertes Dokument kann nicht aus dem GoBD-Space verschoben werden; die Originaldatei kann nicht überschrieben oder gelöscht werden.
- Ereignis des Dokuments: Betrag, Währung, Fälligkeit, Referenznummer, Typ und Dokumentverweis; Löschen erst nach Fristende. Der Status (zum Beispiel bezahlt) bleibt änderbar und wird protokolliert.
- Indexdaten (auch der Dateiname) werden nur über die Korrekturfunktion mit Pflichtbegründung berichtigt (Inhaber oder Admin, siehe Abschnitt 3). Änderbar bleiben Tags und ähnliche Nebenangaben. Jede Änderung wird protokolliert.
Aufbewahrungsfristen
Die Frist richtet sich nach dem Typ des Ereignisses, das zum Dokument gehört. Die Werte sind eine Entscheidung des Betreibers vom Oktober 2026 und von einer Steuerberatung zu bestätigen.
| Ereignistyp | Frist | Rechtsgrundlage |
|---|---|---|
| Rechnung, Beleg, Kontoauszug, Gutschrift | 8 Jahre | § 257 Abs. 1 Nr. 4, Abs. 4 HGB; § 147 Abs. 1 Nr. 4, Abs. 3 AO (BEG IV) |
| Vertrag, Police | 10 Jahre | § 257 Abs. 1 Nr. 1, Abs. 4 HGB; § 147 Abs. 1 Nr. 1, Abs. 3 AO |
| Brief, Angebot | 6 Jahre | § 257 Abs. 1 Nr. 2, 3, Abs. 4 HGB; § 147 Abs. 1 Nr. 2, 3, Abs. 3 AO |
| Bescheid, Lohn- und Gehaltsabrechnung | 6 Jahre | § 147 Abs. 1 Nr. 5, Abs. 3 AO |
| Kein Ereignis oder anderer Typ | 10 Jahre | Standard (längste Frist) |
- Die Frist endet am 31. Dezember des Jahres "Jahr des Dokumentdatums + Frist". Beispiel: Rechnung vom 15.03.2026, Fristende 31.12.2034. Ohne Dokumentdatum zählt der Erfassungszeitpunkt.
- Eine Frist wird nie verkürzt. Bereits archivierte Dokumente behalten ihre Frist, auch wenn sich die Tabelle ändert. Vor der Archivierung gilt die vorläufige Frist; bei der Archivierung wird sie einmal durch die Frist der Belegart ersetzt (das Änderungsprotokoll vermerkt das als policy_applied). Bei Verträgen und Policen kann der Inhaber oder ein Admin das Vertragsende setzen; die Frist läuft dann ab dort.
- Die Ablaufhemmung nach § 147 Abs. 3 Satz 5 AO erkennt Paperarchive nicht automatisch; sie wird über eine Löschsperre abgebildet, die der Inhaber oder ein Admin setzt (siehe unten).
- 60 Tage vor dem Ende der Aufbewahrungsfrist archivierter Belege erhält der Inhaber des Spaces einen Hinweis in der App.
Löschsperre (Ablaufhemmung)
- Inhaber und Admins eines GoBD-Spaces setzen eine Löschsperre für den ganzen Space oder für ein Dokument, mit Begründung und optionalem Enddatum. Setzen und Aufheben werden mit Begründung protokolliert (retention_hold.set, retention_hold.released).
- Solange eine Sperre aktiv ist, werden erfasste Dokumente nicht endgültig gelöscht, auch nicht nach Ablauf ihrer Frist. In den Papierkorb lassen sie sich noch verschieben, das Leeren des Papierkorbs nach 30 Tagen überspringt sie aber. Ihre Werte im Änderungsprotokoll bleiben erhalten. Der Space lässt sich nicht löschen und nicht aus dem GoBD-Modus nehmen.
- Eine aktive Löschsperre blockiert die Kontolöschung des Inhabers: Die Löschung wird abgelehnt, bis die Sperre aufgehoben oder der Space übergeben ist.
- Löschsperren werden in der Web-App gesetzt. Die iOS- und die Android-App zeigen sie noch nicht an.
Löschen
- Ein archiviertes Dokument mit laufender Frist kann weder in den Papierkorb verschoben noch gelöscht werden. Ein archiviertes Dokument ohne Fristende bleibt geschützt.
- Ein noch nicht archiviertes Dokument lässt sich in den Papierkorb verschieben, löschen, aufteilen und zusammenführen, auch während seine vorläufige Frist läuft. Jeder Schritt steht mit der handelnden Person im Änderungsprotokoll. Wird ein solches Dokument aus einem GoBD-Space gelöscht, bleiben seine protokollierten Werte bis zum Ende des Erfassungsjahres plus 10 Jahre erhalten (mindestens die vorläufige Frist) und stehen im Änderungsprotokoll des GDPdU-Exports; löscht der Inhaber des Spaces sein eigenes Konto, werden diese Werte entfernt.
- Ein nie archiviertes Dokument kann aus einem GoBD-Space verschoben werden. Seine Aufbewahrung endet, und das Verschieben wird mit altem und neuem Space protokolliert.
- Nach Fristende kann ein archiviertes Dokument in den Papierkorb, wiederhergestellt und gelöscht werden; seine übrigen Angaben bleiben gesperrt. Paperarchive löscht nach Fristende nicht automatisch.
- Der Papierkorb wird nach 30 Tagen geleert; archivierte Dokumente in der Aufbewahrung und Dokumente unter einer Löschsperre bleiben dabei erhalten. Wurde ein Dokument aufgeteilt und ist einer seiner Teile archiviert, bleibt das Ausgangsdokument im Papierkorb. Jeder Schritt steht im Änderungsprotokoll.
- Archivierte Dokumente in GoBD-Spaces bleiben auch bei Überschreitung des Tariflimits lesbar, herunterladbar und exportierbar.
5. Unveränderbarkeit und Protokollierung
Inhalt eines Eintrags im Änderungsprotokoll
| Feld | Inhalt |
|---|---|
| Zeitpunkt | Setzt die Datenbank selbst, keine Rückdatierung |
| Inhaber | Inhaber des betroffenen Dokuments oder Ereignisses |
| Akteur und Akteurtyp | Wer die Änderung ausgelöst hat (Nutzer, System oder Verarbeitung); bleibt nach einer Kontolöschung als pseudonyme ID erhalten |
| Aktion und Datensatz | Zum Beispiel Dokument geändert, archiviert, gelöscht |
| Alter und neuer Wert | Der geänderten Felder |
| Kontext | Space und, bei Ereignissen, Dokument; Kennung der Anfrage |
| Hash-Kette | Position, Hash des vorherigen Eintrags, eigener Hash |
Was protokolliert wird
- Dokument: angelegt, geändert (Anzeigename, Titel, Inhalt nur als "geändert", Absender, Kategorie, Space mit altem und neuem Space, Referenznummer, strukturierte Angaben, Dokumentdatum, Datei, Archivierung, Frist), archiviert mit Grund, korrigiert mit Begründung, aufgeteilt (jeder Teil behält einen Verweis auf sein Ausgangsdokument), zusammengeführt (die Originaldatei eines umgewandelten Ziels bleibt verknüpft), in den Papierkorb, wiederhergestellt, gelöscht.
- Tags: hinzugefügt und entfernt. Ereignis: angelegt, geändert (Betrag, Währung, Fälligkeit, Referenznummer, Typ, Status), gelöscht.
- Space: GoBD-Modus ein und aus, Space an einen Admin übergeben, Löschsperre gesetzt und aufgehoben, Prüfer-Zugang erteilt, geändert und entfernt, jede Datei, die ein Prüfer öffnet oder herunterlädt, GDPdU-Export erstellt, DATEV-Export erstellt.
- Integritätsprüfungen, gebrochene Hash-Ketten und jedes Entfernen protokollierter Werte.
Nicht protokolliert werden Lesezugriffe von Mitgliedern (Ansehen, Suchen, Herunterladen), Änderungen an Einstellungen, Kategorien, Absendern und Tags selbst und der Volltext vor und nach einer Inhaltsänderung. Dateien, die ein Prüfer öffnet oder herunterlädt, werden protokolliert (siehe Abschnitt 7).
Die Einträge zu Dokumenten, Tags und Ereignissen schreibt die Datenbank in derselben Transaktion wie die Änderung: Scheitert der Eintrag, scheitert die Änderung. Auch die Einträge zu Dateizugriffen von Prüfern und zu DATEV-Exporten sind Pflicht: Lassen sie sich nicht schreiben, wird keine Datei und kein Export ausgeliefert. Andere Einträge, die die API selbst schreibt (Integritätsprüfung, GDPdU-Export), brechen den Vorgang bei einem Schreibfehler nicht ab; der Fehler wird im Anwendungslog vermerkt.
Append-only und Hash-Kette
- Ändern, Löschen und Leeren (TRUNCATE) des Änderungsprotokolls sind in der Datenbank gesperrt. Nutzer haben kein Schreibrecht. Einzige Ausnahmen sind die festgelegten Löschregeln für die gespeicherten Werte: endgültige Löschung nach der Frist, Ablauf der Frist (tägliche Bereinigung) und Kontolöschung, die auch den Inhaberbezug entfernt. Eine Löschsperre hält die Werte fest. Werte ohne Dokument werden nach 10 Jahren gelöscht, Aufzeichnungen über Jobläufe nach einem Jahr. Bei einer Kontolöschung werden IP-Adresse und Browser der gelöschten Person aus Einträgen entfernt, die bleiben (an einen Space-Inhaber übertragene Belege); die Werte bleiben. Jedes Entfernen wird selbst protokolliert, und der monatliche Integritätslauf gleicht die Entfernungen mit diesen Regeln ab. Der Eintrag selbst und die Hash-Kette bleiben erhalten.
- Die Einträge eines Inhabers bilden eine Hash-Kette (SHA-256): Jeder Eintrag enthält den Hash des vorherigen. Eine Veränderung oder Entfernung wird dadurch erkennbar (tamper-evident), aber nicht verhindert.
- Wer Superuser-Rechte auf die Datenbank hat (der Betreiber), könnte eine Kette ab einem Punkt neu berechnen. Das fällt auf, wenn du exportierte Hash-Werte mit einem späteren Export vergleichst.
- Einträge aus der Zeit vor der Hash-Kette sind nicht verkettet, ohne erfassten Akteur und decken nur einen Teil der Felder ab.
Einsicht und Export
- Jeder, der ein Dokument öffnen darf, sieht seinen Verlauf im Tab Verlauf, für den Zeitraum, seit dem das Dokument in seinem aktuellen Space liegt. Nur wer es hochgeladen hat, sieht auch den Verlauf davor.
- Inhaber und Admins eines GoBD-Space exportieren das Änderungsprotokoll für einen Zeitraum als CSV oder JSON, mit den Werten der Hash-Kette. Prüfer erhalten es über den GDPdU-Export.
6. Integrität
Beim Upload berechnet Paperarchive den SHA-256 der gespeicherten Datei, bevor sie umgewandelt wird, und speichert ihn. Hat die App beim Upload einen eigenen Hash berechnet, wird er verglichen; weichen beide ab, bricht die Verarbeitung ab.
- Monatlich: Einmal pro Kalendermonat berechnet Paperarchive für jedes archivierte Dokument in einem GoBD-Space den Hash der Originaldatei neu, vergleicht ihn mit dem gespeicherten Hash, prüft die Hash-Ketten der Inhaber und gleicht jedes Entfernen protokollierter Werte mit den Löschregeln ab.
- Vor der Archivierung: Die gespeicherte Originaldatei wird gegen ihren Hash geprüft; bei einer Abweichung wird das Dokument nicht archiviert und der Inhaber des Spaces benachrichtigt.
- Auf Anforderung: "Integrität prüfen" im Tab Verlauf eines archivierten Dokuments startet dieselbe Prüfung für dieses Dokument.
- Ergebnisse (unverändert, abweichend, Datei fehlt, kein Hash, Prüfung fehlgeschlagen) stehen im Änderungsprotokoll und im Verlauf des Dokuments.
Abweichungen und gebrochene Ketten werden zusätzlich an die Fehlerüberwachung gemeldet, nur mit IDs und Grund. Paperarchive ändert dabei nichts automatisch; ich prüfe die Ursache. Eine veränderte oder fehlende Originaldatei kann derzeit nicht aus einer unabhängigen Sicherung wiederhergestellt werden (siehe 8).
7. Datenzugriff
Zugang und Berechtigungen
- Anmeldung mit E-Mail und Passwort, Google oder Apple, optional mit Zwei-Faktor-Authentifizierung. Exporte und Einladungen verlangen bei eingerichteter 2FA den zweiten Faktor.
- Web-App und Apps greifen über die Supabase-API direkt auf die Datenbank zu; Row Level Security begrenzt jeden Zugriff auf eigene Daten und Spaces, in denen du Mitglied bist. Die API prüft Berechtigungen selbst.
- Der Betreiber hat technisch Zugriff auf alle Daten; diese Zugriffe werden nicht gesondert protokolliert.
- Der Inhaber kann einen Space an ein Mitglied mit der Rolle Admin übergeben (Space übergeben); die Übergabe wird im Änderungsprotokoll des Space vermerkt.
| Rolle | Rechte |
|---|---|
| Inhaber | Alles, inklusive Übergeben und Löschen des Space |
| Admin | Mitglieder und Einstellungen verwalten, bearbeiten, archivieren, mit Begründung korrigieren, Löschsperren, Änderungsprotokoll exportieren, GDPdU-Export |
| Bearbeiter | Hochladen, bearbeiten, verschieben, löschen im Rahmen der Sperren, DATEV-Export |
| Leser | Lesen und suchen |
| Prüfer | Lesen und suchen, Verlauf, GDPdU-Export, befristet |
Unmittelbarer Zugriff (Z1): Rolle Prüfer
- Inhaber und Admins laden per E-Mail mit der Rolle "Prüfer (nur lesen, befristet)" ein und wählen ein Enddatum, höchstens ein Jahr im Voraus. Der Einladungslink gilt 7 Tage, die Person braucht ein Paperarchive-Konto, der Inhaber des Space ein aktives Abo oder eine Testphase.
- Der Prüfer sieht Dokumente, Dateien, Ereignisse, Angaben und Verlauf, kann suchen und den GDPdU-Export erstellen. Er kann nichts hochladen, ändern, löschen, archivieren oder einladen.
- Der Zugriff endet automatisch am gewählten Tag, nach höchstens 366 Tagen; die Datenbank prüft das bei jeder Abfrage. Inhaber und Admins können ihn jederzeit verlängern, verkürzen und entfernen; der Prüfer kann ihn nicht selbst beenden und den Space nicht verlassen. Die Rolle selbst ist nicht änderbar. Alles wird im Änderungsprotokoll des Space vermerkt.
- Jede Datei, die ein Prüfer öffnet oder herunterlädt (Web-App, iOS, Android, öffentliche API, MCP), wird als auditor.document_viewed im Änderungsprotokoll des Space vermerkt, bevor die Datei ausgeliefert wird. Direkt aus dem Dateispeicher können Prüfer keine Dateien lesen; Dateien erreichen sie nur über diesen protokollierten Link. Lässt sich der Eintrag nicht schreiben, wird keine Datei ausgeliefert. Exporte des Prüfers werden ebenfalls protokolliert.
Mittelbarer Zugriff (Z2)
Du oder eine beauftragte Person wertet die Daten nach Vorgabe der Prüfung in Paperarchive aus: Volltextsuche, Filter, Download von Originalen, Export des Änderungsprotokolls und die Exporte unten. Eine eigene Prüfsoftware bietet Paperarchive nicht.
Datenträgerüberlassung (Z3): GDPdU-Export
- Für Inhaber, Admins und Prüfer, nur angemeldet (kein API-Schlüssel), bei eingerichteter 2FA mit zweitem Faktor.
- Alle Dokumente des Space, deren Dokumentdatum (sonst Erfassungszeitpunkt) im Zeitraum liegt, ohne Papierkorb außer archivierten Dokumenten, die nach Fristende in den Papierkorb verschoben wurden (Spalte Papierkorb); Zeitraum höchstens 11 Jahre.
- ZIP mit index.xml nach dem Beschreibungsstandard der Finanzverwaltung (DTD gdpdu-01-09-2004.dtd), dokumente.csv, ereignisse.csv, aenderungsprotokoll.csv mit jedem Eintrag des Space im Zeitraum und der Hash-Kette, fehlende_dateien.csv für Dateien, die nicht enthalten sein können, und den Originaldateien. UTF-8, Semikolon, Dezimalkomma, Datum TT.MM.JJJJ in der Zeitzone Europe/Berlin, Werte unverändert.
- Große Exporte werden in Teile bis 400 MB aufgeteilt, jeder mit allen Tabellen. Jeder Export wird im Änderungsprotokoll vermerkt.
- Zusätzlich enthalten: Visualisierungen (die PDF-Ansicht von E-Rechnungen und E-Mails), Quell-E-Mails einschließlich weiterer E-Mails mit demselben Anhang und die Ursprungsdateien von Zusammenführungen.
DATEV-Export
Übergabe an die Steuerberatung für höchstens ein Jahr: DATEV-Buchungsstapel (Format 7.0), Belegübersicht und Originale von abgeschlossenen Rechnungen, Belegen und Gutschriften des ganzen Space. Für Inhaber, Admins und Bearbeiter des Space; Leser und Prüfer können ihn nicht starten, weil er im GoBD-Space die exportierten Dokumente archiviert. Kein Prüferexport. Jeder DATEV-Export wird im Änderungsprotokoll des Space vermerkt (space.datev_exported). Aus einem GoBD-Space archiviert der Export jedes exportierte Dokument; Dokumente mit offener Frage werden nicht exportiert, sondern mit einem Hinweis in belege.csv aufgeführt; scheitert die Archivierung, entsteht kein Export. Zusätzlich kann jeder Nutzer jederzeit einen vollständigen Export seiner Daten anfordern.
8. Datensicherheit und Datensicherung
- TLS für alle Verbindungen, Verschlüsselung der gespeicherten Daten bei Supabase/AWS (AES-256), private Speicher, Dateizugriff nur über kurzlebige signierte Links.
- Malware-Scan aller Uploads, Prüfung von Dateityp und Größe.
Datensicherung
- Datenbank: tägliche Backups durch Supabase, 7 Tage aufbewahrt, Region Frankfurt. Kein Point-in-Time-Recovery; bis zu 24 Stunden Datenverlust sind möglich.
- Dateien (Originale, Umwandlungen, E-Mails): liegen in Supabase Storage in Frankfurt, sind nicht Teil der Datenbank-Backups und haben derzeit keine vom System unabhängige Kopie. Das ist eine bekannte Lücke.
- Geplant: nächtliche, verschlüsselte Kopie der Dateien auf einen Speicher bei Hetzner. Ein Termin steht noch nicht fest.
- Bis dahin: Erstelle regelmäßig einen GDPdU-Export oder den Datenexport deines Kontos und bewahre ihn außerhalb von Paperarchive auf.
Wiederherstellung
- Datenbank aus dem passenden täglichen Backup der letzten 7 Tage wiederherstellen.
- Integritätsprüfung für alle archivierten Dokumente und Prüfung der Hash-Ketten.
- Änderungen seit dem Backup anhand des Änderungsprotokolls und vorhandener Exporte abgleichen, fehlende Dokumente erneut erfassen lassen.
- Ergebnis und betroffene Dokumente dokumentieren.
9. Betrieb
| Komponente | Ort |
|---|---|
| Datenbank, Dateispeicher, Anmeldung | Supabase auf AWS, Frankfurt am Main |
| API, Web-App, Website, Reranking, Malware-Scan | Eine VM bei Hetzner, Falkenstein (Deutschland) |
| E-Mail-Eingang | Cloudflare Email Routing, danach API auf der VM |
| Texterkennung | Google Cloud Vision, EU-Endpunkt |
| KI-Analyse und Embeddings | Microsoft Azure OpenAI, Germany West Central, EU Data Zone |
- Quellcode und Datenbank-Migrationen sind in Git versioniert. Änderungen laufen über Pull Requests mit automatischen Tests.
- Nach dem Merge bauen GitHub Actions die Dienste und kopieren sie auf die VM; Migrationen laufen mit Trockenlauf. Danach prüft ein Schema-Vertrag, dass alle benötigten Tabellen, Views und Funktionen vorhanden sind. Ein Guard in CI verhindert ungeprüfte DROP-Anweisungen.
- Überwachung: Health-Checks und Verarbeitungsberichte über n8n, Fehlerüberwachung mit Sentry (EU-Region, ohne Namen und Inhalte), automatische Sicherheitsupdates auf der VM. Die GoBD-Überwachung warnt, wenn die stündliche Archivprüfung 2 Stunden nicht gelaufen ist, die monatliche Integritätsprüfung fehlt, GoBD-Dokumente länger als 10 Tage unarchiviert bleiben, der Trigger für den Speicherschutz fehlt oder die tägliche Bereinigung abgelaufener Werte fehlgeschlagen oder nicht gelaufen ist.
- Jede Fassung dieser Beschreibung ist mit Datum versioniert. Speichere die zum Zeitpunkt deiner Verfahrensdokumentation gültige Fassung als PDF.
10. Internes Kontrollsystem
| Kontrolle | Art | Wer |
|---|---|---|
| Sperren, Löschschutz, Fristen nie kürzer, GoBD-Modus nicht abschaltbar | Datenbank-Trigger | System |
| Hash beim Upload, Vergleich mit dem Hash der App, Duplikatprüfung | Verarbeitung | System |
| Hash-Prüfung des Originals direkt vor der Archivierung, keine automatische Archivierung unvollständiger Dokumente | API und Datenbank | System, Inhaber entscheidet über unvollständige Dokumente |
| Löschsperre für eine Ablaufhemmung | Datenbank | Inhaber oder Admin setzt sie |
| Warnungen bei ausgefallenen Archivläufen, fehlenden Prüfungen, unarchivierten Dokumenten, fehlendem Speicherschutz und fehlgeschlagener Bereinigung | Überwachung | System, Betreiber reagiert |
| Monatliche Prüfung von Dateien und Hash-Ketten mit Meldung | API | System, Betreiber reagiert |
| Append-only-Protokoll mit Hash-Kette | Datenbank | System |
| Rollen, Row Level Security, befristeter Prüfer-Zugang, 2FA für Exporte | Datenbank und API | System, Kunde vergibt Rollen |
| Tests, Migration-Guard, Schema-Vertrag bei jedem Deployment | CI/CD | Betreiber |
| Prüfung unsicherer Angaben, Vollständigkeit, Lesbarkeit | Nutzeraktion | Kunde |
Bekannte Schwäche: Paperarchive wird von einer Person betrieben. Es gibt kein Vier-Augen-Prinzip bei Deployments und noch keine geregelte Vertretung.
11. Grenzen: was Paperarchive nicht tut
- Keine Zertifizierung und keine Prüfung nach IDW PS 880 oder anderen Standards.
- Keine Verfahrensdokumentation für dich: Du brauchst eine eigene (Vorlage siehe unten).
- Kein Buchhaltungssystem: keine Bücher, keine Kasse, keine Finanzbuchhaltung.
- Keine Prüfung der Bildqualität: Ob Papier nach dem Scannen vernichtet werden darf, entscheidest du nach deinem dokumentierten Scanprozess.
- Korrekturen nach der Archivierung nur mit Begründung: Im GoBD-Space wird nach der Verarbeitung archiviert (bei offenem Eingabe-nötig-Hinweis nach der Prüfung, spätestens 10 Tage nach dem Hochladen); danach können nur der Inhaber oder ein Admin Indexdaten korrigieren, mit Pflichtbegründung (siehe Abschnitt 3), und Datei, Hashes, Erfassungszeitpunkt und Archivierungsangaben ändern sich nie.
- Keine automatische Archivierung von fehlgeschlagenen oder nicht verarbeiteten Dokumenten: Sie brauchen eine Entscheidung (erneut verarbeiten oder ausdrücklich mit Begründung archivieren).
- Fristen nach Ereignistyp: Ein falsch erkannter Typ oder ein falsches Datum führt zu einer falschen Frist. Die Ablaufhemmung erkennt Paperarchive nicht automatisch; sie braucht eine Löschsperre.
- Keine automatische Löschung nach Fristende.
- Kein unabhängiges Backup der Dateien und kein Point-in-Time-Recovery.
- Lesezugriffe von Mitgliedern werden nicht protokolliert (Dateizugriffe von Prüfern schon); ältere Protokolleinträge sind nicht verkettet.
- Die Kontolöschung ist der einzige Weg an den Sperren vorbei: Sie löscht auch archivierte Dokumente mit laufender Frist in deinen eigenen GoBD-Spaces, nach ausdrücklicher Bestätigung, dass du die Unterlagen selbst aufbewahrst; eine aktive Löschsperre in einem deiner Spaces blockiert sie, bis die Sperre aufgehoben oder der Space übergeben ist; archivierte Dokumente, die du in einen GoBD-Space eines anderen Inhabers hochgeladen hast, bleiben dort und gehen mit Tags, Absender und Kategorie an diesen Inhaber über, ohne deine IP-Adresse und deinen Browser im Änderungsprotokoll. Exportiere vorher, auch vor einer Kündigung.
- Löschsperren lassen sich nur in der Web-App setzen; die iOS- und die Android-App zeigen sie noch nicht an.
- Per E-Mail werden keine Office-Anhänge übernommen und keine Nachrichten über 25 MB gespeichert.
Deine Aufgaben: GoBD-Modus für die richtigen Spaces einschalten, Vollständigkeit und Lesbarkeit prüfen, erkannte Angaben, Typ und Datum kontrollieren, Zugriffe vergeben und entziehen, eigene Verfahrensdokumentation führen, Fristen mit deiner Steuerberatung abstimmen und regelmäßig exportieren.
12. Änderungshistorie
| Version | Datum | Änderung | Verantwortlich |
|---|---|---|---|
| 1.0 | Februar 2026 | Erstfassung | Marcel Klein |
| 1.1 | Juli 2026 | Verarbeitung auf sieben Stufen aktualisiert | Marcel Klein |
| 2.0 | 05.10.2026 | Neufassung als Systembeschreibung GoBD-Modus: Erfassung und Formate, E-Rechnungen und E-Mails, automatische Archivierung, gesperrte Ereignisse, Fristen 6, 8 und 10 Jahre, Löschen nach Fristende, Änderungsprotokoll mit Akteur und Hash-Kette, Integritätsprüfung, Prüfer-Rolle, GDPdU- und DATEV-Export, Datensicherung, Grenzen. Falsche Angaben der Vorfassung entfernt. | Marcel Klein |
| 2.1 | 06.10.2026 | Falsche Angaben berichtigt: DATEV-Exporte werden protokolliert und archivieren im GoBD-Space; Inhalt des GDPdU-Exports; verschobene und fehlgeschlagene Dokumente werden nur nach abgeschlossener Verarbeitung automatisch archiviert, sonst nach ausdrücklicher Entscheidung; Löschregeln für protokollierte Werte; Aufteilen und Zusammenführen nur für archivierte Dokumente gesperrt; Kontolöschung als einzige Ausnahme von den Sperren benannt; Space übergeben möglich; E-Mails nicht bestätigter Absender im GoBD-Space in Quarantäne; Duplikate je Space; Umfang der Korrektur einheitlich beschrieben. Neu: Hash-Prüfung vor der Archivierung, Archivierungsgrund im Protokoll, protokollierte Dateizugriffe von Prüfern auf allen Kanälen, Löschsperre mit Hinweis 60 Tage vor Fristende, Herkunft beim Aufteilen und Zusammenführen, weitere Quell-E-Mails, Überwachung der täglichen Fristenbereinigung. | Marcel Klein |