Tripletex-integration

Ändrad den Tors, 6 nov. vid 11:46 F.M.

Viktigt: För alla nya integrationsinställningar rekommenderas det starkt att genomföra den första synkroniseringen med endast några få användare inom omfånget.
Detta hjälper till att säkerställa datakvalitet och en smidig uppstart innan hela organisationen inkluderas.


Allt du behöver veta om Tripletex standardintegration


Översikt

Med denna integration kopplar du Simployer One till ditt Tripletex-konto via API och kan därefter göra följande:


  • Schemalagd eller manuell synkronisering av anställdas data såsom personlig information, anställningsuppgifter, ersättningsdata med mera från Simployer One till Tripletex
  • Synkronisering av frånvarodata som sjukdom, föräldraledighet och semester till Tripletex för den period du själv väljer. Du har full kontroll över vilka frånvaron som exporteras, för vilka anställda och under vilken period


Tillgänglig i: Norge


Krav i Tripletex

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


Du kan generera en API-nyckel i ditt Tripletex-konto. Instruktioner finns här: Tripletex hjälpartikel


Konfiguration i Simployer

Integrationen aktiveras via:

Inställningar → Integrationer → Integrera med lönesystem → Lägg till integration



  • Under avsnittet API-integrationer, välj Tripletex
  • Klicka på Nästa för att starta konfigurationsguiden
  • Fyll i all nödvändig information för att etablera anslutningen
  • Valfritt: Ställ in ett specifikt omfång (vilka anställda som ska inkluderas i synkroniseringen) och/eller en schemalagd synkronisering från Simployer till Tripletex. 
Merk: Vid den första synkroniseringen rekommenderas att börja med en mindre grupp anställda för att säkerställa att allt fungerar som det ska.


Du kan välja hur synkroniseringen av anställda ska ske. Följande alternativ finns tillgängliga:


  • Manuell synkronisering
  • Data synkroniseras manuellt till Tripletex av användaren
  • Detta kan vara värdefullt om den schemalagda synkroniseringen är avstängd och du vill styra när data skickas till Tripletex – t.ex. under implementeringsfasen eller under perioder då uppdateringar inte är önskvärda på grund av process- eller lönekörning
  • Manuella synkroniseringar kan utföras även om schemalagd synkronisering är konfigurerad – användbart om många ändringar har skett i Simployer One efter senaste synkronisering


  • Schemalagd synkronisering
  • Synkroniseringen sker enligt ett schema som du själv definierar
  • Du kan välja veckodag(ar) när synkroniseringen ska köras



Observera: För närvarande läggs synkroniseringen i kö och startar strax efter kl. 06:00 CET.


Omfång (Scope)

  • Inställningarna för redigeringsomfång ger mer precision i vilka anställda som ska inkluderas vid automatisk eller manuellt utlöst export till Tripletex. Detta är användbart när inte alla anställda ska exporteras samtidigt.
  • Omfångsvalet följer den standardkonfiguration för omfång som finns i Simployer One.
  • När du konfigurerar integrationen för första gången rekommenderas att börja med en mindre grupp anställda inom omfånget. Detta säkerställer att datasynkroniseringen fungerar som den ska innan du aktiverar ändringar för hela organisationen.


Till exempel kan du börja med att synkronisera endast HR-teamet eller några testanvändare. När allt fungerar som det ska kan du utöka omfånget till att omfatta fler anställda.


Du kan när som helst uppdatera omfånget så att det passar organisationens behov — oavsett om du vill synkronisera endast nyanställda, utvalda avdelningar eller specifika platser.




Anställddata


Översikt

Anställningar skapas i Tripletex för nya anställda som ännu inte finns i Tripletex när integrationen körs.
Om den anställda redan finns i Tripletex innan integrationen konfigureras, lägger vi till nya anställningsdetaljer på den aktuella/aktiva anställningen i Tripletex för den personen.

