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

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

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

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 ‘AppicalNow - Visma|Raet Learning API’-connector. Een koppeling gebaseerd op de Visma Raet Learning API.   Onderstaande velden gebruikt Appical in haar connector: Verplicht in Appical API Endpoint API attribute HRCore Online   Employees personId P01001 - Persoonsnummer Verplicht Employees personCode P01001 - Persoonsnummer   Employees firstNames P01002 - Voornamen   Employees lastName P01008 - Samengestelde naam   Employees lastNamePrefix P01009 - Samengestelde naam-voorvoegsels   Employees knownAs P01003 - Roepnaam     emailAddresses Business: P01035 - E-mail adres werk Prive: P01034 - E-mail adres prive   Employees dischargeDate P00830 - Datum uit dienst   Employees originalHireDate P00834 -Datum in dienst CAO   Employees employmentType P01102 - Soort arbeidsrelatie   Employees jobProfile P01107 - Primaire functie   Employees organizationUnit P01106 - Hierarchische org. eenheid   Organization units id Technical id van de org. eenheid   Organization units shortname ShorName van de org. eenheid   Organization units fullName FullName van de org. eenheid   Organization units parentOrgUnit technical id of the parent Org unit   Organization units organizationUnitType orgUnit Type   Role Assignments organizationUnitCode Technical id van de org. eenheid   Role Assignments shortname (rol 'MGR') P01062 - Rol   Role Assignments personCode (van de medewerker met de rol 'MGR') Persoonsnummer (van de 'MGR')   Role Assignments startDate Begindatum van de versie   Role Assignments endDate Einddatum van de versie    Job profiles shortName Functie code   Job profiles fullName functie naam   Job profiles jobFamily functie groep   Appical synchroniseert eenmaal per dag tussen 6:00 (AM) en 9:00 (AM) de data en dat doen zij voor alle medewerkers.   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 Appical 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 Appical. Als bij een bestaande medewerker een waarde in HRCore is gewijzigd zoals de functie dan is de nieuwe functie zichtbaar in Appical 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 Appical. Medewerkers met een uitdienstdatum worden tot 30 dagen na hun uitdienstdatum nog gesynchroniseerd.    Filtermogelijkheden Vanuit HRCore Online kunnen medewerkers uitgesloten worden op basis van het veld ‘Soort Arbeidsrelatie’ (P01102). Standaard worden er geen fillters ingesteld dus alle medewerkers zijn beschikbaar voor Appical, verzoek om een gewenst filter tijdens de implementatie aan te melden via een Servicedesk-ticket. ... View more