Xledger-integrasjon

Endret Tue, 27 Mai ved 3:11 PM

Alt du trenger å vite om Xledger-standardintegrasjonen

Oversikt

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

Planlagt eller manuell synkronisering av ansattdata som personopplysninger, ansettelsesinformasjon, kompensasjonsdata og mer – fra Simployer One til Xledger.
Synkronisering av fraværsdata som sykdom, foreldrepermisjon og ferie til Xledger for en valgfri periode. Du har full kontroll over hvilke fravær som eksporteres, for hvilke ansatte og for hvilken periode.

Tilgjengelig i: Norge

Krav til Xledger

Du må ha tilgang til følgende gyldige autentiseringsopplysninger:

Tilgangstoken: Dette finner du her: https://xledger.net/f/api-tokens

Følg disse trinnene:

Klikk på "Generate new token"
Skriv inn en beskrivelse for tokenet, f.eks. "Simployer One" eller "Simployer"
Velg "Read" og "Write" for følgende områder: Accounts payable, Accounts receivable, Common og General Ledger
Klikk "Generate token"

Når tokenet er generert, kan det brukes til å sette opp Xledger-integrasjonen i Simployer One

Legge til integrasjonen

Integrasjonen aktiveres via:

Innstillinger → Integrasjoner → Legg til integrasjon (i seksjonen "Integrer med lønnssystem").

I seksjonen API-integrasjoner, velg Xledger
Klikk Neste for å starte veiviseren
Fyll inn alle nødvendige detaljer for tilkoblingen

Innstillinger

Du kan velge hvordan synkroniseringen for ansatte skal utføres. De tilgjengelige alternativene er:

Manuell synkronisering

Data synkroniseres manuelt til Xledger av brukeren.
Dette er nyttig dersom du har deaktivert planlagt synkronisering og ønsker kontroll over når data sendes til Xledger, for eksempel under implementeringsfasen eller i perioder hvor oppdateringer ikke er ønsket på grunn av prosess- eller lønnsrutiner.
Manuell synkronisering kan utføres selv om en planlagt synkronisering er konfigurert, for eksempel dersom det er gjort mange endringer etter at den siste planlagte synkroniseringen ble kjørt.

Planlagt synkronisering

Synkroniseringen kjører etter en tidsplan du definerer.
Du kan velge hvilke ukedager og tidspunkt synkroniseringen skal kjøres.

Merk: Når planlagt synkronisering er aktivert, blir den satt i kø og kjørt kort tid etter kl. 06:00 CET neste dag.

Omfang (Scope)

Scopes gir mer detaljerte filtre som bestemmer hvilke ansatte som inkluderes i synkroniseringen.
Dette er spesielt nyttig hvis du ønsker å ekskludere spesifikke ansatte fra eksporten til Xledger.
Scopes følger samme logikk som brukes i andre funksjoner i Simployer One.

Ansattdata

Ansattdata synkroniseres fra Simployer One til Xledger.

Dette betyr at hvis data er oppdatert i Xledger på feltene som er definert som "datafelter", vil disse feltene bli overskrevet ved neste synkronisering fra Simployer One.

Når synkroniseringen kjøres:

Systemet sammenligner datafeltene i Simployer med de tilsvarende feltene i Xledger.

Dersom det ikke er noen forskjeller, vil brukeren ikke bli oppdatert.

Hvis det er endringer, vil dataene bli oppdatert.

Enkelte felt er for øyeblikket hardkodet eller har en standardverdi – se tabellen under

Simployer field	Xledger field	Mapping conditions
Work
Employee.employeeNumber	Employee.code	Required
Employee.workEmail	Contact.email
Financial
Employee.bankAccount.number	Supplier.account
Personal
Person.firstName	Employee.firstName Contact.firstName
Person.lastName	Employee.lastName Contact.lastName
Person.firstName Person.lastName	Contact.name Employee.description	Fields from Simployer are concatenated and then separated by a space
Person.NationalIdList[0].NationalId	Contact.socialSec	If the SSN is removed in Simployer, it will be removed in Xledger as well
Person.Birthdate	Contact.birthday
Employee.nationality	Contact.country
Person.PhoneNumber	Contact.phone
Person.email	Contact.email
Person.Address.street1	Contact.streetAddress
Person.Address.city	Contact.place
Person.Address.postalCode	Employee.zipcode
Employment
Employee.hireDate	Employment.dateFrom
Employment.type
Employment.rate

Fraværsdata

Fraværsdata synkroniseres fra Simployer One til Xledger.

Det betyr at hvis data oppdateres i Xledger på "datafelter", vil de bli overskrevet ved neste synkronisering fra Simployer One.

Når synkroniseringen gjennomføres:

Systemet sammenligner datafeltene i Simployer med de tilsvarende i Xledger.

Dersom det ikke er noen forskjell, vil ingen oppdatering skje.

Hvis det er endringer, vil dataene bli oppdatert.

Enkelte felter er for øyeblikket hardkodet

Simployer field	Xledger field	Mapping conditions
Data
	leavePercent	Defaulted to `100`
AbsenceStartDate	timeFrom
AbsenceEndDate	timeTo
AbsenceEndDate	toDate
AbsenceStartDate	fromDate
	Comment	Defaulted to "temporary comment"
Codes
childcare	“CS”
vacation	“V”
sick_leave	“SWN”
{custom leavecode}	{custom leavecode}	A custom leave code must be set to the exact value defined in Xledger