Versionsmatrix
v13 besitzt fixierte offizielle Vertragsnachweise. v12 ist strukturell abgeleitet.
| Dimension | v13 | Ältere v12 |
|---|---|---|
| Bibliotheksschema | implementiertCURRENT_V13, exakt 125 Buchungsspalten. |
implementiertLEGACY_V12, exakt 124 Buchungsspalten. |
| Unterschied | Enthält Feld 125, Abw. Skontokonto. |
Exakt die ersten 124 Felder der bibliotheksinternen v13-Tabelle; Feld 125 fehlt. |
| EXTF-Verwaltungssatz | implementiertDatevMetadata.bookingBatchV13(); unpassende Schema-/Metadatenversion wird abgelehnt. |
implementiertDatevMetadata.bookingBatchV12(); unpassende Schema-/Metadatenversion wird abgelehnt. |
| Vollständige integrierte Ausgabe | implementiert Verwaltungssatz, offizielle Überschrift und Buchungszeilen. |
implementiert Verwaltungssatz, offizielle Überschrift und Buchungszeilen. |
| Fixierter Vergleich mit offiziellem Prüfprogrammschema | vertraglich getestet Alle 125 Feldtypen, Längen, Dezimalstellen, Pflichtkennzeichen sowie relevante Bezeichnungen/Aliase werden mit dem Schema aus Prüfprogramm DATEV-Format 2.2.3.0 verglichen. |
nicht unabhängig In diesem Release ist kein separates offizielles v12-Prüfschema oder -Testobjekt fixiert. |
| Offizieller Beispielvertrag | vertraglich getestet Exakte Überschrift verglichen und alle 54 Buchungszeilen des fixierten offiziellen v13-Beispiels durch strikte semantische Validierung verarbeitet. |
nur abgeleitet Bibliothekstests belegen Präfix, Breite und Serialisierung mit 124 Spalten; kein unabhängiges offizielles v12-Beispiel wird getestet. |
| Annahme im realen Zielsystem | nicht belegt Kein dokumentierter Annahmetest in einer lizenzierten realen Umgebung für dieses Release. |
nicht belegt Kein dokumentierter Annahmetest in einer lizenzierten realen Umgebung für dieses Release. |
| Aussagestufe | Gegen den offiziellen Vertrag getestete v13-Dateierzeugung; weiterhin ein Importkandidat. | Strukturell abgeleitete v12-Dateierzeugung; als älteren Pfad mit niedrigerem Nachweisniveau behandeln. |
Der optionale Test liest fixierte offizielle Artefakte und prüft die erzeugte Struktur. Das bereitgestellte Prüfprogramm ist eine interaktive Windows-GUI ohne dokumentierten Headless-Vertrag für Ergebnis oder Exit-Code. Der Test behauptet weder einen erfolgreichen GUI-Bericht noch einen Produktimport.
Aufbau der Aussage
Die Nachweisleiter
-
Bibliotheksinvarianten
Standardtests fixieren beide Schemabreiten, beweisen v12 als die ersten 124 Felder von v13, erzwingen passende Metadatenversionen und testen Windows-1252-/CRLF-Serialisierung sowie die Grenze von 99.999 Zeilen.
-
Fixierte offizielle v13-Artefakte
Der optionale
datevCheckerTestlädt das offizielle Prüfprogramm- und Beispielarchiv, verifiziert festgelegte SHA-256-Werte und vergleicht anschließend In-Memory-Schema und Beispielinhalt. Externe urheberrechtlich geschützte Artefakte werden nicht ins Repository kopiert. -
Prüfung eines erzeugten Testobjekts
Eine deterministische vollständige v13-Datei wird strikt als Windows-1252 dekodiert und auf Verwaltungssatz, exakte nicht maskierte Überschrift, Buchungszeile mit 125 Zellen und CRLF-Satzgrenzen geprüft.
-
Zielannahme bleibt offen
Eine lizenzierte Bedienperson muss den Prüfbericht kontrollieren und in das tatsächlich konfigurierte Ziel importieren. Mandanteneinstellungen, Produktversionen, Stammdaten und Buchungsentscheidungen liegen außerhalb eines portablen Java-Tests.
Einsehbar sind der versionierte Kompatibilitätstest zum offiziellen Schema und die fixierte Download-/Prüfsummenkonfiguration.
Exakte Dateigrenze
Was die vollständige integrierte Ausgabe zusichert
| Eigenschaft | Vertrag |
|---|---|
| Satzfolge | EXTF-Verwaltungssatz, feste offizielle Überschrift, danach null bis 99.999 Buchungszeilen. |
| Trennzeichen | Semikolon (;). |
| Zeilenende | CRLF (\r\n) für jeden ausgegebenen Satz. |
| Byte-Kodierung | Striktes Windows-1252 auf integrierten OutputStream-Pfaden; nicht darstellbare Metadaten oder Buchungswerte werden abgelehnt, nicht ersetzt. |
| Überschrift | Exakte feste v13- oder v12-Reihenfolge, durch den integrierten Writer unmaskiert ausgegeben. |
| Maskierung der Buchungszeile | DATEV-Textspaltenmaskierung und CSV-Escaping über den gemeinsamen DatevCsv-Codec. |
| Atomare Validierung | Formatierung, Struktur-, Kodierungs- und konfigurierte semantische Prüfungen enden, bevor die Buchungszeile an das Ziel übergeben wird. Ein E/A-Fehler kann physisch nicht zurückgerollt werden. |
Ein vom Aufrufer gelieferter Zeichen-Writer kontrolliert seine spätere Byte-Kodierung. Eine metadatenfreie Advanced-Ausgabe darf bewusst einen anderen Zeichensatz für einen individuellen CSV-Folgevertrag wählen; das ist kein vollständiges kanonisches EXTF-Byteprofil.
Produktumfang
Fähigkeiten und explizite Nicht-Ziele
| Bereich | Status | Bedeutung |
|---|---|---|
| Feste v13/v12-Erzeugung | ja | Kanonische Breite/Reihenfolge, typisierte EXTF-Metadaten und vollständige integrierte Dateiausgabe. |
| Technische Validierung | ja | Struktur, Format, Längen, Abhängigkeiten sowie optionale kontextbezogene Konto-/Datums-/Periodenprüfungen. |
| Forward-only-Ausgabe | ja | DatevStreamWriter behält erfolgreich geschriebene Zeilen nicht; Zielpufferung bleibt beim Aufrufer. |
| Individuelle CSV-Verträge | optional | Advanced kann Überschriften umbenennen/umordnen; diese Ausgabe ist bewusst nicht mit EXTF-Metadaten kombinierbar. |
| DATEV-GUI-/Server-/API-Integration | nein | Keine Authentifizierung, Uploads, Remote-API-Clients, Desktop-Automation oder Serverintegration. |
| Buchhaltungs- oder Steuerlogik | nein | Keine Soll-/Haben-Entscheidung, Steuerbehandlung, Periodenabschlusspolitik oder Rechtsberatung. |
| Kontenrahmenzuordnung | nein | Keine SKR03-/SKR04- oder Quellsystemkontenzuordnung. Der Aufrufer liefert freigegebene Konten. |
| Stammdatenprüfung | nein | Keine Prüfung, ob Berater, Mandanten, Konten, Steuerschlüssel, Kostenstellen oder Geschäftspartner im Ziel existieren. |
| Importgarantie/Zertifizierung | nein | Keine Zusage, dass eine erzeugte Datei von einem bestimmten DATEV-Produkt oder einer Konfiguration angenommen wird. |
| Unbegrenzte Zeilen | nein | Eine Datei ist auf 99.999 Buchungszeilen begrenzt. Größere Exporte an einer fachlich freigegebenen Grenze aufteilen. |
| Thread-sichere mutable Exporter | nein | Exporter-Instanzen sind mutabel und nicht thread-sicher; jede Datei/jeden Writer auf einen Thread begrenzen. |
Primärreferenzen
Quellen des Formatvertrags
- DATEV Developer Portal: technischer Aufbau / Einstieg.
- DATEV Developer Portal: Formatbeschreibung Buchungsstapel.
- DATEV Developer Portal: Beschreibung des Verwaltungssatzes.
- DATEV Developer Portal: Zeichensatzbeschreibung.
- DATEV Developer Portal: Prüfprogramm DATEV-Format und Beispieldaten.
Diese Links beschreiben das DATEV-Format; sie implizieren keine Verbindung. Die Website paraphrasiert nur die für den Bibliotheksvertrag nötigen Teile und verteilt weder DATEV-Dokumentation noch Prüfprogrammbinärdateien oder Beispieldateien.