E-Mail-Buchungseingang

Diese App macht aus eingehenden Buchungs-E-Mails geprüfte, freigegebene und verbuchte Buchhaltungsbelege — und lässt Sie Postfächer und Zuordnungsregeln konfigurieren, alles an einem Ort.
Was macht diese App?
Der E-Mail-Buchungseingang verbindet sich mit Ihren IMAP-/POP3-Postfächern, durchsucht sie nach Buchungs-E-Mails (Lieferantenrechnungen, Belege, Zahlungsavise) und schlägt zu jeder eine Buchung vor. Es wird nichts automatisch verbucht: Jeder Vorschlag durchläuft den Workflow Vorgeschlagen → Freigegeben → Verbucht mit manueller Prüfung.
Wichtige Funktionen
- Eingang mit Statusfilter (offen, vorgeschlagen, verbucht, abgelehnt) und Zählern pro Status.
- Prüfen & verbuchen: automatisch extrahierten Betrag, Datum, Konto und Lieferanten kontrollieren, dann freigeben & verbuchen oder ablehnen.
- Postfach-Konfiguration: IMAP-/POP3-Postfächer anlegen (Host, Port, Benutzer, TLS, Ordner).
- Zuordnungsregeln: Absender oder Betreff abgleichen und Lieferant sowie Standardkonto vorbefüllen.
Erste Schritte
- Öffnen Sie Postfächer und legen Sie ein Postfach mit IMAP-/POP3-Daten an. Das Passwort wird als Secret-Referenz hinterlegt, nie im Klartext.
- Optional: Legen Sie Zuordnungsregeln für wiederkehrende Absender an.
- Gehen Sie zum Eingang und klicken Sie auf Jetzt scannen.
- Öffnen Sie eine E-Mail, prüfen Sie Betrag und Datum, dann Freigeben & verbuchen — oder ablehnen mit einem Grund.
Postfach-Aufräumung (optional, ausgeschaltet ausgeliefert)
Unter der Postfachliste finden Sie die Postfach-Aufräumung. Sie archiviert alte Nachrichten lokal, liest das Archiv zur Prüfung zurück und löscht sie erst danach unwiderruflich vom IMAP-Server. Es gibt keinen Zeitplan und keinen Cronjob: Jeder Lauf wird von einem Menschen ausgelöst.
Die Funktion ist sichtbar, auch wenn sie ausgeschaltet ist — und sie ist ausgeschaltet ausgeliefert. Das ist keine Vorsicht, sondern ein erzwungener Entscheidungspunkt. Eingeschaltet wird sie über IMAP_PURGE_ENABLED (config.php, Umgebungsvariable oder Modulkonfiguration des Mandanten), und zwar erst, nachdem Sie das Dokument docs/imap-archive-purge-before-you-enable.md durchgearbeitet haben. Das Archivverzeichnis (IMAP_PURGE_ARCHIVE_DIR) liegt auf dem Server und wird nicht in der Oberfläche gesetzt.
Das Panel zeigt und kann:
- Aufbewahrungsfenster (Tage): editierbar. Es schreibt genau die Einstellung, die das Backend liest. Voreinstellung sind 3650 Tage = zehn Jahre, die längste gesetzliche Aufbewahrungsfrist für Geschäftskorrespondenz in [address redacted].
- Aufbewahrung von E-Mail-Entwürfen: ebenfalls in derselben Karte editierbar, aber eine getrennte Funktion.
EMAIL_DRAFT_RETENTION_DAYSbetrifft alte, nicht gesendete und nicht mehr geprüfte Entwürfe, läuft täglich automatisch und hat die Voreinstellung 14 Tage. Die Oberfläche speichert den Wert mandantenspezifisch und zeigt den letzten automatischen Lauf einschließlich Erfolg oder Fehler.IMAP_PURGE_RETENTION_DAYSbleibt dagegen ausschließlich das 3650-Tage-Fenster für die manuell ausgelöste Archivierung und Löschung auf dem Mailserver. - Letzter Lauf: Zeitpunkt, Modus (Probelauf oder echter Lauf) und Zählwerte. Ein fehlgeschlagener oder verweigerter Lauf wird als Fehler dargestellt, mit dem Fehlercode als lesbarem Text. „Noch nie ausgeführt" ist ein eigener, ehrlicher Zustand — nicht dasselbe wie ein Lauf, der nichts gefunden hat.
- Probelauf starten: immer möglich, auch bei ausgeschalteter Funktion. Ein Probelauf löscht nichts; er zählt nur, was ein echter Lauf entfernen würde.
- Aufräumen starten: nur bei eingeschalteter Funktion, und nur nach einem Bestätigungsdialog. Der Dialog benennt die Fragen, die Sie vorher beantwortet haben sollten (liegt das Archiv auf einer anderen Maschine; wer kommt an das Archiv; wie lange wird das Archiv selbst aufbewahrt; wurde eine Wiederherstellung je getestet; enthält dieses Postfach Kopien oder ist es der maßgebliche Bestand) und verlangt, dass Sie die Phrase
PURGEeintippen. Es gibt bewusst keine Häkchen-Liste: Ein gesetztes Häkchen belegt nichts.
FAQ
Ist die Postfach-Aufräumung rückgängig zu machen? Nein. Es gibt keinen Papierkorb und kein Rückgängig. Deshalb wird jede Nachricht zuerst archiviert und das Archiv zurückgelesen und verifiziert; schlägt irgendein Schritt fehl, bleibt die Nachricht auf dem Server. Werden Buchungen automatisch verbucht? Nein. Jede E-Mail wird zu einem Vorschlag, den Sie manuell prüfen und freigeben müssen, bevor er ins Hauptbuch geht. Was bewirkt eine Zuordnungsregel? Sie gleicht Absenderadresse und/oder Betreff ab und befüllt bei einem Treffer Lieferant und Standardkonto des Vorschlags vor. Kann ich erneut scannen, ohne Duplikate zu erzeugen? Ja. Der Scanner merkt sich die zuletzt verarbeitete Nachricht pro Postfach; Duplikate werden übersprungen und gemeldet.