Agda PS: Integrasjon
Oversikt
Med denne integrasjonen kobler du Simployer One til din Agda PS-konto via SFTP, og kan deretter gjøre følgende:
Planlagt eller manuell synkronisering av ansattdata som personopplysninger, ansettelsesdata, lønnsdata og mer fra Simployer til Agda PS.
Tilgjengelig i: Sverige
Krav fra Agda PS
SFTP-servertilgang
Du må be om en dedikert SFTP-konto fra Agda PS support.
Agda PS vil gi deg brukerinformasjon slik at Simployer One kan levere XML-filene.
Oppsett av Agda-importjobb
Agda PS må konfigurere en importjobb for automatisk behandling av disse XML-filene fra ditt SFTP-område.
Merk: Når du konfigurerer integrasjonen, kan du velge å sende filene til enten mappenTest\Importfiler eller Prod\Importfiler i ditt Agda PS SFTP-område. Dette kan brukes under oppsettet sammen med Agda.
Merk: Det kan forekomme oppstarts- og løpende servicegebyrer fra Agda PS for filbehandling.
Hvordan filoverføringen i Agda PS fungerer
Når integrasjonen kjører, oppretter Simployer One automatisk ansattfiler i Agda PS XML Person Export-format og sender dem til importområdet på din Agda PS SFTP.
Flere organisasjoner
Hvis du har flere organisasjoner i Simployer One, opprettes én fil per organisasjon.
Dette gjør det enklere å importere data separat og for Agda PS å vite hvilken organisasjon som tilhører hvilket Agda PS-selskap.
Filnavnformat:
[Organisasjons-ID]-[Organisasjonsnavn]-employees-[Dato og Tid].xml
Eksempel:1-Acme_Corp-employees-20250103-143022.xml
Filplassering:
Filene leveres til mappen du valgte under oppsettet.
Oppsett i Simployer
Integrasjonen aktiveres via:
Innstillinger → Integrasjoner → Velg lønnssystem → Legg til integrasjon
I seksjonen API-integrasjoner, velg Agda PS
Klikk Neste for å starte konfigurasjonsveiviseren
Fyll inn all nødvendig informasjon for tilkoblingen
Valgfritt: Definer et spesifikt omfang (hvilke ansatte som skal inkluderes i synken) og/eller sett opp en planlagt synkronisering fra Simployer til Agda PS
Innstillinger
Du kan velge hvordan integrasjonen skal kjøre synkronisering av ansatte:
Manuell synkronisering
Data synkroniseres manuelt til Agda PS av brukeren.
Nyttig hvis planlagt synkronisering er slått av, og du vil kontrollere når data sendes (for eksempel i implementeringsfasen eller ved lønnsperioder).
Manuelle synkroniseringer kan også utføres selv om planlagt synkronisering er aktivert.
Planlagt synkronisering
Synkroniseringen kjøres automatisk etter en valgt tidsplan.
Du kan angi dag(er) i uken og tidspunkt for kjøring.
Merk: For øyeblikket starter køen kort tid etter kl. 06:00 CET.
Omfang
Innstillingen Omfang (Scope) lar deg definere hvilke ansatte som skal inkluderes i eksporten – enten manuelt eller automatisk.
Dette er nyttig dersom ikke alle ansatte skal overføres til Agda PS.
Omfangsvalg følger standard oppsett for omfang i Simployer.
Ansattdata – Oversikt
Ansattdata synkroniseres fra Simployer til Agda PS.
Dersom data oppdateres i Agda PS og deretter synkroniseres fra Simployer, vil dataene i Agda PS bli overskrevet.
Ved synkronisering sammenlignes verdiene i Simployer og Agda PS. Kun endrede felt oppdateres.
Data felt
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 er det som gjør en medarbeider 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 |
Logikk for inkludering av ansatte:
Ansatte med pågående arbeidsforhold (ingen sluttdato) inkluderes
Ansatte med fremtidige startdatoer (nye ansatte som forberedes) inkluderes
Oppsagte ansatte innenfor en 30-dagers karensperiode inkluderes
Oppsagte ansatte utover 30-dagers karensperiode filtreres 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. |
Seksjonen utelates når:
Ingen ansettelsesforhold finnes eller hovedansettelse ikke er funnet
Alle ansettelsesforhold har ansettelsesgrad = 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 | IBAN | |
| Person.bank.Account.bic | BIC | |
(hard-coded) | UTBETALNINGSTYP | Hard-coded: "Löneutbetalning" |
(hard-coded) | UTBETALNINGSSATT | Hard-coded: "Bankkonto" |
Seksjonen utelates når: Ingen bankkontodata
Logikk for kontonummer (Clearing Number Logic):
Hvis clearingnummeret har mer enn 4 sifre, går de første 4 sifrene til CLEARINGNUMMER, og de resterende sifrene går til 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) |
Seksjonen utelates når: Ingen data for kontor, avdeling eller leder er tilgjengelig
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 for forholdsmessig beregning (Pro-Rating Rules)
Hva som beregnes forholdsmessig:
MÅNEDSLØNN (LONEART 70) beregnes automatisk forholdsmessig basert på ansettelsesgraden som er aktiv på lønnens gyldighetsdato
TIMELØNN (LONEART 10) beregnes aldri forholdsmessig (satsen per time forblir den samme)
Ekstra kompensasjoner beregnes aldri forholdsmessig (faste beløp som lagt inn i Simployer One)
Hvordan forholdsmessig beregning fungerer:
Integrasjonen finner ansettelsesforholdet som er aktivt på lønnens gyldighetsdato
Lønnsbeløpet multipliseres med ansettelsesgraden:
beløp × (grad / 100)Eksempel: 15 000 SEK i lønn ved 50 % stilling = 7 500 SEK sendes til Agda
Viktig for deltidsansatte:
Når en ansatts stillingsprosent endres (f.eks. fra 100 % til 50 %), må du opprette en ny kompensasjonsregistrering i Simployer One med samme gyldighetsdato som endringen i stillingsprosent
Dette sikrer at Agda mottar riktig forholdsmessig beregnet beløp fra datoen endringen trer i kraft
Integrasjonen vil gi en valideringsadvarsel dersom den oppdager en endring i stillingsprosent uten en tilsvarende kompensasjonsregistrering
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
Logikk for lønnsbehandling (Salary Processing Logic)
Lønninger deles etter type (MÅNEDSLØNN vs TIMELØNN), sorteres etter gyldighetsdato, og får beregnede sluttdatoer.
- Tilleggskompensasjoner:
- Knyttes uavhengig med egne lønnskoder (LONEART 1–999) og eksplisitte start-/sluttdatoer fra Simployer One.
- Tilleggskompensasjoner krever en gyldig lønnskode (1–999). Ugyldige eller manglende koder blir hoppet over og rapportert.
- Disse kjøres parallelt med de standard månedlige eller timelønnede lønningene.
- Bruk <BELOPP>-elementet med type "A" (som for månedslønn).
- Kildedata hentes fra AdditionalCompensation-listen i Alexis.
- MÅNEDSLØNN oppretter <BELOPP>-elementer med type "A".
- TIMELØNN oppretter <PRIS>-elementer med type "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. |
Begrensninger
Fraværsdata synkroniseres ikke.
Kun ansattinformasjon overføres – ikke fravær, permisjon eller tidsregistrering.
Ingen sanntidsoppdatering – integrasjonen kjører via batch-filoverføring (inntil én gang per dag eller manuelt).
Kun ansatte med gyldig svensk personnummer og ansattnummer behandles.
Nylig avsluttede ansatte inkluderes kun i 30 dager etter sluttdato.
Feilsøking og spørsmål
For tekniske spørsmål om XML-output fra Simployer One, kontakt Simployer support.
For spørsmål om oppsett av Agda PS-importjobber og SFTP-tilgang, kontakt Agda PS support.
Eksempel på XML-output:
Om ønskelig kan du be Simployer Integration Team om et eksempel på XML-fil til gjennomgang.
Var denne artikkelen nyttig?
Så bra!
Takk for din tilbakemelding
Beklager at vi ikke kunne være mer til hjelp
Takk for din tilbakemelding
Tilbakemeldingen er sendt inn
Vi setter pris på tilbakemeldingen din og vil prøve å rette på artikkelen