SAP SuccessFactors logoProtime logo

Verlof, verzuim en uren

SAP SuccessFactors Protime koppeling: medewerkers en contracturen uit Employee Central in de tijdregistratie

Met een koppeling tussen SAP SuccessFactors en Protime komt elke medewerker van de Nederlandse en Belgische bedrijven uit Employee Central automatisch in Protime, met contracturen, voltijdnorm, afdeling, locatie en werkgever op de ingangsdatum uit SuccessFactors. Een overplaatsing of urenwijziging die HR in Employee Central vooruit plant, staat daardoor op de juiste dag in Protime, en wie vertrekt kan na de laatste werkdag niet meer klokken.

Wat de koppeling doet

Organisaties die medewerkers in SAP SuccessFactors Employee Central beheren en in Nederland of België klokken in Protime, zetten nieuwe medewerkers met de hand in Protime. Een overplaatsing of urenwijziging die HR vooruit in Employee Central plant, komt pas in Protime als iemand eraan denkt, vaak als de medewerker al op de nieuwe afdeling klokt.

  1. HR legt in Employee Central een indiensttreding, functiewijziging of beëindiging vast voor een Nederlands of Belgisch bedrijf.
  2. KoppelHet haalt de gewijzigde medewerkers op, alleen voor de bedrijven die Protime gebruiken.
  3. Een nieuwe medewerker komt in Protime met een contract op basis van de standaarduren en de voltijdnorm.
  4. Afdeling, functie, locatie en werkgever gaan als historie naar Protime, met de ingangsdatum uit Employee Central.
  5. Bij een beëindiging krijgt de persoon in Protime een datum uit dienst.
SAP SuccessFactors → KoppelHet → ProtimeBRONSAP SuccessFactorsDOELProtimeKoppelHetmapping · logging · monitoringSAP SuccessFactors → KoppelHet → ProtimeBRONSAP SuccessFactorsDOELProtimeKoppelHetmapping · logging · monitoring
Heen: Persoon met personeelsnummer, naam en datum in en uit dienst · Contract met standaarduren en voltijdnorm · Afdeling, functie en locatie met ingangsdatum · Werkgever (legal entity)

Waar je op let bij SAP SuccessFactors en Protime

  • Employee Central bewaart op de functiegegevens de standaarduren van een medewerker en zijn fte. Protime vraagt bij een contract de contracturen en de uren van een voltijd werkweek. KoppelHet berekent de voltijdnorm uit standaarduren gedeeld door fte, zodat een Belgische vier-vijfde in Protime dezelfde verhouding heeft als in SuccessFactors.
  • Employee Central kan op één dag meerdere wijzigingen van de functiegegevens hebben, onderscheiden met een volgnummer. Protime houdt per historisch veld één regel per startdatum bij. KoppelHet neemt per dag de laatste wijziging, zodat een correctie op dezelfde dag de eerdere waarde vervangt in plaats van een tweede regel te maken.
  • Een concern in SuccessFactors heeft vaak bedrijven in veel landen, terwijl Protime alleen in Nederland en België draait. KoppelHet vraagt alleen de bedrijven op die Protime gebruiken en zet het bedrijf als werkgever in Protime, zodat de salarisexport uit Protime per werkgever klopt.
  • Gaat een medewerker van een Belgische naar een Nederlandse vestiging, dan krijgt hij in Employee Central vaak een nieuw dienstverband bij een ander bedrijf. In Protime blijft het één persoon met een nieuwe werkgever in de historie, gevonden op het vaste personeelsnummer, zodat zijn kloktijden niet over twee personen verdeeld raken.
  • Protime maakt bij een herhaalde aanvraag zonder sleutel een tweede persoon aan. KoppelHet geeft het personeelsnummer uit SuccessFactors mee als externe referentie, die Protime maar één keer toestaat.
  • Afwezigheid is in de Protime API alleen te lezen. Gebruiken de vestigingen verlof in SuccessFactors, dan kan dat niet automatisch in Protime komen. In deze opzet vragen medewerkers verlof aan in Protime; goedgekeurde afwezigheid terug naar Employee Central kan later als uitbreiding.

Hoe we het bouwen en beheren

  • De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
  • Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
  • Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
  • KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
  • Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
  • De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.

Implementatie, architectuur en compliance

Implementatie en prijs

Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.

Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.

Prijsindicatie · Basis

Laat je zakelijke e-mailadres achter, dan zie je de prijsindicatie direct.

We gebruiken je adres alleen om je vraag over deze koppeling op te volgen.

Veelgestelde vragen

Kan verlof uit SuccessFactors naar Protime?

Niet via de Protime API, want afwezigheid is daar alleen te lezen. Daarom wordt verlof in Protime aangevraagd. Moet het per se in SuccessFactors blijven, dan bespreken we met Protime welke importmogelijkheid er is.

Gaan de geklokte uren naar SuccessFactors?

Nee. De uren gaan van Protime naar de lokale salarisverwerking. Uren in SuccessFactors kan later als uitbreiding.

Werkt de koppeling nog na het einde van basic authentication bij SuccessFactors?

Ja. KoppelHet meldt zich aan met OAuth 2.0 en een SAML bearer assertion, niet met gebruikersnaam en wachtwoord.

Technische details voor IT

Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.

  • SuccessFactors via de OData API v2 met OAuth 2.0 en een SAML bearer assertion, op lastModifiedDateTime en gefilterd op company. Entiteiten PerPerson (personIdExternal), PerPersonal, EmpEmployment, EmpJob (standardHours, fte, company, department, location, startDate, seqNumber) en EmpEmploymentTermination.
  • Protime via de Protime API (v1) met OAuth 2.0 client credentials en scopes per collectie. POST people met externalReferenceIdentifier (409 bij een bestaande referentie), POST contracts (contractHoursInMinutes en fullTimeEquivalentInMinutes tussen 1 en 5999, numberOfDaysInContractPeriod een veelvoud van 7) en PUT op de historie voor department, job, work-location en employer.

Welke velden overgaan

De belangrijkste velden. De volledige mapping stellen we per klant vast.

Veld in SAP SuccessFactorsVeld in ProtimeToelichting
personIdExternalemployeeNumber en externalReferenceIdentifierVaste sleutel, ook bij herindiensttreding
PerPersonal (firstName, lastName)firstName, lastName
EmpEmployment startDate, EmpEmploymentTermination endDateinServiceDate en outOfServiceDate
EmpJob standardHourscontractHoursInMinutesUren per week naar minuten
EmpJob standardHours en ftefullTimeEquivalentInMinutesStandaarduren gedeeld door fte
EmpJob departmentdepartment-history
EmpJob locationwork-location-history
EmpJob companyemployer-historyOok het filter: alleen bedrijven met Protime

Gerelateerd

Welke systemen wil je koppelen?

Vertel welke systemen je gebruikt en wat er automatisch moet gebeuren. Samen bepalen we de kleinste werkende oplossing, met een helder ontwerp en een offerte vooraf.