Skip to content
papii

Document template · eu.employment.secondment_letter

Secondment Letter

  • Render-verified
  • Legal-sensitive
  • Version 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

Fields in this template

Data sent to the API is validated against the template’s JSON Schema before anything is rendered. This template defines 56 fields:

Field Required Type Description
letter_date Required date Date the secondment letter is issued to the secondee.
letter_reference Required string Sending employer's internal reference for this secondment letter.
sending_employer Required object Employer established in the sending Member State with whom the underlying employment contract is and remains in force.
host_entity Required 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 Required object
secondee.family_name Required string
secondee.given_name Required string
secondee.date_of_birth Required date
secondee.nationality Required string ISO 3166-1 alpha-2 nationality code.
secondee.personal_identifier Required string National ID or social-security number in the sending Member State.
secondee.home_address Required string
secondee.current_role Required string
secondee.employment_start_date Required date Start date of the underlying employment contract with the sending employer.
secondment Required object
secondment.purpose Required enum Business purpose of the secondment.
secondment.purpose_detail Optional string Free-text elaboration of the purpose, e.g. specific project name.
secondment.host_role Required string Role title the secondee will hold at the host entity during the secondment.
secondment.work_location Required string Primary place of work in the host Member State (Art. 1(3)(a) Directive 96/71/EC).
secondment.start_date Required date
secondment.end_date Required 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 Required 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 Required 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 Optional 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 Required 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 Required number
remuneration.base_salary_currency Required string
remuneration.payment_frequency Required enum Pay cycle.
remuneration.paying_entity Required enum Which payroll disburses the salary. Typically the sending employer retains payroll for Art. 12(1) Reg. 883/2004 postings.
remuneration.expat_allowance_amount Required number
remuneration.expat_allowance_currency Required string

+26 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": "eu.employment.secondment_letter",
    "data": { ... },
    "options": {"language": "en"}
  }' -o secondment-letter.pdf
Generate with AI on chut.app Try in the dashboard

Frequently asked questions

What is “Secondment Letter”?

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). On papii this document is available as template eu.employment.secondment_letter: a JSON Schema plus a deterministic PDF renderer, so the same data always produces the same document.

Can I generate a Secondment Letter 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 Secondment Letter 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.