VOM (Visma)
De VOM-integratie verbindt mTime met Visma Organisation Master, de centrale service van Visma voor medewerkers- en organisatiegegevens. Via de Visma API worden medewerkers, dienstverbanden, organisatie-eenheden en managers gesynchroniseerd.
Wat er wordt gesynchroniseerd
De integratie importeert de volgende gegevens uit VOM in mTime:
- Medewerkers — Naam, e-mailadres en persoonlijke gegevens
- Dienstverbanden — Functietitel, start- en einddatum
- Organisatie-eenheden — Afdelingsstructuur en hiërarchie
- Managers — Rapportagerelaties tussen medewerkers en eenheden
Hoe het werkt
VOM maakt verbinding via de Visma API en ondersteunt twee synchronisatiemethoden die samen kunnen worden gebruikt:
- Dagelijkse synchronisatie — Eenmaal per dag wordt een volledige synchronisatie uitgevoerd om alle wijzigingen op te halen
- Live updates — Webhooks leveren wijzigingen in realtime aan zodra ze in Visma plaatsvinden. Standaard uitgeschakeld — mTime-support zet het aan.
Live updates wijzigen alleen medewerkers en eenheden die al in mTime staan. Nieuwe medewerkers en eenheden worden aangemaakt door de nachtelijke synchronisatie en verschijnen dus de dag nadat ze in Visma zijn toegevoegd in mTime. Elke update die Visma stuurt, staat in met de richting Inkomend, zodat je ziet of hij is toegepast en zo niet, waarom.
De integratie kan ook worden geconfigureerd om specifieke typen medewerkers al dan niet op te nemen:
- Consultants — Externe consultants die in Visma zijn geregistreerd
- Contractmedewerkers — Contractwerkers die in Visma zijn geregistreerd
Organisatie-eenheden worden alleen geïmporteerd waar je medewerkers zijn: het team van elke medewerker en de eenheden daarboven, tot aan de eenheid die ze allemaal verbindt. Een eenheid zonder medewerkers komt alleen mee als die op dat pad ligt. Wil je de structuur lager laten stoppen, stel dan Bovenste eenheden in op de VOM-eenheid-ID’s van de hoogste eenheden die je wilt, gescheiden door komma’s. Elke eenheid wordt een eigen hoofdeenheid, en teams daarbuiten worden niet geïmporteerd: hun medewerkers krijgen geen eenheid.
Attributen toegevoegd door VOM
Wanneer de integratie actief is, worden er alleen-lezen attributen toegevoegd aan gesynchroniseerde records. Deze attributen worden beheerd door VOM en kunnen niet worden bewerkt in mTime.
| Attribuut | Omschrijving |
|---|---|
| VOM medewerkers-ID | De unieke identificatie van de medewerker in VOM |
| VOM eenheid-ID | De identificatie van de organisatie-eenheid afkomstig uit VOM |
| Dienstverbandnummer | Uniek nummer voor elk dienstverbandrecord |
Ze verschijnen op elk record in een eigen gedeelte, met de naam van de integratie. Zie Aangepaste attributen voor meer informatie over hoe integratie-attributen werken.
Aan de slag
Voor de VOM-integratie moet uw mTime-werkruimte zijn gekoppeld aan een Visma-rechtspersoon.
Neem contact op met mTime Support en geef aan dat u VOM wilt verbinden. Zij zullen:
- Uw werkruimte koppelen aan de juiste Visma-rechtspersoon
- De synchronisatieopties configureren (dagelijkse synchronisatie, live updates, filters voor medewerkerstype)
- U helpen bij het uitvoeren en verifiëren van de eerste synchronisatie
Wat u kunt verwachten na de eerste synchronisatie
Nadat de integratie voor de eerste keer heeft gedraaid:
- Medewerkers uit Visma worden aangemaakt in mTime — u vindt ze via
- Dienstverbanden worden gekoppeld aan de bijbehorende medewerkers
- Organisatie-eenheden worden aangemaakt conform de afdelingsstructuur in Visma via
- Managersrelaties worden ingesteld op basis van de Visma-gegevens
- De hierboven vermelde alleen-lezen attributen worden ingevuld op elk record
Vervolgstappen
Zodra de integratie actief is, raadpleegt u Integraties voor informatie over het controleren van de synchronisatiestatus, het handmatig starten van synchronisaties, het aanpassen van instellingen en het oplossen van problemen.