Productsheet: Yoobi Nmbrs API koppeling In Yoobi is een koppeling met de Nmbrs API aanwezig. Met deze koppeling kunnen NAW gegevens van medewerkers gesynchroniseerd worden. Hiernaast kunnen periode totalen (uren, kilometers, etc.) aangeleverd worden op de toegewezen looncomponenten. Deze specifieke looncomponenten die door Yoobi worden aangeleverd aan Nmbrs Koppeling maken Via de Yoobi instellingen kan de koppeling met Nmbrs gelegd worden via de Nmbrs email en token van een geautoriseerde gebruiker. Vervolgens kan het specifieke bedrijf gekoppeld worden welke in Nmbrs is gedefinieerd. Figuur 1: Email en token van geautoriseerde Nmbrs gebruiker Figuur 2: Koppeling met Nmbrs berdrijf maken in Yoobi Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 1 van 10
Koppeling gebruiken Medewerker synchronisatie en looncomponenten aanleveren (op basis van de mapping) kan via Nmbrs beheer te vinden in Beheer / Systeemvoorkeuren. Figuur 3: Nmbrs koppeling gebruiken in Yoobi (waar te vinden) Synchroniseren van of naar Nmbrs kan via de knoppen op het overzicht tabblad. Huidige salarisperiode wordt opgehaald uit Nmbrs en ook worden alle salarisperioden getoond waarop data is aangeleverd vanuit Yoobi. Om data aan te leveren is eerst een mapping nodig. Figuur 4: Nmbrs koppeling gebruiken in Yoobi Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 2 van 10
Synchroniseren van medewerkers Koppelen medewerkers Dit proces wordt altijd uitgevoerd vóór het synchroniseren van of naar Nmbrs. Voegt niet bestaande medewerkers uit Nmbrs toe in Yoobi. Voegt niet bestaande medewerkers uit Yoobi toe in Nmbrs. Medewerker bestaat als 1 van de volgende matches precies 1 keer voorkomt. o Match 1 = bsn o Match 2 = personeelsnr & achternaam o Match 3 = achternaam & voornaam o Match 4 = achternaam o Match 5 = voornaam Synchroniseer medewerker-data Personeelsnr, achternaam, tussenvoegsels, initialen en voornaam Geslacht BSN, Geboortedatum Kostenplaats & kostendrager Afdeling (Maakt nieuwe afdeling aan indien niet bestaat) Functie Contactgegevens (tel,mobiel,email,rekeningnr) Adressen Gebruiker (indien niet bestaat) Contract & rooster Sync van Nmbrs naar Yoobi 1. Koppelen medewerkers 2. Synchroniseer medewerker-data van Nmbrs naar Yoobi. Sync van Yoobi Naar Nmbrs 1. Afdelingen en functies van actieve medewerkers in Yoobi toevoegen in Nmbrs, indien niet aanwezig in Nmbrs, indien toegestaan met gebruikersprofiel van Nmbrs. 2. Koppelen medewerkers. 3. Synchroniseer medewerker-data van Yoobi naar nmbrs. Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 3 van 10
Voorbeeld: Nieuwe medewerker toevoegen in Nmbrs Figuur 5: Medewerker Art in Yoobi Figuur 6: Medewerker Art na synchronisatie in Nmbrs Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 4 van 10
Voorbeeld: Nieuwe medewerker toevoegen in Yoobi Figuur 7: Medewerker Joris in Nmbrs Figuur 8: Medewerker "Joris" na synchronisatie in Yoobi Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 5 van 10
Voorbeeld: Medewerker wijzigen in Yoobi Figuur 9: Medewerker Lotte in Yoobi voor synchronisatie Figuur 10: Medewerker "Lotte" in Nmbrs Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 6 van 10
Figuur 11: Medewerker "Lotte" na synchronisatie Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 7 van 10
Aanleveren van dagen, loon- en salariscomponenten Mapping In de mapping ligt vast welke data elke periode aangeleverd moet worden. Per onderdeel kan aangegeven worden hoe dit in Nmbrs moet komen. De opties zijn Dagen gewerkt of een van de in nmbrs ingestelde loon- of salariscomponenten. Mapping kan gekoppeld worden aan contracten van medewerkers. Figuur 12: Nmbrs mapping in Yoobi Figuur 13: Nmbrs mapping looncomponenten Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 8 van 10
Periode data aanleveren 1. Data voorheen aangeleverd ophalen. 2. Data ophalen per mapping, per medewerker voor de periode. 3. Per medewerker: 3.1. Geen data voorheen aangeleverd of data anders dan voorheen aangeleverd toevoegen aan de bulkuitvoer insert_batch, behalve dagen, die gaan via eigen api DaysVar_Set. 3.2. Als er wijzigingen zijn voor hour- of wage van de medewerker, dan worden de hour- en wagecomponenten van betreffende periode opgehaald en verwijderd indien gelijk aan voorheen aangeleverde data. 4. Data voor deze periode vastleggen als aangeleverde data. 5. Hour en wage insert_batch uitvoeren indien er wijzigingen zijn. Voorbeeld Figuur 14: Mapping voorbeeld Figuur 15: Data aanleveren voor salarisperiode Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 9 van 10
Figuur 16: Looncomponent aangeleverd uit Yoobi Figuur 17: Looncomponent (uren/dagen) aangeleverd uit Yoobi Versie: 1 Yoobi. Helder, flexibel en altijd actueel! Pagina 10 van 10