Zum Inhalt springen
Verfahrensdokumentation DMS (Entwurf)
ConnectDMS

Verfahrensdokumentation DMS (Entwurf)

Zuletzt geändert am 27.10.2026

Auf dieser Seite

Entwurf

Dieses Dokument beschreibt die technischen Kontrollen des ConnectCloud-DMS im Sinne der GoBD (BMF-Schreiben vom 28.11.2019, zuletzt geändert 2024). Es ersetzt keine mandantenspezifische Verfahrensdokumentation. Organisatorische Regelungen (Zuständigkeiten, Scan-Prozess, internes Kontrollsystem) muss jeder Mandant ergänzen und mit seiner Steuerberatung abstimmen.

1. Allgemeine Beschreibung

Das DMS archiviert steuerrelevante und sonstige Unterlagen eines Mandanten (Kundennummer + Mandant) revisionssicher. Unterlagen gelangen über drei Wege in das System:

Eingang Beschreibung Quelle (source)
Portal-Upload Benutzer laden Dateien im Portal hoch upload
E-Mail-Import Anhänge und Original-EML aus dem Rechnungspostfach mail
Fachmodule Trade, HR, CRM u. a. legen Belege über die interne API ab internal / api

Jedes Dokument erhält eine fortlaufende, mandantenbezogene Dokumentnummer (DOC-<Jahr>-<lfd. Nr.>) und kann mit beliebig vielen Datensätzen anderer Module verknüpft werden (Kunde, Lieferant, Mitarbeiter, Vorgang, Rechnung, Projekt, Ticket).

2. Anwenderdokumentation (Kurzfassung)

  • Erfassen: Upload im Portal (Dokumentenexplorer) oder automatisch über E-Mail-Import und Fachmodule.
  • Versionieren: Korrekturen werden als neue Version hochgeladen. Frühere Versionen bleiben unverändert abrufbar.
  • Sperren: Ein WORM-Lock kann nur verlängert, nie verkürzt werden.
  • Legal Hold: DMS-Administratoren können Dokumente mit Begründung (z. B. Betriebsprüfung) von jeder Löschung ausnehmen.
  • Löschen: nur nach Ablauf der Aufbewahrungsfrist, ohne Legal Hold und ohne aktive Sperre, mit optionaler Begründung.
  • Export für die Außenprüfung: DMS-Administratoren erzeugen einen ZIP-Export für Zeitraum und Kategorien.

3. Technische Systemdokumentation

3.1 Unveränderbarkeit (Rz. 58 ff. GoBD)

  • Gespeicherte Inhalte werden nie überschrieben. Jede Version erhält einen eigenen Objektschlüssel im S3-Speicher und einen SHA-256-Hash (document_versions).
  • Optional erzwingt S3 Object Lock (Governance-Modus, DMS_S3_OBJECT_LOCK=true) die Aufbewahrung bis zum Fristende auch auf Speicherebene. Der Bucket muss dafür mit aktiviertem Object Lock angelegt sein.
  • Metadatenänderungen (Verknüpfungen, Sperren, Legal Hold, Löschung) werden mit den betroffenen Werten im Protokoll festgehalten. Zusammen mit der Hash-Kette ist jeder frühere Zustand rekonstruierbar.

3.2 Protokollierung (Rz. 59, 64 GoBD)

Alle Aktionen werden in der Tabelle audit_log protokolliert: Anlage, Ansicht, Download, Verknüpfung, Entknüpfung, neue Version, Sperre, Legal Hold, Löschung, Bereinigung, Export und Prüfung. Erfasst werden jeweils Benutzer bzw. Dienst, IP-Adresse, Zeitpunkt (UTC) und Details.

  • Das Protokoll ist append-only: Ein Datenbank-Trigger weist UPDATE, DELETE und TRUNCATE ab.
  • Die Einträge eines Mandanten bilden eine Hash-Kette: entry_hash = SHA-256(prev_hash, Felder des Eintrags). Jede nachträgliche Änderung (auch unter Umgehung des Triggers) bricht die Kette. GET /api/dms/v1/audit/verify meldet den ersten betroffenen Eintrag.
  • Ein Inhalt wird nur ausgeliefert, wenn der Zugriff vorher protokolliert wurde (fail closed).

3.3 Aufbewahrung (§ 147 AO, § 257 HGB)

Die Frist beginnt mit dem Schluss des Kalenderjahres, in dem das Dokument erfasst wurde.

Die Frist richtet sich nach der Dokumentart (Kategorie) des Dokuments. Dokumentarten pflegt der Mandant unter Einstellungen › Dokumente › Dokumentarten: englischer Code (z. B. contract), Bezeichnung und Aufbewahrung in Jahren (1–30). Jedes im Portal hochgeladene Dokument erhält eine aktive Dokumentart. Der Belegeingang per E-Mail und der Rechnungseingang legen Belege unter der Dokumentart ab, die in der E-Rechnungs-Integration als Original-Eingangsbeleg gewählt ist (nur diese durchlaufen die Eingangsrechnungsverarbeitung); Anlagen dazu erhalten die Art des Zusatzbelegs. Diese beiden Arten sowie mail (E-Mail-Original) lassen sich nicht löschen oder deaktivieren. Eine geänderte Frist gilt für neu abgelegte Dokumente; bereits abgelegte behalten die Frist, die bei der Ablage galt.

Vorbelegte Dokumentarten:

Dokumentart Frist
incoming_document (Eingangsbeleg, Original-Eingangsbeleg) 10 Jahre
incoming_supplement (Eingangsbeleg Zusatz, Zusatzbeleg) 10 Jahre
contract (Vertrag), correspondence (Korrespondenz) 6 Jahre
mail (E-Mail-Original) 6 Jahre
other (Sonstiges) 10 Jahre
ohne Dokumentart (ältere Dokumente, Importe ohne Angabe) 10 Jahre (Sicherheitsvorgabe)

