Guide till MRPeasy-integration för produktionsplanering med SkyPlanner APS

MRPeasy är en molnprodukt utan lokalt installerade versioner, så alla kunder använder samma API. Det finns två versioner:

1. REST API v1 (OpenAPI 1.0, server https://api.mrpeasy.com/rest/v1) är det API som används i drift. Det omfattar /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units och produktionsrapporter som /report/production/operations.
2. REST API v2 (OpenAPI 2.0.0, server https://api.mrpeasy.com/rest/v2) befinner sig i ett tidigt utvecklingsskede. Där tillkommer /workstation-groups med work_hours och holidays, /workstations med productivity och idle, /inventory, /stock-movement samt PATCH. Tillverkningsorder hanteras fortfarande i v1.

Var uppmärksam på benämningarna. Workstation group i MRPeasys gränssnitt motsvarar work-center-types i v1 (type_id). Workstation motsvarar work-centers (center_id). Operationerna i en operationsföljd hänvisar till en grupp via type_id, inte till en maskin.

API:et ingår i MRPeasys Unlimited-abonnemang för betalande konton. MRPeasy skriver också: ”Our Support Department cannot help you using the API.” (Vår supportavdelning kan inte hjälpa dig att använda API:et.) Därför måste någon ansvara för integrationen: SkyPlanner, er MRPeasy-konsult eller er utvecklare. SkyPlanner-teamet tar hand om just det arbetet under införandet.

På MRPeasys prissida anges ”API, webhooks (for paid accounts)” (API, webhooks för betalande konton), men specifikationerna för v1 och v2 dokumenterar inga webhook-händelser för tillverkningsorder. Integrationen hämtar därför uppdateringar från MRPeasy genom inkrementell polling:

• Tillverkningsorder filtreras på Not scheduled (15), Scheduled (20), In progress (30) och Paused (35).
• Inköpsorder och lagersaldon hämtas enligt ett schema eller före varje planeringskörning.
• Grunddata hämtas vid ändringar eller varje natt.

Sekventiell polling med filtrering håller sig med god marginal under gränsen på 100 anrop per 10 sekunder. I andra riktningen skickar SkyPlanners egna webhooks planändringar så snart de sker. Återskrivningen är alltså händelsestyrd.

1. Första inläsningen av grunddata. Hämta artiklar, enheter, BOM och operationsföljder från v1 samt produktionsgrupper och deras grupperingar från v1 eller v2. Hämta kalendrar från /workstation-groups i v2 (work_hours, holidays) eller ange skift direkt i SkyPlanner. Mappa varje grupp av typen Active processing group till en gruppering i SkyPlanner med de tillhörande produktionsgrupperna som medlemmar.

2. Ordersynkronisering. Läs in öppna tillverkningsorder med deras operationer samt öppna inköpsorder och lagersaldon. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered. Vid varje omplanering kontrolleras både lagersaldon och inkommande inköp.

3. Återskrivning av planen. PUT /manufacturing-orders/{id} stöder code, quantity, due_date och assigned_id samt anpassade fält i form av custom_<id>. Där det är överenskommet skriver SkyPlanner planerat slut till due_date. Planerad start, planerat slut och status skrivs till anpassade fält i MRPeasy. Försäljning och inköp kan då se den faktiska planen i MRPeasy. Den detaljerade operationsföljden och tilldelningen av produktionsgrupp per operation finns i SkyPlanner, som visar körplanen för verkstadsgolvet.

4. Order som skapas utanför MRPeasy. Om order någon gång skapas via API:et accepterar POST /manufacturing-orders parametrarna no_scheduling och no_bookings. Använd dem så att MRPeasy inte bokar produktionsgrupper som SkyPlanner redan planerar.

5. Återrapportering från verkstadsgolvet. Operatörerna registrerar arbete med SkyPlanner Mobile Confirmations, Production Timer eller Quick Log Mode, och tidsregistreringarna håller planen uppdaterad. Välj en rapporteringskanal. Om MRPeasys Internet-kiosk och SkyPlanner används parallellt för samma operationer skapas två versioner av sanningen.

6. Dataansvar och konfliktregler. Dokumentera dem före driftstart:

Flöde för konstruktion mot order. I ett genomfört MRPeasy-projekt blir varje kundprojekt en huvudprodukt och ett till tre halvfabrikat. Varje produkt har en egen BOM och operationsföljd i MRPeasy, och tillverkningsordern finns i båda systemen. Behåll en stabil, gemensam identifierare på varje order så att uppdateringar aldrig skapar dubbletter.

• Tidsfälten skiljer sig mellan gränssnitten. Gränssnittets fält Setup time, Cycle time och Capacity motsvaras av fixed_time, variable_time och variable_quantity i API:et. Capacity över 1 innebär batchbearbetning, som i en ugn. Mappa det som en batchoperation, inte som en längre cykel.
• Grupper för passiv bearbetning. Grupper för torkning och kylning körs 24/7 utan kapacitetsbegränsningar. Mappa dem som väntetider, inte som produktionsgrupper med begränsad kapacitet.
• Kalendrar saknas i v1. work-centers returnerar bara center_id, type_id, code och title. Använd v2 eller underhåll skiften i SkyPlanner.
• Stilleståndstid. I produktionsgruppens Idle time registreras underhåll och driftstopp. Synkronisera dessa uppgifter, annars planerar SkyPlanner in arbete på en maskin som står still.
• Operationsföljder hänvisar till grupper. MRPeasy väljer den maskin som har bäst tillgänglighet. I SkyPlanner blir gruppens produktionsgrupper faktiska alternativ som planeringsmotorn väljer mellan.