Mijn Communities
Help

Van IBU naar File API

door Cristo Amezcua (Bijgewerkt ‎22-07-2022 15:04 door Cristo Amezcua VISMA )

Van IBU naar File API

IBU is een Visma|Raet applicatie die wordt gebruikt om bestanden te downloaden vanuit en/of te uploaden naar Youforce. Deze manier van bestanden up- en downloaden gaan wij moderniseren. Hiervoor hebben wij een aantal redenen. 

  1. Ten eerste zero footprint. IBU.exe (een Visma|Raet-applicatie) moet lokaal door jullie beheerder worden geïnstalleerd. Het lokaal installeren van software past niet meer bij onze, maar vaak ook jullie IT-strategie.
  2. Een API is een moderne en duurzame techniek die nog beter voldoet aan de huidige eisen m.b.t. GDPR en Security. 
  3. Omdat voor de File API geen Youforce-certificaat meer nodig is, is het beheer eenvoudiger en minder foutgevoelig.
  4. En tenslotte is de File API volledig gebouwd voor de cloud en wordt daardoor automatisch geschaald zodra er meer of minder capaciteit nodig is. Dit komt de performance ten goede.

 

IBU wordt op dit moment op twee manieren gebruikt, te weten: 

  • Unattended (StandAlone): automatisch bestanden uitwisselen (vanuit opdrachten en scripts)
  • Interactive (zend en ontvang):een gebruiker download of upload bestanden handmatig vanuit het Youforce-portaal 

In eerste instantie gaan we voor de gebruikers van Beaufort Online de ‘Unattended’-variant’ vervangen door de File API. De vervanging voor de ‘Interactive IBU’ volgt op een later moment. 

 

File API

De nieuwe wijze van bestandsuitwisseling gaat dus via de File API. Er zijn drie mogelijke manieren om dit technisch te regelen. 

Optie 1

De File API download een bestand op jullie server en deelt vervolgens dit bestand met de derde partij. Vergelijkbaar dus met zoals de IBU nu werkt. 

Optie 2

Er is een rechtstreekse connectie tussen de File API en de derde partij. Bestanden worden zonder “tussenstop” op jullie (klant) server uitgewisseld. (Extra afname is nodig en de 3e partij moet een aanpassing doen)

CristoAmezcua_0-1658415500097.png

Optie 3

Data wordt rechtstreeks tussen Youforce en de derde partij uitgewisseld, zonder gebruik te maken van bestanden waarin de data is opgeslagen. Eigenlijk zoals API’s bedoeld zijn. Deze API’s, ook wel Domein APIs genoemd, zijn beschikbaar voor IAM, Opleiding & Ontwikkel en SIVI gerelateerde gegevens.
Let op: het betreft hier een volledig nieuwe werkwijze om data uit te wisselen. Om deze manier van uitwisseling te gebruiken is zowel inspanning van een Youforce consultant als een techneut van de derde partij nodig. (Extra afname is nodig en de 3e partij moet een aanpassing doen)

CristoAmezcua_1-1658415599041.png

 

Tijdlijn HR Core Beaufort gebruikers

We zullen de file API in fases gaan uitleveren. 

CristoAmezcua_2-1658415629500.png

Fase 1

Op dit moment zijn de volgende bestandstypes beschikbaar in de file API voor  HR Core Beaufort Online gebruikers  voor de automatische koppelingen (´unattended'):

  • BINT-bestanden (voor meer informatie klik hier
  • DPIA100 (voor meer informatie klik hier
  • Datafeed (voor meer informatie klik hier
  • Raet Betaalmanager(voor meer informatie klik hier)
  • Aantal Gemal exports (voor meer informatie klik hier

De exacte datum waarop we de ‘Unattended IBU’ (automatische koppeling) van de markt gaan halen is nog niet vastgesteld. Zodra we hier meer informatie over hebben en/of over de planning van ‘Interactive IBU’ (handmatig zenden/ontvangen) zullen wij dit vanzelfsprekend bekend maken. 

De file API heeft op dit moment de status Controlled Available omdat nog niet alle bestandstypes beschikbaar zijn en niet alle klanten er nu gebruik van kunnen maken.

Fase 2 

In de volgende fase zullen wij nieuwe bestandstypes toevoegen waardoor ook de HR Core Beaufort 'on prem' klanten gebruik kunnen gaan maken van de file API. Zodra de planning definitief is laten wij dit via de community weten.

Fase 3

In deze fase zullen wij ook een alternatief gaan leveren voor het zenden / ontvangen via Youforce. 

 

Andere HR Cores

Klanten die gebruiken maken van een andere HR Core (HR Core Education, HR Core Business and PB core Idella) zullen op een later moment geïnformeerd worden over de tijdslijnen die voor hen gaan gelden. Ook hier zullen wij het gefaseerd gaan invoeren, eerste de automatische koppelingen ('Unattend IBU') en dan het handmatig zenden en ontvangen van bestanden.

 

Technisch informatie

De API is gedocumenteerd via developers.youforce.com

https://vr-api-integration.github.io/file-api-documentation/

 

Tevens is er een API sandbox beschikbaar waarmee je dummy bestanden kunt up- en downloaden.  https://vr-api-integration.github.io/file-api-documentation/guides_getting_started.html

 

Updates rondom de file API worden ook gecommuniceerd via de Youforce API community.

https://community.visma.com/t5/Youforce-API-s/ct-p/nl_ra_YF_API

 

Plan van aanpak

CristoAmezcua_3-1658415899913.png

Meer informatie nodig of vragen?

Neem contact op met je Customer Success Manager. 

 

10 Opmerkingen