Via onderstaande stappen publiceer je jouw applicatie in de Visma App Store, op die manier kan een Visma Raet-consultant jouw applicatie koppelen aan een klant zonder invitatiecode. Log in via: https://oauth.developers.visma.com/   Na het selecteren van je applicatie kies je voor het scherm ‘Visma App Store’ en de optie 'Publicly available'.   Om de consultant een juiste selectie te laten maken aan de hand van een filtering, vragen we om bij het Filtering Systems-veld voor Youforce te kiezen.  Als categorie (Categories) kies je het domein wat past bij jouw applicatie, de waarde ‘HRM’ kan je altijd selecteren als er geen passende waarde aanwezig is.   Controleer of de drie url-velden een waarde hebben, vul bij voorkeur de url naar jouw bedrijfswebsite in, het mag voor alle drie de velden dezelfde url zijn.   En kies vervolgens voor ‘New marketplace’     Netherlands is het te selecteren land.     Hier maak je de pagina zoals het wordt gepresenteerd aan de klant volledig. Door op een gedeelte van de pagina te klikken kan je het onderdeel bewerken,       De inleidende alinea onder de kopregel is aan te passen, door er op te klikken zie je rechts van het scherm een tekstblok waarin je de tekst kunt wijzigen.    Je hoeft de tekst niet op te slaan, door op het volgende onderdeel te klikken wordt de tekst-editor afgesloten en opgeslagen.     De verplicht aan te vullen onderdelen zijn: Inleidende alinea onder de kopregel De omschrijving  (description, ‘What is Lorem Ipsum’). ‘Add new pricing tier’, dit is een verplicht onderdeel, advies om hier niet de daadwerkelijke kostprijzen te vermelden maar een tekst zoals te zien in onderstaand voorbeeld.     Een afbeelding (logo) is niet verplicht maar aan te raden voor de zichtbaarheid, ter info, afbeeldingen moeten worden goedgekeurd door een medewerker van Visma, dit wordt door de portal aangeboden je hoeft hier zelf niks voor te doen.   De ‘Save changes’-knop linksonder kleurt groen, klik hier op en vervolgens nogmaals voor ‘publish to Visma App Store'.   Je ziet de bevestiging via de Status 'Available in Visma App Store’       ... View more

Nedap Ons is een populair systeem dat zorgprofessionals veel administratieve taken uit handen neemt door personeelsplanningen te maken en deze te koppelen aan Elektronische CliëntenDossiers (ECD).    Visma | Raet levert, met het toonaangevende Youforce platform, een volledig digitale HR-administratie waarmee de werkgever ‘in control’ is over alle processen in de employee lifecycle: van recruitment tot offboarding.   De integratie specialisten van Visma Connect hebben een API connector ontwikkeld die de overdracht van HR data tussen de applicaties van Visma | Raet en Nedap automatiseert.   Youforce API en import ONS Nedap De Youforce Workforce Management (WFM) API met de Extenions API, welke het mogelijk maakt om flexibel 'eigen' rubrieken toe te voegen, vormen de bron voor de connector.  Via de API's wordt de data opgehaald uit HRCoreOnline, waarnodig getransformeerd en aangeboden aan de API van ONS Nedap of via de XML-import van ONS Nedap zodat de data zichtbaar is in de applicatie van ONS Nedap.       Om gebruik te kunnen maken van de connector dien je contact op te nemen met je Customer Success Manager.   Frequentie van het ophalen van de data via de Youforce WFM API en het aanbieden aan ONS Nedap via de API en via de XML-import is ieder uur.   Via onderstaand tabel zie je de betreffende HRCoreOnline-velden die worden uitgewisseld. De velden maken deel uit van een 'scope' (deelgebied), als klant kan je kiezen welke scope(s) je op wilt nemen in de koppeling, bespreek dit met de Raet Consultant.   Benodigde voorbereiding    Eigen rubrieken aanmaken Een belangrijk deel van de informatie wordt via Eigen rubrieken vastgelegd, deze velden zijn essentieel om ONS Nedap goed te kunnen gebruiken, de aanwezigheid van deze velden in HRCoreOnline zijn dus een vereiste. Het aanmaken van de velden met de refentietabellen kan eenvoudig via XML-importbestanden, vraag die op bij je consultant. De wijze van import in HRCoreOnline staat hier beschreven:   https://community.visma.com/t5/Nieuws-Youforce-HR-Core-Beaufort/Rubrieken-voor-eigen-HRSS-inrichting-betaald-ouderschapsverlof/ba-p/504058   Let op, de velden zijn dan beschikbaar in HRCoreOnline desgewenst dien je ze ook op te nemen in de Selfservice-workflows.   ONS Nedap API en XML-import toegang Als klant vraag je bij ONS Nedap het volgende aan: Login credentials voor de ONS Nedap API (met Certificaat) Gebruikersnaam en wachtwoord voor de XML-import Je deelt dit met de Raet Consultant.   Youforce API filter Met behulp van autorisaties filters kan worden bepaald welke medewerkers in de API beschikbaar komen. Bekijk de mogelijkheden via: https://community.visma.com/t5/Kennisbank-Youforce-API/Autorisatie-WFM-api/ta-p/557545     Inhoud van de koppeling   Scope Basis (Persoonsgegevens, dienstverbanden en inzetregels).   HRCoreOnline - veld Import via ONS Nedap API-veld Import via Nedap XML-  veld Opmerking  Persoon P01001 - Persoonsnummer  employee.identificationNo        P00303 - Voorletters  employee.initials       P01003 - Roepnaam employee.firstName       P00301 - Geboortenaam employee.birthName       P00302 - Geboortenaam-voorvoegsels employee.partnerName       P01008 - Samengestelde naam employee.lastName       P01009 - Samengestelde naam-voorvoegsels employee.prefix       P00304 - Gebruik achternaam employee.preferredNameType       P00390 - Partner-naam employee.partnerName       P00391 - Partner-voorvoegsels employee.partnerNamePrefix       P00330 - Geslacht employee.gender       P00321 -Geboorte datum employee.dateOfBirth               Contact- gegevens Business: P01035 - E-mail adres werk employee.emailAddress       Business :P01037 - Telefoonnr werk employee.mobilePhoneNumber               Dienst- verband P01101 - volgnr dienstverband employee.identificationNo-[Volgnr van WFM]         contract.beginDate         contract.endDate         Employee.type   Heeft een vaste waarde 0 (regular)   P01102  - Soort Arbeidsrelatie contract.contractType     P01119 - Max. uren per week payroll.Contract.var /contract.hoursVar               Inzet-regels P01125 - Ingang inzet teamAssignments.beginDate       P01126 - Einde inzet teamAssignments.endDate       P01121 - Operationele org. eenheid team_assignments.teamObjectId       P01124 - Uren inzet per week payroll.Contract.fixed /contract.hoursFixed       Einddatum van het contract in ONS is gebasseerd op de einddatum van de inzetregel.      Scope Extensies (Eigen rubrieken)     HRCoreOnline - veld Import via ONS Nedap API-veld Import via Nedap XML-  veld Opmerking Extentie-velden WKKRT1 - Weekkaartprofiel   registrationprofile     AGB001 - AGB-code 1   employee. agb.primaryAgbCode     AGB002 - AGB-code 2   employee.agb.agbCode     P09165 - BIG-nummer (1)   employee.bigCode     BIG002 - BIG-nummer (2)   employee.bigCode     BIG003 - BIG-nummer (3)   employee.bigCode     DBC001 - Cono-/DBC-beroepsgroep 1   employee. conoBeroepsgroep     DBC002 - Cono-/DBC-beroepsgroep 2   employee. conoBeroepsgroep     DBC003 - Cono-/DBC-beroepsgroep 3   employee. conoBeroepsgroep     AUT001 - Authenticatienummer employee. authentication MobilePhone employee. authenticationNumber     CAO001- CAO-code Ons   collectiveagreement. agreement     DEP001- Deskundigheids-profiel   education.id     COMP01- Compensatie berekenen     Wordt toegevoegd   COMP02- Compensatie begindatum     Wordt toegevoegd   COMP03 -Compensatie uitbetalen     Wordt toegevoegd   ONAN001- Onderaannemer     Niet beschikbaar      Scope Prive (Adres, telefoonnummer en e-mailadres)   HRCoreOnline - veld Import via ONS Nedap API-veld Import via Nedap XML-  veld Opmerking Adres (thuis) P01014 straatnaam EmployeeAddress.street     Adres (thuis) P01016 Huisnummer EmployeeAddress. homeNumber     Adres (thuis) P01018 Huisnummer toev EmployeeAddress. homeNumberExtension     Adres (thuis) P01020 Postcode EmployeeAddress.zipcode     Adres (thuis) P01022 Plaatsnaam EmployeeAddress.city     Adres (thuis) P01024 Land EmployeeAddress.country     Adres (post) P00365 straatnaam EmployeeAddress.street     Adres (post) P00367 huisnummer EmployeeAddress. homeNumber     Adres (post) P00368 huisnummer toev EmployeeAddress. homeNumberExtension     Adres (post) P00308 plaatsnaam EmployeeAddress.zipcode     Adres (post) P00313 postcode EmployeeAddress.city     Adres (post) P00847 land EmployeeAddress.country     Telefoonnummer Home: P01027 - telefoonnr woonadres EmployeeAddress. telephoneNumber     Telefoonnummer Mobile : P01036 - Telefoonnr mobiel EmployeeAddress. telephoneNumber2     E-mailadres Prive: P01034 - E-mail adres privé EmployeeAddress.email     Type Adres   typeString   Standaard wordt de volgende waarde gebruikt: 1: Living (bij Adres Thuis) 2: Postal (bij Adres Post) Type persoon   personType   Standaard wordt de volgende waarde gebruikt: 2: Employee Type verblijf   residentType   Standaard wordt de volgende waarde gebruikt: 0: Unknown     _______________________       Scope Salaris details   HRCoreOnline - veld Import via ONS Nedap API-veld Import via Nedap XML-  veld Opmerkingen Berekend uurloon P01160 Berekend garantie uurloon   employee.HourlyWage.wageInCents         employee.HourlyWage.startOfWage Datum waarop dit uurloon is ingegaan.  *Bestaat niet in Youforce,  eventueel contract datum nemen       employee.HourlyWage.endOfWage Datum waarop dit uurloon niet langer valide is. *Bestaat niet in Youforce eventueel contract datum nemen _____________________         Scope Verlof (rechten)   HRCoreOnline - veld Import via ONS Nedap API-veld Import via Nedap XML-  veld Opmerkingen Verlofsoort (WET, BW etc.) P01430 code verlofsoort werknemer   VacationAmount.plb   Jaar verlofrecht P01440 verlofjaar verlofrechten   CurrentDate   Verlofrechten huidig jaar P01443 verlofrecht huidig jaar in uren   VacationAmount.absolute       ... View more

  Account aanmaken op Visma Developer Portal De Visma Developer portal is te bereiken via  https://oauth.developers.visma.com/service-registry/home   en maak via Create account een account aan             De portal zal via do.not.reply@mail.connect.visma.com  je een e-mail sturen met een Activatie account link.   Gebruik bij het registreren het Kvk-nummer als Organization number       Startscherm na inloggen       Desgewenst kun je een collega toevoegen via My team en New member. Jullie hebben dan beiden inzicht in de gegevens van de applicatie.       De volgende stap is het aanmaken van een applicatie. Een applicatie aanmaken   Door een applicatie aan te maken ontstaat er een API Key en een Secret Key die je gebruikt om de authenticatietoken op te halen.   Kies via het tabblad My Applications voor Add Application     Als application type selecteer Service, dit is het enige type wat door Visma|Raet wordt ondersteund.       Het aanmaken van de applicatie gaat via vier tabbladen, vul de gegevens in op het eerste tabblad Details. Weet dat de opgegeven Client Id wordt gebruikt als API key bij de API-aanroepen.   Je moet zelf de Client Id opgeven.    Testomgeving - Het is tevens mogelijk om gebruik te maken van onze sandbox. Met deze sandbox kun je testen. De applicatie voor de productieomgeving kan ook gekoppeld worden aan de sandbox. Maak hiervoor een 2e Invitation code  aan (deze stap wordt later toegelicht).    Via deze applicatie met bijbehorende Client Id en Secret krijg je toegang de data en of bestanden uit de Youforce/HRCoreOnline-omgeving(en). Eén API key-set kan toegang geven tot meerdere klantomgevingen. Via de Tenant Id die je als Header meestuurt bij het aanvragen van een authenticatie token bepaal je de benodigde klantomgeving.   Access Token Lifetime mag op de default waarde blijven staan. Een aanpassing van deze waarde heeft geen effect op werking van de API, alsmede de opties Include JSON Web Token ID en TestApplication.   Gebruik eerst Save as a draft om vervolgens de applicatie aan te maken via Create, via Next ga je naar het volgende tabblad.       Het tabblad Credentials stelt je in staat om de API Secret aan te maken. Let op, de Secret waarde wordt alleen getoond via de pop up bij het aanmaken, dus neem dit direct over. De pop up toont ook je eerder gekozen ID (API key).   Let op: Wordt de bestaande secret vergeten dan dien je een nieuwe aan te maken, deze wordt dan toegevoegd.       Via het tabblad Integrations selecteer de gewenste Youforce API, oftewel je ‘basis’ API, je gebruikt hiervoor New integration.         Visma Raet zal de opgegeven API’s goedkeuren. Dit gaat via een workflow in de portal, je hoeft daar niks voor te doen. De goedkeuring door Visma Raet kan enkele dagen duren en zolang de goedkeuring niet is verleend kan je de stap van de Visma App Store niet uitvoeren.       Per API dien je de Scope te selecteren welke gebruikt gaat worden in de applicatie. Op deze manier kun je bepaalde functionaliteiten (endpoints) binnen de Youforce API uitsluiten van je applicatie. Je kunt vanzelfsprekend ook alle Scopes selecteren, een API kan ook bestaan uit 1 Scope.       Het tabblad Integrations kan je niet direct bevestigen via Save, dat kan pas op het moment dat Visma|Raet de gekozen API’s bij de applicatie heeft goedgekeurd, dit gaat via een flow je hoeft hier niks voor te doen. De goedkeuring door Visma Raet kan enkele dagen duren en zolang de goedkeuring niet is verleend kan je de stap van de Visma App Store niet uitvoeren.   Je kan door te klikken op stap ‘Visma App store’ naar de laatste stap (mits Visma Raet de API('s) heeft goedgekeurd).             Tabblad Visma App Store, op dit moment stellen wij de Visma App Store niet ter beschikking aan onze klanten.    Voor toegang tot de klantdata genereer je een Invitation Code. Hoe je dit doet staat hieronder verder uitgelegd. Visma Raet zal de toegang tot de klant-data goedkeuren en dan direct de koppeling van klantdata aan je applicatie gereedmaken.       Na Start setup for Visma App Store ziet u onderstaand scherm en dan kies je bij Access level - Audience voor Invite only   Vul ook de url in waar uw product is uitgelegd.       Je bent nu klaar met het aanmaken van de applicatie, de optie Save wordt zichtbaar op het moment dat Visma Raet de applicatie heeft goedgekeurd, je kunt het aanmaken sluiten door bijvoorbeeld op Back to my Applications te klikken.    Wanneer Visma Raet de goedkeuring heeft verleend, ontvang je hier een e-mail van en kun je de volgende stap uitvoeren door de applicatie te koppelen aan klant-data. Dit staat uitgelegd in het volgende hoofdstuk ‘Invitatiecode aanmaken’.   Invitatiecode aanmaken Met een invitatiecode maak je het mogelijk de klantgegevens op te halen via je applicatie. Ga naar de Developer Portal https://oauth.developers.visma.com/service-registry/home    Kies voor My Applications. En klik op het potloodje achter de applicatie (Edit).      Kies voor het tabblad Visma App Store. En vervolgens New Invitation Code.       Bij Invitation description vul je de naam van de betreffende klant in. En klik vervolgens op Generate.         Visma Raet zal de toegang tot de klant-data goedkeuren en dan direct de koppeling van klantdata aan je applicatie gereedmaken.   Binnen het beheer van je applicatie en het scherm Integrations is via de tabblad Tenants (default wordt het tabblad Scopes getoond) terug te zien welke klanten (tenants) gekoppeld zijn aan je applicatie. Dit scherm laat ook de bijbehorende TenantID zien. De TenantID is benodigd bij het opvragen van de authenticatie token.     Voorbeeld van een Tenant ID     Testomgeving - Het is tevens mogelijk om gebruik te maken van onze sandbox. Met deze sandbox kun je testen. De applicatie voor de productieomgeving kan ook gekoppeld worden aan de sandbox. Maak hiervoor een Invitation code  aan en deel die met Visma Raet.   ... View more

