Treasurer Automation CLI

Ein modulares CLI-Tool in .NET 10 zur Automatisierung von Buchhaltungsaufgaben für Vereine. Aktuell synchronisiert es Verkäufe (z. B. Getränkeverkäufe) von SumUp direkt als detaillierte Buchungen nach easyVerein.

Datenfluss

flowchart LR
    subgraph SumUp [SumUp Portal]
        S_TX[Transaktionen]
        S_REC[Belegdetails]
    end

    subgraph CLI [Treasurer Automation CLI]
        C_RUN[dotnet run -- sumup-sync]
        C_VAL[Validierung & Filterung]
        C_FMT[Umsatzsteuer- & Produkt-Formatierung]
        C_RUN --> C_VAL --> C_FMT
    end

    subgraph EV [easyVerein]
        EV_ACC[Kassenbuch / Buchungen]
    end

    S_TX -->|1. ListAsync| C_RUN
    S_REC -->|2. GetAsync| C_RUN
    C_FMT -->|3. Post v2.0/booking| EV_ACC

Loading

Setup & Konfiguration

Die Konfiguration kann entweder über Umgebungsvariablen oder direkt als CLI-Optionen (überschreibt Umgebungsvariablen) übergeben werden:

Parameter	CLI-Option	Umgebungsvariable	Beschreibung
SumUp Token	--sumup-token	SUMUP_ACCESS_TOKEN	API-Zugriffsschlüssel für SumUp
SumUp Merchant Code	--merchant-code	SUMUP_MERCHANT_CODE	Deine Händler-ID bei SumUp
easyVerein Token	--easyverein-token	EASYVEREIN_TOKEN	API-Token (Bearer) für easyVerein
easyVerein Konto-ID	--billing-account	EASYVEREIN_BILLING_ACCOUNT_ID	Interne ID des Kassen-/Bankkontos in easyVerein

Nutzung

Navigiere in das Projektverzeichnis:

cd TreasurerAutomation

Hilfe anzeigen

dotnet run
# oder für spezifischen Befehl:
dotnet run -- sumup-sync --help

Synchronisierung starten (Beispiel mit CLI-Parametern)

dotnet run -- sumup-sync \
  --sumup-token "DEIN_TOKEN" \
  --merchant-code "DEIN_CODE" \
  --easyverein-token "DEIN_EV_TOKEN" \
  --billing-account 12345 \
  --days 3 \
  --limit 50

Zusätzliche Parameter für sumup-sync:

• --days <int>: Zeitraum in Tagen in die Vergangenheit (Standard: 1)
• --limit <int>: Maximale Anzahl der zu importierenden Transaktionen (Standard: 100)

---

1. Neuer Befehl: Erstelle eine Klasse in Commands/ (z. B. Commands/MemberAuditCommand.cs), die von AsyncCommand<TSettings> erbt.
2. Registrieren: Füge den Befehl in Program.cs hinzu:

   config.AddCommand<MemberAuditCommand>("member-audit")
         .WithDescription("Auditiert Mitgliedsbeiträge.");

---

easyVerein Verbindungstest (easyverein-test)

Es gibt einen integrierten Test-Befehl easyverein-test im Hauptprojekt, um den Beleg-Upload und die Buchungsverknüpfung in easyVerein unabhängig von SumUp vollautomatisch zu testen.

Ausführung

Navigiere in den Hauptordner:

cd TreasurerAutomation

Starte den Test (das easyVerein-Token kann per Parameter oder Umgebungsvariable EASYVEREIN_TOKEN übergeben werden):

dotnet run -- easyverein-test --easyverein-token "DEIN_TOKEN"

Dieser Befehl erstellt automatisch ein temporäres Test-Zahlungskonto, lädt einen 1x1 Dummy-PNG-Beleg hoch und verknüpft diesen mit einer Test-Buchung.