Allgemein
Der Header ist immer die erste Zeile einer CSV-Datei im DATEV-Format. Er enthält alle notwendigen Informationen, um die Datei im DATEV Rechnungswesen korrekt zu verarbeiten. Die Header-Zeile ermöglicht es auch die Dateien automatisiert von außen zu importieren (Details siehe Import/Export ).
Der Header kann grundsätzlich für alle Formatbeschreibungen den gleichen Satzaufbau haben. Nur für die Formatbeschreibungen der Bewegungsdaten muss zusätzlich auf die Angabe einiger bestimmter Datenfelder geachtet werden, welche hingegen bei den Stammdaten nicht zu befüllen sind. Welche Datenfelder davon betroffen sind, wird in der Tabelle für den Satzaufbau kenntlich gemacht.
Beispiele
Hier zwei Beispiele für valide Header einer CSV-Datei im DATEV-Format.
Buchungsstapel:
"EXTF";700;21;"Buchungsstapel";13;20240130140440439;;"RE";"";"";29098;55003;20240101;4;20240101;20240831;"Buchungsstapel";"WD";1;0;0;"EUR";;"";;;"03";;;"";""
Debitoren / Kreditoren:
"EXTF";700;16;"Debitoren/Kreditoren";5;20240130140659583;;"RE";"";"";29098;55003;20240101;4;;;"";"";;;;"";;"";;;"03";;;"";""
Satzaufbau
The following structure of the header must be followed. To describe the properties of a data field, we use simple regular expressions. The notation we use can be found here
# |
Überschrift |
Ausdruck |
Beschreibung |
---|---|---|---|
1 | Kennzeichen | ^["](EXTF|DTVF)["]$ | EXTF = Export aus 3rd-Party App DTVF = Export aus DATEV App |
2 | Versionsnummer | ^(700)$ | Versionsnummer des Headers. Anhand der Versionsnummer können ältere Versionen abwärtskompatibel verarbeitet werden. |
3 | Formatkategorie | ^(16|20|21|46|48|65)$ | 16 = Debitoren-/Kreditoren 20 = Sachkontenbeschriftungen 21 = Buchungsstapel 46 = Zahlungsbedingungen 48 = Diverse Adressen 65 = Wiederkehrende Buchungen |
4 | Formatname | ^["](Buchungsstapel|Wiederkehrende Buchungen|Debitoren/Kreditoren| Sachkontenbeschriftungen| Zahlungsbedingungen| Diverse Adressen)["]$ |
Formatname |
5 | Formatversion | ^(2|4|5|13)$ | Debitoren-/Kreditoren = 5 Sachkontenbeschriftungen = 3 Buchungsstapel = 13 Zahlungsbedingungen = 2 Wiederkehrende Buchungen = 4 Diverse Adressen = 2 |
6 | Erzeugt am | ^([2])([0])([0-9]{2})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])(2[0-3]|[01][0-9])([0-5][0-9])([0-5][0-9][0-9][0-9][0-9])$ |
Zeitstempel: YYYYMMDDHHMMSSFFF |
7 | Importiert | ^[]$ | |
8 | Herkunft | ^["]\w{0,2}["]$ | RE |
9 | Exportiert von | ^["]\w{0,25}["]$ | z. B. Max Mustermann |
10 | Importiert von | ^["]\w{0,25}["]$ | z. B. Admin |
11 | Beraternummer | ^(\d{4,6}|\d{7})$ |
Bereich 1001-9999999 |
12 | Mandantennummer | ^\d{1,5}$ | Bereich 1-99999 |
13 | WJ-Beginn | ^([2])([0])([0-9]{2})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])$ | Wirtschaftsjahresbeginn Format: YYYYMMDD |
14 | Sachkontenlänge | ^[4-8]$ | Nummernlänge der Sachkonten. Wert muss beim Import mit Konfiguration des Mandats in der DATEV App übereinstimmen. |
15 | Datum von | ^([2])([0])([0-9]{2})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])$ | Beginn der Periode des Stapels Format: YYYYMMDD |
16 | Datum bis | ^([2])([0])([0-9]{2})(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])$ | Ende der Periode des Stapels Format: YYYYMMDD |
17 | Bezeichnung | ^["][\w.-/ ]{0,30}["]$ | Bezeichnung des Stapels z.B. „Rechnungsausgang 02/2024“ |
18 | Diktatkürzel | ^["]([A-Z]{2}){0,2}["]$ | Kürzel in Großbuchstaben des Bearbeiters z.B. "MM" für Max Mustermann |
19 | Buchungstyp | ^[1-2]$ | 1 = Finanzbuchführung (default) 2 = Jahresabschluss |
20 | Rechnungs- legungszweck |
^(0|30|40|50|64)$ | 0 = unabhängig (default) 30 = Steuerrecht 40 = Kalkulatorik 50 = Handelsrecht 64 = IFRS |
21 | Festschreibung | ^(0|1)$ | 0 = keine Festschreibung 1 = Festschreibung (default) |
22 | WKZ | ^["]([A-Z]{3})["]$ | ISO-Code der Währung "EUR" = default Liste der ISO-Codes |
23 | Reserviert | ^[]$ | Leerfeld |
24 | Derivatskennzeichen | ^["]["]$ | Leerfeld |
25 | Reserviert | ^[]$ | Leerfeld |
26 | Reserviert | ^[]$ | Leerfeld |
27 | Sachkonten- rahmen |
^["](\d{2}){0,2}["]$ | Sachkontenrahmen der für die Bewegungsdaten verwendet wurde |
28 | ID der Branchen- lösung |
^\d{0,4}$ | Falls eine spezielle DATEV Branchenlösung genutzt wird. |
29 | Reserviert | ^[]$ | Leerfeld |
30 | Reserviert | ^["]["]$ | Leerfeld |
31 | Anwendungs- information |
^["].{0,16}["]$ | Verarbeitungskennzeichen der abgebenden Anwendung z.B. „09/2019“ |