Youforce Developer Portal gaat offline Onze producten en oplossingen worden beter wanneer ze verbinding maken met een ecosysteem van geweldige andere oplossingen. Mede daarom heeft Visma Raet besloten aan te sluiten bij het Visma Developer Portal. Waar wij eerder alleen voor Youforce integraties een developer portal hadden, zijn wij binnenkort onderdeel van een groot netwerk van Visma producten.    Dit sluit perfect aan bij onze Best of Breed filosofie. De best of breed strategie houdt in dat je als bedrijf je niet bindt aan één totaalpakket voor software, maar juist op zoek gaat naar de optimale softwareoplossingen voor ieder specifiek deel van het bedrijf. Aangezien Visma in Nederland alleen al meer dan 60 software oplossingen aanbiedt, is de kans groot dat je naast Youforce minimaal nog één of zelfs meerdere  andere Visma producten afneemt. Door op één plaats alle Visma APIs aan te bieden, zorgen wij ervoor dat de integratie uniform is.    Een bijkomend voordeel van de Visma Developer Portal is dat je meer dan één persoon van jullie organisatie toegang kan geven, zodat het onderhoud en de continuïteit van de aangemaakte applicaties gegarandeerd blijft.    Een nog belangrijkere reden voor ons om over te stappen op het Visma Development Portal is de Security. Visma beschikt over zeer bekwame beveiligingsteams, die 24 uur per dag het hele jaar door toezicht houden op alle activiteiten rondom datadeling o.b.v. API-integraties. Deze beveiligingsteams bestaan uit beveiligingsingenieurs, beveiligingsanalisten, incidentresponders, penetratietesters, beveiligingsadviseurs, beveiligingsarchitecten, beveiligingsonderzoekers, beveiligingsmanagers en compliancemanagers. Door ons aan te sluiten bij het Visma Developer Portal kunnen wij gebruikmaken van de expertise van deze  beveiligingsteams en daarmee onze klanten Security van het allerhoogste niveau bieden.   Tijdlijnen Dit betekent dat wij jullie vragen je API-connecties op korte termijn over te zetten van de Youforce Developer Portal naar de Visma Developer Portal.  Vanaf 1 april 2023 kun je geen nieuwe connecties meer aanmaken op de oude Youforce Developer Portal.  En vanaf 1 juni aanstaande zullen wij de Youforce Developer Portal offline halen.  De oude People & Organisation API komt per 1 juni te vervallen. De nieuwe IAM API is hiervoor in de plaats gekomen.    Handleiding Een handleiding die beschrijft hoe je de nieuwe API-applicatie aanmaakt op de nieuwe developer portal vind je op onze Community.    Als je de API-connectie aanmaakt op de nieuwe portal, dan blijft de inhoud van de bestanden ongewijzigd. Wel krijg je een nieuwe clientID, clientSecret en TenantID waarvoor een authenticatietoken opgehaald moet worden.  File API Maak je gebruik van het door Visma Raet gepubliceerde script om via de FileAPI bestanden te down- of uploaden, dan vind je hier een aangepaste script voor de nieuwe situatie. Daarnaast wijzigt voor de FileAPI de basis url naar “https://fileapi.youforce.com/v1.0”.   Leveranciers van aanpalende systemen Grote kans dat niet jij maar jullie leverancier van het aanpalende pakket de API-integratie in het verleden gemaakt heeft. In dat geval is het verstandig dit bericht met hen te delen, zodat zij tijdig de API-applicatie kunnen verhuizen naar de nieuwe Visma Development Portal.   Online Spreekuur Je kunt de nieuwe API-applicatie op de Visma Developer Portal eenvoudig en snel zonder hulp van Visma Raet aanmaken. Mocht je toch nog vragen hebben dan kun je op donderdag 30 maart tussen 15 en 16 uur op ons Online Spreekuur terecht. Onze experts zitten dan klaar om je vragen te beantwoorden of indien gewenst je op weg te helpen met het aanmaken van de API-applicatie op de Visma Developer Portal.    Heb je daarna toch nog behoefte aan ondersteuning van één van onze experts, dan kun je via 4Me een consultant aanvragen.  ... View more

Visma|Raet maakt nu gebruik van de Developer portal van Visma, een portal waar u API-applicaties kunt aanmaken en beheren. Met deze portal heeft u niet alleen toegang maar hebben uw collega's ook toegang tot de aangemaakte applicaties.   Wat moet u doen om gebruik te maken van de nieuwe portal?   Raadpleeg de oude portal Log in op de oude portal (developers.youforce.com) en raadpleeg via het scherm 'Your apps' de API-applicaties die u nu beschikbaar heeft, ter info applicaties met het kenmerk 'Production' zijn daadwerkelijk gekoppeld aan de gegevens uit HRCoreOnline, applicaties met het kenmerk 'Sandbox' geven toegang tot test-data. Onthoud de applicaties en de daarbij horende Youforce API.   Maak een account aan op de Visma Developer Portal Een werkinstructie is via onderstaande link beschikbaar: https://community.visma.com/t5/Kennisbank-Youforce-API/Visma-Developer-portal-een-account-aanmaken-applicatie/ta-p/527059#toc-hId-1536010841   Maak de applicaties aan De applicaties die u heeft via de oude portal kunt u opnieuw aanmaken, kies daarbij vanzelfsprekend de Youforce API die ook gekoppeld is aan de oude applicatie: https://community.visma.com/t5/Kennisbank-Youforce-API/Visma-Developer-portal-een-account-aanmaken-applicatie/ta-p/527059#toc-hId--1016146120   Autoriseer de applicatie De aangemaakte applicatie geeft nog geen toegang tot de gegevens uit HRCoreOnline, maak hiervoor een 'invitatiecode' aan, hoe staat hier beschreven: https://community.visma.com/t5/Kennisbank-Youforce-API/Visma-Developer-portal-een-account-aanmaken-applicatie/ta-p/527059#toc-hId-726664215   Voor de FileAPI dient Visma|Raet nog een extra autorisatie-stap uit te voeren. Vermeld daarom in de e-mail die u verstuurt met de invitatiecode ook de benodigde Youforce-bestanden (businessTypeID's).   De API-applicatie is nu gereed voor gebruik, u kunt de nieuwe en de oude applicatie beide gelijktijdig gebruiken.   Voer de wijzigingen door in uw aanroep van de API   In onderstaande tabel staat links de oude werkwijze en via 'Nieuwe Visma developer Portal' de wijzigingen door het gebruik van de nieuwe portal. De impact zit in de stap waarbij de authenticatie-token wordt opgehaald. Bij gebruik van de FileAPI zit er ook een wijziging in de URL.   De tenant_id wijzigt door de nieuwe portal, in plaats van het van een 7-cijferig nummer is het nu een langere string, onder de tabel staat een plaatje hoe u de nieuwe tenant_id kunt achterhalen.     Oude Raet developer portal Nieuwe Visma developer Portal Authencation token url:   https://api.youforce.com/authentication /token   Met in de Body de volgende authenticatie gegevens uit de Youforce developer portal: client_id client_secret  url:   https://connect.visma.com /connect/token   Met in de Body de volgende authenticatie gegevens uit de Visma developer portal: client_id client_secret  tenant_id Let op: De tenant_id is dus toegevoegd aan de authencation en wordt tussen de endpoint meegegeven in de bearer token. File API File API basis path moet gewijzigd worden van “https://api.raet.com/mft/v1.0 ”  naar “https://fileapi.youforce.com/ v1.0”   Learning API GET User endpoint In learning API is het endpoint beschikbaar via verschillende url versie zoals v0.1 en v.1.0 GET https://api.youforce.com//learning/v0.1/ users (employeeId=xxxx) GET https://api.youforce.com//learning/v1.0/ users (employeeId=xxxx) In de Learning en IAM API is het endpoint enkel beschikbaar via de url versie v1.0 GET https://api.youforce.com//learning/v1.0/ users(employeeId=10010) Alle API's All endpoints base url: api.youforce.com met de volgende gegevens in de header bearer authorisation token uit het youforce.com authorisation token Tenant_id. Dit is een 7-cijferig nummer dat de klant binnen Raet identificeert base url: api.youforce.com met de volgende gegevens in de header bearer authorisation token uit het visma.com authorisation token. In dit visma token zit de tenant_id al verwerkt Note: Het tenant_id hoeft dus niet meer bij elke API call meegegeven worden.  Wordt de tenant_id per ongeluk wel meegegeven in de API call dan wordt deze genegeerd  Daarnaast blijven de endpoints via de base url api.youforce.com    Nieuwe tenant_id Via je applicatie, Integrations en het tabblad Customers kan je de tenant ID van inzien:               ... View more

