Ü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
NextCloud-Synchronisation	MESO-WSNEXTCLOUD	Bidirektionale Kalender-Synchronisation M365 ↔ NextCloud	Last-Write-Wins-Konfliktauflösung, tägliche/wöchentliche Serientermine, flexible Zeitfenster, Delta-Sync
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
Berichtswesen	MESO-WSREPORT	Eigene Berichte auf WinLine-Daten im Report-Designer	MesoXPO-Entitäten, freie Abfragen, PowerReport- und LIST-Definitionen, Master-Detail, MESOSAFE-Filterung je WinLine-Benutzer, Export in alle gängigen Formate

Detaillierte Beschreibungen der einzelnen Module finden Sie im Abschnitt Hauptkomponenten.

Hauptfunktionen

Der MesoWorkerService bietet sieben 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. NextCloud-Kalendersynchronisation

Synchronisiert Kalender bidirektional zwischen Microsoft 365 und NextCloud (CalDAV)
Löst Konflikte automatisch nach dem Last-Write-Wins-Prinzip (Änderungen und Löschungen)
Nutzt Delta-Sync über Graph-Delta-Link und CalDAV-Sync-Token
Überträgt tägliche und wöchentliche Serientermine (RRULE)
Konfigurierbare Zeitfenster und Zeitzone je Sync-Paar

5. 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

6. Ü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

7. 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 | Quartz.NET | Blazor Web-UI)
============================================================

Module (je Aufgabe separat lizenziert)
  • Mail-Dienst — MESO-WSMAIL (jede Sekunde)
  • Belegzeilen-Workflows — MESO-WSBELEG (alle 5 Min)
  • Terminsynchronisation — MESO-WSGRAPH (alle 10 Min)
  • NextCloud-Kalendersync — MESO-WSNEXTCLOUD (alle 10 Min)
  • Offene Posten — MESO-WSOP (täglich 7:00)
  • Open Banking — MESO-WSBANKK (täglich 6:00)
  • Überwachung / NoRuleWarning — in MESO-WSMAIL (täglich 8:00)

Datenquellen
  • WinLine-Datenbanken (CWLSYSTEM, Mandanten-DB, FIBU/T019)
  • MesoArchivWeb (Dokumentenarchiv & Belege)
  • WinLine Server (OP-Blatt, Workflow-Schritte)
  • GetMyInvoices (Bank-, Kreditkarten-, PayPal-Transaktionen)

Ausgabe / Integrationen
  • SMTP / Microsoft 365 (OAuth) – E-Mails, OP-Übersichten, Warnungen
  • Microsoft Graph API – Exchange/Outlook-Termine
  • NextCloud (CalDAV) – bidirektionaler Kalenderabgleich
  • WinLine CRM – neue Fälle & Workflow-Schritte
  • FIBU-Buchungen – DZ, KZ, Ausgangs- & Kostenbuchungen

Anwendungsdatenbank (MesoWorkerDb)
  • Konfiguration + Journale (Mail, Termin, OP, Banking, NextCloud)

Administrationsoberflächen:

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

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