Zum Inhalt

Workflows

Ein Workflow handelt von selbst: Wenn ein Dokument aufgenommen oder eingeordnet wird (Auslöser) und alle Bedingungen zutreffen, führt Belegt seine Aktionen aus. Workflows legt nur der Inhaber an, auf der Seite Workflows; die Steuerberatung sieht sie, der Prüfer nicht.

Regeln und Workflows

Regeln schlagen vor, Workflows handeln. Eine Regel ändert nichts, bis jemand „Übernehmen“ klickt; ein Workflow setzt Tags, Korrespondent, Dokumenttyp und Feldwerte sofort. Beides bleibt getrennt, damit klar ist, was nur ein Vorschlag ist und was Belegt selbst getan hat.

Auslöser

  • Dokument aufgenommen: jedes neue Dokument, gleich woher (Hochladen, Mail, Eingangsordner, Schnittstelle, abgeleitet, Import).
  • Dokument eingeordnet: wenn das Dokument eingeordnet wird; eine spätere neue Einordnung löst denselben Workflow nicht noch einmal aus.

Ein Workflow sieht nur Dokumente, die nach seinem Anlegen aufgenommen oder eingeordnet wurden, und bearbeitet jedes Dokument genau einmal. Gelöschte Dokumente bearbeitet er nicht.

Bedingungen

Alle ausgefüllten Bedingungen müssen zutreffen; ohne Bedingung gilt der Workflow für jedes Dokument seines Auslösers.

