De afgelopen periode zijn de volgende verbeteringen in de API's doorgevoerd:
Extension API uitgebreid met een nieuw endpoint op basis van de historie tabel
De extension API is uitgebreid met een nieuw endpoint employment/timelines. Dit nieuwe endpoint is gebaseerd op de historie tabel in Beaufort, waardoor het mogelijk is per element een ingangdatum weer te geven. Het endpoint werkt op een vergelijkbare wijze als het employment endpoint in de extensie API.
Onderstaand voorbeeld laat het onderscheid tussen beide endpoints zien.
employments
Dit endpoint toont de waarde van de betreffende rubriek uit het actuele model van Beaufort.
Employments/timelines
Dit endpoint toont de waarde van de betreffende rubriek uit de historie tabel van Beaufort.
Om dit endpoint te kunnen gebruiken moet de historie voor het betreffende veld geactiveerd zijn. Dit kunt u doen in het scherm Rubrieken in Beaufort.
Daarnaast moeten de rubrieken ook als extentie in de API geconfigureerd zijn. Dit kan gedaan worden door een API consultant van Visma Raet.
De afgelopen periode zijn de volgende verbeteringen in de API's doorgevoerd:
Extensions API uitgebreid met endpoints voor de Basic API
Vanaf nu is het ook mogelijk om de Youforce Extension API te gebruiken in combinatie met de Basic API.
De nieuwe endpoint zijn:
GET ..extensions/v1.0/basic/persons
GET ..extensions/v1.0/basic/employments
Deze endpoints zijn enkel te gebruik in combinatie met de Basic API. Zie voor meer Eigen rubrieken met de Extensions API
Recruitment API uitgebreid met endpoint voor aannemen medewerker
De recruitment API is uitgebreid met een endpoint voor het aannemen van een nieuwe medewerker. Binnen dit proces wordt onderscheid gemaakt tussen het aannemen van een nieuwe medewerker en het creëren van een nieuw dienstverband voor een bestaande medewerker.
Om dit proces te ondersteunen, is er ook een endpoint ontwikkeld waarmee u kunt controleren of een persoon al in de Beaufort-omgeving bestaat.
Het endpoint "Search person" stelt u in staat om te zoeken op verschillende velden, zoals voornaam, geboortenaam, geboortedatum en geboorteplaats. Ten minste één van deze zoekvelden is verplicht. Dit endpoint geeft maximaal 10 resultaten terug.
Op basis van het resultaat van dit endpoint kan het recruitment systeem bepalen of er sprake is van een een geheel nieuwe medewerker of enkel van een nieuw dienstverband bij een bestaande medewerker. Het recruitment systeem kan vervolgens één van de volgende endpoints starten:
POST hires: Hiermee wordt een workflow voor het aannemen van een nieuwe medewerker in HR Self Service gestart, waarbij de gegevens vanuit de API als standaardwaarden worden overgenomen.
POST Contract: Hiermee wordt een workflow voor het creëren van een nieuw dienstverband in HR Self Service gestart, waarbij de gegevens vanuit de API als standaardwaarden worden overgenomen.
Tevens is een endpoint toegevoegd waarmee contractwijzigen kunnen worden doorgegeven. Dit is bijvoorbeeld relevant bij interne sollicitaties. Het endpoint is:
POST contract/adjustments: Hiermee wordt een workflow voor het wijzigen van een bestaand dienstverband in HR Self Service gestart, waarbij de gegevens uit de API als standaardwaarden worden overgenomen.
Consultancy De recruitment API biedt diverse mogelijkheden om de API nader te configureren. Deze mogelijkheden kunnen tijdens de implementatie door onze consultants toegelicht worden. Status De API is op dit moment nog Controlled Available. Zodra de eerste integraties zijn ontwikkeld zullen we u hier nader over informeren.
De afgelopen periode zijn de volgende verbeteringen in de API's doorgevoerd:
Het veld expectedRecoveryDate toegevoegd aan het endpoint Sickleaves (WFM api)
Aan het endpoint sickleaves is een nieuw veld "expectedRecoveryDate" toegevoegd. Dit veld komt overeen met de Beaufort rubriek "P01605 Datum verwacht herstel" en wordt gebruikt om bij een ziekte een verwachte herstel datum vast te leggen.
GET https://api.youforce.com/wfm/v1.0/sickleaves
Synchronisatie met HR Core voor de Extension API verbeterd
De afgelopen periode is de integratie tussen HR Core Beaufort en de Extension API verbeterd. Daardoor wordt de data vaker gesynchroniseerd en zullen wijzigingen in Beaufort ook eerder zichtbaar zijn in de extensie API.
Youforce Extensions uitgebreid met extra endpoints voor het MLM domain
Vanaf nu is het ook mogelijk om de Youforce Extension API te gebruiken in combinatie met de MLM base API. Zie hiervoor het algemeen gebruik van de extension API Eigen rubrieken met de Extensions API
De nieuwe endpoint hiervoor zijn:
api.youforce.com/extensions/v1.0/mlm/persons
api.youforce.com/extensions/v1.0/mlm/employments
Eerste versie Recruitment API beschikbaar
Er is een eerste versie van de recruitment API beschikbaar. Deze eerste versie bevat endpoint voor het ophalen van de organisatie structuur en de basis gegevens van de medewerkers. Met deze eerste versie is het mogelijk om uw huidige medewerkers in uw recruitment systeem op te nemen als mogelijk interne kandidaten.
Beschikbare endpoints zijn:
GET Persons
GET Employments
GET Users
GET Organisation Units
GET Role Assignments
GET Job Profiles
Meer informatie over de recruitment API is te vinden op: Kennisbank Recruitment API