Agda PS: Integrasjon

Endret Tue, 14 Okt ved 1:31 PM

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 mappen
Test\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”

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

Working Time

Simployer One	Agda PS XML Field	Notes
Employment.rate	SYSSELSATTNINGSGRAD	From mainEmploymentId employment only. Section omitted if no mainEmploymentId OR main employment not found

Bank Account

Simployer One	Agda PS XML Field	Notes
Person.bankAccount.clearing	CLEARINGNUMMER	Section omitted if no bank account data
Person.bankAccount.accountNumber	BANKKONTONUMMER
(hard-coded)	UTBETALNINGSTYP	Hard-coded: "Löneutbetalning"
(hard-coded)	UTBETALNINGSSATT	Hard-coded: "Bankkonto"

Organization

Simployer One	Agda PS XML Field	Notes
Group.groupName	AVDELNING

Salary Components

Simployer One	Agda PS XML Field	Notes
Payroll.payoutPeriod	LONEART	MONTHLY→"70", HOURLY→"10"
Compensation.compensationAmount	BELOPP	For MONTHLY salary (amount)
Compensation.compensationAmount	PRIS	For HOURLY salary (price)
Payroll.payrollEffectiveDate	DATUM_IN	Start date (as XML attribute)
(calculated)	DATUM_UT	End date (day before next payroll starts)
(type-specific)	FASTAARTER_TYP	"A" for MONTHLY, "P" for HOURLY

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.