Integraties / ERP / MRPeasy
MRPeasy-integratiegids voor productieschema’s met SkyPlanner APS
Deze MRPeasy-integratiegids laat consultants en IT-teams zien hoe ze MRPeasy koppelen aan SkyPlanner APS. SkyPlanner wisselt via de MRPeasy REST API gegevens uit met MRPeasy in beide richtingen:
- Productieorders, bewerkingsvolgordes, BOM’s, werkcentrumgroepen, werkcentra, artikelen, voorraden en inkooporders worden ingelezen.
- Geplande datums en voortgang worden teruggeschreven naar elke Manufacturing Order.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
SkyPlanner is in klantprojecten al gekoppeld aan MRPeasy. Tijdens de implementatie stemt het SkyPlanner-team de integratie af op uw MRPeasy-inrichting. Ook na ingebruikname blijft het team de integratie ondersteunen. Deze gids is voor consultants en ontwikkelaars die hieraan willen meewerken of zelf willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-referentie).
De MRPeasy REST API: v1 en v2
MRPeasy is één cloudproduct zonder on-premisesversies. Elke klant gebruikt dus dezelfde API. Er zijn twee versies:
- REST API v1 (OpenAPI 1.0, server
https://api.mrpeasy.com/rest/v1) is de API voor productiegebruik. Deze omvat/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsen productierapporten zoals/report/production/operations. - REST API v2 (OpenAPI 2.0.0, server
https://api.mrpeasy.com/rest/v2) bevindt zich in een vroege ontwikkelfase. Deze versie voegt/workstation-groupsmetwork_hoursenholidaystoe, evenals/workstationsmetproductivityenidle,/inventory,/stock-movementen PATCH. Productieorders blijven op v1.
Let op de naamgeving. Een Workstation group in de MRPeasy-interface komt in v1 overeen met work-center-types (type_id). Een Workstation komt overeen met work-centers (center_id). Bewerkingen in de bewerkingsvolgorde verwijzen via type_id naar een groep, niet naar een machine.
De API is beschikbaar voor betalende accounts met het Unlimited-abonnement van MRPeasy. MRPeasy vermeldt ook: “Our Support Department cannot help you using the API.” (Onze supportafdeling kan u niet helpen bij het gebruik van de API.) Er moet dus iemand verantwoordelijk zijn voor de integratie: SkyPlanner, uw MRPeasy-consultant of uw ontwikkelaar. Het SkyPlanner-team neemt precies dat werk op zich tijdens de implementatie.
Authenticatie en limieten
MRPeasy gebruikt HTTP Basic-authenticatie: Authorization: Basic base64(api-key:api-secret). U maakt de API key en API secret aan onder Settings → Integration → API access. Als u de sleutel wist, wordt de API uitgeschakeld.
De limieten bepalen hoe de synchronisatie wordt ingericht:
- Eén gelijktijdig verzoek per client: verzoeken worden na elkaar verwerkt.
- Maximaal 100 verzoeken per 10 seconden. Bij overschrijding geeft de API statuscode 429 terug.
- Lijsten retourneren standaard 100 records en maximaal 1.000 met de
Range-header.Content-Rangein de respons geeft het totaal aan.
De REST API van SkyPlanner gebruikt een API-token voor authenticatie (SkyPlanner Settings > API) en is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste aanroepen.
Events en polling
Op de prijspagina van MRPeasy staat “API, webhooks (for paid accounts)” (API, webhooks voor betalende accounts), maar de specificaties van v1 en v2 documenteren geen webhookevents voor productieorders. Daarom haalt de integratie wijzigingen in MRPeasy incrementeel op via polling:
- Productieorders, gefilterd op Not scheduled (15), Scheduled (20), In progress (30) en Paused (35).
- Inkooporders en voorraad op vaste tijdstippen of vóór elke planningsrun.
- Stamgegevens bij wijzigingen of elke nacht.
Sequentiële, gefilterde polling blijft ruim binnen de limiet van 100 verzoeken per 10 seconden. In de andere richting geven de eigen webhooks van SkyPlanner wijzigingen in het productieschema direct door. Het terugschrijven is dus eventgestuurd.
Datamapping
| MRPeasy-object (endpoint) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Producten en materialen | MRPeasy → SkyPlanner | Eerste import, daarna elke nacht |
BOM met componenten (/boms) | Productstructuur, deelproducten, materialen per product | MRPeasy → SkyPlanner | Eerste import, daarna bij wijzigingen |
Bewerkingen in de bewerkingsvolgorde (/routings): type_id, fixed_time, variable_time, variable_quantity | Processtappen met bewerkingsduur, insteltijden en batchgrootte | MRPeasy → SkyPlanner | Eerste import, daarna bij wijzigingen |
Workstation group (/work-center-types; v2 /workstation-groups) | Werkcentrumgroepen, ploegendiensten | MRPeasy → SkyPlanner | Eerste import, daarna zelden |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Werkcentra, efficiëntiewaarden, afwezigheden | MRPeasy → SkyPlanner | Eerste import, dagelijks voor stilstand |
Manufacturing Order met bewerkingen, due_date (/manufacturing-orders) | Orders en taken | MRPeasy → SkyPlanner | Polling om de paar minuten |
Inventory, Stock lots (/stock/inventory, /lots) | Voorraadsaldi | MRPeasy → SkyPlanner | Elk uur of per planningsrun |
Purchase Order (/purchase-orders) | Binnenkomend materiaal met verwachte leverdatum | MRPeasy → SkyPlanner | Elk uur of per planningsrun |
Velden due_date en custom_<id> van Manufacturing Order (PUT /manufacturing-orders/{id}) | Geplande start, gepland einde, voortgang | SkyPlanner → MRPeasy | Bij wijzigingen in het productieschema, via een SkyPlanner-webhook |
| Niet in MRPeasy | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, aantallen operators, alternatieve werkcentra | Beheerd in SkyPlanner | Ingericht tijdens de implementatie |
Integratiepatronen
1. Eerste import van stamgegevens. Haal artikelen, eenheden, BOM’s en bewerkingsvolgordes op uit v1, en werkcentrumgroepen en werkcentra uit v1 of v2. Haal kalenders op via v2 /workstation-groups (work_hours, holidays) of stel ploegendiensten rechtstreeks in SkyPlanner in. Koppel elke Active processing group aan een werkcentrumgroep in SkyPlanner en voeg de bijbehorende werkcentra als leden toe.
2. Ordersynchronisatie. Lees openstaande productieorders met hun bewerkingen in, samen met openstaande inkooporders en de voorraad. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder als Delivered is gemarkeerd. Bij elke herplanning wordt zowel de voorraad als de verwachte aanvoer gecontroleerd.
3. Het productieschema terugschrijven. PUT /manufacturing-orders/{id} ondersteunt code, quantity, due_date en assigned_id, plus aangepaste velden als custom_<id>. Waar dat is afgesproken, schrijft SkyPlanner het geplande einde naar due_date. De geplande start, het geplande einde en de voortgang worden naar aangepaste velden in MRPeasy geschreven. Verkoop en inkoop zien dan in MRPeasy het werkelijke productieschema. De gedetailleerde bewerkingsvolgorde en het werkcentrum per bewerking staan in SkyPlanner, dat dient als overzicht voor de aansturing van de werkvloer.
4. Orders die buiten MRPeasy worden aangemaakt. Als er ooit orders via de API worden aangemaakt, accepteert POST /manufacturing-orders de parameters no_scheduling en no_bookings. Gebruik die om te voorkomen dat MRPeasy werkcentra reserveert die SkyPlanner al inplant.
5. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations, Production Timer of Quick Log Mode. De tijdregistraties houden het productieschema actueel. Kies één kanaal voor terugmeldingen. Als u de Internet-kiosk van MRPeasy en SkyPlanner naast elkaar gebruikt voor dezelfde bewerkingen, ontstaan er twee versies van de waarheid.
6. Verantwoordelijkheden en conflictregels. Leg deze vast vóór ingebruikname:
| Gegevens | Eigenaar |
|---|---|
| Artikelen, BOM’s, bewerkingsvolgordes, hoeveelheden, voorraad, inkoop | MRPeasy |
| Bewerkingsvolgorde, start- en eindtijden, toewijzing aan werkcentra | SkyPlanner |
| Omsteltijdenmatrix, gereedschappen, aantallen operators, alternatieve resources | SkyPlanner |
| Diensten en afwezigheden | Eén systeem, gekozen tijdens de scopebepaling |
| Ordervoortgang en geregistreerd werk | SkyPlanner, samengevat op de Manufacturing Order |
Engineer-to-order-proces. In een opgeleverd MRPeasy-project wordt elk klantproject een hoofdproduct met één tot drie halffabricaten. Elk product heeft een eigen BOM en bewerkingsvolgorde in MRPeasy, en de productieorder staat in beide systemen. Gebruik voor elke order een vaste, gedeelde identificatie, zodat updates nooit duplicaten aanmaken.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Daarvóór kunt u SkyPlanner 30 dagen gratis uitproberen met uw eigen gegevens, ongeacht uw MRPeasy-abonnement. Exporteer artikelen, BOMs, bewerkingsvolgordes, werkcentra en openstaande productieorders vanuit de lijstweergaven van MRPeasy naar CSV. Importeer ze vervolgens en controleer het productieschema.
Het project zelf omvat:
- Abonnement controleren. Controleer of uw MRPeasy-abonnement toegang tot de API biedt en maak de API key en secret aan.
- Mapping. Leg de mappingtabel vast, bepaal welk systeem leidend is voor welke gegevens en kies de aangepaste velden voor het terugschrijven en het rapportagekanaal.
- Eerste gegevensimport. Artikelen, eenheden, BOMs, bewerkingsvolgordes, werkcentrumgroepen, werkcentra en kalenders.
- Orders en inkooporders synchroniseren. Wijzigingen stapsgewijs ophalen via polling op status, met afhandeling van 429-responses.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantallen operators en alternatieve werkcentra.
- Terugschrijven. Leverdatums en aangepaste velden op elke Manufacturing Order.
- Parallel testen. Gebruik SkyPlanner naast de huidige Production schedule, vergelijk datums en corrigeer stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een MRPeasy-integratie
- Tijdvelden verschillen per interface. De velden Setup time, Cycle time en Capacity in de gebruikersinterface heten in de API
fixed_time,variable_timeenvariable_quantity. Een Capacity boven 1 betekent batchverwerking, zoals in een oven. Modelleer dit als een batchtaak, niet als een langere cyclus. - Passive processing groups. Droog- en koelgroepen draaien 24/7 zonder capaciteitsbeperkingen. Modelleer ze als wachttijden, niet als werkcentra met beperkte capaciteit.
- Kalenders ontbreken in v1.
work-centersretourneert alleencenter_id,type_id,codeentitle. Gebruik v2 of beheer de diensten in SkyPlanner. - Stilstandtijd. De stilstandtijd van een werkcentrum omvat onderhoud en andere stilstand. Synchroniseer deze gegevens, anders plant SkyPlanner werk in op een machine die niet beschikbaar is.
- Bewerkingsvolgordes verwijzen naar groepen. MRPeasy kiest de machine met de beste beschikbaarheid. In SkyPlanner worden de werkcentra binnen de groep concrete alternatieven waaruit de planningsengine kiest.
De MRPeasy-integratie: wie richt die in en biedt ondersteuning?
Het werk omvat het koppelen van uw bewerkingsvolgordes, werkcentrumgroepen en orderstroom, plus het instellen van randvoorwaarden die MRPeasy niet vastlegt: de matrix met insteltijden, gereedschappen, aantallen operators en alternatieve resources.
- Het SkyPlanner-team richt de integratie in tijdens de onboarding en biedt ondersteuning na de ingebruikname. Elke fabriek gebruikt MRPeasy anders. Die praktijkkennis wordt in de inrichting verwerkt. Omdat API-werk buiten de ondersteuning van MRPeasy valt, is het belangrijk dat één team verantwoordelijk is voor de integratie.
- Uw MRPeasy-consultant of integratiepartner kan de integratie bouwen. In een opgeleverd MRPeasy-project koppelde een integratiepartner de twee systemen via hun beide REST APIs. SkyPlanner biedt de REST API, Swagger/OpenAPI-documentatie en webhooks.
- Uw eigen ontwikkelaars kunnen de koppeling bouwen met een API-token. Dat is voldoende om te beginnen; het SkyPlanner-team helpt waar nodig. Productdocumentatie, onder meer over inkooporders en de API voor producten en materialen, vindt u in de SkyPlanner-documentatie.
SkyPlanner is verkrijgbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw proces en behoeften, samen met uw abonnement. Zo kent u de volledige kosten voordat u begint. Bekijk de prijzen en functies, en lees hoe de eigen planningstool van MRPeasy zich verhoudt tot SkyPlanner op de pagina over capaciteitsplanning in MRPeasy. Het overzicht vindt u op de MRPeasy-pagina. Andere ERP-systemen staan in het overzicht van ERP-integraties.
Ervaringen van productiebedrijven met SkyPlanner
2 htijdwinst per week
“Dankzij SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime optimalisatie van de productie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd, en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
6 maandenvooruit inzicht in vrije capaciteit voor de verkoopafdeling
“SkyPlanner biedt een betrouwbare basis voor de volledige productieplanning.”
Anu Järvinen, productiemanager
Fredman Operations · Voedselveilig verpakkingspapier
De verkoopafdeling ziet de vrije capaciteit zes maanden vooruit. Verzoeken om de planning te wijzigen die vroeger een uur of langer kostten, worden nu binnen enkele seconden beantwoord.
Veelgestelde vragen
Heeft MRPeasy een API en welk abonnement heb ik nodig?
Ja. MRPeasy biedt betalende accounts met het Unlimited-abonnement een REST API: v1 is in productie en v2 is in ontwikkeling. Authenticatie verloopt via HTTP Basic met een API key en secret uit Settings → Integration → API access.
Kan SkyPlanner het productieschema terugschrijven naar MRPeasy?
Ja. SkyPlanner werkt elke Manufacturing Order bij via PUT /manufacturing-orders/{id}. Daarbij schrijft het de leverdatum en aangepaste velden voor de geplande start, het geplande einde en de voortgang terug. De gedetailleerde bewerkingsvolgorde blijft in SkyPlanner, waar operators vanuit hun eigen werklijst werken.
Stuurt MRPeasy wijzigingen in realtime door?
De API-specificaties beschrijven geen webhook-events voor productieorders. Daarom haalt SkyPlanner elke paar minuten openstaande orders op per status. De eigen webhooks van SkyPlanner sturen wijzigingen in het productieschema door zodra ze plaatsvinden.
Wie bouwt de MRPeasy-integratie?
Het SkyPlanner-team richt de tweerichtingsintegratie in tijdens de onboarding en biedt ondersteuning na de ingebruikname. Uw MRPeasy-consultant, een integratiepartner of uw eigen ontwikkelaars kunnen de koppeling ook bouwen met de gedocumenteerde REST API van SkyPlanner.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u met maximaal 20 werkcentra werken en gegevens via CSV uit MRPeasy importeren. Dit kan met elk MRPeasy-abonnement en zonder creditcard. Start de proefperiode of neem contact op met ons verkoopteam voor de scopebepaling van de integratie.
