Xledger-integrering

Ändrad den Mån, 5 jan. vid 10:37 F.M.

Allt du behöver veta om Xledger standardintegration

Översikt

Med denna integration kopplar du Simployer One till ditt Xledger-konto via API. Det ger dig möjlighet att:

Köra schemalagd eller manuell synkronisering av anställdas data såsom personuppgifter, anställningsinformation, ersättningsdata m.m. från Simployer One till Xledger.
Synkronisera frånvarodata såsom sjukfrånvaro, föräldraledighet och semester till Xledger för valfri period. Du har full kontroll över vilka frånvarotyper som exporteras, för vilka anställda och under vilken period.

Tillgängligt i: Norge

Krav från Xledger

Du behöver ha tillgång till följande giltiga behörighet:

Åtkomsttoken
Den hittar du här: https://xledger.net/f/api-tokens

Klicka på Generate new token
Ange en beskrivning av token, till exempel ”Simployer One” eller ”Simployer”
Välj «Read» och «Write» för följande områden:
- Accounts payable
- Accounts receivable
- Common and General Ledger
- Human Resources
Klicka på Generate token

När token har skapats kan den användas vid konfiguration av Xledger-integrationen i Simployer One.

Lägga till integrationen

Integrationen aktiveras via:

Inställningar → Integrationer → Lägg till integration (i avsnittet "Integrera med lönesystem").

I avsnittet API-integreringar, välj Xledger
Klicka på Nästa för att starta konfigurationsguiden
Ange alla nödvändiga uppgifter för anslutningen

Inställningar

Du kan välja hur synkroniseringen av anställda ska genomföras. Följande alternativ finns:

Manuell synkronisering

Data synkroniseras manuellt till Xledger av användaren
Detta är användbart om schemalagd synkronisering är avstängd och du vill styra exakt när data överförs, till exempel under implementation eller vid känsliga löneperioder
Manuell synkronisering kan även köras när schemalagd synkronisering är aktiv, om många ändringar har gjorts i Simployer One efter senaste körning

Schemalagd synkronisering

Synkroniseringen körs automatiskt enligt ett schema som du definierar
Du kan välja vilka veckodagar och vilken tid på dagen synkroniseringen ska köras

Obs! När schemalagd synkronisering är aktiverad köas den och körs strax efter kl. 06:00 CET följande dag.

Omfattning (Scope)

Omfattning gör det möjligt att skapa mer detaljerade filter som styr vilka anställda som inkluderas i synkroniseringen
Detta är särskilt användbart om vissa anställda ska exkluderas från exporten till Xledger
Omfattning följer samma logik och funktionalitet som i övriga HR-funktioner i Simployer One

Anställdadata

Anställddata synkroniseras från Simployer One till Xledger. Det innebär att om data uppdateras i Xledger i aktuella datafält, och därefter synkronisering från Simployer One körs, kommer data i Xledger att skrivas över.

När synkroniseringen körs jämförs datafälten i Simployer One med motsvarande värden i Xledger.

Om det inte finns några ändringar uppdateras inte användaren.
Om det finns ändringar uppdateras data i Xledger.

Vissa fält är för närvarande hårdkodade eller har standardvärden. Se tabellen nedan för mer information.

Simployer field	Xledger field	Mapping conditions
Work
Employee.employeeNumber	Employee.code	Required
Employee.workEmail	Contact.email
Financial
Employee.bankAccount.number	Supplier.account
Personal
Person.firstName	Employee.firstName Contact.firstName
Person.lastName	Employee.lastName Contact.lastName
Person.firstName Person.lastName	Contact.name Employee.description	Fields from Simployer are concatenated and then separated by a space
Person.NationalIdList[0].NationalId	Contact.socialSec	If the SSN is removed in Simployer, it will be removed in Xledger as well
Person.Birthdate	Contact.birthday
Employee.nationality	Contact.country
Person.PhoneNumber	Contact.phone
Person.email	Contact.email
Person.Address.street1	Contact.streetAddress
Person.Address.city	Contact.place
Person.Address.postalCode	Employee.zipcode
Employment
Employee.hireDate	Employment.dateFrom
Employment.type
Employment.rate

Krav och begränsningar

Employee.employeeNumber krävs
Employee.hireDate krävs
Employee.jobTitle krävs (anställda utan befattning hoppas över)
Person.email krävs
Employment.startDate krävs (anställningar utan startdatum hoppas över)
Endast aktiva anställda behandlas (tidigaste anställningen används om flera finns)
Endast tillsvidareanställningar (permanent_employment) med 100 % tjänst synkroniseras
- Deltidsanställningar hoppas över med varning
Endast NOK stöds som valuta för lönesatser (andra valutor hoppas över)
Historisk data (befattningar/löner före innevarande månad/år) kan inte synkroniseras för befintliga anställda på grund av låsta bokföringsperioder
Stödda utbetalningsperioder:
- HOURLY
- MONTHLY
- ANNUAL
  (andra perioder hoppas över)

Frånvarodata

Frånvarodata synkroniseras från Simployer One till Xledger. Det innebär att om data uppdateras i Xledger i relevanta datafält, och därefter synkronisering från Simployer One körs, kommer data i Xledger att skrivas över.

När synkroniseringen körs jämförs frånvarodata i Simployer One med motsvarande värden i Xledger.

Om det inte finns några ändringar uppdateras inte data.
Om det finns ändringar uppdateras data i Xledger.

Vissa fält är för närvarande hårdkodade. Se informationen nedan för mer detaljer.

Simployer field	Xledger field	Mapping conditions
Data
	leavePercent	Defaulted to `100`
AbsenceStartDate	timeFrom
AbsenceEndDate	timeTo
AbsenceEndDate	toDate
AbsenceStartDate	fromDate
	Comment	Defaulted to "temporary comment"
Codes
childcare	“CS”
vacation	“V”
sick_leave	“SWN”
{custom leavecode}	{custom leavecode}	A custom leave code must be set to the exact value defined in Xledger