Hoppa till huvudinnehåll

Guide för direktintegrering via API (Visma, P, Agda, FourHuman, Fortnox)

Skriven av Nina Wettergren
Uppdaterad idag

Översikt

För ett antal HR-system har Sysarb en dedikerad integration byggd och underhållen i direktt samarbete med HR-systemleverantören. Detta innebär att anslutningen mellan ert HR-system och Sysarb konfigureras genom er befintliga leverantörkontakt — utan behov av tredjepartsprogramvara eller manuell filexport.

För närvarande tillgängligt för: Visma P, Agda, FourHuman, Fortnox


Innan ni börjar

Denna guide är avsedd för kunder som redan har slutfört integrationsutvärderingen och bekräftat att en direktintegrering via API är rätt väg för deras konfiguration. Om ni fortfarande utforskar era alternativ kan vi hänvisa er till vår vägledning för integrationsutvärdering innan ni fortsätter.

Viktigt — om ni redan har befintliga data i Sysarb: Om anställddata redan har importerats manuellt, se till att de unika anställd-ID:n i ert HR-system motsvarar de redan i Sysarb. En felaktig matchning resulterar i dubblerade anställdposter. Om en anställds ID ändras kommer Sysarb att behandla dem som en ny anställd. Förutom att skapa en dublett kommer detta att ha negativ påverkan på historisk lönejämställdhetsanalys och anställningspostanslutningar, samt konversationer (gäller Pay Management-kunder).


Hur det fungerar

  1. Din HR-systemleverantör aktiverar Sysarb API på din instans av HR-systemet

  2. Leverantören genererar en API-nyckel och konfigurerar anslutningen i Sysarb på din vägnar

  3. Ni granskar och slutför fältmatchningen i Sysarbs UI

  4. Integreringen aktiveras och data börjar synkroniseras automatiskt enligt schema

Integreringen ägs och underhålls av er HR-systemleverantör i samarbete med Sysarb. Dag för dag körs synkroniseringen utan intervention — ändringar i ert HR-system reflekteras automatiskt i Sysarb.


Förutsättningar

  • Ni har en aktiv prenumeration på ett av de stödda HR-systemen listade ovan

  • Sysarb API är tillgängligt på er HR-systemsprenumeration — bekräfta detta med er HR-systemkontakt

  • Ni har en tydlig bild av vilka anställddata-fält ni vill synkronisera till Sysarb. Lönefils-mallen är tillgänglig i steg 2 (Välj lönefil) i importflödet — navigera till Importera data → Filimport → Inställningar för att nå den. För att komma åt hämtningen måste ni först slutföra era inställningar i steg 1


Konfigurationssteg

Steg 1 — Kontakta er HR-systemleverantör

Kontakta personkontakten på er HR-systemleverantör som hanterar Sysarb-integreringen. Meddela dem att ni vill aktivera integreringen.

De kommer att:

  • Aktivera Sysarb API på er HR-systeminstans

  • Generera en API-nyckel

  • Logga in på Sysarb och registrera API-nyckeln för att konfigurera anslutningen

När steg 1 är slutfört: Er HR-systemleverantör meddelar er direkt. Ni kan också bekräfta genom att navigera till Importera data → Integrationer i Sysarb — integreringen visas i listan när leverantören har konfigurerat anslutningen och ni är redo att gå vidare till fältmatchning.

Steg 2 — Profil

På profilskärmen kan ni valfritt ge denna integration en titel — användbar om ni har eller förväntar er att ha flera integrationer konfigurerade. Detta kan redigeras senare.

Klicka Fortsätt.

Steg 3 — Fältmatchning

När anslutningen är konfigurerad navigerar ni till Importera data → Integrationer → Fältmatchning i Sysarb.

De flesta standardfält är förmatcha som standard. Granska tabellen och slutför alla fält som ännu inte är matchade — särskilt alla fält som är specifika för er konfiguration, såsom anpassade fält eller organisationsspecifik data.

En varningsikon (⚠️) anger ett obligatoriskt fält som ännu inte har mappats. Arbeta genom alla omappade obligatoriska fält innan ni fortsätter.

Om ni behöver vägledning om vilka fält som är obligatoriska kontra rekommenderade kan ni se er lönefils-mall eller kontakta er Sysarb customer success-kontakt eller support.

Obs! När integreringen är aktiv kan ni när som helst återvända till fältmatchningen genom att navigera till Importera data, lokalisera er integration, klicka på -menyn och välja Matchade fält.

Steg 4 — Aktivera integreringen

När fältmatchningen är slutförd aktiverar ni integreringen. Data börjar synkroniseras enligt överenskommet schema.

Om ni är osäkra på om er konfiguration är korrekt innan ni aktiverar kontaktar ni [email protected] eller er customer success-kontakt för en granskning.


Efter aktivering

När den är aktiv importeras data från ert HR-system automatiskt till Sysarb. Ändringar av anställdposter, organisationsstruktur eller löndata i ert HR-system kommer att reflekteras i Sysarb vid nästa synkronisering.

Om ni behöver göra en engångsimport vid sidan av integreringen — till exempel för att lägga till data som inte är tillgänglig i HR-systemet — kontaktar ni Sysarbs support för att diskutera alternativ.


Ansvarsfördelning

Aktivering av Sysarb API på HR-system

HR-systemleverantör

Er HR-systemkontakt

Generering av API-nyckel och konfigurering av anslutning

HR-systemleverantör

Er HR-systemkontakt

Fältmatchning i Sysarb UI

Kund

Sysarbs support eller customer success

Aktivering av integreringen

Kund

Sysarbs support eller customer success

Pågående synkronisering och underhåll

HR-systemleverantör + Sysarb

Sysarbs support eller customer success


Felsökning

Integreringen visas inte i Sysarb

API ännu inte aktiverat på HR-system

Kontakta er HR-systemleverantör för att bekräfta aktivering

Obligatoriskt fält visar varningsikon

Fält ännu inte matchat

Slutför fältmatchningen i Sysarb UI

Dubblerade anställdposter

Anställd-ID felaktig matchning mellan HR-system och befintliga Sysarb-data

Justera ID:n innan aktivering — kontakta Sysarbs support eller customer success för vägledning

Data uppdateras inte efter ändringar i HR-system

Synkroniseringsfördröjning eller konfigurationsproblem

Kontrollera synkroniseringsschemat; kontakta Sysarbs support eller customer success om problemet kvarstår


Support

Kontakta Sysarb via [email protected] eller direkt i gränssnittet. Om ni är i en aktiv implementation är er customer success-kontakt också tillgänglig för hjälp.

För frågor om konfigureringen på er HR-systemsida kontaktar ni er HR-systemleverantör.

Fick du svar på din fråga?