Hoppa till huvudinnehåll

Guide för SFTP-integration

SFTP, integration, HR-system, HRIS, filexport, fältmatchning, datasynk, CSV, schemalagd export, aktivering, autentisering

Skrivet av Nina Wettergren

Översikt

Den här guiden vägleder er genom de steg som krävs för att konfigurera en SFTP-baserad dataintegrering mellan ert HR-system (HRIS) och Sysarb. När den är aktiv kommer er HRIS att automatiskt leverera en personalfil till en SFTP-server enligt ett schema, vilket Sysarb sedan hämtar och importerar till er miljö.

Så fungerar det

  1. Er HRIS (eller IT-team) genererar en strukturerad export av personaldata enligt ett schema

  2. Filen levereras till en SFTP-server (Sysarb-hostad eller er egen)

  3. Sysarb hämtar filen och importerar datan till er miljö


Innan ni börjar

Den här guiden är avsedd för kunder som redan har genomfört en integrationsutvärdering och bekräftat att SFTP är rätt integreringsväg för er miljö. Om ni fortfarande utforskar era alternativ, se vår vägledning om integrationsutvärdering innan ni fortsätter.

Viktigt — om ni redan har data i Sysarb: Om personaldata redan har importerats manuellt, kontrollera att de unika person-ID:na i er HRIS matchar de som redan finns i Sysarb. En felaktig matchning resulterar i dubblerade personuppgifter.


Förutsättningar

Innan konfigurationen kan börja, bekräfta följande:

  • Ni har administratörsåtkomst till er HRIS, eller IT-support är tillgänglig för att konfigurera en schemalagd export

  • Er organisation kan ansluta till en extern SFTP-server — kontrollera med IT om ni är osäker

  • Ni har arbetat igenom Sysarbs lönefil-mall för att förstå vilka fält som är tillgängliga i er HRIS och hur de mappas till Sysarbs obligatoriska fält


Steg 1 — Förbered exportfilen i er HRIS

Arbeta tillsammans med er HRIS-administratör eller leverantör för att konfigurera en schemalagd dataexport med följande specifikationer:

  • Filformat: CSV (.csv) eller JSON, UTF-8-kodning

  • Leverans: SFTP-överföring till Sysarbs server (detaljer i steg 2)

  • Schema: Enligt överenskommelse under utvärderingen (t.ex. nightly kl. 02:00)

Viktiga krav för filen:

  • En rad per anställning. Om en person har flera aktiva anställningar, inkludera en rad per anställning och säkerställ att varje rad innehåller lämpligt unikt ID för att länka dem till samma person

  • Det unika person-ID:t måste förbli konsistent över alla framtida exporter. Om en persons ID ändras mellan exporter, behandlar Sysarb dem som en ny person, vilket resulterar i dubbletter. Förutom att skapa en dubblerad post, kommer detta att ha negativ påverkan på historiska löneanalyser och anställningspostanslutningar, samt samtal (tillämpligt för Pay Management-kunder)

  • Kolumnrubriker rekommenderas att matcha fältnamnen i er HRIS-export — det gör fältmatchningssteget betydligt enklare

  • Datumformat: YYYY-MM-DD

  • Tomma fält bör lämnas tomma, inte fyllas med platshållarvärden (t.ex. "N/A")

  • Hel populationsfil krävs: Varje leverans måste innehålla alla aktiva anställda — inte bara ändringar eller nya anställningar. Sysarb ersätter den föregående importen med varje ny fil. Om bara ändrade eller nya poster skickas, behandlas befintliga anställda som inte ingår i filen som inaktiva eller borttagna

Om er HRIS inte stöder direktöverföring via SFTP kan er IT-team behöva konfigurera ett skript eller middleware för att hantera filöverföringen.


Steg 2 — Starta integrationskonfigurationen i Sysarb

I Sysarb-gränssnittet, navigera till Importera data via sidomenyn och välj Integrationer som importmetod. Från listan över tillgängliga integrationer, välj SFTP-server.


Steg 3 — Välj vem som ska hosta servern

Ni tas till autentiseringsskärmen. Välj först vem som ska hosta SFTP-servern:



Sysarb-hostad

  • Sysarb tillhandahåller och hanterar SFTP-servern

  • Standardalternativet för de flesta konfigurationer

  • ⚠️ Ert brandvägg måste tillåta utgående SFTP-anslutningar — bekräfta med ert IT-team

Självhostad

  • SFTP-servern körs i er miljö, hanterad av ert IT-team

  • Passar om interna IT- eller säkerhetspolicyer kräver självhosting

  • ⚠️ Konfigurationen kräver IT-medverkan på er sida


Steg 3a — Om ni valde Sysarb-hostad: Uppladdningsmetod och inloggningsuppgifter

Välj hur ni vill ladda upp data till SFTP-servern:


SFTP-leverans (rekommenderas)

  • Filen skickas till SFTP-servern dagligen

  • Passar för återkommande, automatiserade överföringar

Manuell uppladdning i Sysarb

  • Ladda upp filen direkt i Sysarb när en uppdatering behövs

  • Passar för tillfälliga eller lågfrekventa kompletterande uppdateringar

Under SFTP-konfigurationer, välj er Filtillägg (.csv eller JSON).

Era inloggningsuppgifter genereras automatiskt:

Fält

Värde

URL

sftp.sysarb.app — kopiera med kopieringsknappen

Port

2022 — kopiera med kopieringsknappen

Användarnamn

Autogenererat (GUID-format) — kopiera med kopieringsknappen

Lösenord

