Skip to content
papii

Documentsjabloon · generic.hr.promotion_letter

Promotion Letter

  • Rendering geverifieerd
  • Juridisch gevoelig
  • Versie 1.0.0

Formal addendum to an existing employment contract confirming a promotion: new title, reporting line, grade, responsibilities and updated compensation, effective from a stated date.

JSON Schema

Velden in dit sjabloon

Data die naar de API wordt gestuurd, wordt gevalideerd tegen het JSON-schema van het sjabloon vóór er iets wordt gerenderd. Dit sjabloon definieert 31 velden:

Veld Verplicht Type Beschrijving
employer Verplicht object
employer.name Verplicht string
employer.address Verplicht string
employer.reference Optioneel string
employee Verplicht object
employee.name Verplicht string
employee.address Verplicht string
letter_date Verplicht date
effective_date Verplicht date
previous_role Verplicht object
previous_role.title Verplicht string
previous_role.department Verplicht string
previous_role.reports_to Verplicht string
previous_role.grade Optioneel string
new_role Verplicht object
new_role.title Verplicht string
new_role.department Verplicht string
new_role.reports_to Verplicht string
new_role.grade Optioneel string
new_role.responsibilities Verplicht array of string
compensation Verplicht object
compensation.previous_gross Verplicht number
compensation.new_gross Verplicht number
compensation.salary_period Verplicht string
compensation.bonus_target_previous_pct Optioneel number
compensation.bonus_target_new_pct Optioneel number
compensation.new_benefits Optioneel array of string
reason_for_promotion Optioneel string
signatory Verplicht object
signatory.name Verplicht string

+1 extra velden — het volledige JSON-schema is beschikbaar in het dashboard en via de API.

POST /render

Genereer het

Eén POST /render-oproep: stuur je JSON, ontvang de afgewerkte PDF. Of sla de JSON over en beschrijf het document in gewone taal op 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": "generic.hr.promotion_letter",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o promotion-letter.pdf
Genereren met AI op chut.app Proberen in het dashboard

Veelgestelde vragen

Wat is een “Promotion Letter”?

Formal addendum to an existing employment contract confirming a promotion: new title, reporting line, grade, responsibilities and updated compensation, effective from a stated date. Op papii is dit document beschikbaar als sjabloon generic.hr.promotion_letter: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Promotion Letter” genereren met AI?

Ja. chut.app — de AI-backoffice aangedreven door papii — vult dit sjabloon in op basis van een beschrijving in gewone taal: jij beschrijft het document in één zin, de AI structureert de data, papii valideert die tegen het schema en rendert de PDF. Ontwikkelaars kunnen de papii-API ook rechtstreeks aanroepen met gestructureerde JSON.

Is het sjabloon “Promotion Letter” juridisch conform?

Dit sjabloon heeft een geverifieerde rendering: het schema, de voorbeelddata en de PDF-uitvoer worden bij elke release automatisch getest. Het is gepubliceerd met status “ready”, wat betekent dat het de finale juridische review van papii nog niet heeft doorlopen. Waar het naar specifieke wetgeving verwijst, staat dat vermeld in de sjabloonbeschrijving — laat documenten met juridische gevolgen altijd door een professional nakijken voor je erop vertrouwt.