create-employee-from-contract

name	create_employee_from_contract
tier	3
task	T19
description	This skill creates an employee from a PDF EMPLOYMENT CONTRACT (arbeidskontrakt) with FULL details including national identity number (personnummer), STYRK occupation code (stillingskode), email, bank account, salary type, and department. Use this when the prompt mentions "personnummer", "stillingskode", "numéro d'identité", "código de profesión", "Personalausweisnummer". Do NOT use for offer letters (tilbudsbrev) — those have fewer fields and need standard working hours instead. Keywords include "employment contract", "arbeidskontrakt", "contrat de travail", "Arbeitsvertrag", "contrato de trabajo", "contrato de trabalho".

Create Employee from PDF Contract

6 API calls.

Step 1: Read the PDF and find these 13 fields

#	Look for	Example value
1	First name (arbeidstaker)	William
2	Last name	Johnson
3	Date of birth (fødselsdato)	20.02.1990
4	National ID (personnummer)	20029047368
5	Email (e-post)	[e-mail]
6	Bank account (bankkonto)	64387484939
7	Department (avdeling)	Markedsføring
8	STYRK code (stillingskode)	3323
9	Employment form (ansettelsesform)	Fast stilling
10	Salary type (lønnstype)	Fastlønn
11	Percentage (stillingsprosent)	80.0
12	Annual salary (årslønn)	920000
13	Start date (tiltredelse)	11.11.2026

All 13 fields MUST be found before proceeding. Convert dates DD.MM.YYYY → YYYY-MM-DD.

Call 1: GET /department

GET /department?fields=id,name&count=20

Call 2: GET /salary/settings

GET /salary/settings

Municipality ID is needed to create a division.

Call 3: POST /department (if needed) + POST /division

If the PDF's department is not in Call 1 results:

POST /department
{"name": "<field 7>"}

Fresh sandboxes have 0 divisions. Create one:

POST /division
{"name": "Hovedkontor", "organizationNumber": "999999999", "startDate": "2026-01-01", "municipality": {"id": "<from Call 2>"}, "municipalityDate": "2026-01-01"}

Call 4: GET /employee/employment/occupationCode

Tripletex uses 7-digit codes where the first 4 digits are the STYRK code. The code parameter does substring search (NOT prefix!). Results are sorted by name, NOT code.

CRITICAL: Searching code=4110 returns codes CONTAINING "4110" anywhere — most results will NOT start with "4110". You MUST use a more specific search.

Step A — search with STYRK + "1" appended:

GET /employee/employment/occupationCode?code=<field 8>1&count=100&fields=id,code,nameNO

Example: STYRK 4110 → search code=41101. This narrows results to codes like 4110101, 4110102 etc. — guaranteed to start with the correct 4-digit STYRK.

Pick the FIRST result whose code starts with <field 8>. This is your occupation code.

Step B (only if Step A returned 0 results):

GET /employee/employment/occupationCode?code=<field 8>&count=100&fields=id,code,nameNO

Scan ALL results. Pick one whose code starts with <field 8> (exact 4-digit match). If NONE start with the 4-digit STYRK, pick one starting with the first 3 digits, then 2 digits. Last resort: pick FIRST result.

You MUST always set occupationCode. NEVER omit it. NEVER send {}. Always {"id": <number>}.

Call 5: POST /employee

Every field from the PDF goes here:

POST /employee
{
  "firstName": "<field 1>",
  "lastName": "<field 2>",
  "dateOfBirth": "<field 3 as YYYY-MM-DD>",
  "nationalIdentityNumber": "<field 4>",
  "email": "<field 5>",
  "bankAccountNumber": "<field 6>",
  "userType": "NO_ACCESS",
  "department": {"id": "<from Call 1 or 3>"},
  "employments": [{
    "startDate": "<field 13 as YYYY-MM-DD>",
    "division": {"id": "<from Call 3 POST /division>"},
    "isMainEmployer": true,
    "taxDeductionCode": "loennFraHovedarbeidsgiver",
    "employmentDetails": [{
      "date": "<field 13 as YYYY-MM-DD>",
      "employmentType": "ORDINARY",
      "employmentForm": "PERMANENT",
      "remunerationType": "MONTHLY_WAGE",
      "occupationCode": {"id": "<from Call 4>"},
      "percentageOfFullTimeEquivalent": "<field 11>",
      "annualSalary": "<field 12>",
      "workingHoursScheme": "NOT_SHIFT",
      "payrollTaxMunicipalityId": {"id": "<municipality_id_from_Call_2>"}
    }]
  }]
}

POST field	Source
firstName, lastName	PDF fields 1-2
dateOfBirth	PDF field 3 (converted)
nationalIdentityNumber	PDF field 4
email	PDF field 5
bankAccountNumber	PDF field 6
department.id	Call 1 or 3
division.id	Call 3 POST /division
occupationCode.id	Call 4 (REQUIRED)
percentageOfFullTimeEquivalent	PDF field 11
annualSalary	PDF field 12
startDate + date	PDF field 13 (converted)
payrollTaxMunicipalityId	Call 2 salary/settings municipality