euer-datev / Produktdokumentation

Versionshinweise

Hier findest du Änderungen und Schritte für bestehende Installationen des DATEV-Add-ons. euer datev doctor zeigt die installierte Version.

Version 0.3.0

Upgrade von 0.2.0

Diese Version korrigiert den DATEV-Export aus Core-Daten und macht die Prüfung vor der Übergabe nachvollziehbarer.

Nach dem Update

euer datev doctor --year JAHR ausführen und Kanzleidaten sowie Zahlungskonten in [datev.accounts] prüfen.
Den gewünschten Zeitraum validieren und bei ready neu exportieren.
Betroffene Exporte aus 0.2.0 mit falscher Ausgabenrichtung, unvollständiger Konfiguration oder fehlenden Belegen neu erzeugen.
Bereits importierte Stapel nicht einfach erneut importieren. Das Vorgehen zur Korrektur und mögliche Doppelbuchungen mit der Kanzlei klären.

Buchungen und Steuerfälle

Ausgaben, Erstattungen und Einnahmekorrekturen werden mit der richtigen Buchungsrichtung exportiert.
Unklare Steuerfälle, unbestätigte Ersatzkonten, ungeklärte Bewirtung und nicht unterstützte Reverse-Charge-Sätze verhindern einen regulären Export. Geprüfte Bewirtung wird in 70/30-Anteile und gegebenenfalls eine eigene Vorsteuerzeile aufgeteilt.
Fehlt ein gespeichertes Zahlungskonto, zeigt die Validierung Prüfbedarf. Bei Einnahmen kann ein ausdrücklich konfiguriertes Bankkonto übernommen werden; das wird im Bericht ausgewiesen.

Konfiguration und Belege

Globale und projektbezogene Konfiguration werden feldweise kombiniert. Ein ausdrücklich angegebenes --config ersetzt sie vollständig; Befehlsoptionen haben Vorrang.
Relative Projektpfade für Belege und Exporte beziehen sich auf den Projektordner. Belege werden nach Zahlungsjahr und Belegtyp gesucht.
Archivname und CSV-Beleglink werden gemeinsam angepasst, auch bei Sonderzeichen und gleichnamigen Dateien. Ist ein Beleg beim Verpacken nicht mehr lesbar, wird das Zielarchiv nicht ersetzt.

Prüfung und Automationen

Die Validierung unterscheidet ready, needs_review, invalid und empty. JSON-Berichte und gleiche Zeitraumfilter für Validierung und Export erleichtern die Auswertung.
--allow-incomplete erlaubt nur fehlende Belege, kennzeichnet das Teilpaket und liefert Exit-Code 2. --force entfällt. Bestehende Automationen müssen die neuen Exit-Codes beachten.
CSV-Testexporte mit --demo tragen TESTEXPORT in der Stapelbezeichnung. init-skr --write prüft die Konfiguration vor dem Ersetzen.

Vor der Übergabe

Relative Beleglink-Pfade im ZIP helfen bei der manuellen Zuordnung. Sie verknüpfen Belege nicht automatisch mit DATEV DMS oder Unternehmen online. Führe mit deiner Kanzlei einen Testimport in der verwendeten DATEV-Version durch und prüfe Buchungsrichtung, Steuerwirkung und Belegzuordnung.