euer-datev: Offizieller DATEV-Export (EXTF 700) & Kanzlei-Schnittstelle

Die professionelle DATEV-Brücke für euer: Exportiert deine EÜR-Buchhaltungsdaten und Belege mit einem einzigen Klick im offiziellen DATEV-Format — für die reibungslose Übernahme in DATEV Kanzlei-Rechnungswesen.

---

Warum euer-datev?

Viele Freelancer und Selbstständige führen ihre laufende Buchhaltung effizient mit euer, übergeben die Jahresdaten für den Jahresabschluss und die Steuererklärung aber an ihre Steuerberatung.

Das Problem: Steuerberater arbeiten mit DATEV. Wenn sie Belege, unformatierte Excel-Listen oder unstrukturierte CSVs erhalten, müssen die Daten händisch eingetippt werden. Das kostet Kanzleistunden und treibt das Steuerberaterhonorar unnötig in die Höhe.

euer-datev löst dieses Problem an der Wurzel:

• ⚡ 1-Klick DATEV-Export: Generiert einen standardkonformen DATEV EXTF-700 Buchungsstapel (Kategorie 21), den der Steuerberater in 2 Sekunden einliest.
• 📦 Beleg-Packaging: Packt alle zugehörigen Beleg-PDFs in ein ZIP-Archiv und referenziert sie im Feld Beleglink als Datei-/DMS-Referenz für die Kanzlei. (Hinweis: Vollautomatische Verknüpfung in DATEV Unternehmen online via XML-Schnittstelle online steht auf der Roadmap).
• 📋 SKR 03 & SKR 04 Unterstützung: Automatische Kontenzuordnung über den Kontenrahmen ([[ledger_accounts]]) oder erprobte Kanzlei-Standards.
• 🔍 Pre-Flight Validierung: Erkennt fehlende Konten, nicht zugeordnete Belege oder unklare Steuerfälle vor dem Export und liefert ein transparentes Prüfprotokoll.
• 🔌 Doppelte Flexibilität: Funktioniert nahtlos als Plugin in der bestehenden euer-CLI (euer datev export) oder als eigenständiges Standalone-Tool (euer-datev export).

---

Installation & Einrichtung

Installation mit Homebrew (macOS und Linux)

brew tap curiousmarkus/euer
brew install curiousmarkus/euer/euer curiousmarkus/euer/euer-datev
euer datev --help

Installation mit pipx

Für getrennte Installationen:

pipx install euer
pipx install euer-datev
euer datev --help

Bei einer bestehenden pipx-Installation kannst du das Add-on weiterhin als gemeinsames Plugin installieren:

pipx inject euer euer-datev

In beiden Fällen steht der Befehl euer datev zur Verfügung:

euer datev --help

Installation mit uv

uv tool install --with euer-datev euer
euer datev --help

Direkter Standalone-Aufruf

Das Add-on lässt sich auch direkt aufrufen:

euer-datev --help

euer-datev verwendet im Buchhaltungsordner dieselbe Datenbank wie euer: [database].path aus .euer/config.toml hat Vorrang vor ./euer.db. Mit --db PFAD bei export und validate kannst du den Pfad für einen Aufruf überschreiben.

---

Quickstart

1. Kontenrahmen konfigurieren (optional, aber empfohlen)

Erzeuge dir eine passende Vorlage für deinen Kontenrahmen (Standard: SKR 03):

euer datev init-skr --skr 03

Kopiere den Block in deine ~/.config/euer/config.toml (oder nutze --write ~/.config/euer/config.toml). Hier kannst du deine Berater- und Mandantennummer der Kanzlei hinterlegen:

[datev]
berater_nummer = "1001"
mandanten_nummer = "10001"
skr = "03"

[datev.accounts]
"g-n26" = "1200"     # Bankkonto in SKR03
"privat" = "1890"    # Privateinlage

2. Daten vorab prüfen

Prüfe, ob alle Buchungen für das gewünschte Steuerjahr vollständig und DATEV-konform sind:

euer datev validate --year 2026

3. DATEV-Paket exportieren

Erstelle das fertige Exportpaket (ZIP-Archiv mit Buchungsstapel, Belegen und Prüfprotokoll):

