Euer Buchhaltung

EÜR Buchhaltung

Dieses Skill ermöglicht die Verwaltung einer Einnahmenüberschussrechnung (EÜR) für deutsche Kleinunternehmer via CLI.

Tool-Pfad

Das CLI befindet sich im Projektverzeichnis:

euer <command>

Falls das CLI nicht installiert ist, geht auch:

python -m euercli <command>

Datenbank & Config

• Standard‑DB: euer.db im Projekt (oder via --db PFAD).
• Config: ~/.config/euer/config.toml (Beleg‑Pfade, Export‑Verzeichnis, Steuer‑Modus, private Konten, optionaler Kontenrahmen via [[ledger_accounts]]).
• Non-interaktiv setzen: euer setup --set <section.key> <value> (z.B. tax.mode, accounts.private).
• Direkter sqlite3‑Zugriff ist verboten, da sonst Inkonsistenzen auftreten können und das Audit-Log umgangen wird.
• Für fortgeschrittene Abfragen nur euer query verwenden (nur SELECT, keine Writes).

Config-Verwaltung

Alle Config-Werte lassen sich mit euer setup lesen und ändern:

# Aktuelle Config anzeigen
euer config show

# Einzelne Werte setzen
euer setup --set tax.mode "small_business"           # oder "standard"
euer setup --set receipts.root "/pfad/zu/Buchhaltung"
euer setup --set receipts.year_dir "{year}"
euer setup --set receipts.expenses_dir "Ausgaben"
euer setup --set receipts.income_dir "Einnahmen"
euer setup --set exports.directory "/pfad/zu/exports"
euer setup --set user.name "Max"

# Private Konten (kommasepariert)
euer setup --set accounts.private "p-sparkasse-giro, p-sparkasse-kk"

accounts.private — Liste von Konto-Kennungen, die als privat gelten. Wenn eine Ausgabe mit --account <kennung> gebucht wird und die Kennung in dieser Liste steht, wird die Ausgabe automatisch als Sacheinlage (Privateinlage) klassifiziert. Das Matching ist case-insensitiv. Nach Änderung der Liste: euer reconcile private ausführen, um bestehende Buchungen gegen die neue Config abzugleichen.

[[ledger_accounts]] — optionaler Kontenrahmen für Buchungskonten. Wenn vorhanden, kann der Agent statt --category auch --ledger-account <key> verwenden. Die Kategorie wird dann automatisch aus der Config aufgelöst.

SQL‑Abfragen (nur lesend)

Nutze euer query für komplexe Filter. Ausgabe ist CSV auf stdout.

# Ausgaben eines Lieferanten in einem Zeitraum
euer query "SELECT id, payment_date, invoice_date, vendor, amount_eur FROM expenses WHERE vendor LIKE '%OpenAI%' AND payment_date BETWEEN '2026-01-01' AND '2026-12-31' ORDER BY payment_date DESC"

# Große Ausgaben (Betrag <= -500)
euer query "SELECT id, payment_date, invoice_date, vendor, amount_eur FROM expenses WHERE amount_eur <= -500 ORDER BY amount_eur ASC"

Verfügbare Commands

Ausgaben

# Ausgabe hinzufügen
euer add expense \
    --payment-date YYYY-MM-DD \
    [--invoice-date YYYY-MM-DD] \
    --vendor "Lieferant" \
    [--category "Kategorie"] \
    [--ledger-account "hosting"] \
    --amount -XX.XX  # Brutto-Betrag (negativ, was vom Konto abgeht) \
    [--account "Bankkonto"] \
    [--receipt "Belegname.pdf"] \
    [--foreign "Betrag Währung"] \
    [--notes "Bemerkung"] \
    [--vat 3.50]  # Manueller Steuerbetrag in EUR (nicht %) \
    [--rc eu|third-country]  # Reverse-Charge-Typ \
    [--private-paid]  # Als privat bezahlt markieren (Sacheinlage)

