Modèle de document · generic.hr.reference_request
Reference Request
- Rendu vérifié
- Informatif
- Version 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
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 30 champs :
| Champ | Obligatoire | Type | Description |
|---|---|---|---|
| requesting_employer | Obligatoire | object | |
| requesting_employer.name | Obligatoire | string | |
| requesting_employer.address | Obligatoire | string | |
| requesting_employer.reference | Optionnel | string | |
| prior_employer | Obligatoire | object | |
| prior_employer.name | Obligatoire | string | |
| prior_employer.address | Obligatoire | string | |
| addressee | Obligatoire | object | |
| addressee.name | Obligatoire | string | |
| addressee.role | Optionnel | string | |
| candidate | Obligatoire | object | |
| candidate.name | Obligatoire | string | |
| candidate.date_of_birth | Obligatoire | date | |
| candidate.employee_id_at_prior | Optionnel | string | |
| candidate.role_at_prior | Obligatoire | string | |
| candidate.employment_start | Obligatoire | date | |
| candidate.employment_end | Obligatoire | date | |
| role_being_filled | Obligatoire | object | |
| role_being_filled.title | Obligatoire | string | |
| role_being_filled.department | Optionnel | string | |
| consent | Obligatoire | object | |
| consent.signed_on | Obligatoire | date | |
| letter_date | Obligatoire | date | |
| questions | Obligatoire | array of string | |
| response_deadline | Obligatoire | date | |
| requester | Obligatoire | object | |
| requester.name | Obligatoire | string | |
| requester.role | Obligatoire | string | |
| requester.email | Obligatoire | string | |
| requester.phone | Optionnel | string |
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 -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": "fr"}
}' -o reference-request.pdf Questions fréquentes
Qu'est-ce qu'un « 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. Sur papii, ce document est disponible sous forme du modèle generic.hr.reference_request : 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 « Reference Request » 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 « Reference Request » 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.