List all employees

URL

https://api.fortnox.se/3/employees

Method

GET

Description

Retrieve employment information for all employees.

Filters

active

inactive

Response

{
  "MetaInformation": {
    "@TotalResources": 2,
    "@TotalPages": 1,
    "@CurrentPage": 1
  },
  "Employees": [
    {
      "@url": "https://api.fortnox.se/3/employees/2",
      "EmployeeId": "2",
      "PersonalIdentityNumber": "",
      "FirstName": "Arthur",
      "LastName": "Doglas",
      "FullName": "Arthur Doglas",
      "Address1": "",
      "Address2": "Klarälvsvägen 98",
      "PostCode": "44135",
      "City": "ALINGSÅS",
      "Country": "Sweden",
      "Phone1": "0322-36802",
      "Phone2": "",
      "Email": "",
      "EmploymentDate": "2003-01-05",
      "EmploymentForm": "TV",
      "SalaryForm": "MAN",
      "JobTitle": "Marknadschef",
      "PersonelType": "TJM",
      "ScheduleId": "HEL",
      "ForaType": "-",
      "MonthlySalary": "45000",
      "HourlyPay": null,
      "TaxAllowance": "HUV",
      "TaxTable": "33",
      "TaxColumn": 1,
      "NonRecurringTax": "30",
      "Inactive": false,
      "ClearingNo": "",
      "BankAccountNo": ""
    },
    {
      "@url": "https://api.fortnox.se/3/employees/3",
      "EmployeeId": "3",
      "PersonalIdentityNumber": "",
      "FirstName": "Birgitta",
      "LastName": "Berg",
      "FullName": "Birgitta Berg",
      "Address1": "",
      "Address2": "Garverigatan 2",
      "PostCode": "447 34",
      "City": "VÅRGÅRDA",
      "Country": "",
      "Phone1": "0322-25833",
      "Phone2": "",
      "Email": "",
      "EmploymentDate": "2000-03-05",
      "EmploymentForm": "TV",
      "SalaryForm": "MAN",
      "JobTitle": "Ekonomichef",
      "PersonelType": "ARB",
      "ScheduleId": "HEL",
      "ForaType": "-",
      "MonthlySalary": "40000",
      "HourlyPay": null,
      "TaxAllowance": "EXT",
      "TaxTable": null,
      "TaxColumn": null,
      "NonRecurringTax": null,
      "Inactive": true,
      "ClearingNo": "",
      "BankAccountNo": ""
    }
  ]
}
<?xml version="1.0" encoding="UTF-8"?>
<Employees TotalResources="2" TotalPages="1" CurrentPage="1">
    <EmployeeSubset url="https://api-fn3-sl.utv.fortnox.local/3/employees/2">
        <EmployeeId>2</EmployeeId>
        <PersonalIdentityNumber/>
        <FirstName>Arthur</FirstName>
        <LastName>Doglas</LastName>
        <FullName>Arthur Doglas</FullName>
        <Address1/>
        <Address2>Klarälvsvägen 98</Address2>
        <PostCode>44135</PostCode>
        <City>ALINGSÅS</City>
        <Country>Sweden</Country>
        <Phone1>0322-36802</Phone1>
        <Phone2/>
        <Email/>
        <EmploymentDate>2003-01-05</EmploymentDate>
        <EmploymentForm>TV</EmploymentForm>
        <SalaryForm>MAN</SalaryForm>
        <JobTitle>Marknadschef</JobTitle>
        <PersonelType>TJM</PersonelType>
        <ScheduleId>HEL</ScheduleId>
        <ForaType>-</ForaType>
        <MonthlySalary>45000</MonthlySalary>
        <HourlyPay/>
        <TaxAllowance>HUV</TaxAllowance>
        <TaxTable>33</TaxTable>
        <TaxColumn>1</TaxColumn>
        <NonRecurringTax>30</NonRecurringTax>
        <Inactive>false</Inactive>
        <ClearingNo/>
        <BankAccountNo/>
    </EmployeeSubset>
    <EmployeeSubset url="https://api-fn3-sl.utv.fortnox.local/3/employees/3">
        <EmployeeId>3</EmployeeId>
        <PersonalIdentityNumber/>
        <FirstName>Birgitta</FirstName>
        <LastName>Berg</LastName>
        <FullName>Birgitta Berg</FullName>
        <Address1/>
        <Address2>Garverigatan 2</Address2>
        <PostCode>447 34</PostCode>
        <City>VÅRGÅRDA</City>
        <Country/>
        <Phone1>0322-25833</Phone1>
        <Phone2/>
        <Email/>
        <EmploymentDate>2000-03-05</EmploymentDate>
        <EmploymentForm>TV</EmploymentForm>
        <SalaryForm>MAN</SalaryForm>
        <JobTitle>Ekonomichef</JobTitle>
        <PersonelType>ARB</PersonelType>
        <ScheduleId>HEL</ScheduleId>
        <ForaType>-</ForaType>
        <MonthlySalary>40000</MonthlySalary>
        <HourlyPay/>
        <TaxAllowance>EXT</TaxAllowance>
        <TaxTable/>
        <TaxColumn/>
        <NonRecurringTax/>
        <Inactive>true</Inactive>
        <ClearingNo/>
        <BankAccountNo/>
    </EmployeeSubset>
