Tidsbanken Integrasjon i Simployer One

Endret Tue, 30 Sep ved 1:54 PM

Alt du trenger å vite om standardintegrasjonen mot Tidsbanken

Oversikt

Med denne integrasjonen kobler du Simployer One til din Tidsbanken-konto via API og kan gjøre følgende:

Planlagt eller manuell synkronisering av ansattdata som personalinformasjon, ansettelsesdata, lønnsdata m.m. fra Simployer One til Tidsbanken
Synkronisering av fraværsdata som sykdom, foreldrepermisjon og ferie til Tidsbanken for den perioden du velger. Du har full kontroll over hvilke fravær som eksporteres, for hvilke ansatte og for hvilken periode

Tilgjengelig i Norge

Krav i Tidsbanken

Du må ha tilgang til følgende gyldige påloggingsinformasjon:

Ansatt-token: finnes i Tidsbankens hjelpesenter.
Logg inn som administrator: kun administratorer kan hente tb-key.
Åpne Integrasjonssenteret: via skiftenøkkel-ikonet (innstillinger) nederst til høyre i portalen.
Velg "Integrasjoner": gå inn i integrasjonssenteret.
Finn API-nøkkelen (tb-key): denne brukes i oppsettet av integrasjonen.
Kopier og bruk tb-key: lim den inn i Simployer-integrasjonsveiviseren (steg 2).

Legge til integrasjonen

Gå til Innstillinger → Integrasjoner → Legg til integrasjon

Velg Tidsbanken i seksjonen API-integrasjoner
Klikk Neste for å starte konfigurasjonsveiviseren
Legg inn tb-key fra tidligere i feltet i steg 2

Innstillinger

Du kan velge hvordan synkronisering av ansatte skal utføres:

Manuell synk
- Dataene synkroniseres manuelt til Tidsbanken av brukeren.
- Dette kan være verdifullt hvis du har den planlagte synkroniseringen slått av og ønsker å kontrollere når data synkroniseres til Tidsbanken. Enten i implementeringsfasen eller i perioder når en oppdatering ikke er ønskelig på grunn av prosess- og lønnstidspunkt.
- Manual syncs can be performed even when a scheduled sync is configured. This may be necessary if there have been a significant number of changes in Simployer One after a scheduled sync has been executed
Scheduled sync
- Manuelle synkroniseringer kan utføres selv når en planlagt synkronisering er konfigurert
- Dette kan være nødvendig hvis det har vært et betydelig antall endringer i Simployer One etter at en planlagt synkronisering er utført.

Merk: Når en planlagt synkronisering er aktivert, settes den i kø og utføres like etter klokken 06:00 CET den påfølgende dagen.

Scope

Scopes gir mer detaljerte filtre for hvilke ansatte som skal inkluderes i synken.
Dette er nyttig dersom enkelte ansatte skal ekskluderes.
Scopes fungerer på samme måte som i andre Simployer One-funksjoner.

Employee data

Ansattdata synkroniseres fra Simployer One til Tidsbanken. Dette betyr at hvis data oppdateres i Tidsbanken på «datafelt» og synkroniseringen fra Simployer One deretter utføres, vil dataene i Tidsbanken bli overskrevet.

Når synkroniseringen utføres, vil den sammenligne dataene i Simployer for «datafeltene» for å se om det er en forskjell mellom verdiene for disse feltene i Tidsbanken. Hvis det ikke er noen endring, vil ikke brukeren bli oppdatert. Hvis det er en endring, vil dataene bli oppdatert.

Noen felt er for øyeblikket hardkodet eller har en standardverdi. Se tabellen nedenfor for mer informasjon.

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

Expected release in October 2025.

Simployer Absence Code	Tidsbanken Code	Tidsbanken Number	Tidsbanken Name (Norwegian)	Tidsbanken Name (English)	Description
`sick_leave`	`Su16`	122	Sykemelding under 16 dager	Sick leave under 16 days	Sick leave for periods under 16 days
`sick_leave`	`So16`	175	Sykemelding over 16 dager	Sick leave over 16 days	Sick leave for periods over 16 days
`self_certified`	`Eg`	393	Egenmelding	Self-declaration of illness	Self-certified sick leave
`childcare`	`Egb`	61	Egenmelding barns sykdom	Self-declaration of child's illness	Childcare leave for sick child
`vacation`	`F`	131	Ferie	Holiday/Vacation	Annual vacation leave
`off_duty`	`Av`	130	Avspaseringsdag	Compensatory leave day	Compensatory time off
`parental_leave`	`VF`	140	Velferdspermisjon	Welfare leave	Parental/welfare leave
`other_absences`	`Fml`	144	Fravær og Permisjon m/lønn	Absence and Leave with pay	Other absences with pay
`other_absences`	`Ful`	145	Fravær og Permisjon u/lønn	Absence and Leave without pay	Other absences without pay
`public_holiday`	`HML`	200	Helligdagsfri med lønn	Public holiday leave with pay	Public holiday leave
`work_public_holiday`	`AR`	199	Arbeid på røde dager	Work on public holidays	Work on public holidays
`time_account_payout`	`UT`	501	Utbetaling tidskonto	Payout time account	Time account payout
`time_balance_adjustment_plus`	`PL`	502	Justering av timesaldo pluss	Adjustment of time balance plus	Positive time balance adjustment
`time_balance_adjustment_minus`	`MI`	503	Justering av timesaldo minus	Adjustment of time balance minus	Negative time balance adjustment