Skip to content
papii

Modèle de document · be.communications.yearend_letter

Lettre de fin d'année

  • 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 53 champs :

Champ Obligatoire Type Description
letter Obligatoire object
letter.place Obligatoire string
letter.date Obligatoire date
letter.reference_year Obligatoire integer
letter.language Obligatoire enum
letter.reference Optionnel string
employer Obligatoire object
employer.name Obligatoire string
employer.address Optionnel string
employer.bce_number Obligatoire string
employer.vat_number Optionnel string
employer.onss_number Obligatoire string
employer.joint_committee Obligatoire string
employer.social_secretariat Optionnel string
employer.represented_by Optionnel string
employee Obligatoire object
employee.given_name Obligatoire string
employee.surname Obligatoire string
employee.address Optionnel string
employee.function_title Obligatoire string
employee.department Optionnel string
employee.start_date Obligatoire date Date of entry into service (for prorata calculation).
employee.employee_number Optionnel string
employee.statut Optionnel enum
yearend_premium Obligatoire object Year-end premium or 13th month details.
yearend_premium.premium_type Obligatoire enum Legal type of the year-end payment.
yearend_premium.gross_amount_eur Obligatoire number
yearend_premium.onss_employee_eur Obligatoire number Employee ONSS/RSZ deduction (standard 13.07% or special CCT 90 rate).
yearend_premium.withholding_tax_eur Optionnel number Withholding tax (précompte professionnel) deducted at source.
yearend_premium.net_amount_eur Obligatoire number

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

Questions fréquentes

Qu'est-ce qu'un « Lettre de fin d'année » ?

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.yearend_letter : 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 « Lettre de fin d'année » 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 « Lettre de fin d'année » 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.