Hoppa till huvudinnehåll

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

Skrivet av Nina Wettergren

Översikt

För ett antal HR-system har Sysarb en dedikerad integration byggd och underhållen i direkt 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 Personec, 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 befintligt data i Sysarb: Om medarbetardata redan har importerats manuellt, se till att de unika ID:n i ert HR-system motsvarar de redan i Sysarb. En felaktig matchning resulterar i dubblerade medarbetarposter. 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 diskussioner (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 och konfigurera kopplingen i Sysarb

Kontakta erer HR-systemleverantör och meddela att ni vill aktivera Sysarb-integrationen. Det här steget har två delar: leverantören aktiverar integrationen på sin sida och er administratör slutför autentiseringen i Sysarb.

HR-systemleverantören kommer att:

  • Aktivera Sysarb-API:et på er instans av HR-systemet

  • Generera en API-nyckel och dela den med er

Ni kommer sedan:

  • Navigerar till Importera data → Integrationer i Sysarb och väljer ert HR-system

  • Anger den API-nyckel som leverantören har skickat för att etablera kopplingen

Steg 2 — Profil

På profilskärmen kan ni valfritt ge denna integration en titel — användbart 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örmatchade 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 integrationen

När fältmatchningen är slutförd aktiverar ni integrationen. 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 medarbetarposter, 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

Område

Ansvarig part

Supportkontakt

Aktivering av Sysarb API på HR-system

HR-systemleverantör

Er HR-systemkontakt

Generering av API-nyckel

HR-systemleverantör

Er HR-systemkontakt

Autentisering och 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

Problem

Trolig orsak

Vem kontaktar ni

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?