1.0.0Epistola 1.0 is nu algemeen beschikbaar.
In ontwikkeling — Het Leren-gedeelte wordt uitgebreid; alfa-, beta- en previewmogelijkheden worden waar relevant gelabeld.
← Terug naar Documentatie

Datacontract Referentie

Technische uitleg over verwachte documentdata, validatie en voorbeeldpayloads.

Datacontract referentie

Verwachte data beschrijft welke velden een template nodig heeft voordat een document kan worden gegenereerd. De gebruikersuitleg staat in Verwachte data.

Contractformaat

De Suite bewaart het verwachte datamodel als JSON Schema. Gebruik dit om veldnamen, verplichte waarden, geneste objecten, lijsten en validatieregels te beschrijven.

Houd veldnamen stabiel zodra gekoppelde systemen ervan afhankelijk zijn. Als de betekenis verandert, voeg dan een nieuw veld toe of maak een versieerbaar migratiepad.

Voorbeelden

Onderhoud voorbeelden naast het contract. Ze worden gebruikt door template-editors, reviewers, previews en integratietests.

Goede voorbeelden bevatten:

  • Een normale succesvolle zaak.
  • Een zaak waarin optionele velden ontbreken.
  • Grenswaarden die vaak opmaak of juridische tekst wijzigen.

Validatieverantwoordelijkheid

Epistola kan valideren of verplichte data aanwezig en structureel correct is. Het bronsysteem blijft verantwoordelijk voor functionele juistheid: of de zaakwaarde de juiste waarde voor het document is.