Vacatures plaatsen met de Vacature Posting API (VP API)
Op deze pagina lees je alles over de Vacature Posting API (VP API).
Wat doet deze API?
De Vacature Posting API is een eenvoudige software-koppeling tussen je interne personeelssoftware en onze jobdatabank, en zorgt ervoor dat al jouw vacatures rechtstreeks op vdab.be gepubliceerd worden, zonder extra en dubbel werk. Bovendien ben je zeker dat altijd de meest recente versie op vdab.be staat.
Voor wie?
Elke werkgever met jobs in Vlaanderen kan de Vacature Posting API-service gebruiken.
Starten met de Vacature Posting API: uitvoerig testen
Om effectief te kunnen starten met het automatisch doorsturen van vacatures via API's moet je 5 verschillende stappen met intensieve voorbereidende testing doorlopen.
Functionaliteiten
Publicatieperiode voor vacatures
Je kan vacatures met of zonder publicatieperiode publiceren.
- Kies je ervoor om zonder publicatieperiode te werken, kan je een vacature maximaal 90 dagen aanbieden op de website van VDAB. Als die periode voorbij is, neemt het systeem de vacature uit publicatie.
- Je kan de vacature opnieuw publiceren (opnieuw voor maximaal 90 dagen) of afsluiten als de vacature werd ingevuld.
- Kies je ervoor om met een publicatieperiode te werken, geef dan de begin- en einddatum van de publicatie mee. Als die einddatum voorbij is, neemt het systeem de vacature uit publicatie.
- Als de vacature is ingevuld, verwachten we dat je de vacature afsluit.
- Toch nog op zoek naar een geschikte kandidaat? Dan kan je de publicatieperiode verlengen.
Waarmee moet je rekening houden? De 'begindatum van ‘publicatie’ is niet de begindatum van ‘tewerkstelling’. De begindatum van publicatie geeft aan vanaf welke datum de vacature gepubliceerd moet worden.
Matching
Bij het aanmaken van een nieuwe of het aanpassen van een bestaande vacature vergelijken de VDAB-systemen deze vacature met actieve klantendossiers en cv's aan de hand van matchingscriteria.
Waarmee moet je rekening houden? Omdat matching gebaseerd is op de vergelijking van de data in de dossiers en cv's met de gegevens in de vacatures, is de kwaliteit van deze data uitermate belangrijk. Als vacatures niet volgens de kwaliteitsrichtlijnen werden ingevoerd, heeft dit altijd een negatieve invloed op de kwaliteit van de matchingsresultaten.
Online Assistant (OLA)
De OLA (Online Assistant) is een open service van VDAB die de aangeleverde vacatures nakijkt op tegenstrijdigheden en/of onvolledigheden. De OLA verschijnt in de vorm van pop-ups, waarvan sommige blokkerend zijn.
- De OLA-service ondersteunt je om meer kwalitatieve vacatures in te voeren, om voor een betere matching met potentiële kandidaten te zorgen.
- De resultaten van de OLA hebben geen invloed op de publicatie van een vacature (met uitzondering van niet toegelaten woordgebruik), wel op de matching met potentiële kandidaten.
- Blokkerende pop-ups betekenen dat het systeem geen automatische matching met potentiële kandidaten kan uitvoeren, omdat de kwaliteit van de ingevoerde vacature niet voldoet.
Rangschikking
De vacatures op de VDAB-website worden gesorteerd op relevantie. Dit betekent dat de website bij het invoeren van een of meerdere zoektermen en/of filtercriteria, net zoals bij een zoekopdracht in Google, vacatures gaat teruggeven die het best voldoen aan de opgegeven zoekterm(en) en/of filtercriteria, los van de publicatiedatum.
Bemiddeling vacature
Dit betekent dat VDAB-bemiddelaars acties ondernemen om de vacature zo snel mogelijk in te vullen met het juiste profiel.
Kwaliteitsrichtlijnen
VDAB hecht bijzonder veel belang aan de kwaliteit van de aangeleverde vacatures. Net zoals een gebrekkig lot bouwstenen de structuur en de stevigheid van een gebouw in gevaar brengt, geeft een niet kwalitatieve vacature problemen bij het matchen met potentiële kandidaten en leidt ze niet tot de gewenste resultaten.
Meer over het belang van kwaliteit en uitvoerig testen >
Onze kwaliteitsrichtlijnen voor vacatures vind je op werkgevers.vdab.be/richtlijnen/inhoud
Technische informatie
Definities
Competenties: verworven bekwaamheden om een taak goed uit te voeren. Ze bestaan uit 'kennis', 'vaardigheden' en 'attitudes'. Met competenties kan je een duidelijker/specifieker functieprofiel opstellen voor een vacature en voor de selectie van kandidaten.
Meer over Competent.
Jobdomein: dient enkel om een vacature te positioneren bij 'Vind een job' op de VDAB website (filteroptie). Een jobdomein (sector) wordt toegekend op basis van het aan de vacature gekoppeld competentiesjabloon.
Beveiliging
VDAB gebruikt de API-sleutel als authenticatiemiddel en vereist HTTPS-verbindingen die versleuteld zijn via TLS1.2 (of hoger) om de veiligheid te garanderen. Dit betekent dat de VDAB API’s alleen kunnen worden benaderd via het beveiligde HTTPS protocol. Alle API clients die we publiceren gebruiken HTTPS.
Authenticatie en autorisatie
VDAB biedt enkel authenticatie aan via een API-sleutel. Dat is een unieke lange cijfercode. Met deze sleutel herkent de API de gebruiker.
Hoe testen?
Je verstuurt een HR-XML bestand per vacature naar het betrokken end point.