Weitere Dokumentarten legt der Mandant selbst an. Bei der Einführung wurden Dokumente der Kategorie invoice zu Eingangsbelegen (incoming_document); weitere bereits verwendete Kategorien wurden mit ihrer bisherigen Frist als Dokumentarten übernommen, ebenso frühere Verlängerungen aus der DMS-Konfiguration (retentionYears). Bestehende Dokumente wurden bei der Einführung anhand von Kategorie und Erfassungsdatum nachgetragen.

3.4 Löschung

Löschungen sind Soft-Deletes: Der Datensatz bleibt als Tombstone mit Löschzeitpunkt, Benutzer, Begründung und vollständigem Protokoll erhalten. Ein Hintergrundjob entfernt die Dateien frühestens nach einer Karenzzeit (DMS_PURGE_GRACE_DAYS, Standard 30 Tage) und protokolliert dies (PURGE).

3.5 Integritätsprüfung

GET /api/dms/v1/documents/:id/verify berechnet die SHA-256-Hashes aller gespeicherten Versionen neu, vergleicht sie mit den erfassten Werten und prüft die Protokollkette des Mandanten.

3.6 Datenzugriff der Finanzverwaltung (Z3-Datenträgerüberlassung)

POST /api/dms/v1/exports erzeugt asynchron ein ZIP-Archiv mit:

  • index.csv und index.xml: Dokumentnummer, ID, Titel, Kategorie, Quelle, Version, Dateiname, MIME-Typ, Größe, SHA-256, Verschlüsselung, Erfassungs- und Versionszeitpunkt, Fristende, Pfad und Integritätsergebnis;
  • files/<Dokumentnummer>/v<Version>-<Dateiname>: alle Versionen im Originalformat;
  • SHA256SUMS: Prüfsummen aller enthaltenen Dateien (kompatibel zu sha256sum -c).

Der Hash des Archivs wird gespeichert, Erzeugung und Download werden protokolliert. Ende-zu-Ende-verschlüsselte Dokumente (z. B. Personalakte) werden als Chiffrat exportiert. Die Entschlüsselung erfolgt bei Bedarf mit dem Offline-Wiederherstellungsschlüssel des Mandanten.

3.7 Zugriffsschutz und Mandantentrennung

  • Alle Endpunkte verlangen eine gültige Sitzung (JWT) mit aktivem Mandanten und den Berechtigungen tenant:dms:read, tenant:dms:write bzw. tenant:dms:admin.
  • Der Mandant wird ausschließlich aus der signierten Sitzung ermittelt. Interne Dienste benötigen internal:service.
  • Jede Datenbankabfrage ist auf Kundennummer und Mandant eingeschränkt.

4. Betriebsdokumentation

  • Datensicherung: PostgreSQL (Metadaten, Protokoll) und S3 (Inhalte) werden nach dem Betriebskonzept der Plattform gesichert. Wiederherstellungen sind zu protokollieren.
  • Überwachung: Fehlgeschlagene Bereinigungen, Exporte und Object-Lock-Setzungen werden geloggt.
  • Regelmäßige Kontrolle: Empfohlen ist eine monatliche Ausführung von GET /api/dms/v1/audit/verify je Mandant durch einen DMS-Administrator.

5. Internes Kontrollsystem (vom Mandanten zu ergänzen)

  • Zuständigkeiten für Erfassung, Freigabe, Legal Hold und Export
  • Scan-Prozess (ersetzendes Scannen nach Rz. 136 ff. GoBD), falls Papierbelege digitalisiert werden
  • Vergabe und regelmäßige Überprüfung der Berechtigungen
  • Verwahrung des Offline-Wiederherstellungsschlüssels (Vier-Augen-Prinzip, Tresor)

5.1 Automatische Freigabe und Wareneingang (ConnectINVOICE)

Auf Wunsch des Mandanten gibt das System Eingangsrechnungen und Wareneingänge unter festen Regeln automatisch frei. Als Teil des internen Kontrollsystems gilt:

  • Regel: Freigabe nur bei vollständigem 3-Wege-Abgleich (Bestellung und Wareneingang), ohne Sperrgründe, mit bestätigter Umsatzsteuer-ID, ohne Duplikat, ohne Bearbeitung durch eine Person, bei vertrauenswürdigem Lieferanten (automatisch nach mindestens drei freigegebenen Rechnungen, Positivliste optional, Ausschlussliste hat Vorrang) und bis zur Betragsgrenze (brutto, EUR). Der Mandant legt den Betrieb (Aus, Probelauf, Ein) und die Grenze fest; ohne Grenze ist die Funktion nicht einschaltbar.
  • Protokoll: Jede automatische Freigabe und jede automatische Wareneingangsbuchung wird im unveränderlichen Verlauf der Transaktion mit dem Systemakteur (Automatische Freigabe, Automatischer Wareneingang) und der angewendeten Regel festgehalten, im selben Datenbankvorgang wie die Statusänderung.
  • Rücknahme: Eine automatische Freigabe kann eine berechtigte Person mit Pflichtkommentar wiederöffnen. Die Rechnung läuft dann im normalen Freigabe-Workflow und wird nie wieder automatisch freigegeben; die Wiederöffnung steht ebenfalls im Verlauf.
  • Probelauf: Vor dem Einschalten zeigt der Probelauf je Beleg, wie das System entschieden hätte.
  • Vom Mandanten zu prüfen: Höhe der Betragsgrenze, Lieferantenlisten und wer wiederöffnen darf.

Hat das geholfen?