SIVI Verzuimberichten biedt de ziekmeldingen aan vanuit de HRCore Online-applicatie op een manier die overeenkomt met de SIVI-standaard. Het bestand is in lijn met de voorgeschreven XML-structuur en met de XSD-versie van 'Verzuimmeldingen 2020' en wordt vanuit Youforce verstuurd naar de sftp-locatie van de arbodienst.   Inhoud van het bericht In onderstaande tabel staan de velden van het bericht, via de kolom 'HRCore Online veld' kunt u zien welke velden gevuld worden vanuit HRCore Online. Staat in deze kolom geen 'HRCore Online veld' dan is het veld in het bestand leeg. De velden met 'Systeem ..' worden automatisch gevuld.    Wanneer het volgens de SIVI-standaard een verplicht veld is dan staat dat vermeld. Verplicht wil zeggen dat het veld een waarde moet hebben. Een 'Onderdeel' kan wel of niet verplicht zijn en binnen dat onderdeel zijn er wel of niet verplichte velden.   Wanneer wordt een bericht verstuurd Bij de invoer of wijziging van een ziekmelding, of hersteldmelding, wordt bovenstaande data van de ziekmelding en medewerker in het bestand gezet en het bestand wordt dan door Visma | Raet verstuurd naar de sftp-locatie van de arbodienst.   Wanneer een gegeven van een zieke medewerker wijzigt zoals een telefoonnummer, adres of dienstverband dan wordt ook bovenstaande data van de ziekmelding en medewerker in het bestand geplaatst en verstuurd naar de arbodienst. Een dergelijke wijziging van een niet-zieke medewerker leidt niet tot het aanmaken van een bestand. SIVI Verzuimberichten ondersteunt een 'negatieve administratie'.   Binnen Youforce is een log beschikbaar om in te zien of Youforce een bestand heeft aangemaakt en verstuurd naar de arbodienst. Je kan dit log autoriseren voor een Youforce-gebruiker (via Youforce Portaalbeheer, te kiezen optie 'SIVI Berichten').      Initiele load Bij de start kan een initiele load plaatsvinden. Visma|Raet stuurt dan alle openstaande ziekmeldingen en van de betreffende medewerkers de ziekmeldingen met een herstelddatum korter dan 28 dagen terug naar de arbodienst.  De initiele load bevat dus niet een overzicht van alle medewerkers, alle organisatorische eenheiden of de complete verzuimhistorie en dergelijke.    Filter Visma|Raet kan een filter plaatsen zodat niet de ziekmeldingen van alle medewerkers worden verstuurd naar de arbodienst.   Een filter kan ingesteld worden op basis van 1 van onderstaande HRCore Online-velden: CEA-nummer / Opdrachtgever Instelling nummer Soort arbeidsrelatie (P01102) Code doelgroep (P01110) Selectie Dienstverband SIVI API (P05043), dit is een relatief nieuw veld dat naar eigen inzicht ingericht kan worden (referentietabel) en de waarde leg je vast  bij het dienstverband van de medewerker. Op deze manier kunt u bijvoorbeeld (via veld Soort arbeidsrelatie) de ziekmeldingen van de externen uitsluiten.     Tabel met de inhoud van het bericht Omschrijving van het SIVI-veld Veldnaam in de XML Verplicht HRCore Online veld Voorbeeld Aanmaakdatum bericht AandatBr   Systeem Datum 31-3-2021 Aanmaaktijd bericht AantijdBr   Systeem Tijd 13:06:55 Onderdeel 'ADMINISTRATIEKANTOOR'         Handelsnaam organisatie HndlsnmOrg       Inschrijvingsnummer Kamer van Koophandel InschrijvingsnrKvK       Vestigingsnummer Vestigingsnr Handelsregister       Onderdeel 'WERKGEVER' (verplicht)         Handelsnaam organisatie HndlsnmOrg Ja De waarde wordt bij de start ingesteld Bogé regressiebestand Inschrijvingsnummer Kamer van Koophandel InschrijvingsnrKvK       Vestigingsnummer Vestigingsnr Handelsregister       Identificatie werkgever bij Arbo-dienst IdWrkgvrArbdnst Ja De waarde wordt bij de start ingesteld 105 Aansluitnummer gegevensuitwisseling Arbodienst AansltnrGeguitwlng Arbdnst Ja De waarde wordt bij de start ingesteld 6431 Identificatie werkgever bij UWV IdWrkgvrUWV       Loonheffingennummer Lhnr       Indicatie eigenrisicodrager voor de WGA IndERDWGA       Indicatie eigenrisicodrager voor de ZW IndERDZW       Onderdeel 'STRAATADRES NEDERLAND'         Soort adres, code SrtAdrsCd       Ingangsdatum Ingdat       Einddatum Enddat       Postcode Pc   Uit 'NAW-gegevens instelling'   Woonplaatsnaam Wnpl   Uit 'NAW-gegevens instelling'   Straatnaam StraatLang   Uit 'NAW-gegevens instelling'   Huisnummer Huisnr   Uit 'NAW-gegevens instelling'   Huisnummertoevoeging HuisToev   Uit 'NAW-gegevens instelling'   Onderdeel 'POSTBUSADRES NEDERLAND'         Ingangsdatum Ingdat       Einddatum Enddat       Postcode Pc       Woonplaatsnaam Wnpl       Postbusnummer Pbnr       Onderdeel 'COMMUNICATIE'         Soort communicatie, code SrtComCd       Nummer/adres communicatie NrCom       Onderdeel 'CONTACTPERSOON'         Identificatie Werknemer IdWrknmr       Personeelsnummer Persnr       Achternaam /Achternamen Achternaam       Voorletters Voorl       Roepnaam Roepnaam       Geslachtsaanduiding, code GslchtCd       Rol contactpersoon, code RolCntprsnCd       Onderdeel 'COMMUNICATIE' (verplicht)         Soort communicatie, code SrtComCd Ja     Nummer/adres communicatie NrCom Ja     Onderdeel 'WERKNEMER' (verplicht)         Ingangsdatum mutatie IngdatMut       Burgerservicenummer SofiNr       Geboortedatum Gebdat Ja P00321 - Geboortedatum 20-3-1990 Overlijdensdatum Overldat   P01005- Datum overlijden 20-11-2013 Significant deel van de achternaam SignNm Ja P00301 - Geboortenaam Hoffman Voorletters Voorl Ja P00303 - Voorletters M Voorvoegsels Voorv   P00302 - Geboortenaam-voorvoegsels de Roepnaam Roepnaam   P01003 - Roepnaam Marcel Titulatuur voor de naam TitVNm   P00305 - Titulatuur voor de naam Doctor Titulatuur achter de naam TitANm   P03937 - Titulatuur achter de naam Drs Naamvoorkeur, code NmvrkrCd Ja P00304 - Gebruik achternaam 1 Geslachtsaanduiding, code GslchtCd Ja P00330 - Geslacht M Niveau opleiding, code NivOpldngCd       Identificatie werknemer IdWrknmr Ja P01001 - Persoonsnummer 700066 Identificatie werknemer oud IdWrknmrOud       BANKREKENING BnkGiro       IBAN Iban       BIC Bic       Onderdeel 'PARTNER'         Significant deel van de achternaam SignNm Ja, voor dit onderdeel P00390 - Partner-naam Maria Voorvoegsels Voorv   P00391 - Partner-voorvoegsels E Onderdeel 'STRAATADRES NEDERLAND'          Soort adres, code SrtAdrsCd   Systeem Data 01  Soort verpleegadres, code SrtVrplgadrsCd   Systeem Data NA Naam verpleegadres NmVrpladrs   P01622 - Naam verpleegadres VU Medisch Centrum Ingangsdatum Ingdat   P01620 - Ingangsdatum verpleegadres 3-3-2021 Einddatum Enddat   P01621 - einddatum verpleegadres 21-4-2021 Postcode Pc Ja, voor dit onderdeel P01626 - verpleegadres (P01020 - Postcode) 3816NR Woonplaatsnaam Wnpl Ja, voor dit onderdeel P01627 - verpleegadres (P01022 - Woonplaats) HAARLEM Straatnaam StraatLang   P01623 - Straatnaam verpleegadres (P01014 - Straat) Haarlemmerstraat Huisnummer Huisnr Ja, voor dit onderdeel P01624 - huisnummer verpleegadres  45 Huisnummertoevoeging HuisToev   P01625 - huisnummer toe verpleegadres (P01018 - Huisnummer toevoeging) B Onderdeel 'STRAATADRES BUITENLAND'         Soort adres, code SrtAdrsCd       Soort verpleegadres, code SrtVrplgadrsCd       Naam verpleegadres NmVrpladrs       Ingangsdatum Ingdat       Einddatum Enddat       Locatieomschrijving buitenland LocomsBtl       Postcode buitenland PcBtl       Woonplaatsnaam buitenland WnplBtl       Regionaam buitenland RegBtl       Land, code LandCd       Landnaam Landnm       Straatnaam StraatLang       Huisnummer buitenland HuisnrBtl       Onderdeel 'COMMUNICATION'         Soort communicatie, code SrtComCd   Systeem Data 05/06/07/09 Nummer/adres communicatie NrCom Ja, voor dit onderdeel P01034 - E-mail adres prive (05) P01035 - E-mail adres werk (06) P01027 - Telefoonnr woonadres (07) P01036 - Telefoonnr mobiel (09) marcel.h@icici.com marcel.h@gmail.com 612399001 610922334 Onderdeel 'DIENSTVERBAND' (verplicht)         Ingangsdatum mutatie IngdatMut       Identificatie dienstverband IdDnstvbnd   Systeem Data 1 Identificatie dienstverband oud IdDnstvbndOud       Ingangsdatum Ingdat Ja P00322 - Datum in dienst 1-1-2021 Einddatum Enddat   P00830 - Datum uit dienst 31-12-9999 Reden einde dienstverband, code RdEndDnstvbndCd       Personeelsnummer PersNr   P01001 - Persoonsnummer 700060 Personeelsnummer oud PersNrOud       Contractnummer bij Arbo-dienst CntrnrArbdnst       Soort dienstverband, code SrtDnstvbndCd   P01102 - Soort arbeidsrelatie VAST Functiecode Fnctcd   P01107 - Primaire functie 3002 Naam functie NmFnct   P01107 - Primaire functie accountant Code fase indeling F&Z FsIndFZ       Naam organisatie-eenheid NmOrgeenh   P01106 - Hierarchische org. eenheid Receptie Organisatie-eenheid, code OrgeenhCd Ja P01106 - Hierarchische org. eenheid 1882 Onderdeel van organisatieeenheid, code OndOrgeenhCd   (bovenliggende OE?) 801 Onderdeel van organisatie-eenheid, naam OndOrgeenhCdNm   (bovenliggende OE?) Algemene ondersteuning Postcode standplaats PcStandplts       Verdeling, code VrdlngCd       Code contract onbepaalde / bepaalde tijd CdBepTd   P08259 - Code contract O/B Aantal contracturen per week AantCtrcturenPWk   P01109 - Uren per week 36.0 Soort variabele werktijden, code SrtVarWrktdCd       Aantal loonwachtdagen AantLnwchtdgn       Percentage loondoorbetaling PrcLndrbtng       Onderdeel 'ARBEIDSRELATIE'         Identificatie arbeidsrelatie IdArbeidsrelatie       Identificatie arbeidsrelatie oud IdArbeidsrelatieOud       Personeelsnummer PersNr       Personeelsnummer oud PersNrOud       Ingangsdatum Ingdat       Ingangsdatum mutatie IngdatMut       Einddatum Enddat       Aantal contracturen per week AantCtrcturenPWk       Onderdeel 'KOSTENPLAATS'         Ingangsdatum Ingdat       Ingangsdatum mutatie IngdatMut       Einddatum Enddat       Naam kostenplaats NmKostenplaats       Kostenplaats, code KostenplaatsCd       Onderdeel van kostenplaats, code OndKostenplaatsCd       Onderdeel van kostenplaats, naam OndKosten plaatsNm       Onderdeel 'VERZUIM' (verplicht)         Verwerking, code VrwrkCd   Systeem Data 1 Ingangsdatum mutatie verzuim IngdatMutVrzm   Systeem Data 1-3-2021 Ingangsdatum mutatie verzuim oud IngdatMutVrzmOud   Systeem Data 21-2-2021 Verzuimgeval identificatie VrzmgvlId Ja Combinatie van het Personeelsnummer + Identificatie dienstverband + Identificatie ziekmelding 700060 1 926 Verzuimgeval identificatie oud VrzmgvlIdOud       Verzuimgeval volgnummer melding VrzmgvlVnrMld Ja Systeem Data 2 Einde verzuim J/N EndVrzmJN Ja Systeem Data J Datum verzuimmelding werkgever DatVrzmWrkgvr   P01603 - Datum ziekmelding 21-11-2021 Datum eerste verzuimdag DatEerstVrzmdg Ja P01600 - Datum eerste ao-dag 31-7-2021 Datum eerste verzuimdag oud DatEerstVrzmdgOud   (wordt niet getoond?) 11-4-2021 Datum hersteld DatHrstld   P01606 - Datum herstel 20-3-2021 Datum hersteld werkgever DatHrstldWrkgvr       Percentage verzuim PrcVrzm Ja P01642 - ziekte percentage 80 Bijzondere reden start verzuim, code BijzRdnStartVrzmCd       Oorzaak verzuim, code OorzkVrzmCd Ja Systeem Data 99 Vangnetgeval J/N VngntJN Ja P01645 - Soort vangnetgeval J Reden einde verzuim, code RdnEndVrzmCd   (Op welk veld gebaseerd?) 1 WAZO, code WAZOCd   (Op welk veld gebasseerd?) 1 Nummer uitkering bedrijfsvereniging NrUitkBdrver       Percentage arbeidstherapie PrcArbther       Onderdeel 'CONTACTPERSOON'         Identificatie Werknemer IdWrknmr   Persoonsnummer van de leidinggevende ('MGR' van de betreffende OE) 700066 Personeelsnummer Persnr   Persoonsnummer van de leidinggevende ('MGR' van de betreffende OE) 700066 Achternaam /Achternamen Achternaam Ja, voor dit onderdeel Achternaam 'MGR' Veltman Voorletters Voorl   Voorletters 'MGR' A Roepnaam Roepnaam   Roepnaam 'MGR' Marcel Geslachtsaanduiding, code GslchtCd   Geslacht 'MGR' M Rol contactpersoon, code RolCntprsnCd Ja, voor dit onderdeel Systeem data 1 Onderdeel 'COMMUNICATIE' (verplicht)         Soort communicatie, code SrtComCd Ja Systeem data 6-aug Nummer/adres communicatie NrCom Ja P01035 - E-mail adres werk 'MGR' (06) P01037 - Telefoonnummer werk 'MGR' (08) alisha.veltman@raet.com Onderdeel 'ACTIE'         Actie, code ActieCd       Onderdeel 'VRIJE TEKST'         Vrije tekst VrijeTekst       Onderdeel 'CONTACTPERSOON'          werkgever - werknemer - dienstverband         Identificatie Werknemer IdWrknmr   Persoonsnummer van de leidinggevende ('MGR' van de betreffende OE) 700066 Personeelsnummer Persnr   Persoonsnummer van de leidinggevende ('MGR' van de betreffende OE) 700066 Achternaam /Achternamen Achternaam Ja, voor dit onderdeel Achternaam 'MGR' Veltman Voorletters Voorl   Voorletters 'MGR' A Roepnaam Roepnaam   Roepnaam 'MGR' Marcel Geslachtsaanduiding, code GslchtCd   Geslacht 'MGR' M Rol contactpersoon, code RolCntprsnCd Ja, voor dit onderdeel Systeem Data 1 Onderdeel 'COMMUNICATIE' (verplicht)         werkgever - werknemer - dienstverband - contactpersoon         Soort communicatie, code SrtComCd Ja, voor dit onderdeel Systeem Data 6 Nummer/adres communicatie NrCom Ja, voor dit onderdeel P01035 - E-mail adres werk 'MGR' (06) P01037 - Telefoonnummer werk 'MGR' (08)  622345978 ... View more

