1.0.0Epistola 1.0 is nu algemeen beschikbaar.

/ Stabiele integratie

Geavanceerde documentgeneratie binnen workflows van Valtimo en GZAC.

GZAC is een implementatie van Valtimo en gebruikt dezelfde Epistola-plugin. Zaakafhandeling blijft in het workflowplatform, terwijl Epistola templates, datacontracten en rendering beheert.

Geavanceerd← Terug naar integraties

/ Heldere verantwoordelijkheden

Houd elke verantwoordelijkheid in het systeem dat er eigenaar van is.

De plugin verbindt de workflow- en documentlaag zonder zaaklogica naar Epistola te verplaatsen.

Valtimo / GZAC beheert de zaak

Het workflowplatform verzamelt zaakdata, bepaalt wanneer een document nodig is, handelt ZGW API's af en slaat het resultaat op of toont het.

Epistola beheert het document

Epistola beheert geavanceerde templates en datacontracten, valideert de aangeleverde data en rendert het gevraagde document.

/ Architectuurflow

Van zaakdata naar document — bekijk de pluginflow.

Valtimo of GZAC orkestreert de zaak en de ZGW-koppelingen, terwijl Epistola het document genereert. Doorloop de stappen om de verantwoordelijkheidsgrens te bekijken.

1

Medewerker start proces

Caseworker → Zaakafhandelsysteem

Een medewerker start een zaakproces in het zaakafhandelsysteem — bijvoorbeeld het behandelen van een bezwaar.

2

Zaakdata verzamelen

Zaakafhandelsysteem → Data Source

GET/zaken/BZ-2024-001/eigenschappen
{ "zaaktype": "bezwaar", "eigenschappen": [...] }

Het zaakafhandelsysteem verzamelt zaakdata uit het ZRC, ZTC en andere geconfigureerde databronnen.

3

Documentgeneratie aanvragen

Zaakafhandelsysteem → Epistola

POST/api/v1/documents/generate
{ "templateId": "bezwaar-v2", "data": { "zaak": "BZ-2024-001", ... } }

De plugin stuurt een generatieverzoek naar Epistola met het opgeloste template en alle variabelendata.

4

Document renderen en opslaan

Epistola → Temporary Storage

PUT/documents/gen-48291.pdf
{ "contentType": "application/pdf", "size": "142KB" }

Epistola rendert het template met de aangeleverde data en slaat de resulterende PDF op in tijdelijke opslag.

5

Wachten op generatie

Zaakafhandelsysteem → Epistola

GET/api/v1/jobs/gen-48291
{ "status": "completed", "resourceUrl": "/tmp-storage/gen-48291.pdf" }

De Valtimo-plugin volgt de Epistola-generatiejob totdat het document gereed is of de job een fout meldt.

6

Document ophalen

Zaakafhandelsysteem → Temporary Storage

GET/tmp-storage/gen-48291.pdf
{ "format": "application/pdf", "bytes": 145291 }

Het zaakafhandelsysteem downloadt de afgeronde PDF vanaf de resultaatlocatie van Epistola.

7

Registreren in Documenten API

Zaakafhandelsysteem → DRC

POST/enkelvoudiginformatieobjecten
{ "titel": "Besluit op bezwaar", "informatieobjecttype": "besluit" }

Het zaakafhandelsysteem slaat de PDF op in de Documenten API (DRC) en koppelt deze voor archivering aan de oorspronkelijke zaak.

8

Document beschikbaar

Zaakafhandelsysteem → Caseworker

De behandelaar kan het gegenereerde document nu vanuit het zaakafhandelsysteem bekijken en downloaden.

Stap 1 / 8

/ Pluginconfiguratie

Van templatecontract naar zaakdocument in drie stappen.

01

Bereid het documentcontract voor

Publiceer de Epistola-template en leg vast welke data de velden vanuit de zaakworkflow verwachten.

02

Configureer de plugin

Koppel Valtimo of GZAC aan Epistola en map zaakinformatie naar het datacontract van de template.

03

Genereer en verwerk het resultaat

Genereer, preview en probeer indien nodig opnieuw, waarna de workflow het afgeronde document opslaat of toont.

/ Pluginmogelijkheden

De volledige documentstap in uw zaakworkflow.

  • Selecteer een gepubliceerde Epistola-template vanuit een proces.
  • Map zaakdata naar het datacontract van de template.
  • Preview en beoordeel een document vóór de definitieve generatie.
  • Wacht op generatie en handel succes-, fout- en retrypaden af.
  • Geef het gegenereerde document terug aan de zaakworkflow voor opslag of gebruik.

/ Volgende stap

Geïnteresseerd in wat Epistola voor uw product kan betekenen?

Plan een gesprek en stel al uw vragen.