Payroll koppeling
Deel Silae koppeling: eigen Franse werknemers uit Deel als salarié met emploi in het Silae-dossier
Een koppeling tussen Deel en Silae maakt een eigen werknemer van de Franse rechtspersoon in Deel aan als salarié met emploi in het Silae-dossier van het cabinet, met NIR, contracttype, startdatum en basisloon. EOR-medewerkers in Frankrijk en contractors in Deel blijven buiten Silae, en schrijven gaat via het API-account van het cabinet dat de Franse lonen draait.
Wat de koppeling doet
Organisaties die Deel als wereldwijd HR-systeem gebruiken en hun eigen Franse SAS door een cabinet in Silae laten verlonen, sturen het kantoor bij elke Franse aanwerving een formulier. De gestionnaire neemt naam, NIR, contractvorm en loon over, en een tijdelijk contract in Deel staat in Silae soms als CDI.
- HR legt in Deel een eigen werknemer vast bij de Franse rechtspersoon.
- Op de webhook Employee Created Direct controleert KoppelHet de rechtspersoon en haalt het volledige profiel op.
- KoppelHet maakt de salarié met één emploi aan in het dossier van de Franse entiteit, op basis van de modelmedewerker van het cabinet.
- Een loonwijziging gaat naar hetzelfde emploi; een laatste werkdag wacht op de motif van HR en gaat dan door.
- Afwijzingen van Silae komen met foutmelding op een lijst voor het cabinet.
Waar je op let bij Deel en Silae
- De gids van Deel voor eigen werknemers noemt dit het geval waarin de werknemer via een eigen payrollleverancier wordt betaald. KoppelHet neemt alleen die werknemers en alleen de Franse legal entity, zodat iemand die Deel als EOR in Frankrijk verloont niet ook een loonstrook uit Silae krijgt.
- Schrijven in Silae mag alleen in het API-model voor interne HR-toepassingen, en dat is voorbehouden aan partners zoals accountants en payrollbureaus. Een organisatie met Deel heeft zo'n contract meestal niet. KoppelHet werkt daarom met de client credentials van het cabinet, dat de API per dossier openzet.
- In het profiel van Deel is end_date leeg bij een contract voor onbepaalde tijd en gevuld bij een tijdelijk contract. Silae wil een codeContratTravail. KoppelHet leidt daaruit 01 voor een CDI of 02 voor een CDD af, zodat het cabinet de contractvorm niet uit een mail hoeft te halen.
- Deel bewaart het loon met een scale, standaard ANNUAL, en kent ook HOURLY. Silae neemt een salaireDeBase met een vlag of het een uurloon is. KoppelHet zet een jaarloon om naar een maandbedrag, stuurt een uurloon met de vlag aan, en houdt een bedrag in een andere valuta dan euro tegen.
- Silae weigert een salarié zonder geldig NIR van vijftien tekens. Deel geeft nationale nummers alleen in additional_details terug als de feature flag aanstaat en de aanvraag persoonsgegevens niet afschermt. Ontbreekt het nummer, dan maakt KoppelHet de salarié niet half aan maar zet de starter op de lijst van het cabinet.
- Voor een vertrek vraagt Silae naast dateFin ook een motifFinEmploi, zoals 010 voor ontslag door de werknemer. Deel geeft in de people-lijst wel de laatste werkdag, maar geen Franse redencode. KoppelHet vraagt HR of het cabinet de motif te kiezen en stuurt pas daarna beide velden samen.
- Silae accepteert alleen tekens uit Windows-1252, terwijl Deel namen uit alle landen bewaart. Letters daarbuiten zet KoppelHet om, en die medewerkers gaan op een controlelijst voor de bulletin de paie.
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 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.
Veelgestelde vragen
Moet het cabinet iets doen?
Ja. Het cabinet zet de API open voor het dossier, levert de client credentials en kiest een modelmedewerker voor nieuwe salariés.
Gaan verlof en variabelen ook mee?
Niet in de eerste versie. Afwezigheid en premies kunnen later als uitbreiding.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Deel via de HRIS-API met bearer token: webhooks Employee Created Direct en Employee Updated Direct (legal_entity_id, contract_oid, start_date, gross_annual_salary), GET /rest/people voor naam, employments en direct_employee_termination_last_day; additional_details alleen met feature flag.
- Silae via https://payroll-api.silae.fr/payroll met OAuth 2.0 client credentials van het cabinet: POST /v1/SalarieEmplois/CreationSalarieEmplois met numeroDossier, matriculeSalarieModele, codeContratTravail en salaireDeBase; ListeSalarieEmplois voor het emploi-ID; dateFin en motifFinEmploi bij vertrek.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in Silae | Toelichting |
|---|---|---|
Webhook Employee Created Direct (legal_entity_id) | numeroDossier van de Franse entiteit | |
Deel profiel-id | matriculeSalarie | Vaste sleutel tussen beide systemen |
last_name, first_name | nomNaissance, prenom | |
additional_details (NIR) | numeroSecuriteSociale | Alleen met feature flag in Deel |
employment.end_date (leeg of gevuld) | codeContratTravail (01 CDI, 02 CDD) | |
employment.start_date | dateDebutContrat en dateDebut | |
compensation_details (salary, currency, scale) | salaireDeBase met salaireDeBaseEstHoraire | |
direct_employee_termination_last_day plus motif van HR | dateFin en motifFinEmploi |
Gerelateerd
Ashby → Deel
Ashby Deel koppeling: aannames bij de eigen entiteit als direct employee in Deel
Bullhorn → Deel
Bullhorn Deel koppeling: eerste plaatsing als direct employee met contract in Deel
Carerix → Deel
Carerix Deel koppeling: geslaagde plaatsing als persoon of contract in Deel
Deel → 4PS Construct
Deel 4PS Construct koppeling: eigen werknemers van de bouwentiteit in 4PS, met afdeling en kostenplaats als dimensie