Visma.Net-integration

Ändrad den Tis, 6 jan. vid 3:06 E.M.

Viktigt: För alla nya integrationsuppsättningar rekommenderas det starkt att den första synkroniseringen genomförs med endast ett fåtal användare i urvalet (scope). Detta hjälper till att säkerställa datakvalitet och en smidig onboarding innan hela organisationen inkluderas.



Referens: Allmänt grunduppsättning


Innan du konfigurerar denna integration ska du slutföra Simployer HRM Integration – General Setup Guide. Guiden beskriver de inledande stegen för att sätta upp integrationer i Simployer och säkerställer att nödvändiga grundinställningar är korrekt konfigurerade för lyckad datasynkronisering.


Översikt

Med denna Visma.net-integration kopplar du Simployer One till ditt Visma.net-konto via API och kan därefter:

  • Köra schemalagd och/eller manuell synkronisering av medarbetardata såsom personuppgifter, anställningsinformation, ersättningsdata m.m. från Simployer One till Visma.net.

  • Alla nya medarbetare skapas som utkast, så att slutligt godkännande och aktivering sker i Visma.net.

  • Synkronisera frånvarodata såsom sjukfrånvaro, 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 medarbetare och för vilken period.


Krav

Integrationen mellan Simployer One och Visma.net är för närvarande ”Invite Only”. Det innebär att kunder måste begära en inbjudningskod via kundsupport och följa stegen nedan. Detta måste göras innan konfigurationen läggs till i Simployer One.


Steg för att godkänna Visma-integrationen

  1. Logga in i Visma App Store med ditt Visma-konto.

  2. Säkerställ att du är inloggad som användare med rollen Integration Administrator för företaget.

  3. Välj ditt företag i App Store.

  4. Ange inbjudningskoden som vi har tillhandahållit.

  5. Godkänn integrationen genom att välja nödvändiga behörigheter (scopes: read & write) och klicka på Integrate.

  6. Integrationen kommer därefter att visas under My Apps i App Store.


Hitta ditt Tenant ID

  • Ditt företag har ett unikt Tenant ID som krävs för integrationen.

  • Du hittar detta längst upp till höger i Visma App Store, under företagsväljaren.

  • Dela detta Tenant ID med oss om det efterfrågas.

Obs: Inbjudningskoden är giltig i 5 dagar och tas bort från systemet efter 30 dagar om den inte används.


Förutsättningar för integrationen

Visma.net

Du behöver ha tillgång till följande giltiga uppgifter:

  • Visma Tenant ID

Simployer One

  • Giltig Access Token för Public API

Minst en Access Token för Public API måste skapas och används för att koppla samman systemen.
Om du inte redan har skapat en access token gör du detta via Inställningar → Access tokens.


Terminologi och fältmappning (Simployer One → VismaNet)

Detta avsnitt förklarar hur centrala fält benämns i VismaNet, så att kunder enklare kan verifiera data och felsöka vid behov.

Viktiga fältnamn i VismaNet


Si ifra om du vil at jeg også oversetter neste seksjon med konkrete feltmapping-tabeller eller lager en kortversjon for implementering.


Concept

In Simployer One

In VismaNet

Occupational code

Occupational code in Employment Note field

Occupation Code (Type of Work)

Employment rate

Employment rate

Part Time Factor

Employment Type (Temporary or Permanent)

Employment Type

Appointment Type

Payout period

Payout period

Contract Salary Type

Salary amount

Compensation amount

Monthly Salary / Hourly Salary / Yearly Salary (depends on Contract Salary Type)




Val av lönefält i VismaNet (baserat på avtalets löntyp)


Utbetalningsperiod i Simployer One avgör avtalets löntyp i VismaNet, vilket i sin tur bestämmer vilket lönefält i VismaNet som uppdateras.


Payout Period (Simployer One)

Contract Salary Type (VismaNet:)

Visma Salary Field Updated

Monthly

Monthly

Monthly Salary

Hourly

Hourly

Hourly Salary

Annual

Annual

Yearly Salary


Viktigt: Beloppet skickas till Månadslön / Timlön / Årslön baserat på avtalets löntyp.


Innan du börjar (krav på medarbetardata)

Alla medarbetare måste ha fullständig information registrerad i Simployer One innan de kan synkroniseras till VismaNet. Saknad information gör att medarbetaren hoppas över.


Obligatorisk information

Personuppgifter

  • Förnamn

  • Efternamn

  • Födelsedatum

  • Personnummer (SSN)

  • Arbetsmejladress

  • Fullständig adress (inklusive land)


