E-Mail Konten & Sendeverlauf (SYS03, SYS09)

Transaktionen: SYS03 E-Mail Konten, SYS09 E-Mail Sendeverlauf
UI-Pfade: /emailAccounts, /emailSendHistory

Business-Zweck

Das E-Mail-Subsystem stellt Versandkonten bereit (SMTP, Office 365 OAuth) und protokolliert versendete System-E-Mails (Belege, Workflows, EDI). Ohne korrekt konfigurierte EmailAccount-Datensätze schlagen Belegversand, EDI-E-Mail-Kanal und CRM-Benachrichtigungen fehl.

Kernbegriffe

Begriff	Bedeutung
EmailAccount	SMTP/O365-Konto mit Zugangsdaten
Email	Gespeicherte Nachricht (Versand/Historie)
EmailWorkflowQueue	Geplante Workflow-Mails
EmailFilterHead	Regeln für automatischen Belegversand
testConnection	Verbindungstest vor Produktivbetrieb

Fachlicher Ablauf / Workflow

E-Mail-Konto anlegen (SYS03)

1. Konto in SYS03 anlegen: Host, Port, TLS, Absender
2. POST /api/emailAccount/testConnection – Verbindung prüfen
3. Office 365: POST /api/emailAccount/office365 → OAuth-URL, Callback GET /api/emailAccount/office365
4. User zuordnen: GET /api/emailAccount/getAssignedUsers/{id}

Beleg-/Workflow-Versand

1. EmailFilterHead definiert wann welche Belegart versendet wird
2. Queue-Einträge in EmailWorkflowQueue
3. Versand über MailingService

Sendeverlauf (SYS09)

• Liste versendeter E-Mails (Domain Email, Workflow-Queue)
• Fehlgeschlagene Einträge in EmailWorkflowQueue mit Status
• Löschen aus Historie: POST /api/emailWorkflow/deleteFromEmailSendHistory

Partner-Szenarien

Szenario	Endpoint / Transaktion
SMTP für EDI-E-Mail-Kanal	SYS03, EDI-Protokolle
Beleg-PDF per Mail	EmailWorkflow + SAL-Belege
O365-Migration	Office-365-Endpoints in Email Account API
Versand-Monitoring	SYS09, GET /api/emailWorkflow/emailWorkflowQueue

Voraussetzungen

• Gültiges E-Mail-Konto mit Versandrecht
• Firewall: SMTP/HTTPS zu Provider erlaubt
• Für O365: Azure-App-Registrierung laut reybex-Doku

Auswirkungen im ERP

Modul	Nutzung
SAL/PUR	Belegversand, Anhänge
EDI	E-Mail als Transportkanal
CRM	Aktions-Benachrichtigungen
FIN	Mahnwesen (FIN09)

Typische Fehlerquellen

• testConnection fehlgeschlagen – Credentials, TLS, Port
• Mail in Queue hängt – emailWorkflowQueue Status prüfen
• User sieht kein Konto – Zuordnung User ↔ EmailAccount

Weiterlesen

• EDI – Protokolle