Veel arbodiensten gebruiken een eigen systeem om terugkoppelingsdocumenten op te stellen. Deze documenten zijn bedoeld voor betrokkenen binnen de klantorganisatie. Om deze terugkoppelingsdocumenten ook in Verzuim Management beschikbaar te krijgen, is het nodig om deze documenten handmatig in te voeren. Dit leidt echter tot dubbele invoer van de documenten en is bovendien foutgevoelig. Om deze dubbele invoer én eventuele fouten te voorkomen, is de SIVI documenten interface ontwikkeld.   Bij gebruikmaking van SIVI documenten leveren de arbodiensten de bestanden geautomatiseerd aan Visma Raet, via een beveiligde verbinding. Deze bestanden worden gekoppeld aan in Verzuim Management bestaande acties die zijn ingericht met een verwijzing naar de Identificatie document soort van SIVI.   Het aanleveren van de bestanden aan Visma Raet gebeurt via onze File API, de werking van de File API is hier gedocumenteerd.   De pagina Getting Started beschrijft hoe je een access token opvraagt en via Publishers/Multipart upload staat de API call beschreven die zorgt voor de upload.    Het bestand is het door SIVI voorgeschreven (XML)format versie 2020, de XML-bestandsnaam moet bij insturen via de File API voldoen aan het volgende formaat:   DO-XXXXXXXXXXXXXXX_YYYYMMDDHHMMSSFFF.xml of DO-XXXXXXXXXXXXXXX_YYYYMMDDHHMMSSFF.xml of DO-XXXXXXXXXXXXXXX_YYYYMMDDHHMMSS.xml   Voorbeelden:  DO-Tussentijdse evaluatie_20180622010203444.xml DO-Evaluatie n.a.v. gesprek 1_20180622010203444.xml   Toelichting: Onderdeel inhoud DO- Vaste waarde XXXXXXXXX Vrij in te vullen waarde. Variabel, minimaal 1 positie, maximaal 160 posities. Toegestane waarden:  alfa numeriek: A-Z, a-z, 0-9. punten. spaties _ Vast waarde, scheidingsteken YYYY Jaar, 4 posities MM Maand, 2 posities dd Dag, 2 posities HH Uur, 2 posities MM Minuut, 2 posities SS Seconden, 2 posities FF of FFF Milliseconden 0, 2 of 3 posities .xml Vaste waarde, extensie   Om het bestand via een File API-call te versturen naar Visma Raet dient businessTypeID 124000 gebruikt te worden in de call. Dit businessTypeID staat in Youforce voor de SIVI Documenten en dient samen met de bestandsnaam als metadata worden toegevoegd aan de API call. Een voorbeeld van de API-call:     Je kan de upload testen door gebruik te maken van onderstaande API-credentials API Key: VRA_fileapi_4001401_uploadsivi Secret Key: F0m9N5kbdXB4xEPQTkQRpd76H4JZw6CYoJQbskQ9zAJDdtu8WalC687ozkjoZ6tm TenantID: f556855c-a0c4-42c7-88f1-98bf5b209393   Met onderstaande variabelen in het SIVI document-XML-bestand voor een succesvolle test-verwerking:        <IdInzndr>ArbodienstX/IdInzndr> <IdOntvngr>Visma - Raet</IdOntvngr>  <HndlsnmOrg>RAET SIVI TEST</HndlsnmOrg> <IdWrkgvrArbdnst>test12345test</IdWrkgvrArbdnst> <AansltnrGeguitwlngArbdnst>6431</AansltnrGeguitwlngArbdnst> <Lhnr>999999999999</Lhnr> <SrtDocumentCd>999</SrtDocumentCd> <SrtDocumentOms>Overig</SrtDocumentOms> <KenmerkZendPartij>ArbodienstX</KenmerkZendPartij>   <IdWrknmr>1945</IdWrknmr> <IdDnstvbnd>1</IdDnstvbnd> <PersNr>1945</PersNr> <VrzmgvlId>1945 1 1809</VrzmgvlId> <DatEerstVrzmdg>2022-05-24</DatEerstVrzmdg>   Wanneer de File API een 201 (Created) teruggeeft dan is de upload succesvol geweest, neem met Visma Raet contact op om samen te controleren of het document daadwerkelijk is toegevoegd aan het verzuimdossier van de betreffende medewerker (persoonsnummer 1945, verzuimdossier 24-05-2022), een specifieke bestandsnaam van het document (<Bestandsnm>) helpt bij de controle.     ... View more

