Overview
With this integration you will connect Simployer One to your Tidsbanken account via API and can then do the following:
Scheduled or manual sync of employee data such as personal information, employment data, compensation data and more from Simployer One to Tidsbanken
Sync time off data such as sickness, parental leave and vacations to Tidsbanken for the period that you choose. You have full control over what absences are exported for what employees and for what period
Available in: Norway
Tidsbanken requirements
You need to have access to the following valid credentials.
Employee token: this can be found in the Tidsbanken help center article here.
Log in as Administrator: Access Tidsbanken’s web portal using an administrator account; only admins can retrieve the tb-key
Open the Integration Center: Click the wrench icon (settings) in the bottom right corner of the portal
Select "Integrasjoner": From the menu, choose "Integrasjoner" to enter the integration center
Locate Your API Key (tb-key): Your tb-key (API key) will be shown here. This is the key you need for integrations and should be input as "tb-key" in integration setups.[](https://developer.tidsbanken.net/migrating-from-api-v1-to-api-v3)
Copy and Use Your tb-key: Copy the tb-key and input it in the Simployer integration setup wizard (step 2) when prompted.
Adding the integration
The integration is activated from Settings → Integrations → Add Integration
In the API Integrations section, select Tidsbanken
Click Next to start the configuration wizard
Enter the tb-key from earlier into the field in Step 2
Settings
Follow the steps in this article to set up an integration.
Employee data
Employee data is synchronized from Simployer One to Tidsbanken. This means that if data is updated in Tidsbanken on "data fields" and then the sync from Simployer One is done the data in Tidsbanken will be overwritten.
When the sync is executed it will compare the data in Simployer for the "data fields" to see if there is a difference between the values for those fields in Tidsbanken. If there is no change, the user will not be updated. If there is a change present, the data will be updated.
Some fields are currently hardcoded or have a default value, see the table below for more information.
Data fields
Simployer field | Tidsbanken field | Mapping conditions & notes |
id | EksternId |
|
employeeNumber | Id | Required |
firstName | Fornavn | Required |
lastName | Etternavn | Required |
workEmail / privateEmail | Epost | Work email used as default — fallback to private email if work email is missing |
workPhone | Mobil |
|
workPhone | TlfPrivat |
|
birthDate | Fodt |
|
homeAddress.street | Adresse |
|
homeAddress.postalCode | Postnummer |
|
homeAddress.city | Poststed |
|
title | Tittel |
|
hireDate | AnsattDato |
|
employment.rate | Stillingsprosent |
|
ssn | Personnummer |
|
bankAccount.number | Lonnskonto |
|
departmentId | AvdelingId | Required |
employment.type | AnsattGruppeId |
|
Absence data
Simployer Absence Code | Tidsbanken Code | Tidsbanken Number | Tidsbanken Name (Norwegian) | Tidsbanken Name (English) | Description |
|
| 122 | Sykemelding under 16 dager | Sick leave under 16 days | Sick leave for periods under 16 days |
|
| 175 | Sykemelding over 16 dager | Sick leave over 16 days | Sick leave for periods over 16 days |
|
| 393 | Egenmelding | Self-declaration of illness | Self-certified sick leave |
|
| 61 | Egenmelding barns sykdom | Self-declaration of child's illness | Childcare leave for sick child |
|
| 131 | Ferie | Holiday/Vacation | Annual vacation leave |
|
| 130 | Avspaseringsdag | Compensatory leave day | Compensatory time off |
|
| 140 | Velferdspermisjon | Welfare leave | Parental/welfare leave |
|
| 144 | Fravær og Permisjon m/lønn | Absence and Leave with pay | Other absences with pay |
|
| 145 | Fravær og Permisjon u/lønn | Absence and Leave without pay | Other absences without pay |
|
| 200 | Helligdagsfri med lønn | Public holiday leave with pay | Public holiday leave |
|
| 199 | Arbeid på røde dager | Work on public holidays | Work on public holidays |
|
| 501 | Utbetaling tidskonto | Payout time account | Time account payout |
|
| 502 | Justering av timesaldo pluss | Adjustment of time balance plus | Positive time balance adjustment |
|
| 503 | Justering av timesaldo minus | Adjustment of time balance minus | Negative time balance adjustment |