Bij een overstap naar Selection Lab migreer je historische assessmentscores, kandidaat-ID's en rapportlinks via CSV, JSON of API naar je ATS. Records waarvan de bewaartermijn is verlopen of waarvoor geen toestemming aantoonbaar is, worden geweigerd. Proctoringopnames en PDF-rapporten van de oude leverancier gaan niet mee. Je ATS blijft de bron van waarheid.

Van assessmentleverancier wisselen is meer dan een instelling omzetten. Je verplaatst privacygevoelige data, je wilt de historische scores behouden waar hiring managers op vertrouwen en je ATS moet tijdens de hele overgang het leidende systeem blijven. Dit artikel legt uit hoe Selection Lab een migratie van leverancier naar leverancier aanpakt, wat er met je historische assessmentdata gebeurt en welke verplichtingen daar onder de AVG bij horen.

Let op. Een aantal technische details in dit artikel (exacte API-endpoints, versies van het JSON-schema, rate limits per veld en goedgekeurde curl- en Postman-voorbeelden) wacht nog op bevestiging van Engineering en Customer Success van Selection Lab. Onderdelen met [nog te bevestigen door engineering] lees je als structuur, niet als definitieve specificatie. Je implementatiemanager heeft de actuele referentie.

Welke data gaat mee bij een migratie

Voordat je iets exporteert of importeert, bepaal je de grens van de migratie. Selection Lab onderscheidt drie soorten historische data.

• Assessmentresultaten en scores. Afgeronde assessments met numerieke scores, competentie-indicatoren en de uitkomst van de match met de functie. Dit is het hoofddoel van de migratie.
• Profielvelden van kandidaten. Naam, contactgegevens en externe ID's die een kandidaatrecord aan je ATS koppelen. Voor deze velden gelden de bewaartermijnen uit de AVG, en soms is nieuwe toestemming nodig voordat je ze opnieuw mag verwerken.
• Proctoringmedia en rapportbestanden. Sessieopnames, schermafbeeldingen of PDF-rapporten van de oude leverancier. Selection Lab importeert geen mediabestanden uit proctoringsystemen van derden. Links naar rapporten kunnen als metadata worden bewaard, de bestanden zelf blijven bij de leverancier die ze maakte.

Alle persoonsgegevens die Selection Lab verwerkt staan in Frankfurt. Toestemming wordt per verwerkingsdoel vastgelegd en bewaartermijnen gelden op recordniveau (Selection Lab Main Deck 2026). Hoe de AVG bij recruitment skill tests verder werkt, staat in een apart artikel. Voor de migratie betekent het dit. Records waarvan de bewaartermijn voorbij is, of waarvoor je geen geldige toestemming kunt aantonen, horen niet in een importbatch.

Exportformaten en schema-objecten

Selection Lab ondersteunt export in CSV en JSON, plus programmatische toegang via de API [nog te bevestigen door engineering, exacte endpoints]. Voor een migratie zijn dit de relevante objecten.

Zonder vaste identifiers lukt de mapping niet. Gebruikte je oude leverancier een ander ID-systeem, bijvoorbeeld losse UUID's zonder verwijzing naar je ATS, dan heb je vooraf een koppelbestand nodig dat oude ID's aan je ATS-kandidaat-ID's verbindt. Het implementatieteam van Selection Lab helpt daarbij tijdens de onboarding, die volgens de Main Deck 2026 twee tot tien weken duurt.

Alle tijdstempels moeten in ISO-8601 staan (YYYY-MM-DDTHH:MM:SSZ). Selection Lab houdt per assessmentrecord vier tijdstempels bij.

• invitedAt, het moment waarop de kandidaat de uitnodiging kreeg
• startedAt, het moment waarop de kandidaat het assessment opende
• completedAt, het moment waarop de kandidaat het assessment inleverde
• scoredAt, het moment waarop de scoring een resultaat opleverde

API-authenticatie en importgedrag

[Nog te bevestigen door engineering] De API van Selection Lab gebruikt een OAuth 2.0 client credentials flow voor server-to-server dataverkeer. Je implementatiemanager levert een client_id en client_secret die alleen voor migratie werken. Het token haal je op bij /oauth/token, het bearer token stuur je mee in de Authorization-header van elke migratie-aanroep.

De belangrijkste regels voor imports.

