Schema kanonisch halten
Eine geordnete Definition für alle 125 v13-Felder und die 124 Felder der älteren v12-Struktur verwenden – statt eigene Tabellen oder Arrays zu pflegen.
Java 17 · Apache-2.0 · Release 0.2.0
Bereits zugeordnete Buchungsdaten werden zu deterministischen DATEV-Buchungsstapel-/EXTF-Dateien – mit festen v13/v12-Schemata, typisierten Metadaten, technischer Validierung und Forward-only-Streaming.
Warum es die Bibliothek gibt
Ein vollständiger Buchungsstapel kombiniert einen anders aufgebauten Verwaltungssatz, eine exakte versionsgebundene Überschrift und streng formatierte Buchungszeilen. Schon kleine Abweichungen bei Breite, Reihenfolge, Maskierung, Zeilenenden oder Kodierung können einen ansonsten gültigen Export unbrauchbar machen.
Eine geordnete Definition für alle 125 v13-Felder und die 124 Felder der älteren v12-Struktur verwenden – statt eigene Tabellen oder Arrays zu pflegen.
Strukturelle, Windows-1252- und optionale semantische Verstöße ablehnen, bevor eine Buchungszeile an das Ziel übergeben wird.
Zeilen behalten, wenn sie geprüft oder erneut ausgegeben werden müssen; sie einmalig vorwärts streamen, wenn das Exportvolumen keine Speicherung rechtfertigt.
Lieferumfang
Der Standardpfad bleibt abhängigkeitsarm. Optionale Module sind explizit – eine Univocity-Abhängigkeit oder der semantische Validator kommt nur hinzu, wenn er gewählt wird.
Empfohlener Standard
Vollständige v13/v12-EXTF-Ausgabe, speichernde DatevFile und der Forward-only-DatevStreamWriter. Die richtige Wahl, solange der Empfängervertrag nicht bewusst von der offiziellen Überschrift abweicht.
Individuelles Folgeformat
Überschriften umbenennen, umordnen oder ersetzen und den Validierungsmodus je Datei wählen. Individuelle Überschriften sind nicht mit EXTF-Metadaten kombinierbar, weil sie nicht mehr dem festen DATEV-Schema entsprechen.
Nur für vorhandene Pipeline
Überschrift und Buchungszeilen über einen vorhandenen Univocity-CsvWriter ausgeben. Er kann den anders geformten Verwaltungssatz nicht erzeugen und maskiert offizielle Textüberschriften abweichend.
Bewusste Abgrenzung
Kontenrahmen, Steuerbehandlung, Stammdaten und mandantenspezifische Regeln vor dem Aufruf des Exporters bestimmen.
Typisierte Metadaten anhängen, benannte oder typisierte Spalten schreiben und metadatenbezogene technische Validierung auswählen.
Die erzeugte Datei über den kontrollierten Übertragungsweg bewegen und die Annahme in der lizenzierten, konfigurierten DATEV-Zielumgebung prüfen.
Eine bestandene Bibliotheksvalidierung – oder die Übereinstimmung mit dem geprüften v13-Schema- und Beispielvertrag – beweist weder die buchhalterische Richtigkeit noch die Annahme durch ein bestimmtes DATEV-Produkt, einen Mandanten oder dessen Konfiguration.
Nachweise statt Adjektive
Für v13 fixiert ein optionaler Vertragstest das offizielle DATEV-Prüfprogrammschema und das offizielle Beispielarchiv, vergleicht die 125 Felddefinitionen und validiert alle 54 Beispielbuchungen. Er macht aus dem Start einer Windows-GUI kein bestandenes oder fehlgeschlagenes Importergebnis.
Für v12 unterstützt die Bibliothek das Präfix mit 124 Spalten und den passenden Verwaltungssatz. Aktuell fehlt jedoch ein unabhängiges offizielles v12-Testobjekt oder ein dokumentierter realer Importnachweis.