Valtimo Plugin Overview
What the Valtimo Epistola plugin is and how it connects GZAC/Valtimo to Epistola.
What is the Valtimo Epistola Plugin?
The Valtimo Epistola Plugin connects Valtimo (GZAC) case management to Epistola document generation. It lets process designers add document generation directly into BPMN workflows — no custom code required.
What it provides
The plugin adds three BPMN service task actions to Valtimo:
- Generate Document — submit an async document generation request to Epistola
- Check Job Status — poll the status of a generation job
- Download Document — retrieve the completed PDF
These actions can be composed in any BPMN process to generate documents at the right point in a case workflow.
How it works
- A process designer configures the plugin with the Epistola API endpoint and credentials
- BPMN service tasks use the plugin actions to trigger generation
- Case data is mapped to template fields using value resolvers
- Documents are generated asynchronously and correlated back to the waiting process
- The completed document can be downloaded, stored, or forwarded
Related documentation
- Configuration — set up the plugin connection
- Document Generation Action — configure the main BPMN action
- Data Mapping — map case data to template fields
- Async Patterns & BPMN — recommended process patterns