Det är ett krav att den anställda har en anställning registrerad i Simployer One för att kunna skicka anställd- och anställningsdata till Tripletex.


Nedan hittar du de fält vi fyller i när en anställning skapas i Tripletex, samt de fält som uppdateras när en anställd avslutas i Simployer One.


Arbetsomfang 


SimployerOne 

Tripletex field

Mapping conditions

Additional Info

Employee.employeeNumber

Employee.employeeNumber

 

The employee number is used to match employees between Simployer One and Tripletex. It is thus not updated.  And it is important that the employee number is assigned correctly in the systems for the integration to work.

Employee.workEmail || Employee.privateEmail

Employee.email

Uses Simployer One work email if it exists. Otherwise the private email is used.

Not updated

Employee.workPhone

Employee.phoneNumberMobile

 

Updated if given new value in SimployerOne

Financial

SimployerOne

Tripletex field

Mapping conditions

Additional Info

Employee.bankAccount.number

Employee.bankAccountNumber

 

Updated if given new value in SimployerOne

Employee.bankAccount.iban

Employee.iban

 

Updated if given new value in SimployerOne. This field is required if the Bank country is other than Norway.

Employee.bankAccount.bic

Employee.bic

 

Updated if given new value in SimployerOne. This field is required if the Bank country is other than Norway.

Personal

SimployerOne

Tripletex field

Mapping conditions

Additional Info

Employee.firstName

Employee.firstName

 

Updated if changed

Employee.lastName

Employee.lastName

 

Updated if changed

Employee.birthDate

Employee.dateOfBirth

 

Field is required. Can be updated, but not after a-melding has been submitted for the employee in Tripletex.

Employee.ssn

Employee.nationalIdentityNumber

If ssn is NOT of DNumber format

Only updated if it does not have a value in Tripletex.

Employee.ssn

Employee.dnumber

If ssn IS of DNumber format

Updated if given new value

 

Employee.internationalId.number

 

 

Employee.homeAddress.street

Employee.address.addressLine1

 

Not updated

Employee.homeAddress.postalCode

Employee.address.postalCode

 

Not updated

Employee.homeAddress.city

Employee.address.city

 

Not updated

 

Employee.userType

 

Set to default STANDARD. Not updated

Employee.internationalId stöds för närvarande inte.
Kontakta Customer Success om detta är något du behöver. 


SimployerOne

Tripletex field

Mapping conditions

Additional Info

Employment.id

Employment.employmentId

 

The id of the first employment for the employee in Simployer One

Employment.startDate

Employment.startDate

 

We use the first employment of the employee to create an employment in Tripletex. Only if there is no employment registered in tripletex for said employee.

Employee.endDate

Employment.endDate

 

When employee is offboarded in Simployer One. We set the employment end date in Tripletex to the employee end date from Simployer One.

 

Employment.employmentEndReason

EMPLOYMENT_END_EMPLOYEE

When the employee is offboarded in SimployerOne, and we end the employment in Tripletex. We use the hardcoded value "EMPLOYMENT_END_EMPLOYEE" as the end reason. If the customer wants to change the reason, they have to do it manually in Tripletex.

Anställningsdetaljer – datamappning

Anställningsdetaljer skapas på den huvudsakliga/aktiva anställningen i Tripletex när en ny anställning skapas för en anställd i Simployer One, eller när en ny ersättning läggs till.

Om en ny anställning skapas i Simployer One kombineras anställningsdata med den senaste ersättningen som finns för den anställda.


På motsvarande sätt, om en ny ersättning läggs till i Simployer One, kombineras ersättningsdata med den senaste anställningen som finns för den anställda.


Simployer One field

Tripletex field

Mapping conditions

Additional Info

 

employmentDetail.employmentType

 

Set to ORDINARY by default

Employment.relations.type.name

employmentDetail.employmentForm

If Simployer One employment type name contains "permanent" → PERMANENT  If Simployer One employment type name contains "temporary" → TEMPORARY

 

