Absence transactions

Table of content

Absence transactions list, creates or edits resources towards “Absence” in the salary Calendar.

List all absence transactions

URL

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

Method

GET

Description

Lists all absence transactions for all emploeyes. Supports query-string parameters employeeid and date for filtering the result

Response

{
  "MetaInformation": {
    "@TotalResources": 2,
    "@TotalPages": 1,
    "@CurrentPage": 1
  },
  "AbsenceTransactions": [
    {
      "@url": "https://api.fortnox.se/3/absencetransactions/9978/2016-12-06/SJK",
      "EmployeeId": "9978",
      "CauseCode": "SJK",
      "Date": "2016-12-06",
      "Extent": "100",
      "Hours": "0",
      "HolidayEntitling": true,
      "CostCenter": null,
      "Project": ""
    },
    {
      "@url": "https://api.fortnox.se/3/absencetransactions/9978/2016-12-07/TJL",
      "EmployeeId": "9978",
      "CauseCode": "TJL",
      "Date": "2016-12-07",
      "Extent": "0",
      "Hours": "5",
      "HolidayEntitling": false,
      "CostCenter": null,
      "Project": ""
    }
  ]
}
<?xml version="1.0" encoding="UTF-8"?>
<AbsenceTransactions TotalResources="2" TotalPages="1" CurrentPage="1">
    <AbsenceTransactionSubset url="https://api.fortnox.se/3/absencetransactions/9978/2016-12-06/SJK">
        <EmployeeId>9978</EmployeeId>
        <CauseCode>SJK</CauseCode>
        <Date>2016-12-06</Date>
        <Extent>100</Extent>
        <Hours>0</Hours>
        <HolidayEntitling>true</HolidayEntitling>
        <CostCenter></CostCenter>
        <Project></Project>
    </AbsenceTransactionSubset>
    <AbsenceTransactionSubset url="https://api.fortnox.se/3/absencetransactions/9978/2016-12-07/ARB">
        <EmployeeId>9978</EmployeeId>
        <CauseCode>ARB</CauseCode>
        <Date>2016-12-07</Date>
        <Extent>0</Extent>
        <Hours>5</Hours>
        <HolidayEntitling>false</HolidayEntitling>
        <CostCenter></CostCenter>
        <Project></Project>
    </AbsenceTransactionSubset>
</AbsenceTransactions>

Retrieve an absence transaction

URL

https://api.fortnox.se/3/absencetransactions/{EmployeeId}/{Date}/{CauseCode}

Method

GET

Description

Retrieves a single absence transaction for an employee on a specific date and cause code

Response

