De happy path is maar een deel van de workflow

API’s zijn tijdelijk onbereikbaar, data ontbreekt en gebruikers voeren onverwachte waarden in. Een workflow moet deze situaties als normale systeemtoestanden behandelen.

Begin met foutcategorieën. Een tijdelijke netwerkfout is iets anders dan ongeldige klantdata of een geweigerde autorisatie. De eerste kan vaak veilig met backoff opnieuw geprobeerd worden; de tweede vraagt correctie; de derde kan een security- of configuratieprobleem zijn. Eén generieke “retry alles”-strategie maakt workflows juist gevaarlijker.

Kies per fout tussen retry, stop of escalatie

Een tijdelijke netwerkfout kan opnieuw geprobeerd worden. Ongeldige data vraagt meestal menselijke correctie. Een kritieke fout kan de volledige flow veilig moeten stoppen.

Bewaar voldoende context voor herstel. Als een flow halverwege stopt, wil je weten welk record, welke stap en welke externe actie al uitgevoerd zijn. Zonder die status kan een handmatige retry onbedoeld dubbele mails, records of betalingen veroorzaken. Foutafhandeling en idempotency horen daarom samen ontworpen te worden.

Fouten moeten zichtbaar en traceerbaar zijn

Logging, foutcontext en een duidelijke eigenaar voorkomen dat stille automationfouten dagenlang onopgemerkt blijven.

Maak tenslotte eigenaarschap expliciet. Welke fouten mogen automatisch herstellen, welke worden een ticket en wie krijgt de alert? Een workflow is pas operationeel wanneer iemand weet wat te doen zodra de happy path stopt. Anders wordt automation vooral een manier om fouten minder zichtbaar te maken.