Hoppa till huvudinnehåll

Guide för SFTP-integration

Steg-för-steg-guide för att sätta upp en SFTP-baserad dataintegration mellan ert HR-system och Sysarb.

Skriven av Nina Wettergren
Uppdaterad idag

Ö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 Sysarbs 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 Sysarbs SFTP-server

  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 lonefil-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

  • En integrationsbegäran från Sysarb har skickats in och utvärderats


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 (steg 4) 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 — Anslut till Sysarbs SFTP-server

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

Ni kommer till autentiseringsskärmen. Ange följande anslutningsdetaljer:

Filfiltipos

.csv

URL

sftp.sysarb.app

Port

2022

Användarnamn

Tillhandahålles av Sysarb

Lösenord

Tillhandahålles av Sysarb

För att få ert användarnamn och lösenord, kontakta Sysarb support på [email protected] innan ni påbörjar konfigurationen.

Klicka Autentisera. Om anslutningen lyckas, ser ni ett bekräftelsemeddelande. Klicka Fortsätt för att fortsätta.

Om autentiseringen misslyckas, dubbelkolla de autentiseringsuppgifter som tillhandahålles av Sysarb och säkerställ att ert nätverk tillåter utgående anslutningar till sftp.sysarb.app på port 2022.

Notering: Det är också möjligt att använda en kundhanterad SFTP-server istället, där Sysarb hämtar filen snarare än att ta emot den. Om detta är relevant för er miljö, kontakta Sysarb support på [email protected].


Steg 3 — 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 (t.ex. för att skilja dem åt efter källsystem eller datatyp). Detta kan redigeras senare.

Klicka Fortsätt.


Steg 4 — 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 visar de fält som upptäcktes från er fil

  • Den högra kolumnen visar Sysarb-fälten för att mappa dem till

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

  • En grön bockmark indikerar ett framgångsrikt matchat fält

  • 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 5 — 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 6 — 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

SFTP-autentiseringsuppgifter och slutpunkt

Sysarb

Sysarb support eller customer success

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 övervakad av export

Kund / HRIS

HRIS-leverantör


Felsökning

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 eller customer success om olöst


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?