# Ausgaben anzeigen
euer list expenses [--year YYYY] [--month MM] [--category "..."] [--full]
# Zeigt RC-Typ, USt (Output) und VorSt (Input) an, falls vorhanden.
# Mit --full zeigt die Tabelle zusätzlich Konto, Beleg, Fremdwährung und Notiz.
# Kategorieanzeige in Listen: `(<EÜR-Zeile>) <Name>` (z.B. `(51) Arbeitsmittel`).

# Ausgabe aktualisieren
euer update expense <ID> [--payment-date ...] [--invoice-date ...] [--vendor ...] [--amount ...] [--rc eu|third-country|--no-rc] [--private-paid|--no-private-paid] ...

# Ausgabe löschen
euer delete expense <ID> [--force]

Einnahmen

# Einnahme hinzufügen
euer add income \
    --payment-date YYYY-MM-DD \
    [--invoice-date YYYY-MM-DD] \
    --source "Kunde/Quelle" \
    [--category "Kategorie"] \
    [--ledger-account "erloese-19"] \
    --amount XX.XX  # Brutto-Betrag (positiv, was auf dem Konto eingeht) \
    [--receipt "Belegname.pdf"] \
    [--foreign "Betrag Währung"] \
    [--notes "Bemerkung"] \
    [--vat 285.00]  # Manueller Umsatzsteuer-Betrag bei Regelbesteuerung (nicht %) \
    [--vat-rate 19|7|0] \
    [--tax-free]

# Einnahmen anzeigen
euer list income [--year YYYY] [--month MM] [--full]
# Tabellenansicht zeigt immer die Spalte USt (vat_output).
# Mit --full kommt zusätzlich die Spalte Notiz hinzu.

# Einnahme aktualisieren
euer update income <ID> [--payment-date ...] [--invoice-date ...] [--source ...] [--amount ...] [--vat-rate 19|7|0] [--tax-free] ...

# Einnahme löschen
euer delete income <ID> [--force]

Privatvorgänge

# Privateinlage/Privatentnahme direkt buchen
euer add private-deposit --date YYYY-MM-DD --amount XX.XX --description "..."
euer add private-withdrawal --date YYYY-MM-DD --amount XX.XX --description "..."

# Optional mit Referenz auf Ausgabe (Ausgleich)
euer add private-withdrawal --date YYYY-MM-DD --amount XX.XX --description "..." --related-expense-id <EXPENSE_ID>

# Anzeigen
euer list private-transfers [--year YYYY]
euer list private-deposits [--year YYYY]
euer list private-withdrawals [--year YYYY]

# Ändern/Löschen
euer update private-transfer <ID> [--amount ...] [--description ...] [--related-expense-id <ID>|--clear-related-expense]
euer delete private-transfer <ID> [--force]

Übersicht & Export

# Zusammenfassung (Kategorien + Gewinn/Verlust)
euer summary [--year YYYY]
euer summary [--year YYYY] [--include-private]

# Privat-Zusammenfassung (ELSTER Zeile 121/122)
euer private-summary --year YYYY

# Persistierte private Klassifikation nachziehen (z.B. nach Setup-Änderung)
euer reconcile private [--year YYYY] [--dry-run]

# Export als CSV oder XLSX
euer export [--year YYYY] [--format csv|xlsx]
# Für jahresweise Exportordner konkreten Pfad setzen; exports.directory
# unterstützt keinen {year}-Platzhalter.
euer export --year YYYY --output "/pfad/zu/Buchhaltung/YYYY/Exporte"

# SQL-Query (nur SELECT, Ausgabe als CSV)
euer query "SELECT ... FROM ... WHERE ..."

# Kategorien anzeigen
euer list categories [--type expense|income]

# Kontenrahmen anzeigen
euer list ledger-accounts [--category "..."]

# Audit-Log für Transaktion
euer audit <ID> [--table expenses|income|private_transfers]

