Norman CLI für Steuern 2026: Steuererklärung direkt aus dem Terminal

Wer als Entwickler oder technischer Gründer eine GmbH oder ein Einzelunternehmen führt, kennt das Problem: Buchhaltungssoftware lebt im Browser, Code lebt im Terminal. Die Norman CLI bringt deine Steuerprozesse dorthin, wo du sowieso arbeitest – inklusive UStVA, EÜR und Körperschaftsteuer-Vorauszahlungen. Norman ist eines der ersten Buchhaltungs-Tools mit einer vollwertigen Tax-CLI für den deutschen Markt.

Was ist eine Tax-CLI?

Eine Tax-CLI ist ein Kommandozeilen-Werkzeug, mit dem du steuerliche Aufgaben skriptbar erledigst – ohne Klickpfade, ohne UI-State, ohne Wartezeit beim Login. Die Norman Tax-CLI ist eine Erweiterung der Buchhaltungs-CLI von Norman um Steuermodule und arbeitet auf denselben Daten wie die Web-App und die MCP-Schnittstelle.

Welche Steuerprozesse abgedeckt sind

Die Tax-CLI deckt die wichtigsten wiederkehrenden Pflichten für Selbstständige und GmbHs ab:

• UStVA – Umsatzsteuervoranmeldung monatlich oder quartalsweise erzeugen, prüfen und an ELSTER übergeben
• Zusammenfassende Meldung – ZM für innergemeinschaftliche Lieferungen erstellen
• EÜR-Vorbereitung – Einnahmen-Überschuss-Rechnung mit allen SKR-Konten als JSON exportieren
• Steuervorauszahlungen – Körperschaftsteuer- und Gewerbesteuer-Bescheide auslesen, Liquidität planen
• Belegabfrage – einzelne Belege per ID, Datum oder Konto suchen und exportieren

Installation und erste Schritte

Die Norman CLI installierst du über npm oder Homebrew und authentifizierst dich einmalig mit einem Personal Access Token aus deinem Norman-Account. Danach steht dir der Befehl norman mit Subkommandos wie tax, bookkeeping und invoice zur Verfügung. Du kannst sie lokal nutzen oder direkt in Container-Images für CI/CD bauen.

UStVA per CLI einreichen

Mit norman tax ustva submit --period 2026-Q1 erzeugst du die Umsatzsteuervoranmeldung für das gewünschte Quartal, prüfst sie als Vorschau und übergibst sie an ELSTER – alles aus dem Terminal. Die CLI nutzt denselben ELSTER-Backend wie die Web-App, das heißt: dieselbe Validierung, dieselben Plausibilitätsprüfungen, dasselbe Übermittlungsprotokoll. Mehr Hintergrund zur UStVA für die GmbH findest du im separaten Guide.

EÜR und Jahresabschluss vorbereiten

Für die jährliche Einnahmen-Überschuss-Rechnung exportierst du mit norman tax eur export --year 2026 --format json einen vollständigen Datensatz aller relevanten Konten. Den Output kannst du direkt im Repo committen, mit deinem Steuerberater teilen oder per Skript in eigene Auswertungen einlesen. Für GmbHs gibt es entsprechend norman tax balance für die handelsrechtlichen Auswertungen.

Skripte, CI und Automation

Der echte Hebel der Tax-CLI ist die Automatisierung. Beispiele:

• Pre-deadline-Check in CI – ein nightly Job ruft norman tax ustva preview auf und postet das Ergebnis in Slack, damit nichts kurz vor der Frist überrascht.
• Daten ins DataWarehouse – wöchentlicher Export von Umsatz und Vorsteuer in BigQuery oder Snowflake.
• Regression bei Buchungslogik – nach jedem Code-Deploy wird die EÜR neu erzeugt und mit dem Vortag verglichen.

Sicherheit und Audit-Trail

Jeder CLI-Aufruf wird in deinem Norman-Account protokolliert, mit Token-Hash, Befehl und Zeitstempel. Du kannst Tokens jederzeit widerrufen oder mit Scope einschränken (tax:submit, tax:read, bookkeeping:write). Für Submissions an ELSTER ist eine zusätzliche Bestätigung per E-Mail oder MFA Standard.

Ergänzung zur Web-Oberfläche und MCP

Die CLI ersetzt nicht die Web-App, sondern ergänzt sie. Während die Web-App für Auswertungen, Dashboards und manuelle Korrekturen ideal ist, glänzt die CLI bei wiederholbaren Tasks und Automation. Komplementär dazu: der Norman MCP-Server, der die gleichen Operationen für KI-Agenten zugänglich macht. Drei Schnittstellen, ein gemeinsamer Datenstand.

Fazit

Die Norman Tax-CLI ist eines der wenigen Werkzeuge, mit denen du deutsche Steuerpflichten direkt aus dem Terminal erledigst – ohne Klick-Workflows, ohne Browser-Wechsel und ohne Datendoppelhaltung. Wenn du sowieso Skripte, CI/CD oder DevOps-Workflows nutzt, gehört Steuerautomation in dieselbe Toolchain. Die Norman CLI ist kostenlos und funktioniert auf macOS, Linux und Windows.