Skip to content
papii

Documentsjabloon · be.communications.leave_balance

Saldo jaarlijkse vakantie (Belgisch recht)

  • 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 46 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
employer.onss_number Verplicht string
employer.joint_committee Verplicht string
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.statut Verplicht enum
employee.start_date Verplicht date
employee.contract_type Optioneel enum
employee.work_regime Optioneel string Régime de travail: 'fulltime' ou fraction temps partiel (ex. '4/5').
leave_year Verplicht integer Année de vacances (année de prise des congés).
reference_year Optioneel integer Année de référence N-1 sur laquelle le droit est basé.
balance_date Optioneel date Date à laquelle le solde est calculé (ex. 31.12 ou date de communication).
legal_leave Verplicht object
legal_leave.days_entitled Verplicht number Jours de congé légaux acquis (Loi 28.6.1971 / AR 30.3.1967).
legal_leave.days_taken Verplicht number Jours de congé légaux déjà pris dans l'année de vacances.
legal_leave.days_remaining Verplicht number Solde de jours de congé légaux restants.
legal_leave.carry_over_allowed Optioneel boolean Report autorisé au-delà du 31.12 (uniquement si accord contractuel).

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

Veelgestelde vragen

Wat is een “Saldo jaarlijkse vakantie (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.leave_balance: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Saldo jaarlijkse vakantie (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 “Saldo jaarlijkse vakantie (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.