Appearance
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:
| Feld | Beschreibung | Beispiel |
|---|---|---|
Mandanten-ID (Tenant ID) | Die Tenant-ID Ihres Microsoft-365-Tenants. | 00000000-0000-0000-0000-000000000000 |
Client ID | Die Anwendungs-ID der registrierten App. | 00000000-0000-0000-0000-000000000000 |
Client Secret | Ein 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:
| Feld | Beschreibung | Beispiel |
|---|---|---|
Postfach E-Mail | Die E-Mail-Adresse des Rechnungs-Postfachs. | eingang@firma.de |
Abhol-Ordner | Ordner, aus dem neue E-Mails abgeholt werden. | Inbox |
In Bearbeitung-Ordner | Ordner für E-Mails, die aktuell verarbeitet werden. | In Bearbeitung |
Archiv-Ordner | Ordner für erfolgreich verarbeitete E-Mails. | Archived |
Abgelehnt-Ordner | Ordner 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:
| Feld | Beschreibung | Beispiel |
|---|---|---|
Absender E-Mail | Die 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:
- 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.
- Postfach-Zugriff: Der Zugriff auf das angegebene Postfach wird geprüft (Berechtigung
Mail.ReadWrite). - 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:
| Anzeige | Grund |
|---|---|
Schreib- und Sendetest – übersprungen | Die Anmeldung bei Microsoft Graph ist fehlgeschlagen. |
Schreibtest (Verschieben) – übersprungen | Der Archiv-Ordner existiert noch nicht. Die Test-Mail wird trotzdem erstellt und gelöscht. |
Sendetest – übersprungen | Es 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
- Falls noch nicht eingerichtet: Invoice-Komponente im Portal konfigurieren
- Sobald die Mandantenkonfiguration vollständig ist: Weiter zur Anleitung für den Rechnungsprozess (Anwendung & Prozesse)