Direkt zum Hauptinhalt

Ü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 acht 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)

8. Berichtswesen

  • Erstellt eigene Berichte im Report-Designer auf Basis von WinLine-Daten
  • Nutzt MesoXPO-Entitäten, freie SQL-Abfragen sowie PowerReport- und LIST-Definitionen, auch als Master-Detail
  • Spalten einer MesoXPO-Datenquelle wählen Sie durch einen Eigenschaftsbaum statt Pfade zu tippen — bestehende Sonderpfade bleiben erhalten
  • Sie können Spaltenpfade auch direkt im Feld „Spalten" eingeben und erhalten während der Eingabe Vorschläge aus dem Entitätstyp mit technischem Pfad und Anzeigename; die Auswahl einer Verweiseigenschaft führt in die nächste Ebene. Sonderpfade bleiben möglich und werden im Feld dezent gekennzeichnet
  • Eine Sammlung können Sie direkt im Baum als Detailabfrage anlegen, wodurch automatisch die Master-Detail-Beziehung entsteht — Spaltenpaare und Vorfilter werden aus der Sammlung hergeleitet, vor dem Anlegen bestätigt und die beteiligten Spalten automatisch in beide Abfragen übernommen
  • Die Feldliste des Report-Designers zeigt Detailtabellen verschachtelt unter ihrer Mastertabelle, „Detailbereich einfügen" bietet die Beziehung direkt an
  • Führt Berichte zeitgesteuert für ausgewählte Mandanten und WinLine-Benutzer aus und legt das Ergebnis in einer Dateiablage ab
  • Filtert die Daten nach MESOSAFE im Kontext des jeweiligen WinLine-Benutzers
  • Protokolliert jede Einzelausgabe im Berichtsjournal, auf Wunsch samt erzeugtem Dokument

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)
  • Berichtswesen — MESO-WSREPORT (alle 5 Min, Standard: aus)
  • Ü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.

Weiterführende Dokumentation (im Ordner Docs/):

Keine Kommentare vorhanden