Skip to content
papii

Documentsjabloon · be.communications.benefits_summary

Jaarlijks overzicht van de voordelen — Belgisch recht

  • Rendering geverifieerd
  • Officieel document
  • 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 40 velden:

Veld Verplicht Type Beschrijving
letter Verplicht object
letter.place Verplicht string
letter.date Verplicht date
letter.language Verplicht enum
letter.reference Optioneel string
employer Verplicht object
employer.name Verplicht string
employer.address Verplicht string
employer.bce_number Verplicht string Numéro BCE/KBO (format 0xxx.xxx.xxx).
employer.vat_number Optioneel string Numéro TVA/BTW (format BE0xxxxxxxxx).
employer.onss_number Verplicht string Numéro ONSS/RSZ.
employer.joint_committee Verplicht string CP / PC numéro et libellé.
employer.social_secretariat Optioneel string
employee Verplicht object
employee.given_name Verplicht string
employee.surname Verplicht string
employee.employee_id Verplicht string
employee.function_title Verplicht string
employee.department Optioneel string
employee.start_date Verplicht date
employee.statut Optioneel enum
reference_year Verplicht integer Année de référence du récapitulatif (ex. 2025).
gross_annual_salary Optioneel number Salaire annuel brut de base (hors avantages extralégaux), en EUR.
benefit_lines Verplicht array of object
benefit_lines[].category Verplicht string Catégorie de l'avantage (ex. 'Pension', 'Santé', 'Alimentation', 'Mobilité', 'Formation', 'Flexibilité').
benefit_lines[].name Verplicht string
benefit_lines[].description Optioneel string
benefit_lines[].employer_annual_eur Verplicht number Contribution annuelle employeur en EUR.
benefit_lines[].employee_annual_eur Optioneel number Contribution annuelle travailleur en EUR (retenue salariale le cas échéant).
benefit_lines[].total_annual_eur Optioneel number Valeur totale annuelle de l'avantage en EUR.

+10 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.benefits_summary",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o benefits-summary.pdf
Genereren met AI op chut.app Proberen in het dashboard

Veelgestelde vragen

Wat is een “Jaarlijks overzicht van de voordelen — Belgisch recht”?

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

Kan ik een “Jaarlijks overzicht van de voordelen — Belgisch recht” 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 “Jaarlijks overzicht van de voordelen — Belgisch recht” 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.