Tripletex-integrasjon - Ansatt data

Endret Wed, 10 Des, 2025 ved 7:35 AM

Tripletex-integrasjon - Ansatt data

Generell setup

Før du konfigurerer denne integrasjonen, vennligst fullfør Simployer HRM Integration – General Setup Guide]. Denne veiledningen dekker de første stegene for å sette opp integrasjoner i Simployer og sikrer at du har konfigurert nødvendige grunninnstillinger for en vellykket datasynkronisering.

Oversikt

Denne artikkelen dekker alle spesifikke detaljer for Tripletex standardintegrasjonen.

Integrasjonen muliggjør planlagt og manuell synkronisering av ansatt- og ansettelsesdata mellom Simployer One og Tripletex. Merk at enkelte datatyper, som fravær, følger egne eksportløp.

Tilgjengelig i: Norge

Tripletex krav

Du må ha tilgang til følgende gyldige påloggingsdetaljer.

Du kan generere en API-nøkkel for bruker i Tripletex-kontoen din, og instruksjoner finnes her: Tripletex help center article.

Simployer Krav

Den ansatte må ha en gyldig ansettelse registrert i Simployer One; først da kan ansatt- og ansettelsesdata eksporteres til Tripletex.

Organisasjons regler

Ansattnummer må være identiske i Simployer One og Tripletex for at integrasjonen skal fungere riktig. Tildel unike og korrekte ansattnumre i begge systemer.
Ansattes startdato må samsvare med Simployer og Tripletex
Kompensasjonsstartdatoen må samsvare i både Simployer og Tripletex.
E-post for ansatte prioriteres som jobb-epost; hvis denne mangler, brukes privat e-post. Feltet oppdateres ikke etter første synkronisering.
Oppdatering av felter (som telefonnummer, bankdetaljer, personinformasjon) skjer kun når nye verdier legges inn eller endres i Simployer One.
Enkelte felter er uforanderlige eller oppdateres kun under bestemte betingelser (for eksempel kan fødselsdato ikke endres etter innsending av a-melding i Tripletex).
Fødselsnummer oppdateres kun i Tripletex dersom det ikke allerede finnes en verdi; hvis D-nummer brukes, synkroniseres dette dersom det er registrert.
Enkelte personidentifikasjonsfelt (f.eks. internasjonal ID) støttes ikke for øyeblikket—kontakt Support hvis du trenger disse.
Adressefelt oppdateres ikke i Tripletex etter første opprettelse, så eventuelle endringer i hjemmeadresse må håndteres manuelt i Tripletex.

Den følgende seksjonen beskriver feltmapping mellom Simployer og Tripletex for ansattdata, inkludert opprettelse, oppdateringer og begrensninger for hvert felt.

Ansatt data

Overview

Integrasjonen matcher ansatte basert på ansattnummer. Hvis ansattnummeret i Simployer One samsvarer med en eksisterende ansatt i Tripletex, vil integrasjonen oppdatere detaljene for denne ansatte i Tripletex. Hvis ikke, vil en ny ansattprofil bli opprettet.

Når integrasjonen kjører, opprettes ansettelser i Tripletex for alle ansatte som ikke allerede finnes der. Dersom en ansatt allerede er registrert i Tripletex før integrasjonsoppsett, vil integrasjonen legge til nye ansettelsesdetaljer til den nåværende aktive ansettelsen i Tripletex.

En ansettelse i Simployer One er nødvendig for å muliggjøre eksport av både ansatt- og ansettelsesdata til Tripletex.

Nedenfor er feltene som fylles ut ved opprettelse av en ansettelse i Tripletex, samt feltene som oppdateres når den ansatte offboardes i Simployer One:

Arbeidsomfang

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 støttes foreløpig ikke.
Ta kontakt med Customer Success dersom dette er noe du har behov for.

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.

Ansettelsesdetaljer – datakobling

Ansettelsesdetaljer opprettes på hoved-/aktive ansettelsesforhold i Tripletex når en ny ansettelse opprettes for en ansatt i Simployer One, eller når en ny kompensasjon legges til.

Hvis en ny ansettelse opprettes i Simployer One, kombineres ansettelsesdataene med den siste kompensasjonen som finnes for den ansatte.

Tilsvarende, hvis en ny kompensasjon legges til i Simployer One, kombineres kompensasjonsdataene med den siste ansettelsen som finnes for den ansatte.

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.

For å sette opp fraværsdata, følg artikkelen Tripletex-integrasjon – fraværsdata.