Ordner-Sync
Ein Auftrag überwacht einen Eingangsordner, wandelt jede eingehende Rechnung ins eingestellte Zielformat und legt sie im Ausgangsordner ab. Mehrere Aufträge laufen parallel. Das ist die lokale Antwort auf „viele Dateien“ — und das einzige Werkzeug, das ohne Zutun arbeitet.
Woraus ein Auftrag besteht
Abschnitt betitelt „Woraus ein Auftrag besteht“| Feld | Bedeutung |
|---|---|
| Name | frei wählbar; leer gelassen, steht der Eingangspfad in der Liste |
| Eingang | wird überwacht |
| Ausgang | hier landet das Ergebnis |
| Fehlerordner | hierhin wandert, was nicht verarbeitbar war |
| Zielformat | XRechnung, ZUGFeRD, … |
| „auch bei Prüfbefund schreiben“ | Vorgabe aus: eine ungültige Rechnung bleibt liegen, statt den Fehler an den Empfänger zu delegieren. Abschaltbar, wenn das Zielsystem selbst prüft |
| aktiv | ob der Auftrag gerade läuft |
Alle drei Ordner müssen gesetzt sein, und der Ausgang darf nicht im Eingang liegen — sonst frisst sich der Auftrag selbst.
Was im Hintergrund für Verlässlichkeit sorgt
Abschnitt betitelt „Was im Hintergrund für Verlässlichkeit sorgt“| Vorkehrung | Warum |
|---|---|
| Stabilitätsfenster (2 s) | Ein Dateiüberwacher meldet, wenn eine Datei angelegt wird, nicht wenn sie fertig ist. Ohne Wartezeit würden halbe Uploads verarbeitet — bevorzugt die großen. Größe und Zeitstempel müssen konstant bleiben |
| Abtastdurchlauf (10 s) neben dem Überwacher | Auf Netzlaufwerken (SMB) meldet der Überwacher unzuverlässig; unter macOS gehen Ereignisse bei Massenanfall verloren |
| Atomares Schreiben | temporäre Datei, dann umbenennen — am anderen Ende des Ausgangs sitzt in aller Regel wieder eine Überwachung |
| Dublettenschutz über Inhalts-Hash | aber nur erfolgreiche Durchläufe zählen; sonst wäre ein einziger Fehlschlag endgültig |
| Fehlerordner | eine unverarbeitbare Datei im Eingang zu lassen hieße, sie bei jedem Durchlauf erneut zu versuchen — die eine kaputte Datei verdeckte alle folgenden |
Das Verarbeitungsjournal
Abschnitt betitelt „Das Verarbeitungsjournal“Zugleich das Protokoll, das Sie sehen wollen: je Datei Name, Inhalts-Hash, Ausgang (umgewandelt, fehlgeschlagen, abgelehnt, Dublette), Grund bzw. erkanntes Quellformat, Name der erzeugten Datei und Zeitpunkt. Es liegt als SQLite-Datei neben den Einstellungen.