Identity en access management
Deel JumpCloud koppeling: JumpCloud-gebruikers voor werknemers en contractors uit Deel, met de Deel-app of maatwerk
Met een koppeling tussen Deel en JumpCloud krijgt iedereen die via Deel voor jullie werkt een JumpCloud-gebruiker met functie, afdeling, entiteit en soort medewerker, en wordt die gebruiker geschorst zodra het vertrek in Deel is afgerond. Deel bouwt zelf een JumpCloud-app die gebruikers aanmaakt, bijwerkt en schorst; KoppelHet komt erbij voor de leidinggevende, klaarzetten tot de startdatum, nieuwe collega's zonder werkadres en een vertrek dat nog verschuift.
Wat de koppeling doet
Organisaties die mensen in meerdere landen via Deel aannemen en JumpCloud voor apparaten en apps gebruiken, zetten vaak de JumpCloud-app van Deel aan. Daarna merken ze dat iemand zonder werkadres niet aankomt, dat de leidinggevende ontbreekt en dat de gebruikersnaam van een tweede collega met dezelfde naam een cijfer krijgt.
- In Deel komt een organisatietoken met alleen leesrechten op mensen, contracten en organisatiestructuur, en webhooks voor eigen werknemers en contracten.
- In JumpCloud maakt de beheerder een apart beheeraccount met MFA en daarop een API-sleutel voor KoppelHet.
- Bij een nieuwe persoon in Deel maakt KoppelHet een klaargezette JumpCloud-gebruiker, met werkadres volgens jullie naamgevingsregel en de relatie naar de leidinggevende.
- Op de startdatum activeert KoppelHet de gebruiker, en groepen per entiteit en soort medewerker bepalen apps en apparaten.
- Is de beëindiging in Deel afgerond, dan schorst KoppelHet de gebruiker na de laatste werkdag.
Waar je op let bij Deel en JumpCloud
- De JumpCloud-app wordt door Deel gebouwd en ondersteund. JumpCloud beschrijft op één pagina zowel een nachtelijke als een uurlijkse synchronisatie, en Deel spreekt van wijzigingen binnen seconden. KoppelHet werkt op de webhooks van Deel en legt per persoon vast wanneer JumpCloud is bijgewerkt, zodat niemand hoeft te raden welk schema geldt.
- De Deel-app slaat iemand zonder werkadres over. Bij een eigen werknemer is het werkadres in Deel een optioneel veld bij het aanmaken. KoppelHet maakt het adres met jullie naamgevingsregel en meldt HR vóór de startdatum dat het in Deel moet worden ingevuld, zodat de nieuwe collega op dag één kan inloggen.
- De Deel-app bouwt de gebruikersnaam als voornaam.achternaam en plakt een cijfer aan de achternaam als die naam al bestaat. KoppelHet controleert de naamgevingsregel vooraf tegen JumpCloud en kiest bij een dubbele naam een vaste variant, zodat de inlognaam niet van de volgorde van aanmaken afhangt.
- In de veldentabel van de Deel-app staat geen leidinggevende, terwijl JumpCloud de leidinggevende als relatie naar een andere gebruiker kent. Deel geeft bij een eigen werknemer een direct_manager mee. KoppelHet zoekt daar de JumpCloud-gebruiker bij en legt de relatie, ook als de leidinggevende zelf contractor is.
- De Deel-app zet bij een actieve persoon de status klaargezet of actief, zonder dat de documentatie zegt welke van de twee. JumpCloud kent klaargezet alleen bij het aanmaken. KoppelHet maakt iemand met status NOT_STARTED altijd klaargezet aan en activeert hem op de startdatum.
- Een beëindiging in Deel doorloopt stappen van PENDING tot COMPLETED of CANCELED, en de laatste werkdag kan in die tijd nog schuiven. KoppelHet schorst pas na de laatste werkdag als de beëindiging is afgerond, en doet niets bij een geannuleerde beëindiging.
- De webhook voor een gewijzigde eigen werknemer geeft de huidige stand, maar niet welke velden veranderden. KoppelHet vergelijkt met de vorige stand en stuurt alleen gewijzigde velden naar JumpCloud, zodat een aanpassing die IT in JumpCloud deed aan een ander veld blijft staan.
Deze koppeling hoort ook bij in-, door- en uitstroom.
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
Komen contractors ook in JumpCloud?
Ja, als jullie dat willen. De soort medewerker gaat mee als employeeType, zodat contractors andere groepen en apparaten kunnen krijgen.
Waarom niet alleen de JumpCloud-app van Deel?
Die is vaak genoeg als iedereen op tijd een werkadres heeft en JumpCloud geen leidinggevende nodig heeft. Kies maatwerk als klaarzetten en vertrek op de dag moeten kloppen.
Gaan er salarisgegevens naar JumpCloud?
Nee. Het token van KoppelHet heeft geen rechten op compensatie of betalingen.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Standaard: de JumpCloud-app van Deel (Deel App Store, Built by Deel) met een JumpCloud API-sleutel van een beheerder (Manager, Administrator of Admin with Billing); in Deel Org Admin-rechten. Velden: work email, voornaam, achternaam, volledige naam, functie, afdeling, werklocatie, team naar costCenter, worker type, entiteit en profiel-id. Handmatig synchroniseren in Deel onder Apps & Integration.
- KoppelHet leest Deel via de REST API (versie 2026-01-01; GET /rest/people met hiring_type, person_status, client_legal_entity, department, direct_manager, employments, active_worker_termination_status en direct_employee_termination_last_day) en webhooks, waaronder Employee Created Direct en Employee Updated Direct voor eigen werknemers. Eigen werknemers volgens de Deel-gids als direct employee onder de eigen legal entity.
- Naar JumpCloud via API v1 /systemusers (header x-api-key): employeeIdentifier uniek per gebruiker, employeeType, company, manager als relatie, state STAGED alleen bij aanmaken, daarna ACTIVATED of SUSPENDED.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in JumpCloud | Toelichting |
|---|---|---|
Deel-id van de persoon | employeeIdentifier | |
first_name en last_name | firstname en lastname | |
work_email of naamgevingsregel | email en username | |
job_title | jobTitle | |
department | department | |
legal_entity | company | |
hiring_type | employeeType | |
direct_manager | manager | JumpCloud-id van de leidinggevende |
start_date en laatste werkdag | state (STAGED, ACTIVATED, SUSPENDED) |
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