Deze release notes zijn van technische aard en bedoeld voor File API ontwikkelaars die rechtstreeks met de File API integreren of de technische werking van de File API kennen. Deel deze release notes met jouw IT afdeling.   IP Whitelisting voor File API Applicaties Huidige Situatie  Momenteel ondersteunt de File API geen IP-whitelisting, dus jouw File API-verzoeken kunnen overal worden gedaan.   Nieuwe Situatie Vanaf heden, 22 oktober 2024, is de ondersteuning van IP whitelisting beschikbaar, dus als je dat wenst, kun je deze configuratie nu al aanvragen voor jouw File API applicatie en jouw publieke IP(s) om de veiligheid van File API verzoeken te vergroten.   Jouw Actie:  Maak een 4me-verzoek aan met de onderstaande informatie:   Jouw openbare IP-adressen in CIDR-indeling (bijvoorbeeld: 192.0.2.0/24) vanwaar met de File API wordt gecommuniceerd. Jouw ClientId dat wordt gebruikt om bij de File API te authenticeren. ... View more

Deze release notes zijn van technische aard en bedoeld voor File API ontwikkelaars die rechtstreeks met de File API integreren of de technische werking van de File API kennen. Deel deze release notes met jouw IT afdeling.   File API Healthcheck Endpoint Huidige Situatie   Een goede gewoonte bij het gebruik van API's is het controleren van hun status voordat ze daadwerkelijk worden aangeroepen. Momenteel is de enige manier om erachter te komen of de File API operationeel is, het aanroepen van een van de beschikbare eindpunten (bijvoorbeeld het List-eindpunt) en het controleren van het resultaat. Als het resultaat een fout is, moet uw uitwisselingsproces de fout afhandelen..   Een betere manier is om de status van de File API te controleren voordat u uw uitwisselingsproces start. Om dit te vergemakkelijken en verbeteren hebben we een nieuw “Health Check”-eindpunt geïntroduceerd dat kan worden aangeroepen voordat uw uitwisselingsproces begint. Nieuwe situatie   Vanaf heden, 22 oktober 2024, is het ‘Health Check’ eindpunt beschikbaar om de status van de File API te controleren.   Dit nieuwe eindpunt vertelt je of de File API volledig operationeel is of dat er sprake is van een storing. In geval van een storing kunt u uw uitwisselingsproces uitstellen tot een later tijdstip.   Het eindpunt kan op 3 verschillende manieren worden gebruikt:   Handmatig (bijv met Postman) om de beschikbaarheid op een willekeurig moment te kunnen controleren. Automatisch (als onderdeel van uw monitoringsysteem) om regelmatig de status van de File API te controleren. Automatisch (als onderdeel van uw uitwisselingsproces) vlak voordat uw geautomatiseerde uitwisselingsproces begint. In de toekomst zullen de resultaten van de health check ook in Youforce worden weergegeven, waardoor de handmatige verificatie veel sneller en intuïtief zal verlopen.   Response van het ‘Health Check’ eindpunt   Het eindpunt retourneert de algemene status van de File API en de status van elk individueel eindpunt.  De mogelijke waarden voor de algemene status van de File API zijn:   Operational: Wanneer de status van alle eindpunten “healthy” is. Major Outage: Wanneer de status van een van de meest gebruikte eindpunten ‘unhealthy’ is. De meest gebruikte eindpunten zijn:  Publisher UploadMultipart Subscriber Delivery Subscriber List Subscriber Download Partial Outage: Wanneer de status van de meest gebruikte eindpunten ‘healthy’ is, maar de status van een van de minder gebruikte eindpunten ’unhealthy’ is. De minder gebruikte eindpunten zijn: Publisher UploadResumable Publisher List Publisher Download Subscriber DownloadByChunks Subscriber Delete Jouw Actie  Als u het Health Check-eindpunt wilt gaan gebruiken om de status van de File API te controleren, volgt u de stappen zoals die worden uitgelegd in onze technische File API-documentatie.  Zie onderstaande technische links: File API documentation  File API Swagger  File API Postman Collection  ... View more

