Skip to content

Zielgruppe & Rolle

Rolle: Mandanten-Administrator / IT-Admin | Voraussetzung: microtech Mandantenkonfiguration abgeschlossen und Postfach-Konfiguration eingerichtet

Mail Komponente im Portal konfigurieren ​

Unterstützung durch MBCOM

Auf Wunsch kann die vollständige Einrichtung der Mail-Konfiguration im Portal durch MBCOM übernommen werden.

Die Mail-Konfiguration im ConnectCLOUD Portal stellt die Verbindung zu Ihrem Microsoft-365-Postfach her. Diese Konfiguration wird von ConnectInvoice (Rechnungseingang) und ConnectWorkflow (E-Mail-Benachrichtigungen) benötigt.

Voraussetzung ist, dass die Postfach-Konfiguration in Microsoft Entra ID bzw. für ConnectWORKFLOW die Postfach-Einrichtung für ConnectWORKFLOW abgeschlossen wurde und Ihnen die Zugangsdaten (Tenant ID, Client ID und Client Secret) vorliegen.

Microsoft Graph API ​

Im Bereich Microsoft Graph API tragen Sie die Zugangsdaten Ihrer Entra-App-Registrierung ein:

FeldBeschreibungBeispiel
Mandanten-ID (Tenant ID)Die Tenant-ID Ihres Microsoft-365-Tenants.00000000-0000-0000-0000-000000000000
Client IDDie Anwendungs-ID der registrierten App.00000000-0000-0000-0000-000000000000
Client SecretEin gültiges Client-Secret der App.••••••••

Postfach & Ordnerstruktur Eingangsrechnung ​

Im Bereich Postfach & Ordnerstruktur konfigurieren Sie das Zielpostfach und die Ordner für die automatisierte Rechnungsverarbeitung:

FeldBeschreibungBeispiel
Postfach E-MailDie E-Mail-Adresse des Rechnungs-Postfachs.eingang@firma.de
Abhol-OrdnerOrdner, aus dem neue E-Mails abgeholt werden.Inbox
In Bearbeitung-OrdnerOrdner für E-Mails, die aktuell verarbeitet werden.In Bearbeitung
Archiv-OrdnerOrdner für erfolgreich verarbeitete E-Mails.Archived
Abgelehnt-OrdnerOrdner für fehlerhafte oder abgelehnte E-Mails.Rejected

Ordnernamen

Geben Sie die Ordnernamen exakt so an, wie sie im Postfach existieren. Die Ordner müssen vor dem produktiven Start im Postfach angelegt werden. Details zur Ordnerstruktur finden Sie in der Postfach-Konfiguration.

Absender-Adresse für Benachrichtigungen ​

Im Bereich Absender Adresse konfigurieren Sie die E-Mail-Adresse, die für den Versand von Workflow-Benachrichtigungen verwendet wird:

FeldBeschreibungBeispiel
Absender E-MailDie E-Mail-Adresse, von der Benachrichtigungen versendet werden.noreply@firma.de

Berechtigung Mail.Send

Für den Versand von Workflow-Benachrichtigungen muss in der Entra-App-Registrierung die Berechtigung Mail.Send (Application permission) gesetzt sein. Details finden Sie in der Postfach-Einrichtung für ConnectWORKFLOW sowie der Postfach-Konfiguration für ConnectINVOICE.

Verbindungstest ​

Der integrierte Verbindungstest prüft:

  1. Zugangsdaten & Token: Mit Tenant ID, Client ID und Client Secret wird ein echtes Token bei Microsoft Entra ID angefordert. Dafür ist keine Postfach-Berechtigung nötig.
  2. Postfach-Zugriff: Der Zugriff auf das angegebene Postfach wird geprüft (Berechtigung Mail.ReadWrite).
  3. Ordnerstruktur: Alle konfigurierten Ordner werden im Postfach gesucht.

Das Feld Postfach E-Mail ist optional. Ist es leer, werden Postfach- und Ordnerprüfung übersprungen. Das ist der richtige Weg, wenn die Mail-Anbindung nur für den Versand von Benachrichtigungen genutzt wird (z. B. bei der USt-ID-Prüfung oder ConnectWORKFLOW) und die App nur die Berechtigung Mail.Send besitzt.

Starten Sie den Test über die Schaltfläche Zugang testen. Bei einem erfolgreichen Test werden alle Prüfungen grün markiert.

Optionaler Schreib- und Sendetest ​

Mit der Option Optionalen Schreib- und Sendetest durchführen prüft der Test zusätzlich die Schreib- und Sendeberechtigungen:

  • Schreibtest: Eine Test-Mail wird im Postfach erstellt, in den Archiv-Ordner verschoben und wieder gelöscht.
  • Sendetest: Von der hinterlegten Absender-Adresse für Benachrichtigungen wird eine Test-Mail an dieselbe Adresse gesendet.

Beide Tests laufen, sobald die Anmeldung bei Microsoft Graph erfolgreich war, auch wenn einzelne Ordner noch nicht angelegt sind. Kann ein Schritt nicht ausgeführt werden, erscheint er grau markiert mit Begründung, zum Beispiel:

AnzeigeGrund
Schreib- und Sendetest – übersprungenDie Anmeldung bei Microsoft Graph ist fehlgeschlagen.
Schreibtest (Verschieben) – übersprungenDer Archiv-Ordner existiert noch nicht. Die Test-Mail wird trotzdem erstellt und gelöscht.
Sendetest – übersprungenEs ist keine Absender-Adresse für Benachrichtigungen hinterlegt.

Warnungen (z. B. wenn die Test-Mail nicht verschoben oder gelöscht werden konnte) werden gelb markiert. Der Test ist unabhängig davon, ob die Mail-Komponente bereits aktiviert ist.

Aktivierung ​

Nach einem erfolgreichen Verbindungstest kann die Mail-Komponente über den Aktivierungsschalter eingeschaltet werden. Speichern Sie anschließend die Konfiguration.

Für die volle Funktionalität von ConnectINVOICE müssen sowohl die microtech- als auch die Mail-Komponente aktiv sein.

Nächste Schritte