Alle Youforce API's zoals de IAM API, Learning API, ect tonen een vaste set aan rubrieken. Voor iedere API is deze vaste set beschreven met daarbij het bron-veld uit HRCoreOnline.   Via de Extensions API, die als een extra API bij een Youforce API geactiveerd wordt, is het mogelijk Eigen rubrieken' (E-rubrieken) of bepaalde standaard HRCoreOnline-velden (toegewezen aan verzameltabel DPIA032), op het niveau van de persoon (PS) en dienstverband (DV) aan de API toe te voegen.    Eigen rubrieken  Hieronder een voorbeeld van een Eigen rubriek wat toe te voegen is aan de Extensions API. De gegevenssoort moet of PS - Persoon of DV - Dienstverband zijn en het moet gaan om een 'Stam gegeven'.   Standaard-rubrieken Het standaard HRCoreOnline-veld moet zijn toegewezen aan tabel DPIA032. De gegevenssoort moet of PS - Persoon of DV - Dienstverband zijn en het moet gaan om een 'Stam gegeven'. Toets dit zelf door in HRCoreOnline de rubriek-eigenschappen op te vragen van het benodigde veld. Een voorbeeld van een Standaard-rubriek wat toe te voegen is aan de Extensions API.    Dit betekent dat standaard ingedeelde Raet HRCoreOnline-velden niet kunnen worden toegevoegd en ook niet de velden die op een 'ander niveau' worden vastgelegd in de HRCoreOnline-applicatie, denk aan velden bij een ziekmelding, verlofaanvraag of bij een organisatorische eenheid et cetera. Dit soort velden zijn opgenomen in de standaard set van de Youforce API mits het veld past bij de doelbinding van de betreffende API.   De extensions API heeft per API twee endpoint waar het veld aan toegevoegd kan worden: Gecombineerd met een API, bijvoorbeeld de IAM api. api.youforce.com/extensions/v1.0/IAM/persons  api.youforce.com/extensions/v1.0/IAM/employments De Extensions API toont: de persoonscode; bij een dienstverband-rubriek het dienstverbandnummer; rubrieknummer uit HRCoreOnline; de veldnaam (fieldNameAlias, deze kies je zelf, daarover later meer); de waarde, bij velden met een 'tabel' toont de API de waarde en omschrijving (description). Zie hieronder voor een voorbeeld op Persoonsniveau en dienstverband niveau:       Eerst afstemmen met de partij die Youforce API gebruikt De Extentions API is te gebruiken in combinatie met een andere Youforce API. Raadpleeg altijd vooraf bij de partij die de Youforce API gebruikt of zij ook kunnen koppelen met de Extensions API en stem met die partij ook de extra velden af. Het is niet ondenkbaar dat de ontvangende partij een aanpassing moet doen in hun koppeling op de Youforce API.   Extensions API is een product-afname Neem contact op met de Customer Success Manager om de Extensions API als product af te nemen.   Hoe kan je hier als klant gebruik van maken Omdat de Extensions API alleen gebruikt kan worden met de nieuwe Developer portal zal de houder van de API-applicatie een nieuwe applicatie moeten aanmaken (met vanzelfsprekend ook de 'Youforce Extensions API'): Instructie Visma Developer portal  Visma|Raet stemt de nieuwe Developer portal af met haar partners maar de afstemming over de extra velden zal je zelf met de ontvangende partij moeten doen.   Wanneer de API-applicatie is aangemaakt dien je als klant een 4ME-ticket aan te maken met daarin de volgende informatie: ClientID van de API-applicatie of als het gaat om een Visma|Raet-partner de naam van de partner; HRCoreOnline-rubrieknummer met de gewenste veldnaam zoals deze terug moet komen in de API. De tekst dat het gaat om 'inrichting van de Extensions API, bestemd voor API Consultancy'   Kies binnen 4ME voor Youforce (Portal) en de tegel Request for information.   Visma|Raet zal de velden toevoegen en de status via het ticket bijhouden. Je zal zelf de ontvangende partij moeten informeren.  De aanvraag is vanuit Visma|Raet ook afgerond op het moment dat de velden zijn toegevoegd aan de API, desgewenst controleren/testen van de uitbreiding in de applicatie van de andere partij zal je zelf moeten afstemmen met de ontvangende partij.     ... 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 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. ... View more

  Introductie Voor de overgang van de IBU (Automatisch) naar File API kun je de volgende opties in overweging nemen:   Je kunt dit volledig zelf doen Consultancy afspraak van een uur waarin wij de file API en benodigde stappen uitleggen. Consultancy afspraak van 4 uur (Intake 1 uur + 3 uur verdere inrichting)  waarin we onderstaande stappen gezamenlijk doorlopen. Voor optie 2 en 3 (het inplannen van een consultancy afspraak) kan je in Mijn Support een nieuwe aanvraag indienen, kiezen voor soort consultancy (API), optie Aanvraag consultancy en vervolgens de benodigde informatie velden invullen.    Indien je ervoor kiest om de inrichting zelf te doen, volg dan onderstaande stappen: Inventariseer om welke bestanden het gaat. Maak een Account aan op Visma Developer Portal Maak een applicatie aan op Visma Developer Portal Maak een Invitatiecode aan op Visma Developer Portal Dien een ticket in via ‘Mijn support’ Pas systemen aan om gebruik te maken van File API Implementeer de nieuwe File API oplossing in uw eigen omgeving.  1 - Inventariseer om welke bestanden het gaat Jullie Customer Success Manager heeft inzicht in het gebruik van IBU en kan daar op verzoek een lijst van aanleveren.   2 - Account aanmaken op Visma Developer Portal De Visma Developer portal is te bereiken via  https://oauth.developers.visma.com/service-registry/home   en maak via Create account een account aan         De portal zal via do.not.reply@mail.connect.visma.com  je een e-mail sturen met een Activatie account link.   Gebruik bij het registreren het Kvk-nummer als Organization number     Startscherm na inloggen     Desgewenst kun je een collega toevoegen via My team en New member. Jullie hebben dan beiden inzicht in de gegevens van de applicatie.     De volgende stap is het aanmaken van een applicatie (zie stap 3). 3 - Een applicatie aanmaken   Door een applicatie aan te maken ontstaat er een API Key en een Secret Key die je gebruikt om de authenticatietoken op te halen. Bij het gebruik van de File API vragen we je om een aparte applicatie aan te maken per business type (bijvoorbeeld BINT, Datafeed, DPIA100).   Kies via het tabblad My Applications voor Add Application   Als application type selecteer Service, dit is het enige type wat door Visma|Raet wordt ondersteund.     Het aanmaken van de applicatie gaat via vier tabbladen, vul de gegevens in op het eerste tabblad Details. Weet dat de opgegeven Client Id wordt gebruikt als API key bij de API-aanroepen.    Je moet zelf de Client Id opgeven, om je bij vragen sneller van dienst te kunnen zijn, vragen wij je om bij het gebruik van de File API de waarde alsvolgt te kiezen: VRA_fileapi_6412345_BINT oftewel VRA_fileapi_ met daarachter je Visma|Raet-klantnummer en business type.    Let op: De Applicatienaam en Client Id heb je nodig in stap 5  om de autorisatie aan te vragen.   Let op:  Testomgeving - Indien je de API wilt koppelen aan jullie eigen testomgeving vragen wij je om bij het gebruik van de File API de waarde als volgt te kiezen: VRA_fileapi_6412345_BINT oftewel VRA_fileapi_ met daarachter je Visma|Raet-klantnummer van de testomgeving en business type.    Het is tevens mogelijk om gebruik te maken van onze sandbox. Met deze sandbox kun je 3 dummy testfiles testen. De applicatie voor de productieomgeving kan ook gekoppeld worden aan de sandbox. Maak hiervoor een 2e invitation code aan.    Via deze applicatie met bijbehorende Client Id en Secret krijg je toegang de data en of bestanden uit de Youforce/HRCoreOnline-omgeving(en). Eén API key-set kan toegang geven tot meerdere klantomgevingen. Via de Tenant Id die je als Header meestuurt bij het aanvragen van een authenticatie token bepaal je de benodigde klantomgeving.   Access Token Lifetime mag op de default waarde blijven staan. Een aanpassing van deze waarde heeft geen effect op werking van de API, alsmede de opties Include JSON Web Token ID en TestApplication.   Gebruik eerst Save as a draft om vervolgens de applicatie aan te maken via Create, via Next ga je naar het volgende tabblad.     Het tabblad Credentials stelt je in staat om de API Secret aan te maken. Let op, de Secret waarde wordt alleen getoond via de pop up bij het aanmaken, dus neem dit direct over. De pop up toont ook je eerder gekozen ID (API key).   Let op: Wordt de bestaande secret vergeten dan dien je een nieuwe aan te maken, deze wordt dan toegevoegd.     Via het tabblad Integrations selecteer je Youforce File (voor de bestanden), oftewel je ‘basis’ API, je gebruikt hiervoor New integration.       Visma | Raet zal de opgegeven API’s goedkeuren. Dit gaat via een workflow in de portal, je hoeft daar niks voor te doen. De goedkeuring door Visma | Raet kan enkele dagen duren.       Per API dien je de Scope te selecteren welke gebruikt gaat worden in de applicatie. Op deze manier kun je bepaalde functionaliteiten (endpoints) binnen de Youforce API uitsluiten van je applicatie. Je kunt vanzelfsprekend ook alle Scopes selecteren, een API kan ook bestaan uit 1 Scope.     Scopes Betekenis businesstypes list  In de toekomst zal deze scope publishers en subscribers toestaan om informatie te krijgen over businesstypes. Op dit moment is het alleen mogelijk voor een publisher om op te vragen of er een subscriber is voor een specifieke tenant/businesstype combinatie. files delete Deze scope staat subscribers toe om bestanden te verwijderen files download Deze scope staat subscribers toe om bestanden te downloaden, alsook publishers om bestanden die zij zelf geüpload hebben te downloaden. files upload Deze scope staat publishers toe om bestanden te uploaden. files list Deze scope staat subscribers toe om bestanden weer te geven, alsook publishers voor de bestanden die zij zelf geüpload hebben. Gebruik onderstaande tabel voor het selecteren van de scopes: Tabel filetypes   HR Core Online gebruik makend van de IBU Unattended (Automatisch) IBU: Module Id - Naam File API: Business Type Id - Name Scopes 403 - Ontvangen van Hosted BO4 - Download 101028 - BO4 Bint Export businesstypes list files delete files download files list 407 - Ontvangen van Hosted BO4 RPSA - Download 101028 - BO4 Bint Export businesstypes list files delete files download files list 402 - Zenden naar Hosted BO4 - Upload 101020 - BO4 DPIA100 Import businesstypes list files upload files download files list 406 - Zenden naar Hosted BO4 RPSA - Upload 101020 - BO4 DPIA100 Import businesstypes list files upload files download files list 81 - Management Informatie - Download 118000 - MI BO4 Datafeed businesstypes list files delete files download files list   Het tabblad Integrations kan je niet direct bevestigen via Save, dat kan pas op het moment dat Visma|Raet de gekozen API’s bij de applicatie heeft goedgekeurd, dit gaat via een flow je hoeft hier niks voor te doen.    Je kan door te klikken op stap ‘Visma App store’ naar de laatste stap.         Tabblad Visma App Store, op dit moment stellen wij de Visma App Store niet ter beschikking aan onze klanten.    Voor toegang tot de klantdata genereer je een Invitation Code. Hoe je dit doet staat hieronder verder uitgelegd. Visma | Raet zal de toegang tot de klant-data goedkeuren en dan direct de koppeling van klantdata aan je applicatie gereedmaken.     Na Start setup for Visma App Store ziet u onderstaand scherm en dan kies je bij Access level - Audience voor Invite only   Vul ook de url in waar uw product is uitgelegd.     Je bent nu klaar met het aanmaken van de applicatie, de optie Save wordt zichtbaar op het moment dat Visma | Raet de applicatie heeft goedgekeurd, je kunt het aanmaken sluiten door bijvoorbeeld op Back to my Applications te klikken.  Wanneer Visma | Raet de goedkeuring heeft verleend, ontvang je hier een e-mail van en kun je de volgende stap uitvoeren door de applicatie te koppelen aan klant-data. Dit staat uitgelegd in het volgende hoofdstuk 4 ‘Invitatiecode aanmaken’.   4 - Invitatiecode aanmaken Met een invitatiecode maak je het mogelijk de klantgegevens op te halen via je applicatie. Ga naar de Developer Portal https://oauth.developers.visma.com/service-registry/home  Kies voor My Applications. En klik op het potloodje achter de applicatie (Edit).    Kies voor het tabblad Visma App Store. En vervolgens New Invitation Code.     Bij Invitation description vul je de naam van de betreffende klant in. En klik vervolgens op Generate.       Let op: De Invitation Code heb je nodig in stap 5 om toegang te vragen tot de klant-data.   Visma | Raet zal de toegang tot de klant-data goedkeuren en dan direct de koppeling van klantdata aan je applicatie gereedmaken.   Binnen het beheer van je applicatie en het scherm Integrations is via de tabblad Tenants (default wordt het tabblad Scopes getoond) terug te zien welke klanten (tenants) gekoppeld zijn aan je applicatie. Dit scherm laat ook de bijbehorende TenantID zien. De TenantID is benodigd bij het opvragen van de authenticatie token.   Voorbeeld van een Tenant ID   5 - Dien een ticket in via Mijn Support Dien ticket in via Mijn Support met de invitation code en het verzoek om autorisatie. Selecteer template van IBU naar File API.   6 - Pas systemen aan om gebruik te maken van File API   De versturende systemen dienen aangepast te worden voor verzenden via de file API. Zie link voor meer informatie per systeem.   7 - Implementeer de nieuwe File API oplossing in uw eigen omgeving.  Vraag een IT collega met verstand van schedulen en het opstellen van powershell scripts om het stappenplan te volgen. Je vind de voorbeeld powershell scripts op deze pagina.     ... View more

Zenden en Ontvangen, waarbij IBU wordt gebruikt, en de File API, zijn 2 verschillende Youforce modules. Ze hebben elk hun eigen bestanden. Standaard worden Youforce-bestanden voor jou naar Zenden en Ontvangen gestuurd. Om de bestanden ook beschikbaar te krijgen voor File API moet je sommige Youforce modules die je gebruikt vertellen dat ze de bestanden naar de File API sturen.   Deze pagina beschrijft voor elke module waar een aanpassing voor nodig is, de benodigde stappen om een Youforce-bestand te koppelen aan de File API. Gebruik je straks zowel Bestandsuitwisseling (interactief) als File API (automatische koppeling) voor dezelfde Youforce module dan hoef je de stappen voor die module slechts 1x uit te voeren.   Voor de volgende Youforce-modules zijn aanpassingen nodig:     Payroll Gemal Direct File Type 128001 - Payroll Gemal - Ontvang De File API biedt de mogelijkheid om de bestanden die in een Payroll Gemal-productie zijn afgeroepen, automatisch te downloaden naar je lokale omgeving. Het gaat om het ophalen van data bestanden zoals de journaalposten, flexbestanden, loonstaten in csv; hetgeen in bestandsvorm bij 'zenden en ontvangen' gedownload kan worden.   Onderstaande werkgevercode is voor alle klanten die met losse Gemal output (zie bestandsnamen verderop) werken in 'zenden en ontvangen' en zij kunnen dit onderdeel via de File API laten verlopen zodra deze stap is gedaan.   Hoe Werkgeverscode 30050 is vanaf 2022-10 beschikbaar in Gemal Direct Inrichting om de ontvangen bestanden naar beiden (IBU en File API) of alleen naar de File API te sturen. Deze werkgevercode vind je in Gemal Direct Inrichting via Selecteren werkgever-productie / werkgevergegevens / overzicht en bestanden / algemeen   Werkgeverscode 30050 File-API 0 = Bestanden via 'Zenden&Ontvangen' 1 = Bestanden via 'Zenden&Ontvangen' en via de File API  / Bestandsuitwisseling 2 = Bestanden via File API / Bestandsuitwisseling - (werkt voorlopig nog gelijk aan waarde 1, maar ben je over op Bestandsuitwisseling (File API), leg deze waarde dan vast)         Als de waarde 0 is, worden de bestanden op de oude/huidige manier verzonden. Een waarde van 1 maakt de bestanden ook beschikbaar in de File API. Waarde 2 heeft nu nog hetzelfde effect als 1, maar door dit vast te leggen als je over bent, krijgen we inzicht in de mate waarin klanten deze stap hebben gezet. Op termijn zal waarde 2 conform de beschrijving alleen via File API worden verwerkt. Gewijzigde bestandsnamen LET OP! Daarnaast zijn de bestandsnamen aangepast als je deze via de File API ophaalt. Deze nieuwe namen krijg je via de route File API en Bestandsuitwisseling te zien. Hiermee wordt het meer helder welk bestand je daar ziet staan. In 'Zenden en Ontvangen' blijven de huidige benamingen van toepassing (linker kolom hieronder).       Werkgeverscode 30050 hoeft alleen geregistreerd te worden bij instelling nummer 1. Tenslotte: het downloaden van de Salaristabellen staat los van deze aanpassing en deze kunnen voorlopig alleen nog met IBU uit Zenden en Ontvangen worden opgehaald. We werken aan een oplossing zodat deze bestanden ook via de File API beschikbaar zijn.   HR Core online File Type 101014 - HR Core Online Hosted - Ontvang   De bestanden moeten worden geplaatst in de nieuwe map 'Hosted-Klant-Files'. Vanuit deze map worden de bestanden automatisch gekoppeld aan de File API.  File Type 101017 - HR Core Online Hosted - Zend De ingestuurde bestanden worden op de J-schijf geplaatst in de map J:\Raet\Klant\Hosted net zoals dat het geval was met IBU Zenden File Type 101020 - Imports via de DPIA100  - Zend Omdat het automatiseren van het proces van uploaden, inlezen en verwerken van indirecte mutaties redelijk wat kennis en ervaring vereist wordt geadviseerd om dit proces te laten begeleiden door een consultant van Visma|Raet.   In het kort hieronder de te volgen stappen:   Het is vereist om de procescode die in het DPIA100-bestand wordt gebruikt op te nemen in de bestandsnaam van het in te zenden bestand:  DPIA100_[PROCESSCODE]<DATE&TIME>.txt en de betreffende procescode dient aanwezig te zijn in de HRCoreOnline-inrichting met daarbij de toegestane rubrieken (PS, DV etc.) welke via het DPIA100-bestand worden aangeboden. In onderstaand voorbeeld is gekozen voor de procescode IMP. Let op: de IMP procescode is slechts een voorbeeld en dient te worden vervangen door een voor uw situatie andere unieke procescode die duidelijk maakt wat de bron van de opgevoerde mutaties is.       Met de opties 'Auto import' en 'Auto verwerken' bepaal je de mate van automatisering. Advies om de 'Auto import' in alle gevallen te activeren.      Via onderstaand status-scherm in HRCoreOnline kan je controleren of de IMP-bestanden geimporteerd en verwerkt zijn.     De backup bestanden kan je vinden op de J:\Raet\Intracom\Backup map, zoeken op 'DPIA100_IMP' (bij procescode IMP)     File Type 101028 - BINT-bestanden (alle) - Ontvang De bestanden moeten worden geplaatst in de nieuwe map 'Hosted-klant-exports'. Vanuit deze map worden de bestanden koppeld aan de File API.   Het wijzigen van het betreffende stuurgegeven kan via: Applicatiebeheer - Stuurgegevens - Wijzigen stuurgegevens -Selecteer stuurgegeven "EXP_PAD" en wijzig in het onderste veld van de waarde alleen het laatste deel van het pad waar staat 'Hosted-Klant'. Zet daar '-exports' achter. Het pad eindigt dan dus op 'Hosted-Klant-Exports'.   Individuele BINT-bestanden voor 3e partijen  Voor partners is het mogelijk individuele BINT bestanden te ontvangen. De inrichting daarvan zal altijd door consultancy worden begeleid. De op dit moment beschikbare BINT-bestanden staan hier beschreven: https://vr-api-integration.github.io/file-api-documentation/guides_file_bo4_3rdparties_raet_file_typ...     Betaalmanager  File Type 135000 - Betaalmanager Gemal Downloads File Type 135001 - Betaalmanager Gemal Opdrachten File Type 114000 - Betaalmanager VIPS Disbursements Downloads File Type 114001 - Betaalmanager VIPS Disbursements Opdrachten   Betaalmanager biedt de mogelijkheid automatisch betaal- en downloadbestanden te ontvangen in de klantomgeving met behulp van Bestnadsuitwisseling (File API).  Op het scherm Beheer > Instellingen is het veld Zenden naar gesplitst in drie velden SEPA-betalingen zenden naar, Downloads zenden naar en non-SEPA zenden naar. Om instellingen aan te passen is rechts een knop Aanpassen toegevoegd:   Indien je op de knop Aanpassen klikt, dan wordt een apart scherm Instellingen rekening aanpassen getoond waarin je eventuele rekeninginstellingen kunt wijzigen:   Als je een nieuw IBAN van afschrijving gaat gebruiken, dan blijft de initiële inrichting: SEPA betalingen zenden naar EQUENS-CPS, Download zenden naar Zenden Ontvangen en Non-SEPA betalingen zenden naar Zenden Ontvangen.  Het is niet mogelijk om achteraf nog bestanden te achterhalen. Mocht je gebruik willen maken van de File Api, adviseren wij om de Online Help van de Betaalmanager door te lezen, waarin onder andere het volgende is opgenomen:   Als bij Beheer > Instellingen >  Aanpassen > SEPA betalingen zenden naar gekozen is voor verzenden naar File Api dan maakt de Betaal Manager het SEPA-betaalbestand aan en biedt dit aan aan de File Api. De betaalbestanden worden beschikbaar gesteld in de omgeving die u in de File Api heeft ingericht. De status van een verzonden betaalopdracht ziet u bij de details van de betaalopdracht bij Betaalopdrachten bekijken.     ... View more

