1.0.0Epistola 1.0 is now generally available.
Work in progress — The Learn section is being expanded; alpha, beta, and preview capabilities are labelled where relevant.
← Back to Learn

Handle results and errors

Wait for the PDF, send successful documents to review, and give users a clear retry path when generation fails.

integrationoperations

Video planned

45-second recording: show generation, wait, success/failure routing, download, and retry.

Handle generation results

After Valtimo starts document generation, the case should wait until Epistola has finished the PDF.

  1. Start document generation.
  2. Wait for the completion signal.
  3. If generation succeeded, download the PDF.
  4. If generation failed, show the error and route to a retry or manual review step.
  5. Store or send the document only after a successful download.

What users should see

Users should not see technical job details. Show whether the document is waiting, ready, failed, or needs correction. If correction is possible, send the user to a retry form with the fields they can fix.

Developer note

The Valtimo plugin stores the technical result state for the workflow. Modelers usually only need the success, failure, and retry paths.