Guide til MRPeasy-integrasjon for produksjonsplanlegging med SkyPlanner APS

MRPeasy er ett skyprodukt uten lokalt installerte versjoner, så alle kunder bruker samme API. Det finnes to versjoner:

1. REST API v1 (OpenAPI 1.0, server https://api.mrpeasy.com/rest/v1) er API-et som brukes i produksjon. Det omfatter /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units og produksjonsrapporter som /report/production/operations.
2. REST API v2 (OpenAPI 2.0.0, server https://api.mrpeasy.com/rest/v2) er i en tidlig utviklingsfase. Denne versjonen legger til /workstation-groups med work_hours og holidays, /workstations med productivity og idle, /inventory, /stock-movement og PATCH. Produksjonsordrer håndteres fortsatt i v1.

Vær oppmerksom på navnene. En Workstation group i MRPeasy-grensesnittet tilsvarer work-center-types i v1 (type_id). En Workstation tilsvarer work-centers (center_id). Operasjonene i en produksjonsrute peker til en gruppe via type_id, ikke til en maskin.

API-et er inkludert i MRPeasys Unlimited-abonnement for betalende kontoer. MRPeasy opplyser også: «Our Support Department cannot help you using the API.» (Brukerstøtten vår kan ikke hjelpe deg med å bruke API-et.) Integrasjonen må derfor ha en ansvarlig: SkyPlanner, MRPeasy-konsulenten din eller utvikleren din. Det er nettopp dette arbeidet SkyPlanner-teamet tar seg av under innføringen.

MRPeasys prisside oppgir «API, webhooks (for paid accounts)» (API og webhooks for betalende kontoer), men spesifikasjonene for v1 og v2 dokumenterer ingen webhook-hendelser for produksjonsordrer. Integrasjonen henter derfor endringer fra MRPeasy med inkrementell polling:

• Produksjonsordrer filtrert på statusene Not scheduled (15), Scheduled (20), In progress (30) og Paused (35).
• Innkjøpsordrer og lagerbeholdning til faste tider eller før hver planleggingskjøring.
• Grunndata ved endringer eller hver natt.

Sekvensiell, filtrert polling holder seg godt innenfor grensen på 100 forespørsler per 10 sekunder. I motsatt retning sender SkyPlanners egne webhooks planendringer idet de skjer. Tilbakeskrivingen er dermed hendelsesstyrt.

1. Førstegangsinnlasting av grunndata. Hent varer, enheter, BOM-er og produksjonsruter fra v1, og arbeidsstasjonsgrupper og arbeidsstasjoner fra v1 eller v2. Hent kalendere fra v2 /workstation-groups (work_hours, holidays), eller sett opp skift direkte i SkyPlanner. Koble hver Active processing-gruppe til en arbeidsstasjonsgruppe i SkyPlanner, med gruppens arbeidsstasjoner som medlemmer.

2. Ordresynkronisering. Les inn åpne produksjonsordrer med tilhørende operasjoner, samt åpne innkjøpsordrer og lagerbeholdning. SkyPlanner regner bestilt materiale som tilgjengelig på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Ved hver omplanlegging kontrolleres både lagerbeholdningen og innkommende innkjøp.

3. Tilbakeskriving av planen. PUT /manufacturing-orders/{id} støtter code, quantity, due_date og assigned_id, samt egendefinerte felt som custom_<id>. SkyPlanner skriver planlagt slutt til due_date der det er avtalt, og planlagt start, planlagt slutt og fremdrift til egendefinerte felt i MRPeasy. Da ser salg og innkjøp den faktiske planen i MRPeasy. Den detaljerte operasjonsrekkefølgen og arbeidsstasjonen for hver operasjon ligger i SkyPlanner, som er visningen for arbeidsfordeling i produksjonen.

4. Ordrer opprettet utenfor MRPeasy. Hvis ordrer opprettes via API-et, godtar POST /manufacturing-orders parameterne no_scheduling og no_bookings. Bruk dem slik at MRPeasy ikke reserverer arbeidsstasjoner som SkyPlanner allerede planlegger.

5. Registreringer fra produksjonsgulvet. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations, Production Timer eller Quick Log Mode, og tidsregistreringene holder planen oppdatert. Velg én rapporteringskanal. Hvis MRPeasys Internet-kiosk og SkyPlanner brukes parallelt for de samme operasjonene, får dere to versjoner av sannheten.

6. Regler for eierskap og konflikthåndtering. Dokumenter dem før driftsstart:

Arbeidsflyt ved konstruksjon mot ordre. I ett levert MRPeasy-prosjekt blir hvert kundeprosjekt til et hovedprodukt og ett til tre halvfabrikater. Hvert av dem har sin egen BOM og produksjonsrute i MRPeasy, og produksjonsordren finnes i begge systemer. Bruk en stabil, felles identifikator på hver ordre, slik at oppdateringer aldri oppretter duplikater.

• Tidsfeltene er ulike i brukergrensesnittet og API-et. Feltene Setup time, Cycle time og Capacity i brukergrensesnittet heter fixed_time, variable_time og variable_quantity i API-et. Capacity over 1 betyr satsvis behandling, som i en ovn. Modeller dette som en satsjobb, ikke som en lengre syklus.
• Grupper for passiv bearbeiding. Grupper for tørking og kjøling kjører 24/7 uten kapasitetsbegrensninger. Modeller dem som ventetider, ikke som arbeidsstasjoner med begrenset kapasitet.
• Kalendere mangler i v1. work-centers returnerer bare center_id, type_id, code og title. Bruk v2, eller vedlikehold skiftene i SkyPlanner.
• Stillstandstid. Arbeidsstasjonens stillstandstid omfatter vedlikehold og driftsstans. Synkroniser denne informasjonen, ellers planlegger SkyPlanner arbeid på en maskin som står stille.
• Produksjonsruter viser til grupper. MRPeasy velger maskinen med best tilgjengelighet. I SkyPlanner blir arbeidsstasjonene i gruppen reelle alternativer som planleggingsmotoren velger mellom.