Agda PS: Inteagration

Ändrad den Tis, 14 okt. vid 1:34 E.M.

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

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

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.