Leren en certificaten
Deel StudyTube koppeling: eigen medewerkers, EOR en contractors in de academy, met de juiste licentie en taal
Met een koppeling tussen Deel en StudyTube krijgt iedereen die in Deel start automatisch een StudyTube-account in het team van zijn afdeling, met een licentie die past bij zijn soort contract en de taal van zijn land. De datum van het laatst behaalde StudyTube-certificaat gaat terug naar een eigen veld in Deel, en na de laatste werkdag van het laatste contract verdwijnt het account.
Wat de koppeling doet
Internationale werkgevers die mensen via Deel aannemen, als eigen werknemer, via employer of record of als contractor, en StudyTube als academy gebruiken, zetten iedereen met de hand in StudyTube. Wie welke licentie krijgt en in welke taal, regelt iemand per persoon, en vertrekkers blijven staan tot iemand opruimt.
- Deel meldt een nieuw of gewijzigd contract via een ondertekende webhook.
- KoppelHet zet de afdelingen uit Deel als teams in StudyTube, met de bovenliggende afdeling als parent.
- De persoon krijgt een account in zijn afdelingsteam, met licentie en taal op basis van contractsoort en land; de uitnodiging gaat pas uit op de startdatum.
- Na een nieuw certificaat zet KoppelHet de datum in het afgesproken eigen veld in Deel.
- Na de laatste werkdag van het laatste lopende contract verwijdert KoppelHet het account na de afgesproken termijn.
Terug: Datum en naam van het laatst behaalde certificaat in een eigen veld in Deel
Waar je op let bij Deel en StudyTube
- Deel geeft per contract een hiring type, zoals eigen werknemer, employer of record of contractor. Per hiring type spreken we af of StudyTube een contentlicentie toekent; een contractor kan zo wel de verplichte gedragscode volgen zonder een volledige licentie te kosten.
- Bij een afdeling in Deel staat de bovenliggende afdeling als naam, niet als ID. KoppelHet bouwt de teamboom in StudyTube op die namen en houdt zelf een vaste sleutel per afdeling bij, zodat een hernoemde afdeling in StudyTube hetzelfde team blijft.
- Iemand kan in Deel meerdere contracten hebben, bijvoorbeeld een oud contractorcontract en een nieuw EOR-contract. KoppelHet gebruikt het worker ID als sleutel en verwijdert het StudyTube-account pas als het laatste lopende contract is beëindigd, zodat een overstap van contractvorm geen trainingshistorie kost.
- Elk contract in Deel heeft een land. KoppelHet geeft StudyTube daarop de taal van de gebruiker mee, zodat een collega in Spanje de academy in het Spaans opent en een collega in Nederland in het Nederlands.
- Deel kent de persoonsstatus NOT_STARTED voor wie al getekend heeft maar nog niet begonnen is. KoppelHet zet het account dan al klaar in StudyTube, maar stuurt de uitnodiging pas op de startdatum.
- Deel heeft geen openbare API voor leren, maar wel eigen velden per persoon die je via de API kunt vullen. KoppelHet zet de naam en datum van het laatst behaalde certificaat in zo'n veld, zodat HR het in Deel ziet zonder StudyTube te openen.
- Deel schakelt een webhook uit na tien mislukte pogingen. KoppelHet vergelijkt daarom elke dag de mensen in Deel met de gebruikers in StudyTube, zodat een gemiste melding binnen een dag is hersteld.
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
Krijgen contractors ook een StudyTube-account?
Als jullie dat willen. Per hiring type kiezen jullie: geen account, een account zonder licentie, of een volledige licentie.
Waarom staat niet elk certificaat in Deel?
Deel heeft geen opleidingsdossier dat via de API te vullen is. Een eigen veld met het laatste certificaat is het kleinste werkende geheel; het volledige overzicht blijft in StudyTube.
Welke rechten heeft de koppeling in Deel nodig?
Leesrechten op people en schrijfrechten op eigen velden. Salaris en bankgegevens vraagt de koppeling niet op.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Deel REST API (versie 2026-01-01) met een API-token of OAuth2: GET /rest/people met fields en de filters hiring_types en hiring_statuses; per persoon worker_id, preferred_first_name, department (name, parent), person_status (ACTIVE, NOT_STARTED, INACTIVE) en employments met work_email, job_title, country, hiring_type en termination_last_day. Webhooks met x-deel-signature (HMAC-SHA256). Terug via PUT /rest/people/{worker_id}/custom_fields met de scope people:write; een bestaande waarde wordt overschreven.
- StudyTube Academy API v2 met OAuth 2.0 client credentials en de scope write. POST /api/v2/users op uid met language, assign_licence en send_invite, POST /api/v2/users/{id}/reinvite, academy-teams/bulk/upsert tot 500 teams, en GET /api/v2/certificates met name en completion_date.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Deel | Veld in StudyTube | Toelichting |
|---|---|---|
worker_id | uid en employee_number | Blijft gelijk over contracten heen |
preferred_first_name of first_name, last_name | first_name, last_name | |
employments[].work_email | email | |
employments[].job_title | company_role | |
department (name, parent) | Team (external_id, name, parent) | |
employments[].hiring_type | assign_licence | Tabel per contractsoort |
employments[].country | language | |
employments[].termination_last_day | Verwijderen na de laatste werkdag | |
Certificaat (name, completion_date) terug | Eigen veld via PUT /people/{worker_id}/custom_fields |
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