HR naar ERP
Visma Peple Dynamics 365 koppeling: medewerkers uit Peple in Business Central, met kostenplaats als dimensie
Met een koppeling tussen Visma Peple en Microsoft Dynamics 365 Business Central wordt elke medewerker uit Peple automatisch een employee in het Business Central-bedrijf van zijn Peple-onderdeel, met functie, zakelijk e-mailadres en kostenplaats als standaarddimensie. Een overplaatsing uit de afdelingshistorie van Peple voert KoppelHet door op de ingangsdatum, en na het laatste contract krijgt de medewerker de status beëindigd.
Wat de koppeling doet
Organisaties met Visma Peple voor salaris en HR en Business Central voor de financiële administratie, maken medewerkers in Business Central met de hand aan voor uren, declaraties of projecten. Na een overplaatsing in Peple blijft de oude kostenplaats in Business Central staan.
- KoppelHet start in Peple exports van medewerkers, contracten en afdelingshistorie met alleen de wijzigingen sinds de vorige ronde, en haalt de bestanden op zodra ze klaar zijn.
- Een nieuwe medewerker wordt een employee in het Business Central-bedrijf van zijn Peple-onderdeel.
- Kostenplaats en afdeling uit de afdelingshistorie worden standaarddimensies op de ingangsdatum.
- Een code die in Business Central nog niet bestaat, gaat als melding naar finance.
- Na de einddatum van het laatste contract krijgt de medewerker de status beëindigd.
Waar je op let bij Visma Peple en Microsoft Dynamics 365
- Business Central houdt per medewerker één waarde per dimensie bij, zonder ingangsdatum. Peple levert de afdelingshistorie met begin- en einddatum, ook voor overplaatsingen die nog moeten ingaan. KoppelHet bewaart zo'n toekomstige regel en zet de nieuwe kostenplaats pas op de dag zelf in Business Central.
- Peple kan de loonkosten van een contract over meerdere kostenplaatsen verdelen, maar een standaarddimensie in Business Central heeft één code. KoppelHet neemt de kostenplaats uit de afdelingshistorie als standaard. Een verdeling over meerdere plaatsen gaat als melding naar finance, die bij boekingen zelf kan afwijken.
- Dimensiewaarden zijn in de Business Central-API alleen te lezen. Peple levert zijn kostenplaatsen als aparte metadata-export. KoppelHet vergelijkt die lijst met de dimensiewaarden in Business Central en meldt een nieuwe Peple-code aan finance voordat de eerste medewerker ermee binnenkomt.
- Een medewerker kan in Peple meer dan één contract hebben, terwijl Business Central één employee per persoon kent. KoppelHet neemt de vroegste begindatum als datum in dienst en zet de status pas op beëindigd als het laatste contract is afgelopen, zodat iemand die één aanstelling verliest gewoon kan blijven declareren.
- Het zakelijke e-mailadres valt in de werknemersexport van Peple onder de standaardrechten. Privéadres en privé-e-mail vragen een aparte scope. Business Central heeft er wel velden voor, maar KoppelHet vraagt die scope niet aan en laat de velden leeg, omdat uren en declaraties ze niet nodig hebben.
- Peple draait een export als achtergrondtaak, met onderhoud op zaterdagavond waarin de API tijdelijk niet beschikbaar is. KoppelHet herhaalt een geweigerde opdracht na de wachttijd die Peple meegeeft, zodat een medewerker hooguit een paar uur later in Business Central staat.
- Elk Peple-onderdeel heeft een eigen organisatie-ID, en de Business Central-API werkt per bedrijf. KoppelHet koppelt elk onderdeel aan één bedrijf, zodat medewerkers van een stichting en haar dochter niet in hetzelfde bedrijf terechtkomen.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Gaan salarisgegevens mee naar Business Central?
Nee. De koppeling vraagt in Peple geen salarisexports aan. Het loonjournaal is een aparte stroom die later als uitbreiding kan.
Werkt dit ook met Dynamics 365 Finance?
Deze pagina gaat uit van Business Central. Voor Dynamics 365 Finance kijken we apart naar de entiteiten.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Peple via de Visma.net HRM & Payroll Reporting API met Visma Connect - exports via POST /v1/command/nl/hrm/employees (businessemailaddress zonder extra scope), /contracts (functionname, startdate, enddate), /contracts/department-histories en /metadata/costcenters, resultaat via GET /v1/query/nl/hrm/.../{jobId}; incrementeel met changeTimestampAfter. 503 met Retry-After tijdens onderhoud; twee volledige exports per endpoint per tenant per 24 uur.
- Business Central API v2.0 per bedrijf met een app-registratie in Microsoft Entra ID - employees (POST, PATCH; number, givenName, middleName, surname, jobTitle, email, employmentDate, terminationDate, status) en defaultDimensions met parentType Employee; dimensionValues alleen GET.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Visma Peple | Veld in Microsoft Dynamics 365 | Toelichting |
|---|---|---|
employeeid | number | |
Naamvelden uit de werknemersexport | givenName, middleName, surname | |
functionname | jobTitle | |
businessemailaddress | email | |
odporgid | Bedrijf in Business Central | Vaste tabel per onderdeel |
department-histories: costcenter | defaultDimensions (kostenplaats) | |
department-histories: orgunit | defaultDimensions (afdeling) | Alleen als finance een afdelingsdimensie gebruikt |
Vroegste startdate van de contracten | employmentDate | |
Laatste enddate van de contracten | terminationDate en status Terminated |
Gerelateerd
Visma Peple → Active Directory
Visma Peple Active Directory koppeling: accounts vanuit Peple HRM & Payroll
ASVisma Peple → Arbodienst (SIVI)
Visma Peple arbodienst koppeling via SIVI: ziek- en herstelmeldingen uit Peple naar de arbodienst
Visma Peple → Microsoft Entra ID
Visma Peple Entra ID koppeling: Microsoft-accounts vanuit Peple HRM & Payroll
Visma Peple → Exact Online
Visma Peple Exact Online koppeling: kostenplaatsen klaar in Exact en medewerkerswijzigingen op een werklijst