Bulk-Import

# Import von CSV oder JSONL
euer import --file import.csv --format csv
euer import --file import.jsonl --format jsonl
euer import --schema  # Schema + Beispiele

# Unvollständige Einträge anzeigen
euer incomplete list
euer incomplete list --format csv

Hinweis:

• Fehlende Pflichtfelder brechen den Import ab.
• Standard add-Einträge dürfen optionale Felder (z.B. Beleg/Notiz) fehlen und werden später per update ergänzt.

Workflow:

1. Importieren bzw. Eintrag erfassen, Pflichtfelder müssen vorhanden sein.
2. euer incomplete list prüfen und offene Aufgaben festhalten (fehlende payment_date, invoice_date, category, receipt, vat, account).
3. Fehlende Felder per euer update expense <ID> / euer update income <ID> ergänzen. Hinweis: Für die Kategorie Gezahlte USt (57) ist kein Beleg erforderlich.

Import-Schema (Kurzfassung):

• Pflichtfelder: type, party, amount_eur und mindestens eines aus payment_date/invoice_date (date gilt als Alias für payment_date)
• Optional: category, account, ledger_account, foreign_amount, receipt_name, notes, rc, private_paid, vat_input, vat_output, vat_rate, vat_code, tax_free
• Fehlende Pflichtfelder führen zu einem Import-Abbruch.
• Alias-Keys (Auszug): EUR, Belegname, Lieferant, Quelle, RC, Vorsteuer, Umsatzsteuer, Privat bezahlt
• rc akzeptiert eu oder third-country; Legacy-Werte rc=true|X brauchen zusätzlich eine Jurisdiktionsspalte.
• vat_rate akzeptiert 19, 7, 0, 19%, 7%, 0%.
• vat_code ist für Round-Trips erlaubt: output_standard_19, output_reduced_7, output_zero_0, output_tax_free_no_vorsteuer, input_invoice, reverse_charge_eu, reverse_charge_third_country.
• private_paid=true|1|yes|X markiert die Ausgabe manuell als Sacheinlage.
• Kategorien wie Arbeitsmittel (51) werden automatisch auf Arbeitsmittel bereinigt.
• Steuerfelder:
  • small_business + rc=eu|third-country: vat_output wird automatisch aus amount_eur * 0.19 berechnet, vat_input wird auf 0.0 gesetzt (Felder können weggelassen werden).
  • small_business + Einnahmen: neue Einnahmen werden als output_tax_free_no_vorsteuer klassifiziert.
  • standard + Ausgaben: vat_input wird per --vat/Import erfasst (außer bei RC, dort automatisch).
  • standard + Einnahmen: ohne Angabe gilt vat_rate=19. Nutze --vat-rate 7, --vat-rate 0 oder --tax-free für abweichende Fälle. amount_eur wird immer 1:1 als Brutto-Zahlfluss gespeichert.
• private_transfers/Sacheinlagen aus dem Export sind kein Standard-Bulk-Importformat.

Beleg-Verwaltung

# Konfiguration anzeigen
euer config show

# Fehlende Belege prüfen
euer receipt check [--year YYYY] [--type expense|income]

# Beleg öffnen
euer receipt open <ID> [--table expenses|income]

Wichtige Regeln

Beträge

Der Betrag (--amount) entspricht immer dem tatsächlichen Zahlfluss auf dem Bankkonto (Brutto).

• Ausgaben: Immer NEGATIV (z.B. --amount -119.00).
  • Standard-Fall: Das ist der Brutto-Preis inkl. USt.
  • Reverse-Charge: Das ist der Netto-Preis (da keine USt überwiesen wurde).
• Einnahmen: Immer POSITIV (z.B. --amount 119.00).
  • Standard-Fall: Brutto-Rechnungsbetrag, den der Kunde überwiesen hat.
