Integrationer / ERP / MRPeasy
Guide til MRPeasy-integration til produktionsplanlægning med SkyPlanner APS
Denne guide til MRPeasy-integration viser konsulenter og IT-teams, hvordan de forbinder MRPeasy med SkyPlanner APS. SkyPlanner integrerer med MRPeasy i begge retninger via MRPeasy REST API:
- Produktionsordrer, ruter, BOM’er, arbejdsstationsgrupper, arbejdsstationer, varer, lagerbeholdninger og indkøbsordrer hentes ind.
- Planlagte datoer og fremdrift skrives tilbage til hver Manufacturing Order.
- SkyPlanners webhooks sender ændringer i planen, så snart de sker.
SkyPlanner er blevet integreret med MRPeasy i kundeprojekter. SkyPlanner-teamet tilpasser integrationen til jeres MRPeasy-opsætning under opstarten og yder support efter idriftsættelsen. Denne guide er til konsulenter og udviklere, der vil deltage i arbejdet eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
MRPeasy REST API: v1 og v2
MRPeasy er ét cloudprodukt uden lokalt installerede versioner, så alle kunder bruger samme API. Der findes to versioner:
- REST API v1 (OpenAPI 1.0, server
https://api.mrpeasy.com/rest/v1) er API’et til produktionsbrug. Det dækker/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitsog produktionsrapporter som/report/production/operations. - REST API v2 (OpenAPI 2.0.0, server
https://api.mrpeasy.com/rest/v2) er i en tidlig udviklingsfase. Det tilføjer/workstation-groupsmedwork_hoursogholidays,/workstationsmedproductivityogidle,/inventory,/stock-movementog PATCH. Produktionsordrer håndteres fortsat i v1.
Vær opmærksom på navnene. En Workstation group i MRPeasys brugerflade svarer til work-center-types i v1 (type_id). En Workstation svarer til work-centers (center_id). Operationer i en rute henviser til en gruppe via type_id, ikke til en maskine.
API’et er inkluderet i MRPeasys Unlimited-abonnement for betalende konti. MRPeasy oplyser desuden: “Our Support Department cannot help you using the API.” (Vores supportafdeling kan ikke hjælpe jer med at bruge API’et.) Derfor skal nogen tage ansvar for integrationen: SkyPlanner, jeres MRPeasy-konsulent eller jeres udvikler. SkyPlanner-teamet påtager sig netop dette arbejde under opstarten.
Godkendelse og grænser
MRPeasy bruger HTTP Basic-godkendelse: Authorization: Basic base64(api-key:api-secret). Nøglen og den tilhørende hemmelighed oprettes under Settings → Integration → API access. Hvis nøglen fjernes, deaktiveres API’et.
Grænserne har betydning for, hvordan synkroniseringen skal udformes:
- Kun én anmodning ad gangen pr. klient: Anmodninger behandles sekventielt.
- Højst 100 anmodninger pr. 10 sekunder. Overskrides grænsen, returnerer API’et 429.
- Lister returnerer som standard 100 poster og op til 1.000 med headeren
Range.Content-Rangei svaret angiver det samlede antal.
Hos SkyPlanner bruger REST API’et et API-token til godkendelse (SkyPlanner Settings > API) og er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Hændelser og polling
På MRPeasys prisside står der “API, webhooks (for paid accounts)” (API og webhooks for betalende konti), men specifikationerne for v1 og v2 dokumenterer ingen webhook-hændelser for produktionsordrer. Integrationen henter derfor løbende ændringer fra MRPeasy via polling:
- Produktionsordrer filtreret efter status: Not scheduled (15), Scheduled (20), In progress (30) og Paused (35).
- Indkøbsordrer og lagerbeholdninger med faste intervaller eller før hver planlægningskørsel.
- Stamdata ved ændringer eller hver nat.
Sekventiel polling med filtre holder sig et godt stykke under grænsen på 100 kald pr. 10 sekunder. I den modsatte retning sender SkyPlanners egne webhooks ændringer i planen, så snart de sker. Tilbageskrivningen er dermed hændelsesstyret.
Datamapping
| MRPeasy-objekt (endpoint) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Produkter og materialer | MRPeasy → SkyPlanner | Første indlæsning, derefter hver nat |
BOM med komponenter (/boms) | Produktstruktur, delprodukter, materialer pr. produkt | MRPeasy → SkyPlanner | Første indlæsning, derefter ved ændringer |
Operationer i ruter (/routings): type_id, fixed_time, variable_time, variable_quantity | Procestrin med varigheder, omstillingstider og batchstørrelse | MRPeasy → SkyPlanner | Første indlæsning, derefter ved ændringer |
Workstation group (/work-center-types; v2 /workstation-groups) | Arbejdsstationsgrupper, skiftehold | MRPeasy → SkyPlanner | Første indlæsning, derefter sjældent |
Workstation (/work-centers; v2 /workstations: productivity, idle) | Arbejdsstationer, effektivitetsgrader, fravær | MRPeasy → SkyPlanner | Første indlæsning, dagligt for stilstandstid |
Manufacturing Order med operationer, due_date (/manufacturing-orders) | Ordrer og opgaver | MRPeasy → SkyPlanner | Polling med få minutters mellemrum |
Inventory, Stock lots (/stock/inventory, /lots) | Lagerbeholdninger | MRPeasy → SkyPlanner | Hver time eller ved hver planlægningskørsel |
Purchase Order (/purchase-orders) | Indgående materialer med forventet leveringsdato | MRPeasy → SkyPlanner | Hver time eller ved hver planlægningskørsel |
Felterne due_date og custom_<id> på Manufacturing Order (PUT /manufacturing-orders/{id}) | Planlagt start, planlagt afslutning, fremdrift | SkyPlanner → MRPeasy | Ved ændringer i planen via SkyPlanner-webhook |
| Findes ikke i MRPeasy | Omstillingstidsmatrix, værktøjer som begrænsede ressourcer, antal operatører, alternative arbejdsstationer | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Hent varer, enheder, BOM’er og ruter fra v1 samt arbejdsstationsgrupper og arbejdsstationer fra v1 eller v2. Hent kalendere fra v2 /workstation-groups (work_hours, holidays), eller opret skiftehold direkte i SkyPlanner. Knyt hver gruppe af typen Active processing til en arbejdsstationsgruppe i SkyPlanner med de tilhørende arbejdsstationer som medlemmer.
2. Synkronisering af ordrer. Hent åbne produktionsordrer med deres operationer samt åbne indkøbsordrer og lagerbeholdninger. SkyPlanner betragter bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren får status Delivered. Ved hver omplanlægning kontrolleres både lagerbeholdninger og kommende indkøbsleverancer.
3. Tilbageskrivning af planen. PUT /manufacturing-orders/{id} understøtter code, quantity, due_date og assigned_id samt brugerdefinerede felter som custom_<id>. Hvor det er aftalt, skriver SkyPlanner den planlagte afslutning til due_date og planlagt start, planlagt afslutning og fremdrift til brugerdefinerede felter i MRPeasy. Salg og indkøb kan dermed se den faktiske plan i MRPeasy. Den detaljerede rækkefølge af operationer og arbejdsstationen for hver operation ligger i SkyPlanner, som viser produktionen, hvilke opgaver der skal udføres.
4. Ordrer oprettet uden for MRPeasy. Hvis der oprettes ordrer via API’et, accepterer POST /manufacturing-orders parametrene no_scheduling og no_bookings. Brug dem, så MRPeasy ikke reserverer arbejdsstationer, som SkyPlanner allerede planlægger.
5. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejde med SkyPlanner Mobile Confirmations, Production Timer eller Quick Log Mode, og tidsregistreringerne holder planen ajour. Vælg én kanal til tilbagemeldinger. Hvis MRPeasys Internet-kiosk og SkyPlanner bruges sideløbende til de samme operationer, opstår der to versioner af sandheden.
6. Dataansvar og regler for konflikter. Skriv dem ned før idriftsættelsen:
| Data | Ejer |
|---|---|
| Varer, BOM’er, ruter, mængder, lagerbeholdninger, indkøb | MRPeasy |
| Operationernes rækkefølge, start- og sluttider, tildeling af arbejdsstationer | SkyPlanner |
| Omstillingstidsmatrix, værktøjer, antal operatører, alternative ressourcer | SkyPlanner |
| Skift og fravær | Ét system, valgt under afklaringen |
| Ordrefremdrift og registreret arbejde | SkyPlanner, med en opsummering på Manufacturing Order |
Arbejdsgang til engineer to order. I et gennemført MRPeasy-projekt bliver hvert kundeprojekt til et hovedprodukt og et til tre halvfabrikata. Hvert produkt har sin egen BOM og rute i MRPeasy, og produktionsordren findes i begge systemer. Brug en stabil, fælles identifikator på hver ordre, så opdateringer aldrig opretter dubletter.
Typiske projekttrin
Implementeringen er normalt afsluttet inden for nogle uger efter starten på onboarding. Inden da kan du bruge den gratis prøveperiode på 30 dage med dine egne data, uanset hvilket MRPeasy-abonnement du har. Eksportér varer, BOM’er, ruter, arbejdsstationer og åbne produktionsordrer fra listevisningerne i MRPeasy til CSV, importér dem, og kontrollér produktionsplanen.
Selve projektet omfatter:
- Kontrol af abonnement. Kontrollér, at MRPeasy-abonnementet omfatter API-adgang, og opret API-nøgle og secret.
- Mapping. Fastlæg mappingtabellen, reglerne for dataejerskab, de brugerdefinerede felter til tilbageskrivning og rapporteringskanalen.
- Første indlæsning. Varer, enheder, BOM’er, ruter, arbejdsstationsgrupper, arbejdsstationer og kalendere.
- Synkronisering af ordrer og indkøbsordrer. Inkrementel polling efter status med håndtering af 429.
- Opsætning af begrænsninger i SkyPlanner. Omstillingstidsmatrix, værktøjer, antal operatører og alternative arbejdsstationer.
- Tilbageskrivning. Færdiggørelsesfrister og brugerdefinerede felter på hver Manufacturing Order.
- Paralleltest. Kør SkyPlanner sideløbende med den nuværende produktionsplan, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når data stemmer overens.
Det skal du tage højde for i en MRPeasy-integration
- Tidsfelterne hedder noget forskelligt i brugerfladen og API’et. Brugerfladens Setup time, Cycle time og Capacity svarer til
fixed_time,variable_timeogvariable_quantityi API’et. En Capacity over 1 betyder batchbehandling, som i en ovn. Map det som en batchopgave, ikke som en længere cyklustid. - Grupper af typen Passive processing. Tørre- og kølegrupper kører 24/7 uden kapacitetsbegrænsninger. Map dem som ventetider, ikke som arbejdsstationer med begrænset kapacitet.
- Kalendere mangler i v1.
work-centersreturnerer kuncenter_id,type_id,codeogtitle. Brug v2, eller vedligehold skiftehold i SkyPlanner. - Stilstandstid. Arbejdsstationens stilstandstid omfatter vedligeholdelse og driftsstop. Synkronisér den, ellers planlægger SkyPlanner arbejde på en maskine, der står stille.
- Ruter henviser til grupper. MRPeasy vælger den maskine, der har bedst tilgængelighed. I SkyPlanner bliver gruppens arbejdsstationer til reelle alternativer, som planlægningsmotoren vælger imellem.
MRPeasy-integrationen: Hvem står for opsætning og support?
Arbejdet omfatter mapping af dine ruter, arbejdsstationsgrupper og ordreflow samt opsætning af de begrænsninger, som MRPeasy ikke indeholder: omstillingsmatrix, værktøjer, antal operatører og alternative ressourcer.
- SkyPlanner-teamet sætter integrationen op under onboarding og yder support efter idriftsættelsen. Hver fabrik bruger MRPeasy på sin egen måde, og den viden indgår i opsætningen. MRPeasys support dækker ikke API-arbejde, så det er vigtigt, at ét team har ansvaret for integrationen.
- Din MRPeasy-konsulent eller integrationspartner kan bygge integrationen. I et gennemført MRPeasy-projekt forbandt en integrationspartner de to systemer via begge systemers REST API’er. SkyPlanner stiller REST API, Swagger/OpenAPI-dokumentation og webhooks til rådighed.
- Dine egne udviklere kan bygge videre på integrationen med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. Du finder produktdokumentation, herunder indkøbsordrer og API’et til produkter og materialer, i SkyPlanners dokumentation.
SkyPlanner koster fra 199 € om måneden med 5 arbejdsstationer inkluderet og månedlig fakturering. Du får på forhånd et tilbud på integrationen ud fra dine processer og behov sammen med dit abonnement, så du kender den samlede pris, før du går i gang. Se priser og funktioner, og læs sammenligningen med MRPeasys egen planlægningsfunktion i artiklen om produktionsplanlægning i MRPeasy, der tager højde for den faktiske maskin- og personalekapacitet. Du finder overblikket på MRPeasy-siden og andre ERP-systemer i oversigten over ERP-integrationer.
Produktionsvirksomheders erfaringer med SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-regneark til produktionsoptimering i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
6 månederfrem kan salgsafdelingen se ledig kapacitet
“SkyPlanner giver et solidt og pålideligt grundlag for al produktionsplanlægning.”
Anu Järvinen, produktionschef
Fredman Operations · Emballagepapir til fødevarer
Salgsafdelingen kan se ledig kapacitet seks måneder frem, og forespørgsler om ændringer i produktionsplanen, som før tog en time eller mere, bliver besvaret på få sekunder.
Ofte stillede spørgsmål
Har MRPeasy et API, og hvilket abonnement skal jeg bruge?
Ja. MRPeasy tilbyder et REST API til betalende konti på Unlimited-abonnementet. v1 er i drift, og v2 er under udvikling. Godkendelse sker via HTTP Basic med en API-nøgle og secret fra Settings → Integration → API access.
Kan SkyPlanner skrive produktionsplanen tilbage til MRPeasy?
Ja. SkyPlanner opdaterer hver Manufacturing Order via PUT /manufacturing-orders/{id} og skriver leveringsdatoen samt brugerdefinerede felter for planlagt start, planlagt afslutning og fremdrift. Den detaljerede rækkefølge af operationer ligger i SkyPlanner, hvor operatørerne arbejder ud fra deres egen opgavekø.
Sender MRPeasy ændringer i realtid?
API-specifikationerne beskriver ingen webhook-hændelser for produktionsordrer, så SkyPlanner henter åbne ordrer efter status med få minutters mellemrum. SkyPlanners egne webhooks sender ændringer i produktionsplanen, så snart de sker.
Hvem bygger MRPeasy-integrationen?
SkyPlanner-teamet sætter tovejsintegrationen op under onboarding og yder support efter idriftsættelsen. Din MRPeasy-konsulent, en integrationspartner eller dine egne udviklere kan også bygge videre på SkyPlanners dokumenterede REST API.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med CSV-import fra MRPeasy, uanset hvilket MRPeasy-abonnement du har. Der kræves intet kreditkort. Start prøveperioden, eller kontakt salg for at afklare integrationens omfang.
