Skip to content

Documentsjabloon · generic.hr.reference_request

Reference Request

  • Rendering geverifieerd
  • Informatief
  • Versie 1.0.0

Formal written request to a prior employer seeking a professional reference about a job candidate. Includes explicit candidate-consent statement and GDPR-aligned processing note.

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 30 velden:

Veld Verplicht Type Beschrijving
requesting_employer Verplicht object
requesting_employer.name Verplicht string
requesting_employer.address Verplicht string
requesting_employer.reference Optioneel string
prior_employer Verplicht object
prior_employer.name Verplicht string
prior_employer.address Verplicht string
addressee Verplicht object
addressee.name Verplicht string
addressee.role Optioneel string
candidate Verplicht object
candidate.name Verplicht string
candidate.date_of_birth Verplicht date
candidate.employee_id_at_prior Optioneel string
candidate.role_at_prior Verplicht string
candidate.employment_start Verplicht date
candidate.employment_end Verplicht date
role_being_filled Verplicht object
role_being_filled.title Verplicht string
role_being_filled.department Optioneel string
consent Verplicht object
consent.signed_on Verplicht date
letter_date Verplicht date
questions Verplicht array of string
response_deadline Verplicht date
requester Verplicht object
requester.name Verplicht string
requester.role Verplicht string
requester.email Verplicht string
requester.phone Optioneel string

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.reference_request",
    "data": { ... },
    "options": {"language": "nl"}
  }' -o reference-request.pdf

Veelgestelde vragen

Wat is een “Reference Request”?

Formal written request to a prior employer seeking a professional reference about a job candidate. Includes explicit candidate-consent statement and GDPR-aligned processing note. Op papii is dit document beschikbaar als sjabloon generic.hr.reference_request: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.

Kan ik een “Reference Request” 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 “Reference Request” 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.