Getting started Youforce has several API products available, every API covers a different use cases: The IAM API is intended for identity & access management systems and enables the provisioning of users in other systems like Active Directory or IDP.  The Learning API provides employee data that is relevant for applications in the learning, development, appraisal domain, etc.   The SIVI API is for medical leave management systems in the Netherlands that handles sickness cases according to the Dutch law ‘Wet Poortwachter’ The File API allows you to download or upload files directly from Youforce. In this way we help to achieve ‘purpose binding’ required to safeguard the privacy of employees and to comply with GDPR legislation. It furthermore allows us to tailor and grow the API supporting specific needs in that domain.    So go to the API Library and select the API that is related to your use case. Available data Every API has a fixed dataset, the HRCore-fields that are available in the dataset are documented on the portal, look out for the page ‘datamapping’ to see the details of the dataset of that API and match that with your application. API status The status of an API is displayed using the following labels: General: the API is available in production. Controlled: the API is available, getting API keys takes some time. Deprecated: the API is being phased out. We do not accept any new connections. Concept: the API is currently under development, but you are welcome to take a look. You can find more information here Create an application for testing You are able to create API keys for testing the API. This way you can test the authentication via OAUTH 2.0 and perform most GET-requests. The data that is shown in the response is test-data and not related to any customer. For production the API will work the same only the API keys will be different.   To use a Youforce API, you must register and create an account so you can login. An account is quick to set up and is free of charge. You only need your phone and company address to register. To register and create an account: Click Create an account in the top of the portal Enter your details. (Please register with your company email). You will receive an SMS on your mobile to confirm. The tab ‘Your Apps’ has the option ‘create new app’, you can select the API and the API keys will be published. Support via Visma Developer Community Developers can use the community via Slack to ask questions with Visma developers that design and implement these APIs Visma consultant that help to connect with customer environments Other API consumers Consultancy support You can ask for extra consultancy support by creating a request via 'Service Plein', this is available in the Youforce-platform of the customer you are connecting. It helps us when the request has some details about the topics which require support. We expect that the general information about the API and the relevant documentation via the API library is noted. Getting Production API keys API keys with access to the employee data will be made available after contacting the sales contact person or the Customer Success Manager.   Visma|Raet will share the API keys via the developer portal, so it helps when an account is already available and shared with the Visma|Raet contact person. An e-mail will be sent to the account email address when the API keys are created. We only share API keys with an account that is related to the customer.    After login, you can go to ‘Your Apps’ and see all applications you have access to. Visma|Raet Partner program for software vendors As a software vendor you can become a partner of Visma|Raet, please check the ‘become a partner’ part of the portal. It is not mandatory to become a partner to make use of the API. We would like it because we have an onboarding partner program that will result in a certified connection and we will share the API keys directly with you. You can use the ‘Please contact..’-form to have contact about this partnership. For more information about the API itself you can use the community or ask for extra consultancy support.   If you are not partner, we will share the API keys with an account that is related to the customer and a request is needed for consultancy support. ... View more

Dit document beschrijft de 'Ubeeo ATS - Visma Raet Recruitment API’-connector. Een koppeling gebaseerd op de Visma Raet Recruitment API.   Ubeeo ATS is een geintegreerd werving & selectie portaal die organisaties een complete set aan hulpmiddelen geeft om het werving & selectie traject te automatiseren, meer informatie is via de link beschikbaar: https://ubeeo.nl/   De koppeling zorgt er enerzijds voor dat de medewerkers en organisatorische eenheden vanuit HRCoreOnline worden getoond in Ubeeo en anderzijds wordt een aangenomen sollicitant aangeboden aan Youforce Selfservice.    Vanuit Ubeeo naar Youforce Selfservice Als binnen Ubeeo de keuze wordt gemaakt om een sollicitant te versturen naar Youforce Selfservice dan controleert de koppeling allereerst of de persoon al bekend is in HRCoreOnline vanuit wellicht een eerder afgesloten dienstverband, indien dat het geval is dan wordt het gezien als een nieuw dienstverband (in de printscreen 'new contract'), is de persoon niet bekend dan krijgt de aanmelding het kenmerk 'new hire' (nieuwe persoon). Je kan aan beide routes een bijbehorende Selfservice-workflow koppelen die wordt opgestart.     De Selfservice-workflow neem onderstaande velden over vanuit Ubeeo:   Persoon Verplicht P00301 - Geboortenaam Ja P00302 - Geboortenaam-voorvoegsels   P01003 - Roepnaam Ja P00303 - Voorletters Ja P01002 - Voornamen   P00330 - Geslacht   P00321 - Geboorte datum Ja P01032 - Geboorteplaats   P01041 - Geboorteland   P00305 - Titulatuur voor de naam   P03937 - Titulatuur achter de naam   P00329 - Burgerlijke staat   P00304 - Gebruik achternaam   P00390 - Partner-naam   P00391 - Partner-voorvoegsels   P00320 - BSN/Sofi-nummer   P01034 - E-mail adres prive Ja Huisadres   P01014 Straat   P01016 Huisnummer   P01018 Huisnummer toevoeging   P01020 Postcode   P01022 Woonplaats   P01024 Woonland   Dienstverband   P00322 - Datum in dienst Ja P01106 - Hierarchische org. eenheid Ja P01102 - Soort arbeidsrelatie Ja P01107 - Primaire functie Ja P01103 - CEA nummer Ja, of het CEA-nummer moet vanuit Ubeeo worden verstuurd of het veld moet op het eerste Selfservice-formulier staan met een default-waarde.  P01104 - Instellingennummer Ja, of het Instellingennummer moet vanuit Ubeeo worden verstuurd of het veld moet op het eerste Selfservice-formulier staan met een default-waarde.  Klant-spectieke rubrieken (E-rubrieken)   Documenten Keuze kan gemaakt worden uit de volgende documenten: Aanbiedingsbrief, Formulier, CV, Motivatiebrief, Kopie bankpas, VOG of WGB, Eigen verklaring, BIG-registratie, E- Assessment, ID bewijs, Diploma's, SKJ-registratiepas, Loonheffing formulier en Aanvullend formulier     Vanuit HRCoreOnline naar Ubeeo Onderstaande HRCoreOnline-velden gebruikt Ubeeo ATS in haar connector. Verplicht wil zeggen dat het veld een waarde moet hebben, zonder waarde zal Ubeeo ATS de medewerker niet verwerken.    HRCoreOnline-veld Verplicht voor Ubeeo Benaming in de API Opmerkingen P01001 - Persoonsnummer Ja Persons - personCode   P00303 - Voorletters   Persons - initials   P01002 - Voornamen   Persons - firstNames   P01003 - Roepnaam Ja Persons - knownAs   P01008 - Samengestelde naam Ja Persons - lastName Samengestelde achternaam (op basis van gekozen naam-samenstelling) P01009 - Samengestelde naam voorvoegsel   Persons - lastNamePrefix   P00330 - Geslacht   Persons - gender   P01035 - E-mail adres werk Ja emailAddresses - Business   P01037 - Telefoonnummer werk   phoneNumbers - Business   P01036 - Telefoonnummer mobiel   phoneNumbers - Mobile   P01101 - Volgnummer dienstverband   employments - employmentCode   P00322 - Datum in dienst   employments - hireDate   P00830 - Datum uit dienst   employments - dischargeDate   P01106 - Hierarchische org. eenheid Ja employments - organizationUnit           P01061- organisatorische eenheid Ja OrganizationUnits - id Technische sleutel vanuit HRCoreOnline   Ja OrganizationUnits - shortname De code van de OE   Ja OrganizationUnits - fullname Omschrijving van de OE     OrganizationUnits -parentOrgUnit de 'bovenliggende' OE zodat de structuur kan worden opgebouwd.         OE/ P01062 - Rol code   RoleAssignment - shortname Code van de rol (bijvoorbeeld 'MGR') OE/ Persoonscode van de vastgelegde rol   RoleAssignment - personCode Persoonsnummer van de vastgelegde rol (bijvoorbeeld 'MGR') OE/ P01063 - Ingangsdatum roltoewijzing   RoleAssignment - startDate Ingangsdatum van de vastgelegde rol OE/ P01064 - Einddatum roltoewijzing   RoleAssignment - endDate Einddatum van de vastgelegde rol         Functies/ Functiegroep   JobProfiles - jobFamily De bij de functie vastgelegde 'functiegroep'     Iedere nacht om 02:00 CET doet Ubeeo ATS een volledige synchronisatie op de velden die hierboven zijn beschreven.  De connector verwerkt geen historische of toekomstige data dus enkele de actuele stand.  Nieuwe medewerkers die zijn opgevoerd in HRCoreOnline worden na een synchronisatie zichtbaar in Ubeeo ATS. Als bij een bestaande medewerker een waarde in HRCoreOnline is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in Ubeeo ATS vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in Ubeeo ATS. De data is primair bedoeld om de medewerkers als gebruikers aan te maken in de Ubeeo ATS-applicatie en voor het vacature- en sollicitanten-proces.  Medewerkers met een uitdienstdatum die langer teruggaat dan 14 dagen worden niet meer gesynchroniseerd.   Rollen Ondanks dat de Ubeeo ATS connector de data synchroniseert die zijn vastgelegd voor de rollen binnen de organisatorische eenheden is dit een klantspecifieke configuratie in de Ubeeo ATS applicatie.   Filtermogelijkheden Vanuit HRCore Online kunnen medewerkers uitgesloten worden op basis diverse standaard-velden, hier vind je meer informatie over de mogelijkheden.    Bij de implementatie wordt de filter door de Visma Raet Consultant met de klant afgestemd, wijzigingen van het filter na de implemetatie graag melden via een Servicedesk-ticket.   ... View more

