Saldofest · saldofest.de/extf-validator/

EXTF-Validator: DATEV-Buchungsstapel prüfen

Prüfen Sie eine EXTF-Buchungsstapel-Datei gegen die Formatregeln der DATEV-Formatbeschreibung: Kopfzeile, Feldanzahl, Kodierung, Beträge, Belegdatum, Konten, Belegfelder.

Ihre Datei verlässt diesen Browser nachweislich nicht: Es gibt keinen Upload, keine Speicherung und kein Tracking der Dateiinhalte.

So prüfen Sie das selbst

Öffnen Sie die Entwicklerwerkzeuge Ihres Browsers (Taste F12), den Reiter „Netzwerk“, und legen Sie dann eine Datei ab: Es erscheint keine einzige Anfrage. Die Seite lädt genau ein Skript, /lead/validator.js, und der Server verbietet dem Browser mit der Kopfzeile Content-Security-Policy jede Verbindung zu fremden Adressen (connect-src 'self'). Die Prüfregeln stehen im Skript; gerechnet wird auf Ihrem Gerät.

Geprüft werden Dateien bis 20 MB. Das reicht für einen Monatsstapel mit über 40.000 Buchungen. Größere Dateien lehnt die Seite ab, statt Ihren Browser anzuhalten.

Datei prüfen

CSV-Datei hierher ziehen

Die Prüfung läuft vollständig in Ihrem Browser.

Formatregeln

Jede Regel stammt aus der DATEV-Formatbeschreibung; unter jeder steht, aus welchem Teil.

Kopfzeile und Version

Die erste Zeile der Datei ist die Kopfzeile. Sie beginnt mit „EXTF“ in geraden Anführungszeichen und trägt im zweiten Feld die Versionsnummer 700.

Quelle: DATEV-Formatbeschreibung, Header, Feld 1 und 2

Werte der Kopfzeile

Jedes der 31 Kopffelder trägt einen erlaubten Wert: Formatkategorie 21 mit dem Formatnamen „Buchungsstapel“, Formatversion 13, Beraternummer 1001 bis 9999999, Mandantennummer 1 bis 99999, Sachkontenlänge 4 bis 8, Festschreibung 0 oder 1, Währungskennzeichen als dreistelliger Code. Die Datumsfelder sind Tage, die es gibt; der Zeitraum (Datum von bis Datum bis) liegt im Wirtschaftsjahr, das Feld 13 beginnen lässt, denn daraus leitet DATEV das Jahr jedes Belegdatums ab. Die reservierten Felder bleiben leer.

Quelle: DATEV-Formatbeschreibung, Header (31 Felder mit Werteausdruck) und Buchungsstapel, Feld 10

Feldanzahl je Zeile

Die Überschriftszeile und jede Buchungszeile tragen genau 125 Felder; die Kopfzeile trägt 31. Leerzeilen gibt es weder vor der Kopfzeile noch zwischen den Buchungen.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel (125 Felder) und Header (31 Felder)

Zeichenkodierung

Der Standard ist CP1252 ohne Byte-Order-Mark, mit CRLF-Zeilenenden. UTF-8, UTF-16 und UTF-32 liest DATEV Rechnungswesen nur mit Byte-Order-Mark und nur im manuellen Import oder über die Schnittstelle accounting:extf-files; die Stapelverarbeitung (App KrStaPv) liest kein Unicode. Eine UTF-8-Datei ohne Byte-Order-Mark liest DATEV als CP1252, und Umlaute kommen falsch an.

Quelle: DATEV-Formatbeschreibung, Zeichensatz

Dateiname

Das DATEV-Format ist eine CSV-Datei mit einem festen Dateinamens-Präfix: Der Name beginnt mit „EXTF_“ und endet auf „.csv“.

Quelle: DATEV-Formatbeschreibung, Einstieg („eine CSV-Datei mit einem festen Dateinamens-Präfix (EXTF_....CSV)“)

Soll/Haben-Kennzeichen

Feld 2 trägt ausschließlich „S“ oder „H“.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 2

Umsatzformat

Feld 1 (Umsatz) ist ein Betrag größer als 0,00, mit Komma, genau zwei Nachkommastellen und höchstens zehn Stellen vor dem Komma; das Vorzeichen steckt im Soll/Haben-Kennzeichen.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 1 („Betrag muss positiv und darf nicht 0,00 sein“)

Belegdatum TTMM

Feld 10 (Belegdatum) trägt vier Ziffern im Format TTMM, ohne Jahr: einen Tag, den es gibt, im Zeitraum der Kopfzeile (Datum von bis Datum bis). Das Jahr kommt aus dem Wirtschaftsjahr der Kopfzeile.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 10, und Header, Feld 13, 15 und 16

Länge der Kontonummern

Konto und Gegenkonto bestehen aus Ziffern, nicht nur aus Nullen, höchstens neun Stellen. Kein Konto hat mehr als eine Stelle mehr, als die Kopfzeile in Feld 14 als Sachkontenlänge angibt: Ein Sachkonto hat höchstens so viele Stellen, ein Personenkonto eine mehr. Kürzere Konten sind erlaubt.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 7 und 8 („Die Personenkontenlänge darf nur 1 Stelle länger sein als die definierte Sachkontennummernlänge.“)

Belegfeld 1

