Agda PS: Integration
Översikt
Med denna integration kopplar du Simployer One till ditt Agda PS-konto via SFTP, och kan därefter göra följande:
Schemalagd eller manuell synkronisering av medarbetardata såsom personuppgifter, anställningsdata, löneinformation och mer från Simployer till Agda PS.
Tillgängligt i: Sverige
Krav från Agda PS
SFTP-serveråtkomst
Du måste begära ett dedikerat SFTP-konto från Agda PS support.
Agda PS tillhandahåller inloggningsuppgifter så att Simployer One kan leverera XML-filerna.
Agda-importjobb
Agda PS måste konfigurera ett importjobb för att automatiskt behandla dessa XML-filer från ditt SFTP-område.
Obs: Vid konfiguration av integrationen kan du välja att skicka filerna till mappenTest\Importfiler eller Prod\Importfiler på ditt Agda PS SFTP-område. Detta kan användas under uppsättningen tillsammans med Agda.
Obs: Det kan tillkomma start- och löpande serviceavgifter från Agda PS för filbearbetningen.
Så fungerar filöverföringen i Agda PS
När integrationen körs skapar Simployer One automatiskt medarbetarfiler i Agda PS XML Person Export-format och skickar dem till importområdet på ditt Agda PS SFTP.
Flera organisationer
Om du har flera organisationer i Simployer One skapas en fil per organisation.
Detta gör det enklare att importera data separat och för Agda PS att veta vilken organisation som hör till vilket Agda PS-företag.
Filnamnsformat:
[Organisations-ID]-[Organisationsnamn]-employees-[Datum och Tid].xml
Exempel:1-Acme_Corp-employees-20250103-143022.xml
Filplats:
Filerna levereras till den mapp du valt vid uppsättningen.
Uppsättning i Simployer
Integrationen aktiveras via:
Inställningar → Integrationer → Välj lönesystem → Lägg till integration
I avsnittet API-integrationer, välj Agda PS
Klicka på Nästa för att starta konfigurationsguiden
Fyll i all nödvändig information för anslutningen
Valfritt: Definiera ett specifikt omfång (scope) för vilka medarbetare som ska ingå och/eller sätt upp en schemalagd synkronisering från Simployer till Agda PS
Inställningar
Du kan välja hur synkroniseringen av medarbetare ska utföras:
Manuell synkronisering
Data synkroniseras manuellt till Agda PS av användaren.
Användbart om schemalagd synkronisering är avstängd och du vill styra när data skickas, t.ex. under implementering eller löneperioder.
Manuell synk kan även göras när schemalagd synk är aktiverad.
Schemalagd synkronisering
Synkroniseringen körs automatiskt enligt ett valt schema.
Du kan ange dag(ar) i veckan och tidpunkt för körningen.
Obs: För närvarande köas synken och startar kort efter 06:00 CET.
Omfång
Inställningen Omfång (Scope) gör det möjligt att specificera vilka medarbetare som ska ingå i exporten – manuellt eller automatiskt.
Detta är användbart om inte alla medarbetare ska överföras till Agda PS.
Omfångsurvalet följer standarden i Simployer.
Medarbetardata – Översikt
Medarbetardata synkroniseras från Simployer till Agda PS.
Om data uppdateras i Agda PS och sedan synkroniseras från Simployer, skrivs Agda PS-data över.
Vid synk jämförs värdena i Simployer och Agda PS. Endast ändrade fält uppdateras.
Data fields
Personal Information
Simployer One | Agda PS XML Field | Notes |
Person.employeeNumber | ANST_NR | Required - Long integer (1-999999999999) |
Person.nationalIdList[0].nationalId | PERSNR | Required - Swedish SSN format |
Person.firstName | FORNAMN | Required |
Person.lastName | EFTERNAMN | Required |
Person.gender | KON | MALE→"M", FEMALE→"K", other→"" |
Person.email | EMAILADRESS |
|
Person.birthdate | FODELSEDATUM | yyyy-MM-dd format |
Person.nationalIdList[0].country | MEDBORGARSKAP | From nationalId, not address |
Employee.organizationId | FTG_NR | If organizationId missing, hard-coded to “1” |
Note: FTG_NR + ANST_NR det som gör en medarbetare unik i Agda PS
Address Information
Simployer One | Agda PS XML Field | Notes |
Person.address.streetAddress1 | ADRESS | Home address only |
Person.address.postalCode | POSTNR |
|
Person.address.city | ORT |
|
Person.address.country | LAND |
|
Person.phoneNumber | TELEFON | Mobile address entry |
(hard-coded) | ADRESSTYP | "Hemadress" for address, "Mobiltelefon" for phone |
(hard-coded) | GALLANDE | true for home address, false for mobile |
Section omitted when: No address data AND no phone number present
Position Information
Simployer One | Agda PS XML Field | Notes |
Employee.jobTitle | BEFATTNING | Section omitted if empty or null |
(hard-coded) | BEFATTNINGSSTATUS | Hard-coded: "H" |
Employment Information
Simployer One | Agda PS XML Field | Notes |
Employee.hireDate | ANSTALLNINGSDATUM | Required for active employees |
Employment.endDate | AVGANGSDATUM | Only if person inactive OR no ongoing employment |
Employment.employmentType | ANSTALLNINGSFORM | permanent_employment→"Tillsvidareanställning", probation_employment→"Provanställning", hourly_employment→"Timanställning", fixed_employment→"Vikariat", consultant→"Konsult" |
Employment.startDate | TILLTRADE | Per employment period |
Employment.endDate | TILLTRADETOM | Per employment period |
Logik för inkludering av anställda:
Anställda med pågående anställning (inget slutdatum) inkluderas
Anställda med framtida anställningsdatum (nya anställningar som förbereds) inkluderas
Uppsagda anställda inom en 30-dagars respitperiod inkluderas
Uppsagda anställda efter 30-dagars respitperiod filtreras bort
Working Time
Simployer One | Agda PS XML Field | Notes |
Employment.rate | SYSSELSATTNINGSGRAD | From mainEmploymentId All employments with rate>0 included, sorted by start date. Montly salaries are automatically pro-rated based in the active employment only. Rate at compensation`s effective date. |
| Employment.startDate | FRAN | ISO date format (yyyy-MM-dd) |
| Employment.endDate | TILL | ISO date format (yyyy-MM-dd). Empty if no end date. |
Sektionen utelämnas när:
Inga anställningar finns eller huvudanställning inte hittas
Alla anställningar har sysselsättningsgrad = 0 eller tom (null)
Bank Account
Simployer One | Agda PS XML Field | Notes |
Person.bankAccount.clearing | CLEARINGNUMMER | First 4 digits of clearing number
|
| Person.bankAccount.clearing | CHECKSIFFRA | Remaining digits after first 4(if clearing > 4 digits) |
Person.bankAccount.accountNumber | BANKKONTONUMMER |
|
| Person.bankAccount.iban | BANKKONTONUMMER | |
| Person.bank.Account.bic | BIC | |
(hard-coded) | UTBETALNINGSTYP | Hard-coded: "Löneutbetalning" |
(hard-coded) | UTBETALNINGSSATT | Hard-coded: "Bankkonto" |
Sektionen utelämnas när: Ingen bankkontodata
Logik för clearingnummer:
Om clearingnumret har fler än 4 siffror, går de första 4 siffrorna till CLEARINGNUMMER och de återstående siffrorna till CHECKSIFFRA.
Organization
Simployer One | Agda PS XML Field | Notes |
| Office.name | TJANSTESTALLE | Service location/office name |
Group.groupName | AVDELNING | Department name |
| Manager name | ARBETSLEDARE | Manager's full name (firstName + lastName) |
Sektionen utelämnas när: Ingen data för kontor, avdelning eller chef finns tillgänglig
Accounting Dimensions
Simployer One | Agda PS XML Field | Notes |
|---|---|---|
CostCenter.costCenterCode | PKONTERING2 (value) | Cost center code as element value |
CostCenter.costCenterName | PKONTERING2 @KORTNAMN | Cost center name as attribute |
(hard-coded) | PKONTERING2 @NAMN | Hard-coded: "Kostnadsställe" |
Custom field: "DS-kod" | PKONTERING3 (value) | Custom field value from employee |
(hard-coded) | PKONTERING3 @NAMN | Hard-coded: "DS" |
Sektionen utelämnas när: Inget kostnadsställe och inget anpassat fält "ds" finns tillgängligt
Example XML:
Next of Kin (Children)
Simployer One | Agda PS XML Field | Notes |
|---|---|---|
Child.name | NARSTAENDENAMN | Child's full name |
Child.birthDate | NARSTAENDEFODELSEDAG | Birth date in yyyy-MM-dd format |
(hard-coded) | NARSTAENDENOTERING | Hard-coded: "Barn" |
(hard-coded) | NARSTAENDEVISAEJ | Hard-coded: false |
Sektionen utelämnas när: Inga barn är registrerade för den anställde
Salary Components
Simployer One | Agda PS XML Field | Notes |
Payroll.payoutPeriod/ AdditionalCompensation.salaryCode | LONEART | MONTHLY→"70", HOURLY→"10" , or custom salary code (1-999) for additional compensations |
Compensation.compensationAmount/ AdditionalCompensation.amount | BELOPP | For MONTHLY salary or additional compensations. See pro-rating rules below. |
Compensation.compensationAmount | PRIS | For HOURLY salary (price). Never pro-rated. |
Payroll.payrollEffectiveDate / AdditionalCompensation.effectiveDate | DATUM_IN | Start date (as XML attribute) |
(calculated) | DATUM_UT | End date: calculated (day before next payroll) for standard salaries, or explicit end date for additional compensations |
(type-specific) | FASTAARTER_TYP | "A" for MONTHLY/additional compensations, "P" for HOURLY |
Sektionen utelämnas när: Ingen kompensations-/lönedata eller inga stödda lönetyper finns tillgängliga
Regler för proportionering (Pro-Rating Rules)
Vad som proportioneras:
MÅNADSLÖNER (LONEART 70) proportioneras automatiskt enligt sysselsättningsgraden som är aktiv på lönenes giltighetsdatum
TIMLÖNER (LONEART 10) proportioneras aldrig (timlönen förblir densamma)
Ytterligare ersättningar proportioneras aldrig (fasta belopp enligt registrering i Simployer One)
Hur proportionering fungerar:
Integrationen hittar anställningsposten som är aktiv på lönenes giltighetsdatum
Lönen multipliceras med sysselsättningsgraden:
belopp × (grad / 100)Exempel: 15 000 SEK i lön vid 50 % sysselsättning = 7 500 SEK skickas till Agda
Viktigt för deltidsanställda:
När en anställds sysselsättningsgrad ändras (t.ex. från 100 % till 50 %) måste du skapa en ny ersättningspost i Simployer One med samma giltighetsdatum som ändringen i sysselsättningsgraden
Detta säkerställer att Agda får rätt proportionerat belopp från ändringsdatumet
Integration kommer att visa en valideringsvarning om den upptäcker en ändring i sysselsättningsgrad utan motsvarande ersättningspost
Example Scenario:
2025-07-01: Employment 100%, Salary 10,000 SEK → Agda receives 10,000 SEK 2025-08-01: Employment changes to 50%, NEW Salary 15,000 SEK created → Agda receives 7,500 SEK
Logik för lönehantering (Salary Processing Logic)
- Standardersättningar:
Löner delas upp efter typ (MÅNADSLÖN vs TIMLÖN), sorteras efter giltighetsdatum och får beräknade slutdatum. - Tilläggsersättningar:
- Kopplas oberoende med egna lönekoder (LONEART 1–999) och explicita start-/slutdatum från Simployer One.
- Tilläggsersättningar kräver en giltig lönekod (1–999). Ogiltiga eller saknade koder hoppas över och rapporteras.
- Dessa körs parallellt med de ordinarie månads- eller timlönerna.
- Använd <BELOPP>-elementet med typ "A" (som för månadslöner).
- Källdata hämtas från AdditionalCompensation-listan i Alexis.
- MÅNADSLÖN skapar <BELOPP>-element med typ "A".
- TIMLÖN skapar <PRIS>-element med typ "P".
Example XML Output
Vacation Entitlement
Simployer One | Agda PS XML Field | Notes |
|---|---|---|
Custom field with label: Semesterrätt | SEMESTERRATT | Please note this will overwrite the data field in Agda without creating a history post, don't use this field if this is not acceptable. |
Begränsningar
Frånvarodata synkroniseras inte.
Endast medarbetarinformation överförs – ingen frånvaro, ledighet eller tidrapportering.
Ingen realtidsuppdatering – integrationen körs via batch-filöverföring (upp till en gång per dag eller manuellt).
Endast medarbetare med giltigt svenskt personnummer och anställningsnummer behandlas.
Nyligen avslutade medarbetare inkluderas endast 30 dagar efter slutdatum.
Felsökning och frågor
För tekniska frågor om XML-utdata från Simployer One, kontakta Simployer support.
För frågor om uppsättning av Agda PS-importjobb och SFTP-åtkomst, kontakta Agda PS support.
Exempel på XML-utdata:
Vid behov kan du be Simployer Integration Team om ett exempel på XML-fil för granskning.
Var artikeln till hjälp?
Toppen!
Tack för din feedback
Vi beklagar att det inte var till hjälp
Tack för din feedback
Feddback skickat
Vi uppskattar din feedback och uppdaterar artikeln vid behov