euer datev export --year 2026 --skr 03

Ausgabe:

✅ DATEV-Exportpaket erfolgreich erstellt: /Users/.../exports/DATEV_EXTF_2026.zip
   • 42 Buchungssätze (18.450,00 EUR)
   • 42 Belege im Archiv abgelegt (Beleglink-Referenz)

Sende diese ZIP-Datei einfach an deinen Steuerberater!

---

Anleitung für die Steuerberatungskanzlei

So liest die Kanzlei das Exportpaket in DATEV Kanzlei-Rechnungswesen ein:

1. ZIP-Archiv entpacken:
   Entpacken Sie DATEV_EXTF_2026.zip. Der Ordner enthält:

   • EXTF_Buchungsstapel.csv (Offizieller DATEV EXTF-700 Stapel)
   • belege/ (Alle Beleg-PDFs)
   • PRUEFPROTOKOLL.txt (Zusammenfassung und Validierungsbericht)

2. Buchungsstapel einlesen:

   • In Kanzlei-Rechnungswesen das Mandat öffnen.
   • Wählen Sie: Bestand ➔ Importieren ➔ Stapelverarbeitung.
   • Format: DATEV-Format.
   • Wählen Sie die Datei EXTF_Buchungsstapel.csv aus und klicken Sie auf Importieren.
   • Die Buchungssätze stehen nun im Vorlauf zur Prüfung und Festschreibung bereit.

3. Digitale Belege (Datei-/DMS-Referenz):

   • Der Ordner belege/ enthält alle exportierten Belegdateien.
   • Das Feld Beleglink in der CSV enthält die relative Dateireferenz (z. B. belege/2026-03-15_rechnung.pdf) zur einfachen Zuordnung im Dokumentenmanagementsystem (DMS) oder bei manueller Prüfung.
   • Eine automatisierte Verknüpfung über die DATEV XML-Schnittstelle online befindet sich auf der Roadmap.

---

CLI-Referenz

export

Erzeugt den DATEV-Export:

euer datev export [OPTIONEN]

• --year <JAHR>: Steuerjahr filtern (z. B. 2026)
• --quarter <1-4>: Quartal filtern (z. B. --quarter 1)
• --month <1-12>: Einzelnen Monat filtern (z. B. --month 3)
• --from-date / --to-date: Datumsbereich im ISO-Format (YYYY-MM-DD)
• --skr <03|04>: Kontenrahmen auswählen (Standard: 03)
• --format <zip|csv>: zip (inkl. Belege & Protokoll) oder csv (nur Buchungsstapel)
• -o, --output <PFAD>: Zielpfad oder Zielverzeichnis
• --berater <NR>: Beraternummer überschreiben
• --mandant <NR>: Mandantennummer überschreiben
• --force: Export trotz Validierungsfehlern erzwingen

validate

Führt eine Vorab-Prüfung durch:

euer datev validate --year 2026

init-skr

Erzeugt empfohlene Konfigurationsblätter für SKR 03 oder SKR 04:

euer datev init-skr --skr 03

license

Lizenzschlüssel verwalten und aktivieren:

# Lizenzstatus abfragen
euer datev license status

# Lizenzschlüssel aktivieren
euer datev license activate <DEIN_LIZENZSCHLUESSEL>

Weitere Details zum Lizenzmodell und Erwerb: euer-buchhaltung.de/datev

---

Technische Details & Spezifikation

• Format-Standard: DATEV EXTF Version 700 / Kategorie 21 (Buchungsstapel).
• Zeichenkodierung: Streng Windows-1252 (ANSI) mit CRLF-Zeilenumbruch.
• Umsatzsteuer & Reverse Charge: Automatische Zuweisung gültiger DATEV-Berichtigungsschlüssel (z. B. BU 9 für 19 % Vorsteuer, BU 94 für § 13b Reverse Charge EU).
• Detaillierte Spezifikationen: Siehe docs/DATEV_SPECIFICATION.md.

---

Lizenz

Proprietary Commercial Software. Copyright (c) 2026 Markus Keller. Alle Rechte vorbehalten.