Dit document beschrijft de 'HelloID - Visma Raet IAM API’-connector. Een koppeling gebaseerd op de Visma Raet IAM API.   Onderstaande velden gebruikt HelloID standaard in haar connector. Per implementatie kan hiervan worden afgeweken, vereiste is dat de velden beschikbaar zijn via de IAM API, zie voor de beschikbare velden in de IAM API deze link:   https://community.visma.com/t5/Kennisbank-Youforce-API/IAM-Domain-model-amp-field-mapping/ta-p/428102   De voor HelloID verplichte velden staan dikgedrukt. De dikgedrukte velden zijn benodigd voor een goede werking van de koppeling. De daadwerkelijk gebruikte en benodigde velden kunnen per implementatie verschillen.   API endpoint API attribute HR CoreOnline veldnaam Omschrijving Employees personCode P01001 - Persoonsnummer Persoonsnummer Employees personId P01001 - Persoonsnummer Persoonsnummer Employees id P01001 - Persoonsnummer Persoonsnummer Employees dateOfBirth P00321 - Geboorte datum Geboortedatum Employees emailAddresses P01035 - E-mail adres werk Zakelijk e-mailadres van de medewerker Employees firstNames P01002 - Voornamen Voornamen Employees gender P00330  - Geslacht Geslacht Employees initials P00303 - Voorletters Initialen Employees knownAs P01003 - Roepnaam Roepnaam Employees lastName P01008 - Samengestelde naam Samengestelde achternaam Employees lastNameAtBirth P00301 - Geboortenaam Geboorte-achternaam Employees lastNameAtBirthPrefix P00302 - Geboortenaam voorvoegsels Geboorte-achternaam-tussenvoegsel Employees lastNamePrefix P01009 - Samengestelde naam voorvoegsel Samengestelde achternaam-tussenvoegsel Employees nameAssembleOrder P00304 - Gebruik achternaam Eigennaamcode Employees partnerName P00390 - Partner naam Achternaam partner Employees partnerNamePrefix P00391 - Voorvoegsel partner Tussenvoegsel achternaam partner Employees phoneNumbers Business P01037  - Telefoonnummer werk Zakelijk telefoonnummer Employees phoneNumbers Mobile P01036 - Telefoonnumber mobiel Mobiel telefoonnummer Employees validFrom Ingangsdatum van de versie Ingangsdatum van de actuele 'versie' Employees validUntil Einddatum van de versie Einddatum van de actuele 'versie'         Employment employmentCode P01101  - Volgnummer dienstverband Volgnummer dienstverband Employment hireDate P00322 - Datum in dienst Datum indienst Employment dischargeDate P00830  - Datum uit dienst Datum uitdienst Employment originalHireDate P00834 - Datum in dienst CAO Datum indienst bij de betreffende organisatie Employment employmentType P01102 - Soort arbeidsrelatie Soort arbeidsrelatie Employment jobProfile P01107 - Primaire functie Functie vanuit het dienstverband Employment organizationUnit P01106 - Hiërarchisch organisatorische eenheid Organisatorische eenheid vanuit het dienstverband Employment workingAmount P01109 - Uren per week Contracturen per week vanuit het dienstverband         Assignments id Id van de inzetregel Unieke id van de inzetregel Assignments startDate P01125 - Ingang inzet Startdatum van de inzet-regel -Assignments endDate P01126 - Einde inzet Einddatum van de inzet-regel Assignments jobProfile P0122 - Operationele functie Functie vanuit de inzet-regel Assignments organizationUnit P1121 - Operationele organisatorische eenheid Organisatorische eenheid vanuit de inzet-regel Assignments workingAmount P01109 - Uren per week Contracturen per week vanuit de inzet-regel         Role Assignments id P01062 - roleId Technische code van de roltoewijzing (de rol vastgelegd bij de OE) Role Assignments shortName P01062 - Rol code Code van de rol (bijvoorbeeld 'MGR') Role Assignments startDate P01063 - Ingangsdatum roltoewijzing Ingangsdatum van de vastgelegde rol Role Assignments endDate P01064 - Einddatum roltoewijzing Einddatum van de vastgelegde rol Role Assignments organizationUnit P1121 - Operationele organisatorische eenheid Bijbehorende OE van de vastgelegde rol Role Assignments personCode P01001 - Persoonsnummer Persoonsnummer van de vastgelegde rol         Organization Units fullName Naam organisatorische eenheid Tabel met de organisatorische eenheiden, de naam Organization Units id P01061 - Code organisatorische eenheid Code van de OE Organization Units shortName P01061 - Code organisatorische eenheid Code van de OE Organization Units parentOrgUnit Organisatie eenheid > Onderdeel van Code van de 'bovenliggende' OE         Job Profiles fullName func_oms - Functie omschrijving Tabel met de functies, de omschrijving Job Profiles shortName func_code - Functie code De code van de functie   De tabel met velden is gebasseerd op de standaard-koppeling van Tools4Ever, informeer bij Tools4ever of zij afwijkingen hierop hebben doorgevoerd binnen uw configuratie.   Connector details Iedere dag doet HelloID een volledige synchronisatie op de bovenstaande velden dus voor alle medewerkers.   Nieuwe medewerkers die zijn opgevoerd in HRCoreOnline worden na een synchronisatie zichtbaar in HelloID. Als bij een bestaande medewerker een waarde in HRCoreOnline is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in HelloID vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in HelloID.   Als bij een bestaande medewerker een waarde in HRCore Online is gewijzigd zoals de functie dan wordt deze nieuwe functie doorgegeven aan HelloID. Afhankelijk van de ingestelde 'businessrules' kan dit er voor zorgen dat accounts of autorisaties in de gekoppelde systemen gemuteerd worden op basis van de ingerichte processen binnen HelloID.   Medewerkers met een uitdienstdatum die langer teruggaat dan 90 dagen worden niet meer gesynchroniseerd.   Filtermogelijkheden Binnen de IAM API zijn er geen filtermogelijkheden. Echter binnen HelloID kunnen filters ingesteld worden waarmee bijvoorbeeld bepaald kan worden wie een account krijgt en wie niet.  ... View more

Dit document beschrijft de ‘ProActive - Visma Raet IAM API’-connector. Een koppeling gebaseerd op de Visma Raet IAM API.   Onderstaande velden gebruikt ProActive in haar connector en worden gebruikt als standaard-inrichting. attribute HR Core Online Opmerking personCode P01001 - Persoonsnummer   Initials P00303 - Voorletters   KnowAs P01003 - Roepnaam   lastName P01008 - Samengestelde naam   lastNamePrefix P01009 - Samengestelde naam-voorvoegsels   emailAddresses Business: P01035 - E-mail adres werk In ProActive kan via een mapping bepaald worden welk e-mailadres getoond wordt.   emailAddresses Prive: P01034 - E-mail adres prive In ProActive kan via een mapping bepaald worden welk e-mailadres getoond wordt. phoneNumber Home: P01027 - Telefoonnr woonadres In ProActive kan via een mapping bepaald worden welk telefoonnummer getoond wordt. phoneNumber Mobile: P01036 - Telefoonnr mobiel In ProActive kan via een mapping bepaald worden welk telefoonnummer getoond wordt. phoneNumber Business: P01037 - Telefoonnr werk In ProActive kan via een mapping bepaald worden welk telefoonnummer getoond wordt. jobProfile P01107 - Primaire functie Mogelijkheid om dit te koppelen aan de 'functieprofiel' in ProActive, bespreek dit met ProActive. organizationUnit P01106 - Hierarchische org. eenheid Mogelijkheid om dit te koppelen aan de 'organisatorische eenheid' in ProActive, bespreek dit met ProActive.   Waarvan deze velden voor ProActive verplicht zijn: attribute HR Core Online Opmerking personCode P01001 - Persoonsnummer   emailAddresses Business: P01035 - E-mail adres werk 1 geldig e-mailadres moet in de mapping zijn opgenomen en van dat veld moet de waarde bij de medewerker gevuld zijn. emailAddresses Prive: P01034 - E-mail adres prive 1 geldig e-mailadres moet in de mapping zijn opgenomen en van dat veld moet de waarde bij de medewerker gevuld zijn.   Wanneer bij een medewerker de waarde op 1 van bovenstaande velden ontbreekt zal ProActive de gehele medewerker niet verwerken. Advies om binnen Youforce deze velden ook verplicht te stellen bij het aanmaken van een nieuwe medewerker.   Nieuwe medewerkers die zijn opgevoerd in HRCoreOnline worden na een synchronisatie zichtbaar in ProActive. Als bij een bestaande medewerker een waarde in HRCoreOnline is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in ProActive vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in ProActive.   Medewerkers waarbij de uitdienstdatum is gepasseerd worden niet meer gesynchroniseerd en ProActive zet deze medewerkers in haar applicatie op inactief.   ProActive synchroniseert 1 keer per dag de gegevens, zij doen dat iedere keer voor alle medewerkers. Het tijdstip van de dagelijkse synchronisatie is door de klant zelf te bepalen binnen de ProActive-applicatie.   Filtermogelijkheden Er zijn geen filtermogelijkheden, ProActive synchroniseert alle medewerkers uit HRCoreOnline. ... View more

Dit document beschrijft de ‘PlusPort - Visma Raet Learning API’-connector. Een koppeling gebaseerd op de Visma Raet Learning API.   Plusport kent een koppeling waarbij meerdere (actuele) diensteverbanden wel worden ondersteund en een variant waar met 1 dienstverband per persoon wordt verwerkt.  Onderstaande velden gebruikt Plusport in haar connector bij de variant met 1 dienstverband per persoon:   attribute HR Core Online (BO4)   personCode P01001 - Persoonsnummer   Initials P00303 - Voorletters   KnowAs P01003 - Roepnaam   lastName P01008 - Samengestelde naam   lastNamePrefix P01009 - Samengestelde naam-voorvoegsels   gender P00330 - Geslacht   birthDate P00321 - Geboortedatum   UserUID Ping ID Youforceportal   emailAddresses Business: P01035 - E-mail adres werk   emailAddresses Prive: P01034 - E-mail adres prive   street P01014 straatnaam   houseNumber P01016 Huisnummer   houseNumberAdditional P01018 Huisnummer toev   postalCode P01020 Postcode   city P01022 Plaatsnaam   Telephone number Business :P01037 - Telefoonnr werk   Mobile Mobile : P01036 - Telefoonnr mobiel   hireDate P00322 - Datum in dienst Eerste dienstverband dischargeDate P00830 - Datum uit dienst Langslopende dienstverband jobProfile P01107 - Primaire functie Dienstverband met het meesta aantal contracturen costCenter In ontwikkeling Dienstverband met het meest aantal contracturen organizationUnit P01106 - Hierarchische org. eenheid Dienstverband met het meest aantal contracturen parentOrgUnit De 'bovenliggende' OE zodat de structuur kan worden opgebouwd. Dienstverband met het meest aantal contracturen Rolecode P01062 - Rol code (LMGR en MGR worden gebruikt) Dienstverband met het meest aantal contracturen managerId Persoonsnummer van de vastgelegde LMGR-rol, indien LMGR niet is vastgelegd dan wordt MGR gebruikt. Dienstverband met het meest aantal contracturen BIG  P09165 - Big nummer     Wanneer in de Plusport-software “meerdere dienstverbanden” is geactiveerd zal er per gebruiker een dienstverbandentab beschikbaar worden gesteld. Onder deze tab worden de actuele dienstverbanden per gebruiker getoond met onderstaande velden.   HR Core Online (BO4) P01001 - Persoonsnummer  P00322 - Datum in dienst P00830 - Datum uit dienst P01107 - Primaire functie P01109 - Uren per week P01134 - Costcenter  In ontwikkeling P01106 - Hierarchische org. eenheid Persoonsnummer van de vastgelegde LMGR-rol, indien LMGR niet is vastgelegd dan wordt MGR gebruikt.   Verplichte velden Onderstaande velden zijn onderdeel van de mapping. Wanneer er waarden in één van deze velden bij een medewerker ontbreekt zal Plusport de gehele medewerker niet verwerken. Het advies hierbij is om binnen Youforce deze velden ook verplicht te stellen bij het aanmaken van een nieuwe medewerker. Let op, om foutmeldingen te voorkomen is het essentieël om dit te controleren!   HR Core Online P01001 - Persoonsnummer P01003 - Roepnaam P01008 - Samengestelde naam Ping ID Youforce Business: P01035 - E-mail adres werk P01106 - Hierarchische org. eenheid P01107 - Primaire functie Persoonsnummer van de vastgelegde LMGR-rol, indien LMGR niet is vastgelegd dan wordt MGR gebruikt.   Plusport synchroniseert 1 keer per dag de gegevens, zij doen dat iedere keer voor alle medewerkers.  Iedere ochtend kan Plusport een e-mail versturen met de foutmeldingen die de dag daarvoor zijn opgetreden. Als er een fout is opgetreden, kan de klant via de mail op een reset knop klikken om een nieuwe poging te proberen. Na 5 pogingen doet Plusport geen nieuwe poging meer om de gebruiker te verwerken.    Nieuwe medewerkers die zijn opgevoerd in HRCore worden na een synchronisatie zichtbaar in Plusport. Als bij een bestaande medewerker een waarde in HRCore is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in Plusport vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in Plusport.   Plusport verwerkt 1 manager per organisatorische eenheid, de eerste die zij tegenkomen in de data. Door bij meerdere managers op een organisatorische eenheid de gewenste manager vast te leggen met de LMGR-rol kan je de gewenste aansturing in Plusport bepalen.   Medewerkers met een uitdienstdatum worden tot 90 dagen na hun uitdienstdatum nog gesynchroniseerd.   Documenten naar het Youforce Personeelsdossier De koppeling zal gegenereerde PDF bestanden uit Plusport automatisch aanmaken op persoonsniveau in het personeelsdossier. De koppeling heeft twee opties:   Bewijsstukken: levert alle bewijsstukken waarvoor een PDF is aangemaakt in Plusport aan via standaard documentsoort “certificaat”. De consultant kan deze koppeling voor u activeren tijdens de implementatie en na livegang is het mogelijk om deze via het serviceplein aan te vragen. U bent zelf verantwoordelijk voor de inrichting in het personeelsdossier, zorg ervoor dat het rubriek beschikbaar is voor de juiste populatiegroep(en) en dat het bewaartermijn correct is ingericht. Beoordelingsformulieren: gebruikt de standaard documentsoort  “beoordelingsgesprek". De consultant kan deze koppeling voor u activeren tijdens de implementatie en na livegang is het mogelijk om deze via het serviceplein aan te vragen.   Filtermogelijkheden Vanuit HRCore Online kunnen medewerkers uitgesloten worden op basis diverse standaard-velden, hier vind je meer informatie over de mogelijkheden.    Bij de implementatie wordt de filter door de Visma Raet Consultant met de klant afgestemd, wijzigingen van het filter na de implemetatie graag melden via een Servicedesk-ticket. ... View more

