Valtimo Technical Reference

Use this page for implementation details. For configuration by administrators, start with Configuration.

Plugin instance

A Valtimo environment needs an Epistola plugin instance with the Suite base URL, tenant or environment settings, and credentials for the integration identity.

Use separate credentials per environment where possible. This keeps testing, acceptance, and production authorization auditable.

Action configuration

The document generation action identifies the Epistola template, target environment, output handling, data mapping, and where the result should be stored in the process context.

Result object

Generated document results should be handled as structured data. Store the document identifier, filename, status, and any job or review path needed by later process steps.

Events and errors

Model success and failure explicitly in the process. A failed generation should not disappear into a generic technical incident if a user can correct the input and retry.