Modèle de document · be.communications.leave_balance
Solde des congés annuels (droit belge)
- Rendu vérifié
- Informatif
- Version 1.0.0
Employee communication templates: welcome letters, benefits summaries, salary indexation notifications, and year-end letters.
JSON Schema
Champs de ce modèle
Les données envoyées à l'API sont validées par le schéma JSON du modèle avant tout rendu. Ce modèle définit 46 champs :
| Champ | Obligatoire | Type | Description |
|---|---|---|---|
| letter | Obligatoire | object | |
| letter.place | Obligatoire | string | |
| letter.date | Obligatoire | date | |
| letter.language | Obligatoire | enum | |
| letter.reference | Optionnel | string | |
| employer | Obligatoire | object | |
| employer.name | Obligatoire | string | |
| employer.address | Obligatoire | string | |
| employer.bce_number | Obligatoire | string | |
| employer.onss_number | Obligatoire | string | |
| employer.joint_committee | Obligatoire | string | |
| employer.social_secretariat | Optionnel | string | |
| employee | Obligatoire | object | |
| employee.given_name | Obligatoire | string | |
| employee.surname | Obligatoire | string | |
| employee.employee_id | Obligatoire | string | |
| employee.function_title | Obligatoire | string | |
| employee.department | Optionnel | string | |
| employee.statut | Obligatoire | enum | |
| employee.start_date | Obligatoire | date | |
| employee.contract_type | Optionnel | enum | |
| employee.work_regime | Optionnel | string | Régime de travail: 'fulltime' ou fraction temps partiel (ex. '4/5'). |
| leave_year | Obligatoire | integer | Année de vacances (année de prise des congés). |
| reference_year | Optionnel | integer | Année de référence N-1 sur laquelle le droit est basé. |
| balance_date | Optionnel | date | Date à laquelle le solde est calculé (ex. 31.12 ou date de communication). |
| legal_leave | Obligatoire | object | |
| legal_leave.days_entitled | Obligatoire | number | Jours de congé légaux acquis (Loi 28.6.1971 / AR 30.3.1967). |
| legal_leave.days_taken | Obligatoire | number | Jours de congé légaux déjà pris dans l'année de vacances. |
| legal_leave.days_remaining | Obligatoire | number | Solde de jours de congé légaux restants. |
| legal_leave.carry_over_allowed | Optionnel | boolean | Report autorisé au-delà du 31.12 (uniquement si accord contractuel). |
+16 champs supplémentaires — le schéma JSON complet est disponible dans le tableau de bord et via l'API.
POST /render
Générez-le
Un seul appel POST /render : envoyez votre JSON, recevez le PDF final. Ou passez-vous du JSON et décrivez le document en langage naturel sur chut.app.
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": "fr"}
}' -o leave-balance.pdf Questions fréquentes
Qu'est-ce qu'un « Solde des congés annuels (droit belge) » ?
Employee communication templates: welcome letters, benefits summaries, salary indexation notifications, and year-end letters. Sur papii, ce document est disponible sous forme du modèle be.communications.leave_balance : un schéma JSON associé à un rendu PDF déterministe — les mêmes données produisent toujours le même document.
Puis-je générer un « Solde des congés annuels (droit belge) » avec l'IA ?
Oui. chut.app — le back-office IA propulsé par papii — remplit ce modèle à partir d'une description en langage naturel : vous décrivez le document en une phrase, l'IA structure les données, papii les valide contre le schéma et génère le PDF. Les développeurs peuvent aussi appeler directement l'API papii avec du JSON structuré.
Le modèle « Solde des congés annuels (droit belge) » est-il conforme juridiquement ?
Ce modèle est au rendu vérifié : son schéma, ses données d'exemple et sa sortie PDF sont testés automatiquement à chaque version. Il est publié avec le statut « ready », ce qui signifie qu'il n'a pas encore passé la revue juridique finale de papii. Lorsqu'il fait référence à une législation précise, celle-ci est indiquée dans la description du modèle — faites toujours vérifier par un professionnel les documents à portée juridique avant de vous y fier.