Skip to content

Document template · be.communications.welcome_letter

Welcome Letter — New Employee (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 53 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.vat_number Optional string
employer.onss_number Required string
employer.joint_committee Required string
employer.social_secretariat Optional string
employer.hr_contact_name Optional string
employer.hr_contact_email Optional string
employer.hr_contact_phone Optional string
employee Required object
employee.given_name Required string
employee.surname Required string
employee.address Optional string
employee.national_register_number Optional string
employment Required object
employment.function_title Required string
employment.department Optional string
employment.start_date Required date
employment.workplace_address Required string
employment.contract_type Required enum
employment.work_regime Optional string
employment.manager_name Optional string
employment.manager_title Optional string

+23 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.welcome_letter",
    "data": { ... },
    "options": {"language": "en"}
  }' -o welcome-letter.pdf

Frequently asked questions

What is “Welcome Letter — New Employee (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.welcome_letter: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Welcome Letter — New Employee (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 Welcome Letter — New Employee (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.