</Employees>

Retrieve an employee

URL

https://api.fortnox.se/3/employees/{EmployeeId}

Method

GET

Description

Retrieves employment information for specified employee.

Response

{
  "Employee": {
    "EmployeeId": "2",
    "PersonalIdentityNumber": "",
    "FirstName": "Arthur",
    "LastName": "Doglas",
    "FullName": "Arthur Doglas",
    "Address1": "",
    "Address2": "Klarälvsvägen 98",
    "PostCode": "44135",
    "City": "ALINGSÅS",
    "Country": "Sweden",
    "Phone1": "0322-36802",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "2003-01-05",
    "EmploymentForm": "TV",
    "SalaryForm": "MAN",
    "JobTitle": "Marknadschef",
    "PersonelType": "TJM",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": "45000",
    "HourlyPay": null,
    "TaxAllowance": "HUV",
    "TaxTable": "33",
    "TaxColumn": 1,
    "NonRecurringTax": "30",
    "Inactive": false,
    "ClearingNo": "", 
    "BankAccountNo": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>3</EmployeeId>
    <PersonalIdentityNumber/>
    <FirstName>Birgitta</FirstName>
    <LastName>Berg</LastName>
    <FullName>Birgitta Berg</FullName>
    <Address1/>
    <Address2>Garverigatan 2</Address2>
    <PostCode>447 34</PostCode>
    <City>VÅRGÅRDA</City>
    <Country/>
    <Phone1>0322-25833</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>2000-03-05</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>MAN</SalaryForm>
    <JobTitle>Ekonomichef</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>40000</MonthlySalary>
    <HourlyPay/>
    <TaxAllowance>EXT</TaxAllowance>
    <TaxTable/>
    <TaxColumn/>
    <NonRecurringTax/>
    <Inactive>true</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
</Employee>

Create an employee

URL

https://api.fortnox.se/employees

Method

POST

Description

Creates a new employee.

Request

{
  "Employee": {
    "EmployeeId": "9978",
    "PersonalIdentityNumber": "19730222-9989",
    "FirstName": "Karin",
    "LastName": "Brovall",
    "FullName": "Karin Brovall",
    "Address1": "",
    "Address2": "Båtsmansvägen 7",
    "PostCode": "441 50",
    "City": "ALINGSÅS",
    "Country": "",
    "Phone1": "0322-36844",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "1997-10-01",
    "EmploymentForm": "TV",
    "SalaryForm": "TIM",
    "JobTitle": "Försäljning",
    "PersonelType": "ARB",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": 0,
    "HourlyPay": 125,
    "TaxAllowance": "TMP",
    "TaxTable": 34,
    "TaxColumn": 1,
    "NonRecurringTax": 30,
    "Inactive": false,
    "ClearingNo": "", 
    "BankAccountNo": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <PersonalIdentityNumber>19730222-9989</PersonalIdentityNumber>
    <FirstName>Karin</FirstName>
    <LastName>Brovall</LastName>
    <FullName>Karin Brovall</FullName>
    <Address1/>
    <Address2>Båtsmansvägen 7</Address2>
    <PostCode>441 50</PostCode>
    <City>ALINGSÅS</City>
    <Country/>
    <Phone1>0322-36844</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>1997-10-01</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>TIM</SalaryForm>
    <JobTitle>Försäljning</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>0</MonthlySalary>
    <HourlyPay>125</HourlyPay>
    <TaxAllowance>TMP</TaxAllowance>
    <TaxTable>34</TaxTable>
    <TaxColumn>1</TaxColumn>
    <NonRecurringTax>30</NonRecurringTax>
    <Inactive>false</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
</Employee>

Response

{
  "Employee": {
    "EmployeeId": "9978",
    "PersonalIdentityNumber": "19730222-9989",
    "FirstName": "Karin",
    "LastName": "Brovall",
    "FullName": "Karin Brovall",
    "Address1": "",
    "Address2": "Båtsmansvägen 7",
    "PostCode": "441 50",
    "City": "ALINGSÅS",
    "Country": "",
    "Phone1": "0322-36844",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "1997-10-01",
    "EmploymentForm": "TV",
    "SalaryForm": "TIM",
    "JobTitle": "Försäljning",
    "PersonelType": "ARB",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": 0,
    "HourlyPay": 125,
    "TaxAllowance": "TMP",
    "TaxTable": 34,
    "TaxColumn": 1,
    "NonRecurringTax": 30,
    "Inactive": false,
    "ClearingNo": "", 
    "BankAccountNo": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <PersonalIdentityNumber>19730222-9989</PersonalIdentityNumber>
    <FirstName>Karin</FirstName>
    <LastName>Brovall</LastName>
    <FullName>Karin Brovall</FullName>
    <Address1/>
    <Address2>Båtsmansvägen 7</Address2>
    <PostCode>441 50</PostCode>
    <City>ALINGSÅS</City>
    <Country/>
    <Phone1>0322-36844</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>1997-10-01</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>TIM</SalaryForm>
    <JobTitle>Försäljning</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>0</MonthlySalary>
    <HourlyPay>125</HourlyPay>
    <TaxAllowance>TMP</TaxAllowance>
    <TaxTable>34</TaxTable>
    <TaxColumn>1</TaxColumn>
    <NonRecurringTax>30</NonRecurringTax>
    <Inactive>false</Inactive>
    <ClearingNo/>
    <BankAccountNo/>
</Employee>

Update an employee

URL

https://api.fortnox.se/employees/{EmployeeId}

Method

PUT

Description

Updates employment information.

Request

{
  "Employee": {
    "EmployeeId": "9978",
    "HourlyPay": 500
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <HourlyPay>500</HourlyPay>
</Employee>

Response

{
  "Employee": {
    "EmployeeId": "9978",
    "PersonalIdentityNumber": "19730222-9989",
    "FirstName": "Karin",
    "LastName": "Brovall",
    "FullName": "Karin Brovall",
    "Address1": "",
    "Address2": "Båtsmansvägen 7",
    "PostCode": "441 50",
    "City": "ALINGSÅS",
    "Country": "",
    "Phone1": "0322-36844",
    "Phone2": "",
    "Email": "",
    "EmploymentDate": "1997-10-01",
    "EmploymentForm": "TV",
    "SalaryForm": "TIM",
    "JobTitle": "Försäljning",
    "PersonelType": "ARB",
    "ScheduleId": "HEL",
    "ForaType": "-",
    "MonthlySalary": "0",
    "HourlyPay": "500",
    "TaxAllowance": "TMP",
    "TaxTable": "34",
    "TaxColumn": 1,
    "NonRecurringTax": "30",
    "Inactive": false,
    "ClearingNo": "",
    "BankAccountNo": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<Employee>
    <EmployeeId>9978</EmployeeId>
    <PersonalIdentityNumber>19730222-9989</PersonalIdentityNumber>
    <FirstName>Karin</FirstName>
    <LastName>Brovall</LastName>
    <FullName>Karin Brovall</FullName>
    <Address1/>
    <Address2>Båtsmansvägen 7</Address2>
    <PostCode>441 50</PostCode>
    <City>ALINGSÅS</City>
    <Country/>
    <Phone1>0322-36844</Phone1>
    <Phone2/>
    <Email/>
    <EmploymentDate>1997-10-01</EmploymentDate>
    <EmploymentForm>TV</EmploymentForm>
    <SalaryForm>TIM</SalaryForm>
    <JobTitle>Försäljning</JobTitle>
    <PersonelType>ARB</PersonelType>
    <ScheduleId>HEL</ScheduleId>
    <ForaType>-</ForaType>
    <MonthlySalary>0</MonthlySalary>
    <HourlyPay>500</HourlyPay>
    <TaxAllowance>TMP</TaxAllowance>
    <TaxTable>34</TaxTable>
    <TaxColumn>1</TaxColumn>
    <NonRecurringTax>30</NonRecurringTax>
    <Inactive>false</Inactive>
    <ClearingNo/> 
    <BankAccountNo/>
</Employee>

Properties

Field Type Access Description
EmployeeId  String (15) RW Unique employee-id. Can never be changed once an employee has been created
PersonalIdentityNumber String RW Personal identity number
FirstName String RW First name
LastName String RW Last name
FullName String R Full name
Address1 String RW Address
Address2 String RW Address
PostCode String RW Post code
City String RW City
Country String RW Country
Phone1 String RW Phone number
Phone2 String RW Phone number 2
Email String RW Email address
EmploymentDate Date RW Startdate of employment
EmploymentForm String (3) RW Type of employment. Validates against allowed values specified below.
SalaryForm String (3) RW Type of salary form. Validates against allowed values specified below.
JobTitle String RW Job title
PersonelType String (3) RW Personel type. Validates against allowed values specified below.
Inactive Boolean RW True if employee is inactive
ScheduleId String (10) RW Schedule ID for scheduletimes
ForaType String (3) RW Assigned fora type. Validates against allowed values specified below.
MonthlySalary Float RW Monthly salary
HourlyPay Float RW Hourly pay
TaxAllowance String RW Tax allowance. Validates against allowed values specified below.
TaxTable Float RW Tax table
TaxColumn Integer RW Tax column
NonRecurringTax Float RW Non-recurring tax %
ClearingNo String RW Clearing number
BankAccountNo String RW Bankaccount number

 

 

Allowed values

 

EmploymentForm

Value Description
TV Post with conditional tenure
PRO Probationary appointment
TID Temporary employment
VIK Cover staff
PRJ Project employment
PRA Work experience
FER Holiday work
SES Seasonal employment
NEJ Not employed

SalaryForm

Value Description
MAN Monthly salary
TIM Hourly pay

PersonelType

Value Description
TJM Salaried employee
ARB Worker

ForaType

Value Description
Not signed
A Worker
A3 Workers, Painters
A91 Worker, Electrician – Installation plant contract
A92 Worker, Electrician – Power plant contract
A93 Worker, Electrician – Elektroskandia contract
A51 Worker, Technology Agreement IF Metall
A52 Worker, TEKO Agreement
A53 Worker, Food Production Agreement
A54 Worker, Tobacco Industry
A55 Worker, Company Agreement for V&S Vin & Sprit AB
A56 Worker, Coffee Roasters and Spice Factories
A57 Worker, Construction Materials Industry
A58 Worker, Bottle Glass Industry
A59 Worker, Motor Industry Agreement
A60 Worker, Industry Agreement
A61 Worker, Leather & Sporting Goods
A62 Worker, Chemical Factories
A63 Worker, Glass Industry
A64 Worker, Common Metals
A65 Worker, Explosive Materials Industry
A66 Worker, Allochemical Industry
A67 Worker, Recycling Company
A68 Worker, Laundy Industry
A69 Worker, Quarrying Industry
A70 Worker, Oil Refineries
A71 Worker, Sugar Industry (Nordic Sugar AB)
A72 Worker, IMG Agreement
A73 Worker, Sawmill Agreement
A74 Worker, Forestry Agreement
A75 Worker, Scaling of timber
A76 Worker, Upholstery Industry
A77 Worker, Wood Industry
T Salaried employee
T6 Salaried employee, Employed CEO

TaxAllowance

Value Description
HUV Main employer
EXT Extra income or short-time work
TMP Short-time work less than one week
STU Student without tax deduction
EJ Not tax allowance
??? Unknown tax circumstances