• Idempotentie. Importverzoeken zijn idempotent op de samengestelde sleutel (externalCandidateId, jobId, assessmentTypeId, completedAt). Stuur je een record met dezelfde sleutel nog eens, dan ontstaat geen duplicaat. Je krijgt het bestaande record terug met 200 OK en de vlag "action": "skipped".
• Batches. Grote historische datasets importeer je in batches van 500 records per verzoek. Grotere payloads worden geweigerd met 413 Payload Too Large.
• Dry run. Met "dryRun": true in de request body valideer je de veldmapping en krijg je een overzicht van fouten zonder dat er iets in de database wordt geschreven.

Veldmapping van oude leverancier naar Selection Lab naar ATS

De tabel hieronder laat het algemene patroon zien. De precieze veldnamen van je oude leverancier verschillen [check met je CS-contact].

Over het omrekenen van scores. Gebruikte je oude leverancier een andere schaal, bijvoorbeeld 0 tot 10 of ruwe stanines, zet dan de oorspronkelijke schaal in het veld sourceScoreScale zodat een auditor de conversie kan volgen. Selection Lab rekent scores nooit stilzwijgend om. De omrekenregels leg je vast in het importmanifest.

Over lege velden. Een verplicht veld dat leeg is laat het record afkeuren, het verschijnt dan in het foutenrapport. Optionele velden, zoals startedAt en percentileRank, mag je weglaten. Ook een gedeeltelijke migratie is geldig, bijvoorbeeld persoonlijkheidsresultaten zonder bijbehorende hard-skillsmeting. Het ATS toont dan de assessmenttypes die er wel zijn.

Na de import zet Selection Lab het volledige rapport en de losse scores direct in je ATS. De attributen worden automatisch in het kandidaatrecord gevuld, net als bij de standaard ATS-integratie (Selection Lab Main Deck 2026). Recruiters zien historische records in dezelfde omgeving als nieuwe assessments, zonder dat hun werkwijze verandert.

Bewaartermijnen en verwijdering onder de AVG

Historische assessmentdata is een compliance-onderwerp, niet alleen een archief. Selection Lab past deze regels toe op geïmporteerde records.

• Records buiten hun bewaartermijn worden geweigerd met de foutcode RETENTION_EXPIRED.
• Records zonder geldige toestemmingsgrond, dus zonder consentTimestamp of consentPurpose in de payload, worden geweigerd met CONSENT_MISSING.
• Doet een kandidaat na de migratie een verzoek tot verwijdering, dan worden alle records van die kandidaat bij Selection Lab verwijderd of geanonimiseerd. Het record aan de ATS-kant is de verantwoordelijkheid van de klant.
• Selection Lab gebruikt lokale taalmodellen om persoonsgegevens uit gesprekstranscripten te halen, zoals SmartChat-logs, voordat die worden opgeslagen. Gemigreerde chatdata gaat door dezelfde anonimisering (Selection Lab Main Deck 2026).

Je ATS is het leidende systeem voor assessmentuitkomsten. De rol van Selection Lab bij een overstap is dat systeem correct en binnen de regels aanvullen, en daarna het live scoren overnemen.

Controle na de migratie

Loop na elke importbatch deze controles door.

1. Aantallen vergelijken. Zet het totaal aantal records in je exportbestand naast importSummary.totalProcessed in de API-respons. Elk verschil onderzoek je voordat je de migratie afsluit.
2. Totalen per assessmenttype. Splits de aantallen uit per assessmentTypeId, zodat je zeker weet dat geen enkel type stilzwijgend is weggevallen.
3. Foutenlog doorlopen. Download de lijst importErrors[] uit de respons. De meest voorkomende foutcodes.
   • MISSING_REQUIRED_ID, externalCandidateId, jobId of assessmentTypeId ontbreekt.
   • DUPLICATE_KEY, er bestaat al een record met dezelfde samengestelde sleutel (alleen relevant als idempotentie niet goed is gebruikt).
   • TIMESTAMP_FORMAT_INVALID, de tijdstempel staat niet in ISO-8601.
   • SCORE_OUT_OF_RANGE, normalizedScore valt buiten de opgegeven schaal.
   • ASSESSMENT_TYPE_UNKNOWN, assessmentTypeId komt niet overeen met een type in je Selection Lab-account.
4. Auditlog bewaren. Selection Lab maakt per importbatch een onveranderbare auditlog aan. Bewaar die voor een eventuele audit van je verwerkingen onder artikel 30 AVG.

Een Postman-collectie en goedgekeurde curl-voorbeelden voor de migratie-endpoints zijn op aanvraag beschikbaar bij je implementatiemanager [komt in de publieke documentatie na akkoord van engineering].

Veelgestelde vragen over overstappen van assessmentleverancier