Autogenererat — visas endast en gång, kopiera med kopieringsknappen

⚠️ Kopiera och spara ert lösenord innan ni klickar Fortsätt. Lösenordet döljs efter att ni lämnar sidan och kan inte återställas — bara återskapas.

Dela anslutningsdetaljerna med er HRIS-administratör eller IT-team. Klicka Fortsätt.


Steg 3b — Om ni valde Självhostad: Ange era anslutningsdetaljer

Under SFTP-konfigurationer, fyll i följande fält manuellt:

Fält

Värde

Filtillägg

Välj .csv eller JSON

URL

Er SFTP-serveradress

Port

Er SFTP-serverport

Användarnamn

Ert SFTP-användarnamn

Lösenord

Ert SFTP-lösenord

Klicka Autentisera. Om det lyckas, klicka Fortsätt.



Om autentiseringen misslyckas, dubbelkolla uppgifterna och säkerställ att ert nätverk tillåter utgående anslutningar från Sysarb till er SFTP-server.


Återskapa inloggningsuppgifter (endast Sysarb-hostad)

För att återskapa inloggningsuppgifter, navigera tillbaka till integrationskonfigurationen i Sysarb.

⚠️ Återskapande av inloggningsuppgifter ogiltigförklarar omedelbart de gamla. Eventuell aktiv SFTP-leverans med de gamla uppgifterna kommer att misslyckas tills ert HRIS- eller IT-team uppdaterar sin konfiguration.


Steg 4 — Profil

På profilskärmen kan ni:

  • Valfritt ge denna integration en Titel — används för att skilja integrationer från samma partner eller för att strukturera era integrationer

  • Aktivera Dekryptera uppladdade filer om er HRIS levererar krypterade filer

⚠️ Inaktivering av "Dekryptera uppladdade filer" raderar de aktuella nycklarna och blockerar åtkomst till befintliga filer.

Klicka Fortsätt.


Steg 5 — Matcha fält

På fältmatchningsskärmen mappar ni kolumnerna från er SFTP-exportfil till motsvarande fält i Sysarb.

  • Den vänstra kolumnen (SFTP-server) visar fält — välj matchande fält med rullgardinsmenyn

  • Den högra kolumnen (Sysarb) visar Sysarb-fälten att mappa till

  • En varningsikon (⚠️) indikerar ett obligatoriskt fält som ännu inte matchats

  • Genom att klicka på ett Sysarb-fält visas en Dataförhandsgranskning till höger, inklusive en beskrivning av vad fältet förväntar och en förhandsgranskning av värdet från er fil

Notering: Dataförhandsvisningen kräver att cachelagret är laddat. Om ni ser ett "Försök igen senare"-meddelande, använd menyn och välj Uppdatera data. Vid initial konfiguration kan det finnas en kort bearbetningsfördröjning — detta är förväntat. Försök igen efter några minuter.

Gå igenom listan och välj motsvarande fält från er export för varje Sysarb-fält. Om ni behöver vägledning om obligatoriska kontra rekommenderade fält, hänvisa till er customer success-kontakt eller Sysarb support.

När alla tillgängliga fält är matchade, klicka Lägg till integration.

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


Steg 6 — Testkörning

När ni har slutfört fältmatchningen och klickat Lägg till integration, kontakta Sysarb support på [email protected] för att validera integreringen från ett tekniskt perspektiv.

Er roll i testet:

  • Granska de importerade datan i Sysarb och bekräfta att de motsvarar era förväntningar — personuppgifter, fältvärden, organisationsstruktur

  • Flagga eventuella avvikelser i fältmatchning eller datakvalitet till er Sysarb-kontakt

Alla identifierade problem löses innan integreringen markeras som aktiv.


Steg 7 — Driftsättning

När testningen är godkänd:

  • Den schemalagda exporten körs automatiskt från och med nu

  • Eventuella ändringar av filformatet eller fältmatchningen måste kommuniceras till Sysarb i förväg


Ansvarsfördelning

Område

Ansvarig part

Supportkontakt

Val av SFTP-hosting

Kund

Sysarb support eller customer success

Generering av inloggningsuppgifter (Sysarb-hostad)

Sysarb (automatisk)

Sysarb support eller customer success

Hantering av inloggningsuppgifter (självhostad)

Kund / HRIS-leverantör

HRIS-leverantör

Exportkonfiguration i HRIS

Kund / HRIS-leverantör

HRIS-leverantör

Schemalagd filöverföring till SFTP

Kund / HRIS

HRIS-leverantör

Filformatspecifikation

Sysarb

Sysarb support eller customer success

Fältmatchning i Sysarb-gränssnittet

Kund

Sysarb support eller customer success

Teknisk testning

Sysarb

Sysarb support eller customer success

Validering

Kund

Sysarb support eller customer success

Löpande exportövervakning

Kund / HRIS

HRIS-leverantör


Felsökning

Problem

Vem kontaktar ni

Fil inte levererad / saknad

Kund / HRIS-administratör

Import misslyckades i Sysarb

Sysarb support eller customer success

Felaktig eller oväntad data

Kund (kontrollera källdata) — Sysarb support eller customer success om fältmatchningsproblem

SFTP-anslutningsfel

Kundens IT-team, sedan Sysarb support om olöst

Inloggningsuppgifter fungerar inte (Sysarb-hostad)

Återskapa inloggningsuppgifter — meddela HRIS/IT-team att uppdatera

Krypteringsmismatch

Kontakta Sysarb support eller customer success


Osäker på vilken väg som passar er?


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.

Fick du svar på din fråga?