Tripletex-integrasjon

Endret Thu, 6 Nov ved 11:47 AM

Viktig: For alle nye integrasjonsoppsett anbefales det sterkt å utføre den første synkroniseringen med kun noen få brukere i omfanget.
Dette bidrar til å sikre datanøyaktighet og en smidig oppstart før hele organisasjonen inkluderes.


Alt du trenger å vite om Tripletex standardintegrasjon


Oversikt

Med denne integrasjonen kobler du Simployer One til din Tripletex-konto via API, og kan deretter gjøre følgende:


  • Planlagt eller manuell synkronisering av ansattdata som personlig informasjon, ansettelsesdata, lønnsinformasjon og mer fra Simployer One til Tripletex
  • Synkronisering av fraværsdata som sykdom, foreldrepermisjon og ferie til Tripletex for den perioden du velger. Du har full kontroll over hvilke fravær som eksporteres, for hvilke ansatte og for hvilken periode


Tilgjengelig i: Norge


Krav i Tripletex

Du må ha tilgang til følgende gyldige legitimasjon:



Oppsett i Simployer

Integrasjonen aktiveres via:

Innstillinger → Integrasjoner → Integrer med lønnssystem → Legg til integrasjon



  • I delen API-integrasjoner, velg Tripletex
  • Klikk Neste for å starte konfigurasjonsveiviseren
  • Fyll inn all nødvendig informasjon for tilkoblingen
  • Valgfritt: Sett opp et spesifikt omfang (hvilke ansatte som skal inkluderes i synkroniseringen) og/eller en planlagt synkronisering fra Simployer til Tripletex. 
Merk: For den første synkroniseringen anbefales det å starte med et mindre utvalg av ansatte for å sikre at alt fungerer som det skal.


Innstillinger

Du kan velge hvordan synkroniseringen av ansatte utføres. Følgende alternativer er tilgjengelige:


  • Manuell synkronisering
  • Data synkroniseres manuelt til Tripletex av brukeren
  • Dette kan være nyttig dersom planlagt synkronisering er deaktivert, og du ønsker å kontrollere når data sendes til Tripletex – f.eks. under implementering eller i perioder hvor oppdatering ikke er ønsket pga. prosesser og lønnskjøring
  • Manuelle synkroniseringer kan også utføres selv om planlagt synkronisering er aktivert – nyttig dersom mange endringer har skjedd i Simployer One siden forrige synkronisering


  • Planlagt synkronisering
  • Synkronisering skjer etter en fastsatt tidsplan
  • Du kan velge ukedag(er) for når synkroniseringen skal utføres


Merk: Per nå blir synkronisering plassert i kø og starter kort tid etter kl. 06:00 CET.



Omfang (Scope)

  • Innstillingene for redigeringsomfang gir mer presisjon i hvilke ansatte som skal inkluderes ved automatisk eller manuelt utløst eksport til Tripletex. Dette er nyttig dersom ikke alle ansatte skal eksporteres samtidig.
  • Omfangsvalget følger den standardkonfigurasjonen for omfang som finnes i Simployer One.
  • Når du setter opp integrasjonen for første gang, anbefales det å starte med et lite utvalg av ansatte i omfanget. Dette bidrar til å sikre at datasynkroniseringen fungerer som forventet før du aktiverer endringer for hele organisasjonen.

For eksempel kan du begynne med å synkronisere kun HR-teamet eller noen få testbrukere. Når alt fungerer som det skal, kan du utvide omfanget til å inkludere flere ansatte.


Du kan når som helst oppdatere omfanget slik at det passer til organisasjonens behov — enten du ønsker å synkronisere kun nyansatte, utvalgte avdelinger eller bestemte lokasjoner.





Ansattdata

Oversikt

Ansettelser opprettes i Tripletex for nye ansatte som ennå ikke finnes i Tripletex når integrasjonen kjøres.
Hvis den ansatte allerede finnes i Tripletex før integrasjonen settes opp, legger vi til nye ansettelsesdetaljer på den gjeldende/aktive ansettelsen i Tripletex for den ansatte.

Det er et krav at den ansatte har en ansettelse registrert i Simployer One for at ansatt- og ansettelsesdata skal kunne sendes til Tripletex.


Nedenfor finner du feltene vi fyller ut når en ansettelse opprettes i Tripletex, samt feltene som oppdateres når en ansatt avsluttes 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

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ø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.

 

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

 

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.

 



Fraværsdata

Merk: Fraværsdata (for eksempel sykefravær eller foreldrepermisjon) må eksporteres separat via Administrer tid → Eksport av fravær.
Dette er ikke inkludert i den planlagte eller manuelle synkroniseringsprosessen for ansatte.


Oversikt
Fraværsdata håndteres ikke i de planlagte eller manuelle synkroniseringene – du finner dem under
Administrer tid → Eksport av fravær.



Når du har eksportert de ansatte til Tripletex, kan du også eksportere fraværsdata for dem.


Klikk på Eksporter, og kjør deretter oppdateringen.


Merk: Hvis du eksporterer noe som allerede er registrert i Tripletex, vil du få en feilmelding, ettersom vi ikke overskriver eksisterende data.


Nøkkelinformasjon

Dersom fraværskoden i Simployer One er satt til én av følgende:


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


Fraværet blir eksportert til Tripletex som et permisjonsfravær. Ellers vil fraværet bli eksportert som en timelisteoppføring for en aktivitet som må være definert i Tripletex. Du må derfor sikre at fraværskoden i Simployer One stemmer nøyaktig med aktivitetsnummeret i Tripletex.


Datafelter:

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

Datafelter: Timelisteoppføringer

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 denne artikkelen nyttig?

Så bra!

Takk for din tilbakemelding

Beklager at vi ikke kunne være mer til hjelp

Takk for din tilbakemelding

Fortell oss hvordan vi kan forbedre denne artikkelen.

Velg minst én av grunnene
CAPTCHA-verifisering er obligatorisk.

Tilbakemeldingen er sendt inn

Vi setter pris på tilbakemeldingen din og vil prøve å rette på artikkelen