• Privateinlagen/Privatentnahmen: Immer POSITIV (add private-deposit, add private-withdrawal), Richtung ergibt sich aus dem Typ.

Steuermodus (Config)

Das Verhalten hängt von der Konfiguration ab (~/.config/euer/config.toml):

[tax]
mode = "small_business"  # oder "standard"

1. Kleinunternehmer (mode = "small_business"):

   • Ausgaben werde brutto als Kosten erfasst.
   • Einnahmen werden in der Regel netto (ohne USt) erfasst.
   • Reverse-Charge: Erzeugt eine Umsatzsteuerschuld (vat_output), die nicht als Vorsteuer abgezogen werden kann.

2. Regelbesteuerung (mode = "standard"):

   • Ausgaben: Vorsteuer (vat_input) wird erfasst (automatisch bei RC oder manuell via --vat).
   • Einnahmen: Umsatzsteuer (vat_output) wird erfasst; vat_rate/vat_code müssen für den UStVA-Report stimmen.
   • Standard-Einnahmen ohne Sonderfall mit --vat-rate 19 buchen; für 7 % --vat-rate 7, für 0 % --vat-rate 0, für steuerfrei --tax-free.
   • Reverse-Charge: Nullsummenspiel (Umsatzsteuer = Vorsteuer).

USt-Voranmeldung (vat-report)

euer vat-report --year YYYY
euer vat-report --year YYYY --quarter 1
euer vat-report --year YYYY --month 3
euer vat-report --year YYYY --quarter 1 --format csv --output exports/

Der Report ist kein Ersatz für Steuerberatung oder ELSTER-Übermittlung. Er ist ein Arbeitsbericht mit Kennzahlen, Warnungen und Diagnose. Er nutzt nur payment_date; Buchungen ohne Wertstellungsdatum werden gewarnt und nicht eingerechnet.

Reverse-Charge (--rc eu|third-country)

Verwende --rc eu oder --rc third-country bei ausländischen Anbietern ohne deutsche USt:

• OpenAI, Anthropic
• Render, Vercel, Netlify
• AWS, Google Cloud, Azure
• GitHub, Stripe

Berechnet automatisch 19% USt.

• Kleinunternehmer: Erhöht die Zahllast.
• Regelbesteuerung: Bucht USt und VorSt gleichzeitig (Zahllast-neutral). Hinweis: Bei small_business setzt RC automatisch vat_output, vat_input bleibt 0.0. Die Anwendung leitet eu/third-country nicht automatisch aus Anbieter oder Land ab. Bestehende RC-Buchungen ohne EU-/Drittland-Typ per euer update expense <ID> --rc ... nachpflegen.

Prepaid-Guthaben & Vorauszahlungen (z. B. Google AI Studio, OpenAI)

Bei Anbietern mit Guthabenaufladung (Prepaid):

1. Zahlung erfassen: Die Guthabenaufladung wird direkt bei Zahlung/Kontoabbuchung mit dem Zahlungsbeleg als Ausgabe erfasst (--amount -XX.XX, --rc eu|third-country). Als --invoice-date pragmatisch das Datum des Zahlungsbelegs/Kontoauszugs nutzen. Eine Warnung bei Wertstellungsdatum vor Rechnungsdatum kann ignoriert werden.
2. Monatliche Verbrauchsrechnung: Weist die spätere Monatsrechnung einen Zahlbetrag von 0,00 EUR auf (da mit Guthaben verrechnet), wird sie nicht als neue Ausgabe gebucht (Vermeidung von Doppelzählung). Sie wird im Belegordner abgelegt und optional in den --notes der Zahlungsbuchung vermerkt. (Details: siehe docs/FAQ.md).

Kategorien

Nur diese Kategorien sind verfügbar:

Ausgaben (expense):

Hinweis: Bewirtungsaufwendungen werden in euer summary automatisch 70/30 aufgeteilt. In list expenses und Exporten bleibt der volle Betrag (100%) erhalten; der nicht abziehbare 30%-Anteil wird nur im Summary ausgewiesen.