Bedingung trifft zu, wenn
Quelle das Dokument aus einer der gewählten Quellen kam
Dateiname, Text enthält der Dateiname oder der gelesene Text (PDF, Office, Texterkennung, Mailtext) das Wort enthält, ohne Unterschied zwischen Groß- und Kleinschreibung
Betreff, Absender, Domain, Anhangtyp wie bei den Regeln; ein Anhang hat die Merkmale seiner Mail, ohne Mail ist der Dateiname der Betreff
Dateityp der Typ genau passt (application/pdf) oder mit Stern (image/*)
Hat den Tag, Dokumenttyp, Korrespondent das Dokument den Tag hat, den Dokumenttyp oder Korrespondenten oder keinen
Postfach eine Mail (oder die Mail eines Anhangs) aus dem Postfach mit diesem Namen kam
Unterordner die Datei im Eingangsordner in diesem Unterordner lag, auch tiefer („Steuer“ trifft „Steuer/2026“)

Braucht eine Bedingung den Text, wartet der Workflow, bis der Worker ihn gelesen hat.

Aktionen

  • Tag hinzufügen oder entfernen, Korrespondent oder Dokumenttyp setzen, Feldwert setzen
  • Notiz anlegen
  • Webhook-Ereignis dokument.workflow auslösen; die Nachricht nennt den Workflow (Webhooks)
  • Original an eine Adresse senden, etwa an eine Buchhaltung (unten)
  • Ohne Bestätigung einordnen (siehe unten)

Die Aktionen eines Workflows laufen in einer Transaktion: Scheitert eine, etwa weil ein Tag inzwischen gelöscht ist, geschieht keine, und der Fehler steht in den letzten Läufen. Belegt versucht es nicht wieder. Im Audit-Log und im Verlauf des Dokuments steht jede Änderung mit dem Akteur workflow:<Name>.

Original an Adresse senden

Die Aktion schickt das Original an eine andere App, die Dateien über eine Schnittstelle annimmt: als multipart/form-data per POST, die Datei im Feld mit dem gewählten Namen, dazu feste Felder und eine Kopfzeile für die Anmeldung.

Angabe Bedeutung
Adresse https://… (oder http:// im eigenen Netz); Zugangsdaten gehören nicht in die Adresse
Name des Dateifelds wie die App ihn erwartet, etwa datei, file oder document
Kopfzeile Name (Vorgabe Authorization) und Wert, etwa Bearer … oder Token …. Der Wert ist mit BELEGT_SCHLUESSEL verschlüsselt gespeichert und steht nie in der Oberfläche, der Schnittstelle, dem Protokoll oder dem Log
Feste Felder je Zeile name=wert; Platzhalter {titel} (sonst der Dateiname), {asn}, {id}, {datum} (Entstehung, sonst Eingang), {eingang}, {dateiname}, {art}, {korrespondent}, {dokumenttyp}, {url} (Link auf das Dokument in Belegt)

Gesendet wird im Hintergrund. Eine Antwort 2xx ist ein Erfolg. Antwortet die App nicht, mit 408, 429 oder 5xx, versucht Belegt es nach 1, 5 und 15 Minuten, 1, 3, 6 und 12 Stunden und einem Tag wieder und gibt danach auf; eine andere Antwort (4xx) und jede Weiterleitung (3xx, der Belegt nicht folgt, damit das Original nicht an eine andere Adresse geht) beenden es sofort. Jedes Dokument geht je Aktion höchstens einmal erfolgreich hinaus; Postgres hält eine gesendete Weitergabe fest. Ein Dokument, das vorher gelöscht wird, geht nicht mehr hinaus. Auf der Seite des Dokuments stehen unter Weitergaben Workflow, Ziel, Stand, Zeitpunkt, HTTP-Status und Fehler (Inhaber und Steuerberatung); gibt Belegt auf, meldet es das mit den fehlgeschlagenen Workflows (Benachrichtigungen).

Beispiel Buchhaltung mit Belege-API, hier Haben (POST /api/v1/belege, Datei im Feld datei, Token mit dem Recht belege:anlegen): Haben legt mit derselben Referenz nichts doppelt an.

Angabe Wert
Adresse https://haben.example.de/api/v1/belege
Dateifeld datei
Kopfzeile Authorization = Bearer hb_…
Feste Felder externalSource=belegt, externalId={id}, note=Belegt ASN {asn}: {titel} {url}

Beispiel Paperless-ngx (POST /api/documents/post_document/):

Angabe Wert
Adresse https://paperless.example.de/api/documents/post_document/
Dateifeld document
Kopfzeile Authorization = Token … (API-Token aus dem Profil)
Feste Felder title={titel}, created={datum}

Die Adresse wählt nur der Inhaber; wie bei den Webhooks gehen nur http und https, ohne Weiterleitung und mit Zeitlimit. Eine Adresse im eigenen Netz ist erlaubt, denn dort stehen die Apps meist.

Reihenfolge und Anhalten

Workflows laufen in der Reihenfolge der Liste, jeder sieht, was die vorigen gesetzt haben. Mit „Trifft er zu, laufen die folgenden Workflows für dieses Dokument nicht“ hält ein Workflow die übrigen an.

Einordnen durch einen Workflow

Einordnen setzt die Art, damit die Frist nach § 147 AO, und sperrt das Dokument bis Fristende. Deshalb ordnet ein Workflow nur ein, wenn der Inhaber das bei der Aktion ausdrücklich wählt; Postgres lehnt einen Workflow ohne diese Wahl ab. Er ordnet nur Dokumente im Eingang ein, nie eines, das schon jemand eingeordnet hat, mit dem Tag des Eingangs oder dem Datum einer erkannten E-Rechnung als Entstehung.

Die GoBD verlangen keine Bestätigung je Beleg, aber ein beschriebenes, nachvollziehbares Verfahren (GoBD Rz. 151 ff.): Der Workflow ist die vorab getroffene Entscheidung des Inhabers, jede Einordnung steht mit workflow:<Name> im Audit-Log, und die Verfahrensdokumentation führt jeden aktiven Workflow mit Auslöser, Bedingungen und Aktionen auf. Eine falsche Einordnung korrigierst du wie jede andere mit einer neuen Einordnung; die alte bleibt.

Ändern

Ein Workflow lässt sich aus- und einschalten, verschieben und löschen. Um Bedingungen oder Aktionen zu ändern, legst du ihn neu an und löschst den alten; seine Läufe bleiben im Protokoll. Wird ein Workflow wieder eingeschaltet, bearbeitet er auch die Dokumente, die in der Zwischenzeit ankamen.