Ö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
Er HRIS (eller IT-team) genererar en strukturerad export av personaldata enligt ett schema
Filen levereras till en SFTP-server (Sysarb-hostad eller er egen)
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-kodningLeverans: 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-DDTomma 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.









