Skip to content
papii

Modèle de document · be.communications.benefits_summary

Récapitulatif annuel des avantages — droit belge

  • Rendu vérifié
  • Document officiel
  • 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 40 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 Numéro BCE/KBO (format 0xxx.xxx.xxx).
employer.vat_number Optionnel string Numéro TVA/BTW (format BE0xxxxxxxxx).
employer.onss_number Obligatoire string Numéro ONSS/RSZ.
employer.joint_committee Obligatoire string CP / PC numéro et libellé.
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.start_date Obligatoire date
employee.statut Optionnel enum
reference_year Obligatoire integer Année de référence du récapitulatif (ex. 2025).
gross_annual_salary Optionnel number Salaire annuel brut de base (hors avantages extralégaux), en EUR.
benefit_lines Obligatoire array of object
benefit_lines[].category Obligatoire string Catégorie de l'avantage (ex. 'Pension', 'Santé', 'Alimentation', 'Mobilité', 'Formation', 'Flexibilité').
benefit_lines[].name Obligatoire string
benefit_lines[].description Optionnel string
benefit_lines[].employer_annual_eur Obligatoire number Contribution annuelle employeur en EUR.
benefit_lines[].employee_annual_eur Optionnel number Contribution annuelle travailleur en EUR (retenue salariale le cas échéant).
benefit_lines[].total_annual_eur Optionnel number Valeur totale annuelle de l'avantage en EUR.

+10 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.benefits_summary",
    "data": { ... },
    "options": {"language": "fr"}
  }' -o benefits-summary.pdf
Générer avec l'IA sur chut.app Essayer dans le tableau de bord

Questions fréquentes

Qu'est-ce qu'un « Récapitulatif annuel des avantages — 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.benefits_summary : 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 « Récapitulatif annuel des avantages — 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 « Récapitulatif annuel des avantages — 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.