getreadystack/dsfinv-k-export-lint repository overview

⁠CSV Kassenprüfer — DSFinV-K Export Lint

Prüft eine DSFinV-K-CSV gegen die amtliche Spaltenliste, die Wertelisten und die Formate der DSFinV-K 2.4.

⁠Run

docker run --rm -v "$PWD":/work getreadystack/dsfinv-k-export-lint /work/file

The same 19 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠Free

• Prüft die im Editor geöffnete DSFinV-K-CSV vollständig gegen alle 19 Regeln — 20 amtliche Tabellen, 219 Spalten, 9 Werte für BON_TYP, 25 für GV_TYP, 7 für ZAHLART_TYP — und nennt zu jedem Fund die Zeilennummer. Gemessen an der Beispieldatei _fixtures/dirty.csv (Bonkopf, 23 Spalten, 4 Datenzeilen): 14 Funde, davon 12 Fehler und 2 Warnungen, ausgelöst von 11 der 19 Regeln; die Gegenprobe _fixtures/clean.csv ergibt 0 Funde; die Ergebniskarte zeigt sechs dieser 14 Funde. Geprüft werden Spaltenbestand, Spaltenreihenfolge, Semikolon als Trennzeichen, Spaltenzahl je Zeile, leere Pflichtfelder, Punkt statt Komma im Betrag, Zeitstempel nach ISO 8601, TAXONOMIE_VERSION, Feldlängen und CRLF.
• --rules lists every rule

⁠With a licence ($29 once)

• Prüft den kompletten Exportordner in einem Lauf — alle 20 DSFinV-K-Tabellen zusammen, inklusive der Kreuzprüfungen zwischen den Dateien und der index.xml — und legt den Prüfbericht als Datei ab.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/dsfinv-k-export-lint --dir /work --ci

Eine Steuerberatungskanzlei rechnet die Durchsicht nach § 13 StBVV mit 16,50 bis 41 Euro je angefangene Viertelstunde ab.

⁠Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "dsfinv-k-export-lint": { "command": "npx", "args": ["-y", "@readystack/dsfinv-k-export-lint", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

⁠Use in CI

- name: CSV Kassenprüfer — DSFinV-K Export Lint
  run: npx -y @readystack/dsfinv-k-export-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/dsfinv-k-export-lint --dir /work --ci)

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