Übersicht

Was ist MesoWorkerService?

MesoWorkerService ist ein Automatisierungsdienst für Mesonic WinLine, der Hintergrundaufgaben selbstständig ausführt. Der Dienst basiert auf .NET 10 und kann sowohl als Windows-Dienst als auch als Container betrieben werden.

Module im Überblick

MesoWorkerService ist modular aufgebaut. Jedes Modul wird separat lizenziert und kann unabhängig aktiviert werden:

Modul	Lizenz	Beschreibung	Highlights
Mail-Dienst	MESO-WSMAIL	Automatischer E-Mail-Versand aus CRM-Workflows	Hierarchische Empfängerregeln, SMTP & M365 OAuth, Mail-Vorlagen mit Platzhaltern, Anhänge aus Belegen/Archiv
Belegzeilen-Workflows	MESO-WSBELEG	Automatische CRM-Fall-Erzeugung aus Bestelldateizeilen	Flexible Filterkriterien, Duplikatserkennung, Template-basierte Beschreibungen, Anhänge aus Belegen
Terminsynchronisation	MESO-WSGRAPH	Kalender-Termine aus CRM-Einträgen über MS Graph API	Exchange/Outlook-Integration, Rücksynchronisation, Änderungserkennung, automatische Terminlöschung
Offene Posten	MESO-WSOP	Automatischer Versand von OP-Infos	Konfigurierbare Selektionskriterien, HTML-Vorlagen, Archiv-Anhänge, aktuelles OP-Blatt aus der FIBU als PDF, Journal
Überwachung	(in MESO-WSMAIL)	Warnung bei fehlenden E-Mail-Versendungen	Grace Period, Duplikatsschutz, konfigurierbare Zeiträume

Open Banking MESO-WSBANKK Automatischer Kontoabruf, OP-Matching und FIBU-Buchung Debitor-/Kreditor-OPs, Ausgangsbuchungen, KI-Sachkonto-Klassifikation, PayPal/Kreditkarten-Ketten

Detaillierte Beschreibungen der einzelnen Module finden Sie im Abschnitt Hauptkomponenten.

Hauptfunktionen

Der MesoWorkerService bietet fünf Hauptfunktionen:

1. Automatischer E-Mail-Versand

Versendet E-Mails automatisch basierend auf Workflow-Ereignissen in WinLine
Unterstützt hierarchische Empfängerregeln mit flexiblen Prioritäten
Ermöglicht die Verwendung mehrerer SMTP-Konten inkl. Microsoft 365 mit OAuth
Fügt automatisch Anhänge aus Workflows und Belegen hinzu
Protokolliert alle versendeten E-Mails im Mail-Journal

2. Workflow-Erzeugung aus Bestelldateizeilen

Erstellt automatisch CRM-Fälle aus Bestelldateizeilen (z.B. für Serviceaufträge)
Filtert relevante Zeilen nach konfigurierbaren Kriterien
Verhindert Mehrfachverarbeitung durch intelligente Protokollierung
Ermöglicht flexible Datumsfelder und Template-basierte Beschreibungen

3. Terminsynchronisation

Erstellt automatisch Kalender-Termine aus CRM-Einträgen über MS Graph API
Synchronisiert Termine direkt in Microsoft Exchange/Outlook-Kalender
Flexible Empfänger-Ermittlung über verschiedene CRM-Quellen
Optionale Rücksynchronisation von Terminänderungen zurück in CRM
Unterstützt dynamische Inhalte und Anhänge aus CRM-Einträgen

4. Offene Posten (OP-Versand)

Versendet automatisch OP-Infos an Kunden
Flexible Selektion nach Kontoart, Fälligkeit, Mahnstufe und individuellen Filtern
HTML-Vorlagen mit Platzhaltern für Kunden- und OP-Daten
Optionale Anhänge: Originalrechnungen aus dem Archiv und OP-Blatt aus der FIBU als PDF
Journal-Protokollierung mit Sendeintervall zur Vermeidung von Mehrfachversand

5. Überwachung und Warnung

Überwacht Workflows mit aktiven E-Mail-Regeln
Benachrichtigt Administratoren bei fehlenden E-Mail-Versendungen
Hilft bei der frühzeitigen Erkennung von Konfigurationsfehlern oder fehlenden Stammdaten

6. Open Banking (FIBU-Buchungsautomatisierung)

Ruft automatisch Banktransaktionen über Open-Banking-Provider (GMI, fino) ab Gleicht Eingänge gegen offene Debitoren-OPs ab (Score-basiertes Matching) Bucht erkannte Zahlungen als WinLine-FIBU-Buchungsstapel (DZ) Erkennt und bucht Ausgänge als Ausgangsbuchungen (B) via konfigurierbarer Regeln Verarbeitet Kreditor-Zahlungen gegen offene Kreditoren-OPs (KZ) KI-gestützte Sachkonto-Klassifikation mit T055/T028-Kontext (optional) Unterstützt mehrstufige Zahlungsketten (PayPal → Kreditkarte → Girokonto)

Systemarchitektur

┌──────────────────────────────────────────────────────────────────────────┐
│                          MesoWorkerService                               │
│                    (.NET 10 Hintergrunddienst)                           │
└──────────────────────────────────────────────────────────────────────────┘
                                    │
       ┌──────────────┬─────────────┼─────────────┬──────────────┐
       │              │             │             │              │
       ▼              ▼             ▼             ▼              ▼
┌────────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌─────────────┐
│ Mail-Dienst│ │ Workflow- │ │  Termin-  │ │  Offene   │ │ Überwachung │
│ (WSMAIL)   │ │ Erzeugung │ │  synchr.  │ │  Posten   │ │ (WSMAIL)    │
│            │ │ (WSBELEG) │ │ (WSGRAPH) │ │  (WSOP)   │ │             │
└────────────┘ └───────────┘ └───────────┘ └───────────┘ └─────────────┘
       │              │             │             │              │
       └──────────────┴─────────────┼─────────────┴──────────────┘
                                    │
          ┌─────────────────────────┼──────────────────────────┐
          ▼                         ▼                          ▼
┌──────────────────────┐  ┌─────────────────────┐  ┌───────────────────┐
│ WinLine Datenbanken  │  │  MS Graph API       │  │ MesoArchivWeb     │
│ • CWLSYSTEM          │  │  (Exchange/Outlook) │  │ (Dokumentenarchiv)│
│ • Mandanten-DB       │  └─────────────────────┘  └───────────────────┘
│ • FIBU (T019)        │
└──────────────────────┘            ▼
          │                ┌─────────────────────┐
          ▼                │ WinLine Server      │
┌──────────────────────┐   │ (OP-Blatt)          │
│ Anwendungsdatenbank  │   └─────────────────────┘
│ (MesoWorkerDb)       │
│ • Konfiguration      │
│ • Mail-Journal       │
│ • Termin-Journal     │
│ • OP-Journal         │
│ • Protokollierung    │
└──────────────────────┘

Administrationsoberflächen:

Blazor Web-UI (browserbasiert, Port 5000)
Windows Desktop-Client

Eine detaillierte Architekturübersicht finden Sie in assets/systemarchitektur.md.