Skip to content
papii

Documentsjabloon · be.communications.yearend_letter

Eindejaarsbrief

  • Rendering geverifieerd
  • Informatief
  • Versie 1.0.0

Employee communication templates: welcome letters, benefits summaries, salary indexation notifications, and year-end letters.

JSON Schema

Velden in dit sjabloon

Data die naar de API wordt gestuurd, wordt gevalideerd tegen het JSON-schema van het sjabloon vóór er iets wordt gerenderd. Dit sjabloon definieert 53 velden:

Veld Verplicht Type Beschrijving
letter Verplicht object
letter.place Verplicht string
letter.date Verplicht date
letter.reference_year Verplicht integer
letter.language Verplicht enum
letter.reference Optioneel string
employer Verplicht object
employer.name Verplicht string
employer.address Optioneel string
employer.bce_number Verplicht string
employer.vat_number Optioneel string
employer.onss_number Verplicht string
employer.joint_committee Verplicht string
employer.social_secretariat Optioneel string
employer.represented_by Optioneel string
employee Verplicht object
employee.given_name Verplicht string
employee.surname Verplicht string
employee.address Optioneel string
employee.function_title Verplicht string
employee.department Optioneel string
employee.start_date Verplicht date Date of entry into service (for prorata calculation).
employee.employee_number Optioneel string
employee.statut Optioneel enum
yearend_premium Verplicht object Year-end premium or 13th month details.
yearend_premium.premium_type Verplicht enum Legal type of the year-end payment.
yearend_premium.gross_amount_eur Verplicht number
yearend_premium.onss_employee_eur Verplicht number Employee ONSS/RSZ deduction (standard 13.07% or special CCT 90 rate).
yearend_premium.withholding_tax_eur Optioneel number Withholding tax (précompte professionnel) deducted at source.
yearend_premium.net_amount_eur Verplicht number

+23 extra velden — het volledige JSON-schema is beschikbaar in het dashboard en via de API.

POST /render

Genereer het

Eén POST /render-oproep: stuur je JSON, ontvang de afgewerkte PDF. Of sla de JSON over en beschrijf het document in gewone taal op chut.app.

curl 
curl -X POST https://api.papii.eu/render \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "be.communications.yearend_letter",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o yearend-letter.pdf
Genereren met AI op chut.app Proberen in het dashboard

Veelgestelde vragen

Wat is een “Eindejaarsbrief”?

Employee communication templates: welcome letters, benefits summaries, salary indexation notifications, and year-end letters. Op papii is dit document beschikbaar als sjabloon be.communications.yearend_letter: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Eindejaarsbrief” genereren met AI?

Ja. chut.app — de AI-backoffice aangedreven door papii — vult dit sjabloon in op basis van een beschrijving in gewone taal: jij beschrijft het document in één zin, de AI structureert de data, papii valideert die tegen het schema en rendert de PDF. Ontwikkelaars kunnen de papii-API ook rechtstreeks aanroepen met gestructureerde JSON.

Is het sjabloon “Eindejaarsbrief” juridisch conform?

Dit sjabloon heeft een geverifieerde rendering: het schema, de voorbeelddata en de PDF-uitvoer worden bij elke release automatisch getest. Het is gepubliceerd met status “ready”, wat betekent dat het de finale juridische review van papii nog niet heeft doorlopen. Waar het naar specifieke wetgeving verwijst, staat dat vermeld in de sjabloonbeschrijving — laat documenten met juridische gevolgen altijd door een professional nakijken voor je erop vertrouwt.