Compensation.payoutPeriod

employmentDetail.remunerationType

ANNUAL → MONTHLY_WAGE  MONTHLY → MONTHLY_WAGE  HOURLY → HOURLY_WAGE  Otherwise → NOT_CHOSEN

Allowed values are:  [ MONTHLY_WAGE, HOURLY_WAGE, COMMISION_PERCENTAGE, FEE, NOT_CHOSEN, PIECEWORK_WAGE ]

Employment.rate

employmentDetail.percentageOfFullTimeEquivalent

 

 

Compensation.amount

employmentDetail.annualSalary

If Compensation.payoutPeriod is ANNUAL, then this field is set to Compensation.amount.  If Compensation.payoutPeriod is MONTHLY, then this field is set to Compensation.amount * 12.  Otherwise this field is not set.

 

Compensation.amount

employmentDetail.hourlyWage

if the Compensation.payoutPeriod is set to HOURLY. Otherwise this field is not set.

 

Employment.note

employmentDetail.occupationCode.code

If there is a 7 digit code in the notes field of the employment in Simployer One. And if the code matches one of the occupation codes in the Tripletex API, it will be set on the employment detail.

 


Frånvarodata

Observera: Frånvarodata (som sjukfrånvaro eller föräldraledighet) måste exporteras separat via Hantera tid → Export av frånvaro. 
Detta ingår inte i den schemalagda eller manuella synkroniseringsprocessen för anställda.


Översikt
Frånvarodata hanteras inte i de schemalagda eller manuella synkroniseringarna – du hittar dem under
Hantera tid → Export av frånvaro.



När du har exporterat dina anställda till Tripletex kan du även exportera frånvarodata för dem.


Klicka på Exportera, och kör sedan uppdateringen.


Observera: Om du exporterar något som redan är registrerat i Tripletex får du ett felmeddelande, eftersom vi inte skriver över befintlig data.



Viktig information

Om frånvarotypkoden i Simployer One är inställd på någon av följande:


  • FURLOUGH
  • PARENTAL_BENEFITS
  • MILITARY_SERVICE
  • OTHER_NOT_STATUTORILY_REQUIRED
  • OTHER_STATUTORILY_REQUIRED
  • EDUCATIONAL_NOT_STATUTORILY_REQUIRED
  • EDUCATIONAL_STATUTORILY_REQUIRED


Frånvaro kommer att exporteras till Tripletex som en ledighet.


I andra fall exporteras frånvaron som en tidsregistreringspost för en aktivitet som måste vara definierad i Tripletex. Du måste då säkerställa att frånvarotypkoden i Simployer One exakt matchar aktivitetsnumret i Tripletex.

Simployer One field

Tripletex field

Mapping conditions

leave.id

leaveOfAbsence.importedLeaveOfAbsenceId

leave.startDate

leaveOfAbsence.startDate

leave.endDate

leaveOfAbsence.endDate

leaveOfAbsence.percentage

Default set to 100% - graded leave of absence coming soon!

leave.id

leaveOfAbsence.importedLeaveOfAbsenceId

leave.relations.type.kind

leaveOfAbsence.type

If leave type code is set to one of the following in Simployer One:

FURLOUGH

PARENTAL_BENEFITS

MILITARY_SERVICE OTHER_NOT_STATUTORILY_REQUIRED

OTHER_STATUTORILY_REQUIRED

EDUCATIONAL_NOT_STATUTORILY_REQUIRED

EDUCATIONAL_STATUTORILY_REQUIRED

Datafält: Tidsregistreringsposter

Simployer One absence code

Xledger absence code

Comment

leave.relations.type.kind

entry.activity.number

leave.workingDays.days[].date

entry.date

hours

Default set to 7.5

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

Berätta för oss hur vi kan förbättra den här artikeln!

Välj minst en av orsakerna
CAPTCHA-verifiering krävs.

Feddback skickat

Vi uppskattar din feedback och uppdaterar artikeln vid behov