APIs & Webhooks
Teil von No-Code und Workflow-Automatisierung im Unternehmen
Einen Ablauf vor der technischen Umsetzung beschreiben
Eine praktische Vorlage, um Auslöser, Schritte, Entscheidungen und Ausnahmen eines Arbeitsablaufs vor der technischen Umsetzung festzuhalten.
Beschreiben Sie einen Ablauf so, dass eine fachkundige Person jeden Übergang ohne Kenntnis des späteren Werkzeugs nachvollziehen kann. Benennen Sie Auslöser, Eingaben, Verantwortliche, Entscheidungen, Ergebnisse und Ausnahmen. Steht an einer Stelle nur „System verarbeitet“, fehlt meist die Regel für die Umsetzung.
Mit einem konkreten Fall beginnen
Nehmen Sie einen typischen Vorgang aus dem Arbeitsalltag und verfolgen Sie ihn vom ersten Anlass bis zum fachlichen Ergebnis. Sprechen Sie mit der Person, die ihn startet, und mit der Person, die ihn weiterbearbeitet. Halten Sie zunächst fest, was tatsächlich geschieht; trennen Sie davon den gewünschten künftigen Ablauf. So bleiben bestehende Umwege und offene Entscheidungen sichtbar.
Für einen ersten Entwurf reichen diese Angaben:
- Start:Welches Ereignis oder welche Handlung eröffnet einen Vorgang?
- Eingaben:Welche Angaben müssen vorliegen, aus welchem System stammen sie, und wer darf sie ergänzen?
- Schritte:Welche Person oder welches System übernimmt jeweils die nächste Aufgabe?
- Entscheidungen:Welche Bedingung führt zu welchem Weg, und wer entscheidet bei Unklarheit?
- Endzustände:Was bedeutet erledigt, abgelehnt, zurückgegeben oder ungeklärt?
- Ausnahmen:Was geschieht bei fehlenden Daten, ausbleibender Antwort oder technischem Fehler?
Eine Liste genügt, wenn sie eindeutig ist. Bei mehreren Abzweigungen kann eine einfache Skizze helfen. Der Zweck ist eine gemeinsame fachliche Beschreibung, keine vorweggenommene Konfiguration eines Produkts.
Bestehender vs. gewünschter Ablauf – Materialanforderung
- Aktueller Ablauf
- Manuelle Eingabe per E-Mail, mehrere Zwischenstufen, keine klare Zustandsverfolgung
- Gewünschter Ablauf
- Digitaler Workflow mit klaren Zuständen, automatischer Prüfung und Benachrichtigungen
Beispiel: eine Materialanforderung
Als hypothetischen Zielablauf könnte ein Team Folgendes festlegen:
Eine beschäftigte Person reicht eine Materialanforderung mit Artikel, Menge und Zweck ein. Fehlt eine dieser Angaben, geht die Anfrage zur Ergänzung zurück. Ist sie vollständig, erhält die zuständige Stelle den Vorgang zur Entscheidung. Bei Zustimmung wird der Status „freigegeben“ gesetzt und die anfragende Person benachrichtigt. Bei Ablehnung werden Ergebnis und Grund mitgeteilt. Bleibt die Entscheidung aus oder schlägt die Statusänderung fehl, bleibt der Vorgang sichtbar offen und geht an die benannte Betreuung.
Für die Umsetzung fehlen danach noch fachliche Festlegungen: Wer ist die zuständige Stelle? Welche Angaben darf sie ändern? Ab wann gilt eine Antwort als verspätet?
Welches System führt den Status verbindlich? Was geschieht, wenn die Entscheidung gespeichert ist, aber die Nachricht nicht ankommt? Diese Fragen müssen die Verantwortlichen klären; eine technische Plattform kann die Antworten nicht aus der Formulierung ableiten.
Übergänge prüfbar machen
Schreiben Sie zu jedem Schritt den vorherigen und den erlaubten nächsten Zustand. Eine Benachrichtigung soll erst auf eine gültige Entscheidung folgen. Ein fehlgeschlagener Versand soll die Entscheidung nicht in eine Ablehnung verwandeln. Legen Sie fest, wer einen steckengebliebenen Vorgang erkennt und was diese Person sehen muss, um ihn zu bearbeiten.
Lesen Sie die Beschreibung mit einem normalen Vorgang und einem Fall mit fehlenden Angaben durch. Ergänzen Sie einen Fall, in dem eine technische Aktion kein eindeutiges Ergebnis liefert. Fragen Sie bei jedem Fall, welcher Zustand erwartet wird und wer den nächsten Schritt kennt.
Wenn die Beteiligten dieselben Wege und Ergebnisse verstehen, lässt sich entscheiden, welche Schritte eine App, eine Integration oder eine Automatisierung übernehmen soll.
