DATEV-Anbindung
Craken kann gebuchte Belege auf verschiedene Wege an DATEV liefern.
Heute geliefert: CSV-Buchungsstapel zum manuellen Import. Weitere
Wege sind als Adapter vorbereitet — das Backend trägt eine
DATEVExporter-Schnittstelle, an die jede zukünftige Anbindung
andockt, ohne den Workflow umzubauen.
Verbindungsoptionen im Überblick
Optionsmatrix
| Weg | Status | Aufwand | Berater-Komfort | Anmerkung |
|---|---|---|---|---|
| CSV-Buchungsstapel | ✅ geliefert | — | mittel (manueller Import) | Standard 7/8. Berater zieht CSV ins DATEV Pro. |
| CSV per E-Mail | 🟡 geplant Phase 1.5 | S (~2 h) | hoch (kein Klick im Craken) | Auf der UI ein “Per E-Mail an Berater” Button neben CSV-Download. |
| DATEVconnect Online (DUO REST) | 📋 vorgesehen Phase 2 | L (Partner-Onboarding) | sehr hoch (Buchung + Beleg in DUO) | Erfordert DATEV-Partnerregistrierung, OAuth2 mit mTLS-Zertifikat. |
| DATEV Connect (on-prem) | 📋 vorgesehen Phase 3 | M (pro Kanzlei) | hoch (direkter Push) | Kanzlei-IT muss Endpunkt im LAN exponieren. |
| SFTP-Drop | 💡 möglich | M | mittel | Pro Kanzlei ein eigener Ordner; Push via NATS-Worker. |
Heute: CSV-Buchungsstapel
Aktuell schreibt BookToDATEV pro gebuchtem Beleg eine Datei nach
datev-export/YYYY-MM/<doc-id>.csv (MinIO). Der Berater greift sie
per Klick aus dem Tab Konfiguration → DATEV → Export-Verlauf ab,
oder Sie schicken sie ihm per E-Mail.
Format-Wahl (Standard 7 oder Standard 8) + Belegfeld-Template stellen Sie unter Konfiguration → DATEV ein.
Phase 2: Belege online (DUO Belegtransfer)
Die Königsklasse für Kanzleien, die mit DATEV Unternehmen Online arbeiten: Belege landen automatisch im DUO Postfach des Mandanten, der Berater bucht direkt in DUO mit angeklipptem PDF-Original.
Was sich ändern würde
Implementierungs-Skizze
- Adapter:
services/internal/datev/duo.goimplementiertDATEVExporter. Zwei Methoden:PushBeleg(pdf, meta)+PushBuchung(row, belege_id). - Auth: OAuth2 Client Credentials mit Mandanten-mTLS-Zertifikat, Token-Cache in OpenBao (ADR-0065). Per-Mandant ein eigener Token-Pool.
- Settings-Erweiterung:
datev_settingsbekommtduo_client_id,duo_mandant_no,duo_token_secret_path. - History:
datev_exportsbekommt eine zweite Variante mitcsv_format='duo_belege'(Wiederverwendung des Verlaufs für alle Übertragungswege). - Audit: wie heute —
Reminder.Booked-ähnliche Zeile pro Push in immudb, pluskraken_datev_exports_total{format,status}.
Was wir vor dem Build brauchen
- DATEV-Partner-Registrierung (Wochen bis Monate).
- Pro Kanzlei: einmalige Autorisierung der Craken-Instanz in DUO durch den Mandanten (OAuth-Flow im Browser).
- Entscheidung Berater-Hoheit vs. Mandanten-Hoheit (wer sieht in DUO welche Belege).
Phase 3: DATEV Pro on-prem (DATEV Connect)
Kanzleien mit lokaler DATEV-Pro-Installation können einen lokalen
REST-Endpunkt (DATEV Connect) exponieren. Craken postet
Buchungsstapel + optionale Belege direkt ins lokale Rechenzentrum
der Kanzlei — Cloud-Umweg entfällt.
Adapter-Skelett ist identisch zu Phase 2 (connect.go),
Unterschiede: kein OAuth, sondern API-Key-Header + mTLS auf der
Kanzlei-Grenze.
Was wir DATEV/Steuerberater liefern müssen
Diese Sektion sortiert die rechtliche Pflicht und die praktische Realität auseinander.
An den Steuerberater (Berater-Anlieferung)
Pflicht: alle Belege plus Kontoauszüge. Kanal beliebig — wir liefern heute die CSV-Buchungssätze; Belege bleiben in Craken abrufbar oder werden bei Bedarf per Download an den Berater gegeben.
| Artefakt | Heute liefer- bar | Wie |
|---|---|---|
| Buchungsstapel | ✅ | CSV-Export oder Export-Verlauf |
| Eingangsrechnungen (PDF/XML) | ✅ | Einzeldownload aus Beleg-Drawer |
| Kontoauszüge | ⚠️ | Nicht in Craken-Scope — Mandant liefert separat |
| Kassenbelege | ⚠️ | Nicht in Craken-Scope — wenn vorhanden, Mandant liefert separat |
An DATEV (die Firma)
Pflicht: keine. DATEV ist die Software des Beraters; wir übertragen Daten an die Berater-Installation, nicht an DATEV als Unternehmen.
An das Finanzamt bei Betriebsprüfung (AO §147, GoBD)
Pflicht — wir liefern das:
| Anforderung | Wie Craken erfüllt |
|---|---|
| Buchungssätze maschinell auswertbar (Z3-Export) | DATEV-CSV im GoBD-Bundle |
| Original-Belege unveränderbar archiviert (10 J.) | MinIO inbox Bucket mit Object Lock COMPLIANCE |
| Verfahrensdokumentation | Auto-generiert im GoBD-Bundle |
| Verkettungsnachweis (Unveränderbarkeit) | immudb Merkle-Kette |
| Nachvollziehbare Prozesskette | Audit-Events pro Beleg in immudb |
Den Komplettexport finden Sie unter Audit → GoBD-Export.
Müssen wir PDFs aktiv an DATEV pushen?
Rechtlich: nein. Die Archivierungspflicht erfüllt MinIO Object Lock; der Berater zieht Belege bei Bedarf aus Craken. Phase 2 (Belege online) ist ein Komfort-Feature, kein Pflicht-Pfad.
Müssen wir die CSV aktiv liefern?
Rechtlich: nein. Pflicht ist nur die Aufbewahrung und die Vorlage im Prüfungsfall. Der monatliche CSV-Lauf ist Berater-Service.
Wenn Ihre Kanzlei mit DUO arbeitet und Belege dort sehen möchte: Phase 2 ist die saubere Lösung, bis dahin können Sie die PDFs auch manuell in DUO hochladen — Craken stellt sie unter Konfiguration → DATEV → Export-Verlauf → CSV-Download parallel zur Buchung bereit.