Documentsjabloon · eu.employment.secondment_letter
Detacheringsbrief
- Rendering geverifieerd
- Juridisch gevoelig
- Versie 1.0.0
Inter-company cross-border secondment letter between a sending employer established in one EU Member State and a host entity established in another. Implements the information obligations of Directive 96/71/EC Art. 3 (core terms and conditions of employment that must be guaranteed in the host Member State) and identifies the applicable social-security regime under Reg. (EC) 883/2004 Art. 12(1) (typically evidenced by Portable Document A1).
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 56 velden:
| Veld | Verplicht | Type | Beschrijving |
|---|---|---|---|
| letter_date | Verplicht | date | Date the secondment letter is issued to the secondee. |
| letter_reference | Verplicht | string | Sending employer's internal reference for this secondment letter. |
| sending_employer | Verplicht | object | Employer established in the sending Member State with whom the underlying employment contract is and remains in force. |
| host_entity | Verplicht | object | Group undertaking or host entity in the host Member State to which the secondee is posted (Art. 1(3)(b) Directive 96/71/EC). |
| secondee | Verplicht | object | |
| secondee.family_name | Verplicht | string | |
| secondee.given_name | Verplicht | string | |
| secondee.date_of_birth | Verplicht | date | |
| secondee.nationality | Verplicht | string | ISO 3166-1 alpha-2 nationality code. |
| secondee.personal_identifier | Verplicht | string | National ID or social-security number in the sending Member State. |
| secondee.home_address | Verplicht | string | |
| secondee.current_role | Verplicht | string | |
| secondee.employment_start_date | Verplicht | date | Start date of the underlying employment contract with the sending employer. |
| secondment | Verplicht | object | |
| secondment.purpose | Verplicht | enum | Business purpose of the secondment. |
| secondment.purpose_detail | Optioneel | string | Free-text elaboration of the purpose, e.g. specific project name. |
| secondment.host_role | Verplicht | string | Role title the secondee will hold at the host entity during the secondment. |
| secondment.work_location | Verplicht | string | Primary place of work in the host Member State (Art. 1(3)(a) Directive 96/71/EC). |
| secondment.start_date | Verplicht | date | |
| secondment.end_date | Verplicht | date | Scheduled end date of the secondment. Posting duration is relevant for Art. 3(1a) Directive 96/71/EC (additional host-state rules after 12… |
| secondment.reports_to | Verplicht | string | Name / role of the line manager at the host entity for day-to-day supervision. The employment relationship with the sending employer is pre… |
| secondment.working_hours | Verplicht | string | Weekly working time during the secondment — must respect the host Member State's working-time rules per Art. 3(1)(a) Directive 96/71/EC. |
| secondment.extended_posting_notified | Optioneel | boolean | Whether the sending employer has notified the host authorities to extend the initial 12-month application of host-country rules to 18 month… |
| remuneration | Verplicht | object | Remuneration package — the equal-pay principle of Art. 3(1)(c) Directive 96/71/EC as amended by 2018/957 applies: the secondee must receive… |
| remuneration.base_salary_amount | Verplicht | number | |
| remuneration.base_salary_currency | Verplicht | string | |
| remuneration.payment_frequency | Verplicht | enum | Pay cycle. |
| remuneration.paying_entity | Verplicht | enum | Which payroll disburses the salary. Typically the sending employer retains payroll for Art. 12(1) Reg. 883/2004 postings. |
| remuneration.expat_allowance_amount | Verplicht | number | |
| remuneration.expat_allowance_currency | Verplicht | string |
+26 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 -X POST https://api.papii.eu/render \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"template": "eu.employment.secondment_letter",
"data": { ... },
"options": {"language": "nl"}
}' -o secondment-letter.pdf Veelgestelde vragen
Wat is een “Detacheringsbrief”?
Inter-company cross-border secondment letter between a sending employer established in one EU Member State and a host entity established in another. Implements the information obligations of Directive 96/71/EC Art. 3 (core terms and conditions of employment that must be guaranteed in the host Member State) and identifies the applicable social-security regime under Reg. (EC) 883/2004 Art. 12(1) (typically evidenced by Portable Document A1). Op papii is dit document beschikbaar als sjabloon eu.employment.secondment_letter: een JSON-schema plus een deterministische PDF-renderer — dezelfde data levert altijd hetzelfde document op.
Kan ik een “Detacheringsbrief” 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 “Detacheringsbrief” 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.