Gebruikersautorisaties door CEA-nummers voor Payroll Gemal Exports   Huidige situatie: Op dit moment hebben de gebruikers die geautoriseerd zijn voor het bestandstype "Payroll Gemal Exports" de mogelijkheid om de bestanden van alle CEA-nummers van de organisatie te ontvangen. Het is niet mogelijk om gebruikers te autoriseren om alleen bestanden van specifieke CEA-nummers te ontvangen. Vanaf 7 oktober 2024 komt in Bestandsuitwisseling nieuwe functionaliteit beschikbaar waarmee het toekennen van het ontvangen van specifieke CEA-nummers voor het bestandstype "Payroll Gemal Exports" mogelijk wordt gemaakt voor gebruikers.   Jouw actie: Werkt jouw organisatie niet met meerdere CEA-nummers, of mogen jullie gebruikers de informatie van alle CEA-nummers downloaden, dan hoef je niets te doen. Werkt jouw organisatie wel met meerdere ceanummers en wil je specifieke gebruikers autoriseren om alleen bestanden van bepaalde CEA-nummers te mogen downloaden, volg dan de onderstaande instructies om de autorisaties toe te kennen.   Gebruikers autoriseren voor specifieke CEA-nummers voor Payroll Gemal Exports: In Autorisatiebeheer komt per 7 oktober een nieuw recht beschikbaar: "Toegang tot Bestandsuitwisseling-instellingen" onder de applicatie "Bestandsuitwisseling".     Beheerders die voor dit nieuwe recht worden geautoriseerd, krijgen een nieuw tabblad genaamd "Instellingen" te zien in Bestandsuitwisseling.     In dit tabblad hebben beheerders de mogelijkheid om via het schuifje "Activeer autorisatie voor Payroll Gemal Export" de nieuwe functionaliteit te activeren. Deze optie is standaard uitgeschakeld omdat alle gebruikers op dit moment toegang hebben tot alle CEA-nummers van de organisatie.   Wanneer je het schuifje naar ‘Actief’ zet, voeg dan één voor één de gebruikers toe via de knop ‘Gebruiker Toevoegen’ en geef per gebruiker aan tot welk(e) CEA-nummer(s) zij toegang krijgen voor het bestandstype "Payroll Gemal Exports".   De gebruikers die op deze manier geautoriseerd worden, zullen in de “Ontvang bestanden" tab dan alleen de bestanden van dit bestandstype zien die gerelateerd zijn aan de opgegeven CEA-nummers.   Let op: de gebruikers die niet in de lijst staan, zullen geen enkel bestand van dit bestandstype in de “Ontvang bestanden" tab zien.           ... View more

Bestandsuitwisseling Test file type is gedefinieerd in Bestandsuitwisseling voor test doeleinden. Het bestandstype kan worden gebruikt om de upload en download van dummy-bestanden te testen. Dit file type kan al geautoriseerd worden via Autorisatiebeheer.   Doorloop de volgende stappen om dit file type te gebruiken:   1 - Voeg het rechten “Zend testbestanden naar Bestandsuitwisseling” en “Ontvang testbestanden van Bestandsuitwisseling” toe in Autorisatiebeheer, onder de Applicatie “Bestandsuitwisseling”.   2 - Ga naar de Bestandsuitwisseling applicatie en klik op “Send Files”. 3 - Selecteer het nieuwe bestandstype uit de keuzelijst, selecteer een dummybestand door op "Select Files" te klikken en activeer vervolgens het verzenden door op de "Upload" knop te klikken. 4 - Als het bestand succesvol is ingestuurd verschijnt het in de “Sent Files” lijst.   5 - Een paar seconden later zal het bestand ook verschijnen in de "Receive Files" sectie.  6 - klik op het download-icoon om het te downloaden.     ... View more

Nieuwe functionaliteit en verbeteringen Toegang via Autorisatiebeheer HR Core Online gebruikers en overige gebruikers maken nu gebruik van Autorisatiebeheer om toegang te krijgen tot de Bestandsuitwisseling module. Het toe te kennen recht is “Toegang tot Bestandsuitwisseling”.   File Type Autorisatie via Autorisatiebeheer Op dit moment vindt de gebruikers autorisatie voor de ondersteunde file types nog plaats via een 4me request en wordt afgehandeld door Product Development   In de nabije toekomst zal deze gebruikers autorisatie voor ondersteunde file types ook via Autorisatiebeheer verlopen, en zal het 4me request niet meer nodig zijn.   Nieuw Test File Type: Bestandsuitwisseling Test Een nieuw file type is gedefinieerd in Bestandsuitwisseling voor test doeleinden. Dit file type kan al geautoriseerd worden via Autorisatiebeheer.   Op dit moment kan het file type worden gebruikt om te testen of bestanden correct worden ingezonden door Bestandsuitwisseling. Doorloop de volgende stappen om dit file type te gebruiken:   1 - Voeg het nieuwe recht “Bestandsuitwisseling Test - Zenden” toe in Toegangsbeheer, onder de Applicatie “Bestandsuitwisseling”.    2 - Ga naar de Bestandsuitwisseling applicatie en click op “Send Files”. 3 - Selecteer het nieuwe file type in de dropdown en Zend een willekeurig test bestand.    4 - Als het bestand succesvol is ingestuurd verschijnt het in de “Sent Files” lijst ... View more

