Agentic Ventures Wiki

agentic-ventures-sepa — Standard-Stack-Library fuer SEPA-Zahlungslauf-Generierung

4 Min. Lesezeit

agentic-ventures-sepa — Standard-Stack-Library

Standard-Stack-Baustein der wiederverwendbar bei jedem KMU-Buchhaltungs-Kunden eingesetzt wird. Kein VF-One-Off — Marvin entschied am 2026-05-18: „Wir wollen keine Abhängigkeiten schaffen. Der nächste Kunde will das auch. Wir brauchen einen Standard Stack.”

Problem

Buchhaltungs-User (in KMU typisch der GF oder eine 0.5-FTE-Buchhaltungs-Kraft) traegt eingehende Lieferanten-Rechnungen einzeln per Hand als Ueberweisung in die Banking-Software ein. Bei VF: SFirm. Bei anderen Kunden: andere Banking-Tools (StarMoney, SFirm, Direct-Banking-Web). Dauer: 30-45 Min/Woche pro 10-15 Rechnungen. Fehleranfaellig (IBAN-Tippen).

Standard-Loesung

SEPA-XML-Datei (pain.001.001.09) mit allen offenen Ueberweisungen sammeln, in einen vereinbarten Ablage-Pfad legen, User importiert einmal in seine Banking-Software und gibt mit TAN frei.

pain.001 ist EU-Standard, wird von allen Banking-Tools (SFirm, StarMoney, Sparkassen-Web, Volksbank-Online, Direct-Banking-Apps) akzeptiert. Unabhaengig vom Buchhaltungs-System des Kunden.

Architektur — Library + Lambda-Template, kein MCP

pain.001-Generieren ist deterministische File-Erzeugung mit klaren Eingaben + Output. MCP-Layer bringt nichts — Library + Lambda-Template ist der richtige Schnitt.

~/source/libs/agentic-ventures-sepa/      ← pip-Package, Source-of-Truth
├── pyproject.toml
├── src/agentic_ventures_sepa/
│   ├── pain001.py              # Generator (Default: pain.001.001.09, Pflicht ab Nov 2025)
│   ├── validators.py           # IBAN, BIC, Pflichtfeld-Checks, Amount-Limits
│   ├── adapters/
│   │   ├── base.py             # abstract VoucherSource
│   │   ├── papierkram.py       # VF + Standard-MCP-Setup heute
│   │   ├── sevdesk.py          # fuer Folgekunden mit sevdesk
│   │   ├── lexware.py          # fuer Folgekunden mit lexware
│   │   ├── datev.py            # falls Datev-Schnittstelle gewuenscht
│   │   └── manual.py           # CSV/Excel-Input fuer kein-API-Buchhaltung
│   └── output/
│       ├── xml.py              # pain.001-XML schreiben
│       ├── html_preview.py     # menschenlesbare Vorschau pro Lauf
│       └── sharepoint.py       # optional SharePoint-Upload via Graph
└── tests/
    ├── fixtures/papierkram_response_001.json
    └── test_pain001_golden.py  # Golden-File-Tests gegen Bundesbank-Schema

Plus Lambda-Template im agents-platform fuer die orchestrierende Routine:

~/source/agents-platform/templates/zahlungslauf-routine/
├── lambda_handler.py    # ruft Lib auf, Push-Notification an Kunde
├── cdk-stack.ts         # pro Kunde: 1 Cron-Lambda mit Kunde-spezifischem Config-JSON
└── README.md            # wie man's pro Kunde adaptiert (5 Min Setup)

Kunden-Setup-Aufwand (nach Library + Template stehen)

Pro neuer Kunde:

  1. Adapter-Auswahl (papierkram/sevdesk/lexware/manual) — Config-Eintrag, kein Code
  2. Debitor-IBAN + BIC + Name (Kunde gibt Marvin)
  3. Filter-Kriterien (welche Vouchers in den Lauf? z.B. „faellig in 14 Tagen + von User Y freigegeben”)
  4. Cron-Cadence (woechentlich Mo 8:00, monatlich am 1., bei Bedarf)
  5. Push-Notification-Kanal (Email, Slack, Teams)

Setup-Aufwand: ~30 Min pro Kunde. Dann laeuft das Ding monatlich oder woechentlich autonom.

Bau-Aufwand initial

BlockAufwand
Library-Kern (pain.001 + Validators + Tests gegen Bundesbank-Schema)2 Tage
Papierkram-Adapter (VF + alle Papierkram-Kunden)0.5 Tag
Output-Writer (XML + HTML-Preview + SharePoint-Upload)0.5 Tag
Lambda-Template in agents-platform1 Tag
VF-Konfiguration + Smoke-Test mit Andre0.5 Tag
Vault-Doku (4 Files)0.5 Tag
Gesamt erste Version~5 Tage
sevdesk-Adapter fuer Folge-Kunde+ 0.5 Tag pro Adapter
lexware-Adapter+ 0.5 Tag

DSGVO + Compliance

  • pain.001-Daten enthalten Personenbezogene Daten (Empfaenger-Name, IBAN, Verwendungszweck). DSGVO-relevant.
  • Verarbeitung bleibt innerhalb des Kunden-Tenants (AWS av-<kunde>-Account, eu-central-1). Lambda-Lambda, keine externen Sub-Verarbeiter.
  • Datei-Output landet im SharePoint des Kunden oder einem definierten Ablage-Pfad. Banking-Tool zieht von dort.
  • Keine Daten gehen nach US, kein OpenAI-/Anthropic-Call mit Voucher-Daten (Library macht reines pain.001-XML-Erzeugen ohne LLM).

Vault-Aufnahme als Standard-Capability

Wenn Library + Template stehen + 1. Kunde live ist:

  1. agentic-ventures-sepa — Repo-Capability-File (heute Skelett, dann „in production”)
  2. produkt-bundle — Eintrag unter „Buchhaltungs-Automation” als Standard-Capability
  3. sepa-zahlungslauf-pattern — Wissens-File „warum Library + Adapter statt MCP, wie man neue Backends andockt”
  4. Pitch-Update: „Wir nehmen euch eingehende Ueberweisungen ab — egal welche Buchhaltung, egal welche Bank” als VF-Pilot-Beleg sobald 1. Kunde live

Status + naechster Schritt

Status: planned. Trigger fuer Build-Start: Andre-Workflow-Discovery liefert Volumen-Datum (lohnt sich +5 Tage Bauzeit bei 5 Ueberweisungen/Woche? lohnt sich sicher bei 15+/Woche).

Wenn Andre sagt „brauche ich dringend” → Phase 1 (pain.001-Library) startet direkt. Wenn Andre sagt „eh nur paar” → Welle 4 fokussiert auf 4.4-4.6, SEPA-Library kommt mit dem 2. Kunden.

Cross-Refs

0 Dateien in diesem Ordner.