Bankkonto

Väljs baserat på kontotyp:

Norska bankkonton:

  • Land

  • Kontonummer

Internationella bankkonton:

  • Land

  • IBAN

  • BIC/SWIFT-kod

  • Kontonummer


Anställningsuppgifter (minst en anställning)

  • Anställningsstartdatum

  • Sysselsättningsgrad (i procent, t.ex. 100 %) (VismaNet: Part Time Factor)

  • Yrkes­kod i anställningens anteckningsfält (måste vara 7 siffror) (VismaNet: Type of Work)


Löneinformation

  • Lönebelopp

  • Giltighetsdatum för lön

  • Utbetalningsperiod måste vara en av följande (VismaNet: Contract Salary Type):

    • Månadsvis

    • Timlön

    • Årlig

  • Giltig, aktiv ersättningspost


Fältregler och format

Format för yrkeskod

Yrkeskoden är en 7-siffrig norsk yrkesklassificeringskod som måste anges i anställningens anteckningsfält.
(Visma.net: Type of Work)


Stödda format

Format

Example

Notes

Exact 7 digits

0111101

Basic format

With description

3120105 - Computer Engineer

Code followed by description



Viktigt: Om formatet på yrkeskoden i fältet ”anteckning” är ogiltigt kommer medarbetaren att hoppas över vid synkronisering.


Vad du kan ändra i Visma

Vissa fält kan ändras direkt i Visma.net utan att skrivas över vid nästa synk.


Säkert att ändra i Visma

(Dessa skrivs INTE över)

  • Betalningstyp – Om du ändrar från banköverföring till kontant bevaras ditt val

  • Privata/mobiltelefoner – Manuellt tillagda telefonnummer (icke Business-typ)

  • Privata e-postadresser – Manuellt tillagda e-postadresser (icke Business-typ)

  • Skatteinformation

  • Pensionsuppgifter

  • Fackföreningsmedlemskap

  • Sjukfrånvaroinformation

  • Företagsbilar


Uppdateras från Simployer One

Dessa fält ingår i synkroniseringen. Simployer One är master för dessa fält, vilket innebär att ändringar skrivs över i Visma.net.
Det rekommenderas att ändringar av dessa fält endast görs i Simployer One.

  • Medarbetarens namn

  • Födelsedatum

  • Personnummer

  • Arbetsmejl (från Simployer One)

  • Arbetstelefon (från Simployer One)

  • Adress

  • Bankkontouppgifter

  • Sysselsättningsgrad

  • Yrkeskod

  • Lönebelopp

  • Anställningstyp (Tidsbegränsad/Tillsvidare)


Hårdkodade fält (kan inte ändras via integrationen)

Vissa fält sätts automatiskt av integrationen till fasta värden och kan inte anpassas. Dessa är systemstandarder.


Arbetstidsavtal

Fast värde:
0387f476-2471-4816-8b94-cdabb8fe4c21
(Normal arbetstid – 37,5 timmar/vecka, Norge)

Vad betyder detta:
Alla medarbetare synkroniseras med detta standardavtal för arbetstid.

  • Kan du ändra detta i Visma.net? Ja, manuellt efter första synken

  • Skriver synken över ändringen? Nej, detta fält uppdateras aldrig igen


Typ av anställning (Position Type i VismaNet)

Fast värde: Ordinary

Vad betyder detta:
Alla medarbetare synkroniseras som anställningstyp ”Ordinary”.

  • Kan du ändra detta i Visma.net? Ja, till t.ex. maritimArbeidsforhold, Freelancer, Pension

  • Skriver synken över ändringen? Nej


E-posttyp

Fast värde: Business

Vad betyder detta:
E-postadresser från Simployer One synkroniseras alltid som typen Business.

  • Kan du lägga till andra e-posttyper i Visma.net? Ja, t.ex. Private

  • Skriver synken över dessa? Nej, endast Business-e-post uppdateras


Telefontyp

Fast värde: Business

Vad betyder detta:
Telefonnummer från Simployer One synkroniseras alltid som Business.

  • Kan du lägga till andra telefontyper? Ja

  • Skriver synken över dessa? Nej


Betalningsmetod

Fast värde: bank

Vad betyder detta:
Alla medarbetare sätts upp för banköverföring.

  • Kan du ändra detta i Visma.net? Ja, till kontant vid behov

  • Skriver synken över ändringen? Nej


Skriv ut lönebesked

Fast värde: false (inaktiverad)

  • Kan du ändra detta i Visma.net? Ja

  • Skriver synken över ändringen? Nej


