Skip to content

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
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.