Einnahmen (income):

Datenmodell (Interpretation der Spalten)

Ausgaben (expenses)

Einnahmen (income)

Privatvorgänge (private_transfers)

Belegnamen

Format: YYYY-MM-DD_Anbieter.pdf oder YYYYMMDD_Anbieter.pdf

Beispiele:

• 2026-01-15_Render.pdf
• 20260115_OpenAI.pdf

Belege werden unter einem gemeinsamen Root jahrzentriert erwartet:

<root>/<Jahr>/<Typ>/<Belegname>

Standard:

• Ausgaben: <root>/<Jahr>/Ausgaben/<Belegname>
• Einnahmen: <root>/<Jahr>/Einnahmen/<Belegname>

Das Jahr des Belegordners folgt dem payment_date der Buchung (Zufluss-/Abflussprinzip). Ohne payment_date kann euer beim Buchen keinen Jahresordner sicher ableiten.

Hinweis: Fehlt die Dateiendung, prüft euer receipt check automatisch .pdf, .jpg, .jpeg und .png.

Typische Workflows

Monatliche Buchung

1. Prüfe bestehende Einträge: euer list expenses --year 2026 --month 1
2. Buche neue Ausgaben mit add expense
3. Buche neue Einnahmen mit add income
4. Prüfe Belege: euer receipt check --year 2026

Jahresabschluss

1. Zusammenfassung anzeigen: euer summary --year 2026
2. UStVA-Arbeitsbericht prüfen: euer vat-report --year 2026
3. Export erstellen: euer export --year 2026 --format xlsx
4. Beleg-Vollständigkeit prüfen: euer receipt check --year 2026

Korrektur

1. Eintrag finden: euer list expenses --year 2026
2. Aktualisieren: euer update expense <ID> --amount -XX.XX
3. Historie prüfen: euer audit <ID>

Beispiele

SaaS-Ausgabe buchen (Render)

euer add expense \
    --date 2026-01-04 \
    --vendor "RENDER.COM" \
    --category "Laufende EDV-Kosten" \
    --amount -22.71 \
    --foreign "26.60 USD" \
    --receipt "2026-01-04_Render.pdf" \
    --rc third-country

Kundenrechnung buchen

euer add income \
    --date 2026-01-20 \
    --source "Kunde ABC GmbH" \
    --category "Umsatzsteuerpflichtige Betriebseinnahmen" \
    --amount 2500.00 \
    --vat-rate 19 \
    --receipt "2026-01-20_Rechnung_001.pdf"

Privat bezahlte Rechnung buchen (Sacheinlage)

euer add expense \
    --date 2026-01-15 \
    --vendor "Amazon" \
    --category "Arbeitsmittel" \
    --amount -19.99 \
    --account "p-sparkasse-giro" \
    --receipt "2026-01-15_Amazon.pdf"

Hinweis: Wenn account einen in config.toml [accounts].private konfigurierten Wert hat (z.B. p-sparkasse-giro), wird die Ausgabe automatisch als Sacheinlage (Privateinlage) erfasst. Alternativ kann --private-paid explizit gesetzt werden.

Anteilig absetzbare Ausgabe buchen (gemischte Nutzung)

Bei Ausgaben mit sowohl privater als auch geschäftlicher Nutzung wird nur der geschäftliche Anteil gebucht. Der volle Rechnungsbetrag wird in --notes dokumentiert.

Beispiel: Internet-Anschluss, 50% geschäftlich, privat bezahlt:

euer add expense \
    --date 2026-01-20 \
    --vendor "Vodafone" \
    --category "Telekommunikation" \
    --amount -24.95 \
    --account "p-sparkasse-giro" \
    --receipt "2026-01-20_Vodafone.pdf" \
    --notes "Internet 49,90 EUR, 50% geschäftlich"