Visma.Net-integrasjon

Endret Tue, 27 Mai ved 1:15 PM

Alt du trenger å vite om standardintegrasjonen med Visma.net

Nåværende status: BETA

Merk: Dette er et tillegg til kjernepakkene og må aktiveres og kjøpes separat.

Oversikt

Med denne Visma.net-integrasjonen kobler du Simployer One til din Visma.net-konto via API. Du kan deretter gjøre følgende:

Planlagt og/eller manuell synkronisering av ansattdata som personopplysninger, ansettelsesdata, lønnsinformasjon m.m. fra Simployer One til Visma.net.
Alle nye ansatte vil opprettes som kladder, slik at den endelige godkjenningen og aktiveringen skjer i Visma.net
Synkronisering av fraværsdata som sykdom, foreldrepermisjon og ferie til Visma.net for den perioden du velger. Du har full kontroll over hvilke fravær som eksporteres, for hvilke ansatte og i hvilken periode.

Krav

Visma.net

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

Visma Tenant ID

Simployer One

Gyldig tilgangstoken for Public API

Minst ett tilgangstoken for Public API må være opprettet og brukes for å koble systemene sammen.

Hvis du ikke har laget et tilgangstoken, gjør du det under Innstillinger → Tilgangstokener

Konfigurasjon

Integrasjonen aktiveres fra:

Innstillinger → Integrasjoner → Integrer med lønnssystem → Legg til integrasjon

Velg Visma.net
Klikk Neste for å starte konfigurasjonsveiviseren
Fyll inn alle nødvendige detaljer for tilkoblingen

Innstillinger

Du kan velge hvordan synkroniseringen av ansatte skal utføres. Følgende alternativer finnes:

Manuell synkronisering: Data synkroniseres til Visma.net kun med manuell handling.

Dette kan være nyttig hvis du har deaktivert planlagt synkronisering og ønsker å ha kontroll over når data oppdateres – for eksempel i implementeringsfasen eller ved prosessendringer.
Manuell synkronisering kan også utføres i tillegg til planlagt synkronisering, f.eks. hvis det har vært mange endringer i Simployer One etter at den planlagte synken har kjørt.

Planlagt synkronisering

Synkroniseringen kjøres på et fast tidspunkt basert på valgt ukedag.

Merk: Synkronisering starter for øyeblikket automatisk etter kl. 06:00 CET.

Omfang

Innstillingene for "scope" gir deg mer kontroll over hvilke ansatte som skal inkluderes i automatisk eller manuell synkronisering.

Dette er nyttig dersom ikke alle ansatte skal eksporteres til Visma.net.

Scope-valget følger standard scoping-funksjonalitet som finnes i Simployer One.

Ansattdata

Oversikt

Ansattdata synkroniseres fra Simployer One til Visma.net.

Det betyr at hvis du oppdaterer data i Visma.net som ligger innenfor integrasjonsfeltene, vil de bli overskrevet når Simployer kjører neste synkronisering.

Under synkronisering sammenlignes dataene i Simployer med det som ligger i Visma.net.

Hvis det ikke finnes noen forskjell: ingen oppdatering skjer.

Hvis det finnes endringer: dataene i Visma.net blir oppdatert.

Noen felt er for øyeblikket hardkodet – se under for mer informasjon.

Hvilke ansatte eksporteres?

Følgende felter er obligatoriske for at en ansatt skal bli eksportert:

Fornavn
Etternavn
Adresse eller land i adressefelt
E-post
Fødselsdato
Nasjonalt ID-nummer (personnummer)
Ansettelse
Bankkonto
Lønn/inntjening

Hvis noen av disse feltene mangler, blir den ansatte utelatt fra eksporten.

Integrasjonsdatafelt

(Detaljer om eksakte felt kan spesifiseres om ønskelig.)

Simployer fields	VismaNet fields	Mapping conditions (if any) (Simployer → VismaNet)
Work Section
Employee number	Employee.number
Work email	Employee.emails[0].address	if workEmail in Simploer is null, use privateEmail
N/A	Employee.emails[0].type	Currently hardcoded to “`Business`"
Personal
First name	Employee.firstName
Last name	Employee.lastName
Birthdate	Employee.dateOfBirth
Social security number	Employee.personIds.id
N/A	Employee.personIds.typeOfId	Currently hardcoded to “`NationalID`"
HomeAddress - Street name	Employee.address.streetName
HomeAddress - Zip code	Employee.address.zipCode
HomeAddress - City	Employee.address.cityName
HomeAddress - Country	Employee.address.countryCode
Financial
N/A	Employee.salaryPaymentMethod.paymentType	Currently hardcoded to “`bank`"
Financial - Bank account	Employee.salaryPaymentMethod.localBankAccount	Updated with Bank account number Bank account country is "Norway" in Simployer
N/A	Employee.salaryPaymentMethod.internationalBankAccount	This is defined as true* if bankaccount country not equal to ”Norway” in Simployer*
Financial - BIC	Employee.salaryPaymentMethod.internationalBankSwift	if internationalBankAccount is true
Financial - IBAN	Employee.salaryPaymentMethod.internationalIban	if internationalBankAccount is true
Financial - bankAccount.country	Employee.salaryPaymentMethod.internationalBankCountry	if internationalBankAccount is true
Financial - bankAccount.country	Employee.salaryPaymentMethod.internationalRemittanceCountry	if internationalBankAccount is true
Employment
Employment - Start date	Employee.positions.activeStart
Employment - End date	Employee.positions.activeEnd
Employment - Rate	Employee.positions.partTimeFactors.value
N/A	Employee.positions.typeOfPosition	Currently, hardcoded as “`Ordinary`"
Employment - Employment type	Employee.positions.employmentForm[0].value	Currently, hardcoded as “`fast`"
N/A	Employee.positions.typeOfWork[0].value	Currently, hardcoded as “`0111101`"
N/A	Employee.positions.workTimeAgreement[0].value	Currently, hardcode as “`0387f476-2471-4816-8b94-cdabb8fe4c21`"
Compensation
Compensation.amount	Employee.positions.salaryInformation.monthlySalary	Default 0
Compensation.effectiveDate	Employee.positions.salaryInformation.activeStart
N/A	Employee.positions[0].salaryInformation[0].salaryType	Currently, hardcoded as “`Period`"
N/A	Employee.positions[0].salaryInformation[0].contractSalaryType	Currently, hardcoded as “`Monthly`"
N/A	Employee.positions[0].taxUnitIds
N/A	Employee.positions[0].positionEndReason	Currently hardcoded to “`arbeidsgiverHarSagtOppArbeidstaker`"

Fraværsdata

Fraværsdata håndteres fra:

Administrer tid → Eksporter fravær

Simployer fields	VismaNet fields	Mapping conditions (if any) (Simployer → VismaNet)
Leave type code	eventCode	code from the Leave type. Needs to be configured on each leave type according to Visma.net documentation.
Duration	inputType	One day or longer period → “FullDay” is sent to Visma for each day Half day → is sent to Visma as “Percent” Minutes → is sent to Visma as “Interval”
	properties.percent properties.interval	Value of “Percent” OR value of “Interval”
Leave startdate	startDate	For longer leaves → Earliest date within the requested payrollDateRange. Example. An employee has Parental leave for all of 2024 (January 1 -- December 31). When selecting April and exporting leaves for only April 2024-04-01 will be used as the start date.
Leave enddate	EndDate	For longer leaves → latest date within the requested payrollDateRange. With same example as above 2024-04-30 will be used as EndDate

Les mer om eksport av fravær her