Lönetyp

Fast värde: Period

Vad betyder detta:
Lön hanteras som periodbaserad på systemnivå (inte timbaserad).

Obs: Detta är inte samma sak som Contract Salary Type (Månad, Timme, År), som styrs av utbetalningsperioden i Simployer One och synkroniseras.


Orsak till avslut (vid slutdatum)

Fast värde: arbeidstakerHarSagtOppSelv (Medarbetaren har sagt upp sig)

  • Kan du ändra detta i Visma.net? Ja, till annan orsak (t.ex. arbetsgivaruppsägning, kontrakt slut)

  • Skriver synken över ändringen? Nej


Viktigt att notera

Alla hårdkodade fält kan justeras manuellt i Visma.net efter första synkroniseringen, och ändringarna kommer inte att skrivas över av framtida synkar.


Hur position och anställning fungerar

Att förstå detta hjälper vid felsökning.


Position / Employment (Visma.net)

  • Representerar hela medarbetarens anställningstid i företaget

  • Skapas vid första synk

  • Startdatum baseras på anställningsdatum i Simployer

  • Förändringar spåras via historikposter


Employment (Simployer One)

  • Kan ha flera poster under samma anställningstid

  • Varje ändring skapas som en historikpost i samma position i Visma.net

Därför ska en ny anställningspost skapas i Simployer One vid ändring av:

  • Sysselsättningsgrad

  • Anställningstyp

  • Yrkeskod

med startdatum motsvarande det datum ändringen ska gälla i Visma.net.


Exempel

Scenario:
Medarbetare anställs 1 jan 2024 och får ändrad sysselsättningsgrad 1 juli 2024.

I Simployer One:

  • Anställning 1: 1 jan – 30 juni 2024 (80 %)

  • Anställning 2: 1 juli 2024 – nu (100 %)


I Visma.net:

  • En position med start 1 jan 2024

  • Historik:

    • 80 % (1 jan – 30 juni 2024)

    • 100 % (från 1 juli 2024)


Viktig poäng:
Ändringar i Simployer One skapar inte nya positioner i Visma.net – de uppdaterar historiken på befintlig position.


Hur ersättning (kompensation) fungerar

Ersättning (Simployer One)

  • Medarbetare kan ha flera ersättningsposter

  • Vanligt vid lönerevisioner med bakdaterade startdatum

  • Endast den senast gällande ersättningen synkroniseras


Lönesynk i Visma.net

  • Endast den senaste ersättningsposten skickas

  • Bakdaterade ersättningar stöds, så länge posten är den aktuellt gällande


Exempel – lönerevision med bakdaterat startdatum

I Simployer One:

  • Ersättning 1: Start 1 jan 2024 – 45 000 (Månad)

  • Ersättning 2: Start 1 apr 2024 – 48 000 (Månad), skapad i maj

Vad synkroniseras till Visma.net:
48 000 (månadslön), baserat på Contract Salary Type = Monthly

Viktig poäng:
Bakdaterade ersättningar stöds så länge den senaste posten är den som gäller.


Lönetyper: Månad, Timme, År

Integrationen stöder tre lönetyper beroende på hur medarbetaren ersätts.

Så fungerar det


Utbetalningsperioden i Simployer One avgör vilket lönefält i Visma.net som används för att skicka lönebeloppet.

Payout Period

Visma Field Used

Example

Monthly

Monthly Salary

45,000 NOK per month

Hourly

Hourly Salary

250 NOK per hour

Annual

Yearly Salary

540,000 NOK per year



Viktigt: Systemet sätter automatiskt rätt lönefält baserat på utbetalningsperioden. Du behöver inte göra något särskilt – säkerställ bara att utbetalningsperiod och lönebelopp är korrekt angivna.


Ändra löntyp

Om en medarbetares utbetalningsperiod ändras (t.ex. från månadsvis till timlön):

  • Uppdatera utbetalningsperioden i Simployer One

  • Uppdatera lönebeloppet så att det matchar den nya perioden

  • Nästa synk skapar en ny lönehistorikpost i Visma


Anställningstyp: Tidsbegränsad vs. Tillsvidare

Stödda typer

Integrationen stöder två anställningstyper:

  • Tillsvidare (Permanent i Visma)

  • Tidsbegränsad (Temporary i Visma)


Hur anställningstyp bestäms

I Simployer One:

  • Om fältet för anställningstyp innehåller ordet ”temporary” (skiftlägesokänsligt) synkroniseras den som Tidsbegränsad

  • Annars synkroniseras den som Tillsvidare


