Tripletex-integration - anställd- och anställningsdata

Ändrad den Ons, 10 dec. vid 7:37 F.M.

Tripletex-integration - anställd- och anställningsdata

Reference General Setup
Innan du konfigurerar denna integration ber vi dig slutföra Simployer HRM Integration – General Setup Guide.

Denna guide täcker de inledande stegen för att konfigurera integrationer i Simployer och säkerställer att du har ställt in nödvändiga grundinställningar för en framgångsrik datasynkronisering.

Denna artikel täcker alla specifika detaljer för Tripletex standardintegration.

Integrationen möjliggör schemalagd och manuell synkronisering av anställd- och anställningsdata mellan Simployer One och Tripletex. Observera att vissa datatyper, såsom frånvaro, följer separata exportflöden.

Tillgänglig i: Norge

Tripletex krav

Du måste ha tillgång till följande giltiga autentiseringsuppgifter.

Du kan generera en API-nyckel för användare i ditt Tripletex-konto och instruktioner finns här: Tripletex help center article.

Simployer krav

Den anställde måste ha en giltig anställning registrerad i Simployer One; först då kan anställd- och anställningsdata exporteras till Tripletex.

Affärsregler

Anställningsnummer måste matcha mellan Simployer One och Tripletex för att integrationen ska fungera korrekt. Tilldela unika och korrekta anställningsnummer i båda systemen.
Anställdas startdatum måste matcha i Simployer och Tripletex
Ersättningens ikraftträdandedatum måste matcha i både Simployer och Tripletex.
E-postadress för anställda prioriteras som arbetsmejl; om den saknas används privat mejl. Detta fält uppdateras inte efter första synken.
Uppdatering av fält (som telefonnummer, bankuppgifter, personliga uppgifter) sker endast när nya värden läggs till eller ändras i Simployer One.
Vissa fält är oföränderliga eller uppdateras endast under vissa villkor (t.ex. födelsedatum kan inte ändras efter a-meldingsinlämning i Tripletex).
Personnummer uppdateras endast i Tripletex om det inte finns något befintligt värde; om samordningsnummer används synkas detta om det är angivet.
Vissa personliga identifikationsfält (t.ex. internationellt ID) stöds för närvarande inte—kontakta Support om du behöver dessa funktioner.
Adressfält uppdateras inte i Tripletex efter första skapandet, så eventuella ändringar av hemadress måste hanteras manuellt i Tripletex.

Följande avsnitt beskriver fältmapping mellan Simployer och Tripletex för anställdata, inklusive skapande, uppdateringar och begränsningar för varje fält.

Anställningsdata

Integrationen matchar anställda baserat på deras anställningsnummer. Om anställningsnumret i Simployer One matchar en befintlig anställd i Tripletex kommer integrationen att uppdatera uppgifterna för denna person i Tripletex. Om inte, skapas en ny anställdpost.

När integrationen körs skapas anställningar i Tripletex för alla anställda som ännu inte finns där. Om en anställd redan är registrerad i Tripletex före integrationsuppsättningen kommer integrationen att lägga till nya anställningsuppgifter till den aktuella aktiva anställningen i Tripletex.

En anställning i Simployer One krävs för att möjliggöra export av både anställd- och anställningsdata till Tripletex.

Nedan visas de fält som fylls i när en anställning skapas i Tripletex, samt de fält som uppdateras när den anställde offboardas i Simployer One:

Work Section

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	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
Is not fetched - set to default	Employee.userType		Set to default STANDARD. Not updated

Employee.internationalId is not supported currently. Reach out to CS if this is something you need.

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.
See additional comment	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
Is not fetched - set to default	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.	For norweigan customers,we recommend that you use annual or hourly as the payout period.
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.

För att konfigurera frånvarodata, följ artikeln Tripletex-integration – frånvarodata.