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.