Visma Connect en File API zal onderhevig zijn aan gepland onderhoud tijdens 21 Juni 2023 01:00-03:00 CEST.    De File API en Youforce API's zullen worden beïnvloed.   We verontschuldigen ons voor mogelijk ongemak. ... View more

In dit voorgaande artikel hebben we het uitfaseren van het Youforce Developer Portal gecommuniceerd en de benodigde stappen aangegeven om uw Applicaties te migreren naar het nieuwe Visma Developer Portal.    Het Youforce Developer Portal zal met ingang van 1 Juni offline gaan en niet meer gebruikt kunnen worden. We raden u aan om voor deze datum uw Applicaties te migreren naar het Visma Developer Portal om te voorkomen dat er onderbrekingen optreden in uw geautomatiseerde bestandsuitwisseling.   Tegelijkertijd zullen de basis URL’s voor de File API offline gaan. De nieuwe File API basis URL is https://fileapi.youforce.com/v1.0   Uw actie:  Controleer samen met uw IT afdeling: Of uw Applicaties zijn aangemaakt in het Visma Developer Portal Dat uw Applicaties de nieuwe File API basis URL gebruiken.   In onderstaande tabel staan de oude File API URL’s, de vervangende nieuwe URL en de uiterste datum waarop de wijziging moet hebben plaatsgevonden.   Oude URLs Nieuwe URL Deadline https://api.raet.com/mft/v1.0 https://fileapi.youforce.com/v1.0 1 Juni https://api.youforce.com/mft/v1.0 https://fileapi.youforce.com/v1.0 1 Juni ... View more

De Youforce File API zal op 17 Mei 2023 tussen 01:00-03:00 CEST gepland onderhoud ondergaan. De service zal gedurende ongeveer 30 minuten niet beschikbaar zijn.   De File Exchange module zal gedurende het onderhoud ook niet beschikbaar zijn omdat er geen bestanden kunnen worden uitgewisseld.   Zie ook onze status pagina https://status.visma.com/ voor meer informatie. ... View more

Visma Connect zal onderhevig zijn aan gepland onderhoud tijdens 03 mei 2023 01:00-03:00 CEST. Visma Connect verwacht tussen de 10 en 30 minuten niet beschikbaar te zijn.   De File API en Youforce API's zullen worden beïnvloed.   We verontschuldigen ons voor mogelijk ongemak. ... View more

Bestandsuitwisseling is ontwikkeld om handmatig bestanden uit te wisselen met Youforce en gaat de “Zend & Ontvang" -module vervangen. Bestandsuitwisseling zal samen met de File API de IBU gaan vervangen.   Enkele voordelen: Intuïtief en gebruiksvriendelijk Geen lokale installatie of configuratie nodig Betrouwbaar, veilig en automatisch opschalen tijdens piek uren   De Bestandsuitwisseling module is op dit moment “Gecontroleerd Beschikbaar”, d.w.z. beschikbaar voor een beperkt aantal gebruikers. De redenen dat de module nog niet “Algemeen Beschikbaar” is zijn de volgende: De Bestandsuitwisseling module moet nog door Product Development handmatig voor een klant geactiveerd worden in Policy Management. Gebruikers moeten nog door Product Development handmatig worden geautoriseerd voor  file types om bestanden te kunnen zenden/ontvangen. Niet alle Youforce  file types worden op dit moment ondersteund.   Kennisartikelen Bestandsuitwisseling - Update 2023-04 Bestandsuitwisseling - HR Core Online Gebruikers - Aan de Slag  Bestandsuitwisseling - HR Core Online Gebruikers - Ondersteunde File Types  ... View more