{
  "AbsenceTransaction": {
    "EmployeeId": "9978",
    "CauseCode": "SJK",
    "Date": "2016-12-06",
    "Extent": "100",
    "Hours": "0",
    "HolidayEntitling": true,
    "CostCenter": null,
    "Project": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<AbsenceTransaction>
    <EmployeeId>9978</EmployeeId>
    <CauseCode>SJK</CauseCode>
    <Date>2016-12-06</Date>
    <Extent>100</Extent>
    <Hours>0</Hours>
    <HolidayEntitling>true</HolidayEntitling>
    <CostCenter></CostCenter>
    <Project></Project>
</AbsenceTransaction>

Create an absence transaction

URL

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

Method

POST

Description

Creates a new absence transaction for an employee.

Usable “CauseCode”s:

ASK – Arbetsskada
ATF- Arbetstidsförkortning
FPE – Föräldraledig
FRA or FR1 – Frånvaro övrigt (FR1 is used in PAXml)
HAV – Graviditetspenning
KOM – Kompledig
MIL – Militärtjänst (max 60 dagar)
NAR or NÄR – Närståendevård (NÄR is used in PAXml)
OS1 – Sjuk-OB 1
OS2 – Sjuk-OB 2
OS3 – Sjuk-OB 3
OS4 – Sjuk-OB 4
OS5 – Sjuk-OB 5
PAP – Pappadagar
PEM – Permission
PER – Permitterad
SEM – Semester
SJK – Sjukfrånvaro
SMB – Smittbärare
SVE – Svenska för invandrare
TJL – Tjänstledig
UTB or FAC – Facklig utbildning (FAC is used in PAXml)
VAB – Vård av barn

Request

{
  "AbsenceTransaction": {
    "EmployeeId": "9978",
    "CauseCode": "SJK",
    "Date": "2016-12-08",
    "Extent": "100"
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<AbsenceTransaction>
    <EmployeeId>9978</EmployeeId>
    <CauseCode>SJK</CauseCode>
    <Date>2016-12-08</Date>
    <Extent>100</Extent>
</AbsenceTransaction>

Response

{
  "AbsenceTransaction": {
    "EmployeeId": "9978",
    "CauseCode": "SJK",
    "Date": "2016-12-08",
    "Extent": 100,
    "Hours": "0",
    "HolidayEntitling": true,
    "CostCenter": null,
    "Project": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<AbsenceTransaction>
    <EmployeeId>9978</EmployeeId>
    <CauseCode>SJK</CauseCode>
    <Date>2016-12-08</Date>
    <Extent>100</Extent>
    <Hours>0</Hours>
    <HolidayEntitling>true</HolidayEntitling>
    <CostCenter></CostCenter>
    <Project></Project>
</AbsenceTransaction>

Update an absence transaction

URL

https://api.fortnox.se/3/absencetransactions/{EmployeeId}/{Date}/{CauseCode}

Method

PUT

Description

Updates an absence transaction.

Usable “CauseCode”s:

ASK – Arbetsskada
FPE – Föräldraledig
FRA or FR1- Frånvaro övrigt (FR1 is used in PAXml)
HAV – Graviditetspenning
KOM – Kompledig
MIL – Militärtjänst (max 60 dagar)
NAR or NÄR – Närståendevård (NÄR is used in PAXml)
OS1 – Sjuk-OB 1
OS2 – Sjuk-OB 2
OS3 – Sjuk-OB 3
OS4 – Sjuk-OB 4
OS5 – Sjuk-OB 5
PAP – Pappadagar
PEM – Permission
PER – Permitterad
SEM – Semester
SJK – Sjukfrånvaro
SMB – Smittbärare
SVE – Svenska för invandrare
TJL – Tjänstledig
UTB or FAC – Facklig utbildning (FAC is used in PAXml)
VAB – Vård av barn

Request

{
  "AbsenceTransaction": {
    "Hours": "8"
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<AbsenceTransaction>
    <Hours>8</Hours>
</AbsenceTransaction>

Response

{
  "AbsenceTransaction": {
    "EmployeeId": "9978",
    "CauseCode": "SJK",
    "Date": "2016-12-08",
    "Extent": 0,
    "Hours": "8",
    "HolidayEntitling": true,
    "CostCenter": null,
    "Project": ""
  }
}
<?xml version="1.0" encoding="UTF-8"?>
<AbsenceTransaction>
    <EmployeeId>9978</EmployeeId>
    <CauseCode>SJK</CauseCode>
    <Date>2016-12-08</Date>
    <Extent>0</Extent>
    <Hours>8</Hours>
    <HolidayEntitling>true</HolidayEntitling>
    <CostCenter></CostCenter>
    <Project></Project>
</AbsenceTransaction>

Delete an absence transaction

URL

https://api.fortnox.se/3/absencetransactions/{EmployeeId}/{Date}/{CauseCode}

Method

DELETE

Description

Removes an absence transaction for an employee on a specific date

Properties

Field Type Access Description
EmployeeId  String (15) RW Unique employee-id
CauseCode String (3) RW Cause code
Date Date RW Date
Extent Float RW Extent in %
Hours Float RW Amount of hours
HolidayEntitling Boolean RW Determiens whether or not the registrations is holiday entitling
CostCenter String RW Cost Center
Project String RW Project