Door middel van een koppeling met AFAS HR is het mogelijk om organisatie, locaties, medewerkersgegevens (en meer) uit te wisselen met RegiCare. Door AFAS te koppelen worden deze gegevens vanuit AFAS ingelezen in RegiCare, AFAS blijft leidend. Voor deze koppeling is een zogenoemde GetConnector binnen AFAS nodig. Het onderhouden van toegang* en het dubbel bijhouden van medewerkers gegevens is hiermee verleden tijd. In dit artikel van AFAS is opgenomen hoe een getConnector binnen AFAS aangemaakt kan worden. Voor meer informatie over het aanmaken van de connectoren in AFAS kunt u bij uw AFAS partner terecht.
*voor automatische gebruikers toegang tot RegiCare moet er naast de AFAS ook Single Sign On geconfigureerd worden.
INHOUDSOPGAVE
1. Configureren
Om AFAS te koppelen met RegiCare moet er binnen de AFAS omgeving een getConnector aangemaakt worden. In dit artikel van AFAS is te lezen op wat voor manier een getConnector toegevoegd kan worden.
Om de gewenste gegevens uit te wisselen met RegiCare is het belangrijk dat er twee connectoren worden aangemaakt,
één connector voor personen, één connector voor contracten (zie onderstaande afbeelding 1.0). Afhankelijk van de opzet zijn er extra get- en updateConnectoren nodig. Deze worden in een later stadium aan dit artikel toegevoegd.
Afbeelding 1.0, binnen de app connector RegiCare bestaan er twee GetConnectoren.
Binnen deze connectoren is het belangrijk dat de connectoren ingesteld zijn op historische gegevens en niet op actuele gegevens.
1.1 de getConnector voor medewerkers instellen
Binnen de connector voor medewerkers zijn een aantal velden verplicht (oranje in onderstaande tabel), een aantal zijn optioneel. Wanneer de wens bestaat om meer dan de verplichte velden uit te wisselen dan moet dit afgestemd worden met uw RegiCare consultant.
Welke velden u overgezet wilt hebben naar RegiCare kunt u opnemen in de bijlage MS Excel AFAS Connector V2.xsls te vinden onderin dit artikel. Na het invullen van deze MS Excelsheet kan het ingevulde formulier worden verstuurd naar projecten@adsysco.nl .
| AFAS (Medewerkers) | Formaat | RegiCare | Verplicht = x / Gewenst = xx | Opmerking | |
| EmployeeId | STRING | syncfield_employee_synckey | x | ||
| PersonId | STRING | syncfield_person_synckey | x | ||
| EmployerId | STRING | syncfield_organization_synckey | x | ||
| Naam_werkgever | STRING | syncfield_organization_name | x | ||
| Naam | STRING | syncfield_person_displayname | x | ||
| BirthName | STRING | syncfield_person_birthname | x | ||
| Initials | STRING | syncfield_person_initials | x | ||
| PrefixBirthName | STRING | syncfield_person_birthnameprefix | x | ||
| DateOfBirth | DATE | syncfield_person_datofbirth | x | ||
| Gender | STRING | syncfield_person_gender | x | Code | |
| MaritalStatus | STRING | syncfield_afas_maritalstatus | Code | ||
| PrefixPartner | STRING | syncfield_person_partnernameprefix | |||
| BirthNamePartner | STRING | syncfield_person_partnername | |||
| NameUse | STRING | syncfield_afas_nameuse | Code | ||
| Mobile | STRING | syncfield_person_privatemobile | |||
| Phone | STRING | syncfield_person_privatephone | |||
| E-mail_prive | STRING | syncfield_person_privateemail | |||
| Street | STRING | syncfield_person_address_street | |||
| HouseNumber | LONG | syncfield_person_address_number | |||
| AddNumber | STRING | syncfield_person_address_suffix | |||
| ZIPCode | STRING | syncfield_person_address_zipcode | |||
| City | STRING | syncfield_person_address_city | |||
| Country | STRING | syncfield_person_address_country | Code | ||
| In_dienst__i.v.m._dienstjaren_ | DATE | syncfield_employee_yearsofservice | |||
| EmploymentStart | DATE | syncfield_employee_since | x | Datum in dienst | |
| EmploymentEnd | DATE | syncfield_employee_till | x | Datum uit dienst | |
| HourPerWeek | DECIMAL | syncfield_employee_hoursperweek | |||
| EmploymentType | STRING | syncfield_afas_employmenttype | Code dienstbetrekking | ||
| EmploymentTypeDesc | STRING | syncfield_afas_employmentdesc | Type dienstbetrekking | ||
| FTE | DECIMAL | syncfield_employee_fte | |||
| OrgUnit | STRING | syncfield_department_synckey | |||
| OrgUnitDesc | STRING | syncfield_department_name | |||
| FunctionId | STRING | syncfield_function_synckey | x | ||
| FunctionDesc | STRING | syncfield_function_description | x | ||
| DateDeceased | DATE | syncfield_person_datedeceased | |||
| STRING | syncfield_employee_email | x | |||
| FirstName | STRING | syncfield_person_firstname | x | ||
| Cao_code | STRING | syncfield_cao_synckey | x | ||
| Cao_omschrijving | STRING | syncfield_cao_name | x | ||
| BSN | STRING | syncfield_person_bsn | |||
| Type_contract | STRING | syncfield_afas_contracttype | Code contract type | ||
| Leidinggevende_nr. | STRING | syncfield_manager_synckey | x | ||
| Leidinggevende_Naam | STRING | syncfield_employee_manager_name | x |
1.2 de getConnector voor contracten instellen
Voor de getConnector voor contracten gelden dezelfde regels als voor de connector voor medewerkers.
Welke velden u overgezet wilt hebben naar RegiCare kunt u opnemen in de bijlage MS Excel AFAS Connector V2.xsls te vinden onderin dit artikel. Na het invullen van deze MS Excelsheet kan het ingevulde formulier worden verstuurd naar projecten@adsysco.nl .
| AFAS (Contracten) | Formaat | RegiCare | verplicht | Opmerking | |
| FormatieGUID | STRING | ||||
| Naam | STRING | syncfield_person_displayname | x | ||
| Medewerkercode | STRING | syncfield_employee_synckey | x | ||
| DienstbetrekkingCode | STRING | syncfield_afas_employmenttype | Code dienstbetrekking | ||
| DienstbetrekkingOmschrijving | STRING | syncfield_afas_employmentdesc | Type dienstbetrekking | ||
| TypeContractCode | STRING | syncfield_afas_contracttype | Code contract type | ||
| TypeContractOmschrijving | STRING | syncfield_afas_contractdesc | Beschrijving / label contract type | ||
| SoortMedewerkerCode | STRING | syncfield_afas_employee_type | |||
| SoortMedewerkerOmschrijving | STRING | syncfield_afas_employee_typedesc | |||
| Rooster_GUID | STRING | syncfield_contract_synckey | x | ||
| BegindatumRooster | DATE | syncfield_contract_from | x | ||
| EinddatumRooster | DATE | syncfield_contract_till | x | ||
| Uren | DECIMAL | syncfield_contract_hours | x | ||
| LeidinggevendeCode | STRING | syncfield_contract_manager | x | ||
| VervLeidinggevendeCode | STRING | ||||
| DatumIndienst | DATE | syncfield_employee_since | x | ||
| DatumUitdienst | DATE | syncfield_employee_till | x | ||
| FormatiePercentage | DECIMAL | ||||
| KostenplaatsCode | STRING | ||||
| FunctieCode | STRING | syncfield_function_synckey | x | ||
| Functie | STRING | syncfield_function_desc | x | ||
| VestigingCode | STRING | syncfield_department_synckey | |||
| VestigingOmschrijving | STRING | syncfield_department_desc | |||
| Contract_GUID | STRING | ||||
| WerkgeverCode | STRING | syncfield_organization_synckey | x | ||
| Naam_werkgever | STRING | syncfield_organization_name | x | ||
| Cao_code | STRING | syncfield_cao_synckey | |||
| Cao_omschrijving | STRING | syncfield_cao_name |
Nadat deze getConnectoren zijn aangemaakt en ingesteld is de configuratie binnen AFAS gereed!
1.3 benodigde instellingen in RegiCare
Voordat de test kan beginnen moeten er binnen de RegiCare omgeving van de organisatie verschillende configuratie-opties aangepast worden, deze moeten door de (externe) AFAS contactpersoon doorgegeven worden aan het projectbureau van AdSysCo (projecten@adsysco.nl). De verschillende configuratie opties zijn hieronder opgenomen.
Let op: Wanneer RegiCare al in gebruik is moet het test moment in overleg bepaald worden.
configuration.AFASconnection.endpoint="https://"
Het endpoint is het adres waarop wij AFAS kunnen bereiken om gegevens uit te wisselen. Dit is een URL met een vaste opbouw oa. de AFAS klantcode is in deze URL opgenomen. In principe is voor de configuratie in RegiCare de klantcode voldoende. De url die wij nodig hebben is als volgt opgebouwd (000 is als voorbeeld klantcode gebruikt):
https://000.rest.afas.online/profitrestservices/
configuration.AFASconnection.token="<token><version>1</version><data>xxxx-xxxx-xxxx-xxx-xxxxxxx"</data></token>
Het token is de code die zorgt voor de beveiliging, iedereen met deze token kan verbinding maken, verstuur deze in overleg en apart van het endpoint.
Na het invoeren van deze gegevens kan er in RegiCRM ingesteld worden welke informatie er binnen deze koppeling leidend is. Standaard is voor alle onderdelen AFAS leidend, er kunnen echter uitzonderingen gemaakt worden (zie afbeelding 1.1 hieronder).
Afbeelding 1.1, via het menu "RegiCRM - Instellingen Algemeen" kunnen de instellingen bereikt worden.
De instelling "Koppeling is leidend" betekent dat na het aanpassen van bijvoorbeeld de functie of afdeling in RegiCare, deze aanpassing bij een nieuwe sync ongedaan gemaakt wordt. De gegevens worden dan vervangen door de meest recente informatie uit AFAS. Onderin afbeelding 1.1 zijn nog twee extra opties te vinden.
Contractkoppeling gebaseerd op
hiermee is het mogelijk om ???
Gegevens fixeren gesynchroniseerd voor
hiermee kan de ???
2. Testen
2.1 voordat er getest kan worden
2.2 de test uitvoeren
2.3
Nu alle instellingen en opties zijn geconfigureerd is het mogelijk om de gegevens uit AFAS op te halen. Om er zeker van te zijn dat dit bij een eerste keer in de live omgeving zonder problemen verloopt wordt er door de RegiCare consultant een test omgeving geconfigureerd.
Hierin worden bovenstaande configuraties toegepast en
3. Gebruiken
Het ophalen van gegevens uit AFAS HR wordt gedaan via RegiCRM of RegiTijd, in dit artikel is te vinden hoe de uitwisseling gestart kan worden en dient te verlopen.
4. FAQ
Was dit artikel nuttig?
Dat is fantastisch!
Hartelijk dank voor uw beoordeling
Sorry dat we u niet konden helpen
Hartelijk dank voor uw beoordeling
Feedback verzonden
We stellen uw moeite op prijs en zullen proberen het artikel te verbeteren