This document described the ‘mijnLMS - Visma Raet Learning API’-connector. This connector has been built on top of the Visma Raet Learning API.   mijnLMS is a integrated learning-portal which provides organisations with the tools to manage and automate their own training processes and provide central access to their own learning tools and those of 3th parties. You can read more about the partnership between Visma | Raet and Online Academie for the intergration between the Visma | Raet Youforce platform and mijnLMS on https://www.vismaraet.nl/over-ons/nieuws/samenwerkingsverband-online-academie/   The following fields are used by the mijnLMS connector, required fields are highlighted in bold. Fields described as Uniqe are unique within their entity and tenant. Field connector API Endpoint API attribute HRCore Online Functional description ID Employees personId P01001 - Persoonsnummer Unique identifier of the employee first_name Employees knownAs P01003 - Roepnaam The employees nickname last_name Employees lastName P01008 - Samengestelde naam The persons last name (based on selected name preference) valid_until Employees validUntil Niet beschikbaar Start date of the version of the employee N/A Employees validFrom Niet beschikbaar End date of the version of the employee user_email Employees emailAddresses type:"Business" address P01035 - E-mail adres werk List the business email address of the employee organisationId Employees employments company Niet beschikbaar The functional company code of the employees contract (employment) date_hire Employees employments hireDate P00322 - Datum in dienst The start date of the employees contract (employment) date_out Employees employments dischargeDate P00830 - Datum uit dienst The end date of the employees contract (employment) function_id Employees jobProfile P01107 - Primaire functie The functional job profile code of the employees contract (employment) lms_organisation_id Employees employments organizationUnit P01106 - Hierarchische org. eenheid The functional organizational unit code of the employees contract (employment) id Companies id Niet beschikbaar Unique identifier of the company organisationId Companies code Niet beschikbaar Functional code of the company org_name Companies fullName Niet beschikbaar Functional name of the company N/A Companies validUntil Niet beschikbaar Start date of that version of the company N/A Companies validFrom Niet beschikbaar End date of that version of the company id JobProfiles id Niet beschikbaar Unique identifier of the job profile function_id JobProfiles shortName func_kd - Functie code Functional code of the job profile function_name JobProfiles fullName func_oms - Functie omschrijving Functional name of the job profile N/A JobProfiles validUntil Niet beschikbaar Start date of that version of the job profile N/A JobProfiles validFrom Niet beschikbaar End date of that version of the job profile lms_organisation_id OrganizationUnits id Niet beschikbaar Unique identifier of the organizational unit lms_organisation_name OrganizationUnits fullName P01061 - Code organisatorische eenheid Functional code of the organizational unit N/A OrganizationUnits organizationUnitType Type organisatorische eenheid Functional name of the organizational unit lms_parent_id OrganizationUnits parentOrgUnit Technische sleutel van bovenliggende OE Unique identifier of the parent organizational unit id_manager OrganizationUnits manager Niet beschikbaar Unique identifier of the manager of the organizational unit* *Only for HR Core Business. For HR Core Online the manager is part of the role assignment   Connector details Each day mijnLMS does a full-load on the described endpoints and detects changes on their side including future changes. Every employee needs to comply with the required fields (highlighted in bold) when this is not met the employee will be ignored and not processed. To ensure proper working of the connector the required fields need to be properly configured in the Youforce customer setup. Employees which have been discharged will be ignored and no longer processed by mijnLMS.   Filter applications HR Core Online enables filtering on the field ‘Employment type’ (P01102). By default, no filter is applied and any required filters need to be requested through a service desk ticket. ... View more

This document describes the ‘De leerrekening (EduBookers) - Visma Raet Learning API’ - connector. This connector has been built on top of the Visma Raet Learning API.   The following fields are used by the De leerrekening (EduBookers) connector, required fields are highlighted in bold. Fields described as Unique are unique within their entity and tenant. API endpoint API attribute HR Core Online fieldname Functional description Employees dateOfBirth P00321 - Geboorte datum Birth date of employee Employees emailAddresses P01035 - E-mail adres werk Business email address of employee Employees emailAddresses P01034 - E-mail adres prive Private email address of employee Employees firstNames P01002 - Voornamen First names of employee Employees gender P00330  - Geslacht Gender of the employee Employees id P01001 - Persoonsnummer Technical key of employee Employees originalHireDate P00834 -Datum in dienst CAO Orginal hire date employee within company Employees initials P00303 - Voorletters Initials of the employee (with dots) Employees knownAs P01003 - Roepnaam Calling name of the employee Employees lastName P01008 - Samengestelde naam Formatted name of the employee Employees personCode P01001 - Persoonsnummer Unique person identifier of employee Employees phoneNumbers P01027 - telefoonnr woonadres mobile phone number employee Employment dischargeDate P00830  - Datum uit dienst The day after last working date Employment jobProfile P01107 - Primaire functie Assigned jobprofile (code+description) Employment organizationUnit P01106 - Hiërarchisch organisatorische eenheid Assigned organizational unit Employment workingAmount P01109 - Uren per week Contractual amount in hours/days Organization Units fullName N/A Full description of organizational unit Organization Units id P01061 - Code organisatorische eenheid Technical key orgizational unit Organization Units parentOrgUnit N/A Technical key parent orgizational unit Organization Units shortName P01061 - Code organisatorische eenheid Functional key organizational unit Organization Units organizationUnitType orgUnit Type Type of roganizational unit valuelist Organization Units managerId N/A Assigned manager of the organizational unit Job Profiles shortName functie code Full description of job profile Job Profiles fullName functie naam Short description of job profile Job Profiles jobFamily functie groep Group of job profile   Connector details Each day De leerrekening (EduBookers) does a full-load on the described endpoints and detects changes on their side including past changes. Every employee needs to comply with the required fields (highlighted in bold) when this is not met the employee will be ignored and not processed. To ensure proper working of the connector the required fields need to be properly configured in the Youforce customer setup. Employees which have been discharged will be ignored and no longer processed by De leerrekening (EduBookers)   Filter applications HR Core Online enables filtering on the field ‘Employment type’ (P01102). By default, no filter is applied and any required filters need to be requested through a service desk ticket . ... View more

Dit document beschrijft de ‘Dialog - Visma Raet Learning API’-connector. Een koppeling gebaseerd op de Visma Raet Learning API.   Onderstaande velden gebruikt Dialog in haar connector:   HRCore Online-veld Verplicht in Dialog API Endpoint API attribute Opmerkingen P01001 - Persoonsnummer verplicht Persons personCode   P01035 - E-mail adres werk verplicht Persons emailAddresses (business)   P01003 - Roepnaam / P01002 - Voornamen verplicht Persons knownAs / firstNames Indien het veld Roepnaam leeg is wordt het veld Voornamen gebruikt P01008 - Samengestelde naam verplicht Persons lastName Dit is een samengestelde achternaam P00322 - Datum in dienst   Employments hireDate   P00830 - Datum uit dienst   Employments dischargeDate De datum uitidenst wordt niet getoond in Dialog. Wordt gebruikt om actieve gebruikers te filteren en te de-activeren. P00834 -Datum in dienst CAO   Employments originalHireDate   P01107 - Primaire functie   Employments jobProfile Wordt gebruikt om gebruiker te koppelen aan juiste functie. P01106 - Hierarchische org. eenheid (OE)   Employments organizationUnit Wordt gebruikt om gebruiker te koppelen aan het juiste team. Bij meerdere dienstverbanden wordt de medewerker bij alle OE's getoond. OE/ P01062 - Rol   RoleAssignments PersonID van de MGR (Manager) De bij de OE vastgelegde medewerker met de MGR-rol wordt als leidinggevende in Dialog getoond. OE/ De 'bovenliggende' OE   Organization units parentOrgUnit Aan de hand van de vastgelegde 'bovenliggende' OE wordt de organisatiestructuur in Dialog bepaald. OE/ Geblokkeerd    Organization units isBlocked 'Geblokkeerde' OE's worden niet in Dialog getoond. Functies/ Functiegroep   Job profiles jobFamily De bij de functie vastgelegde 'functiegroep' is te gebruiken in Dialog. Personeelsdossier-documentsoort 'functionerinGesprek'   File upload   Dit onderdeel wordt gebruikt om de evaluatie uit Dialog in PDF-formaat te upload'en naar het Youforce-Personeelsdossier, het document wordt als documentsoort 'functionerinGesprek' in het Personeelsdossier opgegeslagen.   Dialog haalt nachtelijk medewerkers, teams (organization units) en functies (job profiles) op en toont deze informatie in drie aparte tabellen op de 'Koppelingen-pagina' in Dialog.    Wat betreft teams en functies kunnen klanten hier per team/functie kiezen om deze: 1. Aan te maken in Dialog  2. Te koppelen aan een bestaande Dialog team/functie  3. Te negeren.   Zodra een team/functie is ingeladen/gekoppeld in Dialog zal er een verwijzing worden gelegd tussen de opgehaalde HRCore-team/functie en de Dialog-team/functie. Dit zorgt er vervolgens weer voor dat opgehaalde HRCore-medewerkers worden gekoppeld aan een Dialog team/functie.   Bij iedere nachtelijk synchronisatie wordt bij reeds gekoppelde medewerkers gekeken of er nog wijzigingen zijn aan functie/team om deze indien nodig door te voeren in Dialog.   De velden met het kenmerk verplicht moeten gevuld zijn met een waarde, wanneer bij een medewerker de waarde op 1 van bovenstaande verplichte velden ontbreekt zal Dialog de gehele medewerker niet verwerken. Advies om binnen Youforce deze velden ook verplicht te stellen bij het aanmaken van een nieuwe medewerker.    Nieuwe medewerkers die zijn opgevoerd in HRCore worden na een synchronisatie zichtbaar in Dialog. Als bij een bestaande medewerker een waarde in HRCore is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in Dialog vanaf het moment dat de wijziging is ingegaan. Oftewel een medewerker krijgt per de 1e van de volgende maand een nieuwe functie dan is de nieuwe functie vanaf de 1e van de volgende maand zichtbaar in Dialog.   Medewerkers met een uitdienstdatum worden tot 31 dagen na hun uitdienstdatum nog gesynchroniseerd. Iedere nacht synchroniseert de connector de data. Een synchorisatie haalt alle medewerkers, afdelingen en functies op. Het uploaden van het PDF-bestand gebeurt event based als een evaluatie in Dialog wordt afgerond.    Filtermogelijkheden Vanuit HRCore Online kunnen medewerkers uitgesloten worden op basis diverse standaard-velden, hier vind je meer informatie over de mogelijkheden.    Bij de implementatie wordt de filter door de Visma Raet Consultant met de klant afgestemd, wijzigingen van het filter na de implemetatie graag melden via een Servicedesk-ticket. ... View more