Ändra mellan anställningstyper

Du kan ändra en medarbetare från tidsbegränsad till tillsvidare, eller tvärtom:

  • Skapa en ny anställning i Simployer One med uppdaterad anställningstyp

  • Nästa synk skapar en ny anställningshistorikpost i Visma

Obs: Om anställningstypen i Visma är satt till något annat än Tidsbegränsad eller Tillsvidare kommer integrationen inte att uppdatera den. Detta bevarar specialtyper som satts direkt i Visma.


Viktiga saker att komma ihåg

Före integrationsuppsättning

Ny tenant i Simployer One med medarbetare som redan finns i VismaNet

  • Säkerställ att anställningsdatum matchar startdatum för position i VismaNet

  • Säkerställ att bankkonto, personnummer och andra fält har korrekt land och valuta i Simployer One

  • Säkerställ att anställningen i Simployer One har yrkeskod (Type of Work i VismaNet)

Ny tenant i Simployer One utan tidigare data i VismaNet

  • Säkerställ att alla obligatoriska fält för synk har giltiga värden i Simployer One


Efter integrationsuppsättning

  • Alla nya medarbetare skapas som utkast (draft) i VismaNet

  • Efter första synk måste utkastet anställas manuellt i VismaNet

    • Via Edit Draft → Hire Employee i nya VismaNet-gränssnittet

  • Uppdateringar som ska historikföras i VismaNet ska endast göras på aktiva/anställda medarbetare

  • Alla ändringar i synkade fält ska göras i Simployer One

  • Manuella ändringar i VismaNet bör undvikas

  • Ta inte bort eller ändra anställningsdatum efter att medarbetaren har synkroniserats


Felsökning

Medarbetare synkroniseras inte?

Steg 1: Kontrollera felmeddelanden

  • Titta i synkloggar efter meddelanden som:
    “Skipping this employee. [Field] is missing”

Steg 2: Kontrollera obligatoriska data

  • Gå igenom checklistan för krav på medarbetardata

Steg 3: Vanliga problem
(fortsätter i nästa avsnitt)


Issue

Solution

Missing bank account country

Add country field to bank account

Invalid occupational code

Check Employment Note field - must be 7-digit code

Missing payout period

Set payout period to Monthly, Hourly, or Annual

No active employment

Ensure active employment has no end date

Missing salary information

Add compensation record with amount


Lön uppdateras inte?


Möjliga orsaker:

  • Ingen aktiv anställning – Kontrollera om anställningen har ett slutdatum som ligger i det förflutna

  • Fel utbetalningsperiod – Måste vara Månadsvis, Timlön eller Årlig (inte veckovis etc.)

  • Saknad ersättning – Kontrollera att det finns en aktiv ersättningspost med belopp


Vanliga felmeddelanden


Error Message

What It Means

How to Fix

"Skipping this employee. First name is missing"

Employee profile incomplete

Add first name in Simployer One

"Skipping this employee. Address country field is missing"

Address incomplete

Add country to employee address

"Skipping this employee. Bank account country is missing"

Bank account incomplete

Add country to bank account

"Skipping this employee. International bank account is missing IBAN"

International account needs IBAN

Add IBAN for non-Norwegian accounts

"Skipping this employee. International bank account is missing BIC/SWIFT"

International account needs BIC

Add BIC/SWIFT code

"Skipping this employee. Norwegian bank account is missing account number"

Norwegian account needs number

Add account number

"Skipping this employee. Employment is missing start date"

Employment record incomplete

Add start date to employment

"Skipping this employee. Employment note field must contain a valid 7-digit typeOfWork code"

Invalid occupational code

Add valid 7-digit code to Employment Note

"Skipping this employee. Salary is missing"

No compensation record

Add compensation/salary information

"Skipping this employee. Payroll information is missing"

No payroll record

Add payroll information

"Skipping this employee. No active employment found"

All employments ended

Check employment end dates

"Unsupported payout period: WEEKLY"

Wrong payout period type

Change to Monthly, Hourly, or Annual


Frånvarodata
Frånvarodata 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 export av frånvaro här


 

Var artikeln till hjälp?

Toppen!

Tack för din feedback

Vi beklagar att det inte var till hjälp

Tack för din feedback

Berätta för oss hur vi kan förbättra den här artikeln!

Välj minst en av orsakerna
CAPTCHA-verifiering krävs.

Feddback skickat

Vi uppskattar din feedback och uppdaterar artikeln vid behov