In de afgelopen weken hebben we hard gewerkt aan nieuwe updates en verbeteringen van de Bestandsuitwisseling module. Hier volgt een overzicht van de belangrijkste nieuwe features en wijzigingen:   File Type Autorisaties  De autorisatie van file types is verplaatst van organisatieniveau naar gebruikersniveau. Dit betekent dat Product Development nu op gebruikersniveau autorisatie tot specifieke file types kan verlenen. Bestaande Bestandsuitwisseling gebruikers zijn geautoriseerd voor alle file types waar voorheen hun organisatie voor was geautoriseerd. Autorisaties voor nieuwe gebruikers of extra autorisaties voor bestaande gebruikers moeten worden aangevraagd via 4me.   Toegang Autorisatie voor HR Core Online gebruikers HR Core Online gebruikers blijven Policy Management gebruiken om toegang tot de Bestandsuitwisseling module te verlenen. Omdat er nu gebruik wordt gemaakt van gebruikersniveau autorisatie, zijn de toe te kennen rechten in Policy Management versimpeld. Het enige verplichte recht nodig voor toegang tot de applicatie is “Toegang tot Bestandsuitwisseling”.   Toegang Autorisatie voor Niet HR Core Online gebruikers Niet HR Core Online gebruikers zullen geen gebruik maken van Policy Management om toegang te verlenen tot de Bestandsuitwisseling module. Voor nu zal de toegang in de Bestandsuitwisseling module zelf worden geregeld door Product Development, en wel op hetzelfde moment als de gebruikers autorisatie voor de verschillende file types. In de toekomst zal deze functionaliteit terug te vinden zijn in Toegangsbeheer.   Hernoemd De naam van de module is gewijzigd van Visma Files naar File Exchange. Op dit moment wordt nog alleen de Engelse taal ondersteund. In de nabije toekomst zal de Nederlandse taal worden ondersteund en zal de module de naam Bestandsuitwisseling voeren. ... View more

Vanwege onderhoud aan het netwerk zullen er geen Digipoort ZSM berichten van Youforce naar het UWV worden verstuurd op Zondag 2 April tussen 09:00 am en 12:00 pm.   Ingestuurde berichten zullen worden verstuurd nadat het onderhoud is afgelopen. ... View more

Om onze service kwaliteit te verbeteren, is er gepland onderhoud voor de File API op: Zaterdag 3 December van 11:00 CET tot 14:00 CET. Er zijn database updates gepland waardoor de File API voor deze 3 uur niet beschikbaar zal zijn. We houden u op de hoogte van de voortgang van het onderhoud op https://status.visma.com Excuses voor het mogelijk ongemak. ... View more

Van IBU naar de File API - Fase 1 Op 21 juli hebben we aangekondigd dat de wijze van bestanduiwisseling van en naar Youforce gemodeniseerd wordt. In verschillende fases wordt de huidige IBU-applicatie vervangen door een File API. Lees dit terug via dit artikel.        We zijn klaar om de vervanging te starten voor de IBU-applicaties die Unattended worden gebruikt in combinatie met HRCoreOnline.   Je start de omzetting door je aan te melden via een 4me-template, van IBU naar File API. Je vindt dit template binnen 4me via de Service Instance "HR Core Beaufort Online Government/Business". Kies voor de gelijknamige template via de rechterkant van het menu.   De werking van de File API staat beschreven via onze Visma Developer Portal. Het gebruik van een API vraagt enig technisch inzicht, betrek uw IT-collega bij dit traject. Instructies voor het aanmaken van een account op de portal en hoe je de File API activeert zijn beschikbaar via de Youforce API Community.   Eenmaal geactiveerd is het mogelijk om de File API-applicatie eerst te gebruiken in combinatie met test-bestanden om een beter beeld te krijgen van de werking van de File API om vervolgens de daadwerkelijke bestanden aan de File API te koppelen.    De omzetting start met het invullen van het 4me-template, van IBU naar File API.   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 ... View more

Gepland onderhoud aan de File API op Zaterdag 02 Juli van 13:00 CEST tot 17:00 CEST. De File API blijft beschikbaar gedurende deze tijd maar u kunt een gedegradeerde performance ervaren. We houden u op de hoogte van de voortgang van het onderhoud op https://status.visma.com/ We verontschuldigen ons voor mogelijk ongemak. ... View more

Due to maintenance of the infrastructure, the File API might not be available on Friday 27th May between 07.00 and 08:00. We apologize for any inconvenience. ... View more