Belegfeld 1 ist höchstens 36 Zeichen lang. Erlaubt sind Ziffern, Buchstaben von A bis Z ohne Umlaute und die Sonderzeichen $ & % * + - /. DATEV schreibt dazu: „Andere Zeichen sind unzulässig (insbesondere Leerzeichen, Umlaute, Punkt, Komma, Semikolon und Doppelpunkt).“ Das gilt auch für den Unterstrich.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 11

BU-Schlüssel

Feld 9 (BU-Schlüssel) ist leer oder trägt eine bis vier Ziffern.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 9 (vier Stellen)

Buchungstext

Feld 14 (Buchungstext) hat höchstens 60 Zeichen.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 14 („0-60 Zeichen“)

Beleginfo

Die Beleginfo steht ab Feld 21 in bis zu acht Paaren aus Art (höchstens 20 Zeichen) und Inhalt (höchstens 210 Zeichen). DATEV: „Eine Beleginfo besteht immer aus den Bestandteilen Beleginfo-Art und Beleginfo-Inhalt.“ Ein Paar trägt beide Felder oder keines.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 21 bis 36

EU-Land und EU-Steuersatz

Feld 40 beginnt mit dem zweistelligen Kürzel eines EU-Staats (Griechenland EL, Nordirland XI) und trägt dahinter höchstens 13 Stellen USt-IdNr., zusammen höchstens 15 Zeichen. Feld 41 trägt den Steuersatz des Bestimmungslandes mit höchstens zwei Stellen vor und zwei nach dem Komma. DATEV zu Feld 41: „Nur für entsprechende EU-Buchungen: Der im EU-Bestimmungsland gültige Steuersatz.“ Ein Steuersatz braucht deshalb sein Land in Feld 40.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 40 („2-stelliges Länderkürzel … max. 13-stellige USt-IdNr.“) und Feld 41

Festschreibung je Buchung

Feld 114 (Festschreibung) ist leer, 0 oder 1.

Quelle: DATEV-Formatbeschreibung, Buchungsstapel, Feld 114

Pflichtfelder

Umsatz, Soll/Haben-Kennzeichen, Konto, Gegenkonto und Belegdatum sind in jeder Buchungszeile gefüllt.

Quelle: DATEV-Feldtabelle des Buchungsstapels (Pflichtfelder)

Für Kanzleien: was ein Mandant mit Saldofest liefert

Einen Buchungsstapel wie den, den Sie gerade geprüft haben, dazu ein Begleitblatt mit der Kontenzuordnung, Summen je Steuersatz und der Prüfsumme der Datei, auf Wunsch die Rechnungsbilder als Paket für DATEV Belegtransfer. Der Import bleibt bei Ihnen; Saldofest greift auf keine Kanzleisysteme zu.

Dieselben Formregeln wie die Exportfunktion

Diese Seite prüft alle 17 Regeln der Tabelle oben. Eine Probe hält die Exportfunktion von Saldofest bei jeder Änderung gegen dieselbe Tabelle: Was sie aus Formgründen verweigert, ist hier rot, und was sie schreibt, ist hier grün. Die Referenzdateien von Saldofest laufen hier grün, auch das prüft ein Test bei jeder Änderung. Für Ihre eigene Datei ist dieser Validator die Probe.

Was diese Seite nicht prüfen kann: ob die Buchungen zu Ihrem Shop passen – Konten, Steuersätze, Zahlarten, Vollständigkeit des Monats. Dafür braucht es Ihre Bestelldaten. Diese Prüfungen laufen im Plugin, vor dem Export, und ihr Ergebnis steht dort in der Prüfliste. Ebenso wenig prüft sie Regeln der Exportfunktion, die keine Formregeln sind:

  • ob Konto und Gegenkonto verschieden sind: Eine Buchung von einem Konto auf dasselbe nimmt DATEV an, sie bewegt nur nichts.
  • ob der BU-Schlüssel zu den EU-Feldern passt: 240 oder 250 mit Land und Steuersatz bei einer Buchung im OSS-Verfahren, eine USt-IdNr. in Feld 40 nur ohne beides.
  • ob ein Land in Feld 40 ohne USt-IdNr. seinen Steuersatz in Feld 41 hat: Die Exportfunktion schreibt beide nur zusammen, DATEVs Formatbeschreibung verlangt die Paarung nicht.
  • ob ein EU-Steuersatz größer als null ist.
  • ob eine USt-IdNr. in Feld 40 einem anderen EU-Staat gehört als Deutschland.
  • ob eine USt-IdNr. in Feld 40 hinter dem Kürzel mindestens zwei Stellen hat und nur aus Großbuchstaben, Ziffern, + und * besteht: So schreibt die Exportfunktion sie, DATEV begrenzt nur die Länge.
  • ob Belegfeld 1 gefüllt ist: Die Exportfunktion schreibt in jede Zeile eine Rechnungs- oder Bestellnummer, DATEV verlangt keine.
  • ob ein Rechnungsdatum in der Beleginfo ein Tag ist, den es gibt: Die Exportfunktion schreibt dort nur solche, für DATEV ist der Inhalt freier Text.
  • ob alle Belegdaten in einem Kalendermonat liegen: Die Exportfunktion schreibt einen Stapel je Monat, DATEV nimmt auch längere Zeiträume an.
  • ob Textfelder Steuerzeichen wie einen Tabulator tragen: Die Exportfunktion schreibt keine, DATEVs Formatbeschreibung schließt sie nicht aus.
  • ob der Kontenrahmen SKR 03 oder SKR 04 ist und das Wirtschaftsjahr am 1. Januar beginnt: Das sind Grenzen von Saldofest, keine Formatregeln.