Skip to content
papii

Document template · be.communications.leave_balance

Annual Leave Balance Statement (BE)

  • Render-verified
  • Informational
  • Version 1.0.0

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

JSON Schema

Fields in this template

Data sent to the API is validated against the template’s JSON Schema before anything is rendered. This template defines 46 fields:

Field Required Type Description
letter Required object
letter.place Required string
letter.date Required date
letter.language Required enum
letter.reference Optional string
employer Required object
employer.name Required string
employer.address Required string
employer.bce_number Required string
employer.onss_number Required string
employer.joint_committee Required string
employer.social_secretariat Optional string
employee Required object
employee.given_name Required string
employee.surname Required string
employee.employee_id Required string
employee.function_title Required string
employee.department Optional string
employee.statut Required enum
employee.start_date Required date
employee.contract_type Optional enum
employee.work_regime Optional string Régime de travail: 'fulltime' ou fraction temps partiel (ex. '4/5').
leave_year Required integer Année de vacances (année de prise des congés).
reference_year Optional integer Année de référence N-1 sur laquelle le droit est basé.
balance_date Optional date Date à laquelle le solde est calculé (ex. 31.12 ou date de communication).
legal_leave Required object
legal_leave.days_entitled Required number Jours de congé légaux acquis (Loi 28.6.1971 / AR 30.3.1967).
legal_leave.days_taken Required number Jours de congé légaux déjà pris dans l'année de vacances.
legal_leave.days_remaining Required number Solde de jours de congé légaux restants.
legal_leave.carry_over_allowed Optional boolean Report autorisé au-delà du 31.12 (uniquement si accord contractuel).

+16 more fields — the full JSON Schema is available in the dashboard and via the API.

POST /render

Generate it

One POST /render call: send your JSON, get the finished PDF back. Or skip the JSON entirely and describe the document in plain language on 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": "en"}
  }' -o leave-balance.pdf
Generate with AI on chut.app Try in the dashboard

Frequently asked questions

What is “Annual Leave Balance Statement (BE)”?

Employee communication templates: welcome letters, benefits summaries, salary indexation notifications, and year-end letters. On papii this document is available as template be.communications.leave_balance: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Annual Leave Balance Statement (BE) with AI?

Yes. chut.app — the AI back office papii powers — fills this template from a plain-language description: you describe the document in one sentence, the AI structures the data, papii validates it against the schema and renders the PDF. Developers can also call the papii API directly with structured JSON.

Is the Annual Leave Balance Statement (BE) template legally compliant?

This template is render-verified: its schema, sample data and PDF output are automatically tested on every release. It is published with status “ready”, meaning it has not yet been through papii’s final legal review. Where it references specific legislation, that is stated in the template description — always have a professional check documents with legal effect before relying on them.