Visma.Net-integration

Ändrad den Tis, 27 maj vid 1:38 E.M.

Allt du behöver veta om standardintegrationen med Visma.net

Nuvarande status: BETA

Observera: Detta är ett tillägg till grundpaketen och måste aktiveras och köpas separat.

Översikt

Med denna Visma.net-integration kopplar du Simployer One till ditt Visma.net-konto via API. Du kan därefter göra följande:

Schemalagd och/eller manuell synkronisering av medarbetardata såsom personuppgifter, anställningsinformation, kompensationsdata med mera – från Simployer One till Visma.net.
Alla nya anställda kommer att skapas som utkast så att den slutgiltiga godkännandet och aktiveringen görs i Visma.net.
Synkronisering av frånvaro, såsom sjukdom, föräldraledighet och semester till Visma.net, för den period du väljer. Du har full kontroll över vilka frånvarotyper som exporteras, för vilka anställda och för vilken period.

Krav

Följande krav måste vara uppfyllda för att integrationen ska fungera:

Visma.net

Du måste ha tillgång till följande giltiga uppgifter:

Visma Tenant ID

Simployer One

Giltig Access Token för Public API

Minst en Access Token måste skapas och användas för att koppla systemen.

Om du inte har skapat en token än, gör det via Inställningar → Access Tokens

Konfiguration

Integration aktiveras via:

Inställningar → Integrationer → Integrera med lönesystem → Lägg till integration

Välj Visma.net
Klicka Nästa för att starta konfigurationsguiden
Fyll i alla detaljer som behövs för anslutningen

Inställningar

Du kan välja hur synkroniseringen av medarbetare ska ske. Alternativen är:

Manuell synkronisering

Data synkroniseras till Visma.net endast när du själv initierar det.

Detta kan vara användbart om du har avaktiverat schemalagd synkronisering och vill ha kontroll över när uppdateringar sker – till exempel under implementering eller när ändringar inte ska ske av processkäl.

Manuell synkronisering kan även göras utöver schemalagd synkronisering, t.ex. om stora ändringar gjorts i Simployer One efter den schemalagda synken.

Schemalagd synkronisering

Synkroniseringen körs på ett schema som du bestämmer – du väljer vilka veckodagar synken ska köras.

Obs: För närvarande köas synken och startar strax efter 06:00 CET.

Scope (urval)

Inställningen för urval (scope) möjliggör finjustering av vilka medarbetare som ska inkluderas i automatisk eller manuell synkronisering.
Detta är användbart om du vet att inte alla medarbetare ska exporteras till Visma.net.

Urvalet följer standardfunktionalitet för scope i Simployer One.

Medarbetardata

Översikt

Medarbetardata synkroniseras från Simployer One till Visma.net.

Det innebär att om du uppdaterar data i Visma.net för fält som omfattas av integrationen, kommer de att skrivas över nästa gång synken körs från Simployer One.

När synken körs jämförs data i Simployer One med data i Visma.net för respektive fält.

Om ingen skillnad finns: ingen uppdatering sker.

Om skillnad finns: uppdatering sker.

Vissa fält är för närvarande hårdkodade – mer information om detta nedan.

Vilka anställda exporteras?

Följande fält måste vara ifyllda för att en anställd ska kunna exporteras:

Förnamn
Efternamn
Adress eller land i adressfältet
E-post
Födelsedatum
Personnummer (National ID / SSN)
Anställning
Bankkonto
Lön/kompensation

Om något av dessa fält saknas för en medarbetare, kommer denne att uteslutas från exporten.

Integrationsfält (datafält som synkroniseras)

(Detaljer om exakt vilka fält som ingår kan specificeras separat om du önskar.)

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`"

Frånvarodata

Frånvaro hanteras via:

Hantera tid → Exportera frånvaro

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

Läs mer om att exportera frånvaro här