MRPeasy-integrációs útmutató a SkyPlanner APS rendszerrel végzett gyártásütemezéshez

Az MRPeasy egységes felhőalapú termék, helyben telepíthető változata nincs, így minden ügyfél ugyanazt az API-t használja. Két verzió létezik:

1. A REST API v1 (OpenAPI 1.0, szerver: https://api.mrpeasy.com/rest/v1) az éles használatra szolgáló API. Elérhetők benne a /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots és /units végpontok, valamint gyártási jelentések, például a /report/production/operations.
2. A REST API v2 (OpenAPI 2.0.0, szerver: https://api.mrpeasy.com/rest/v2) a fejlesztés korai szakaszában van. Újdonságai a /workstation-groups végpont a work_hours és holidays mezőkkel, a /workstations végpont a productivity és idle mezőkkel, továbbá az /inventory, a /stock-movement és a PATCH támogatása. A gyártási rendelések továbbra is a v1-en érhetők el.

Ügyeljen az elnevezésekre. Az MRPeasy felületén látható Workstation group a v1-ben a work-center-types objektumnak felel meg (type_id). A Workstation megfelelője a work-centers (center_id). A technológiai útvonal műveletei a type_id mezőn keresztül egy csoportra hivatkoznak, nem egy gépre.

Az API az MRPeasy Unlimited csomagjában érhető el, fizető fiókok számára. Az MRPeasy azt is kijelenti: “Our Support Department cannot help you using the API.” (Ügyfélszolgálatunk nem tud segítséget nyújtani az API használatához.) Az integrációnak ezért felelősre van szüksége: ez lehet a SkyPlanner, az Ön MRPeasy-tanácsadója vagy fejlesztője. A bevezetés során a SkyPlanner csapata pontosan ezt a munkát vállalja.

Az MRPeasy árakat ismertető oldalán szerepel az “API, webhooks (for paid accounts)” (API és webhookok fizető fiókok számára), de sem a v1, sem a v2 specifikációja nem dokumentál webhookeseményeket a gyártási rendelésekhez. Az integráció ezért rendszeres, inkrementális lekérdezésekkel olvassa az MRPeasy adatait:

• A gyártási rendeléseket a Not scheduled (15), Scheduled (20), In progress (30) és Paused (35) állapotokra szűrve.
• A beszerzési rendeléseket és a készletadatokat meghatározott időközönként vagy minden ütemezési futtatás előtt.
• A törzsadatokat változáskor vagy éjszakánként.

A sorosan végzett, szűrt lekérdezések száma jóval a 10 másodpercenkénti 100 kéréses korlát alatt marad. A másik irányban a SkyPlanner saját webhookjai azonnal továbbítják az ütemterv változásait, így a visszaírás eseményvezérelt.

1. A törzsadatok kezdeti betöltése. Kérje le a cikkeket, mértékegységeket, darabjegyzékeket és technológiai útvonalakat a v1-ből, a munkaállomás-csoportokat és munkaállomásokat pedig a v1-ből vagy a v2-ből. A naptárakat vegye át a v2 /workstation-groups végpontjáról (work_hours, holidays), vagy állítsa be a műszakokat közvetlenül a SkyPlannerben. Minden Active processing csoportnak feleltessen meg egy SkyPlanner-munkaállomás-csoportot, amelynek tagjai az adott csoport munkaállomásai.

2. Rendelések szinkronizálása. Olvassa be a nyitott gyártási rendeléseket a műveleteikkel együtt, továbbá a nyitott beszerzési rendeléseket és a készletadatokat. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumától tekinti elérhetőnek, a készletet pedig akkor frissíti, amikor a beszerzési rendelés Delivered állapotba kerül. Minden újraütemezéskor ellenőrzi mind a készletet, mind a várható beszerzéseket.

3. Az ütemterv visszaírása. A PUT /manufacturing-orders/{id} támogatja a code, quantity, due_date és assigned_id mezőket, valamint a custom_<id> formátumú egyéni mezőket. Ha erről született megállapodás, a SkyPlanner a tervezett befejezést a due_date mezőbe írja, a tervezett kezdést, a tervezett befejezést és az előrehaladást pedig az MRPeasy egyéni mezőibe. Így az MRPeasy rendszerben dolgozó értékesítők és beszerzők is a valós ütemtervet látják. A részletes műveleti sorrend és az egyes műveletekhez rendelt munkaállomás a SkyPlannerben található; az üzem ebből a nézetből követheti a kiadott feladatokat.

4. Az MRPeasy rendszerén kívül létrehozott rendelések. Ha API-n keresztül is hoznak létre rendeléseket, a POST /manufacturing-orders fogadja a no_scheduling és a no_bookings paramétereket. Használja ezeket, hogy az MRPeasy ne foglalja le azokat a munkaállomásokat, amelyeket már a SkyPlanner ütemez.

5. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations, a Production Timer vagy a Quick Log Mode segítségével rögzítik az elvégzett munkát, az időbejegyzések pedig naprakészen tartják az ütemtervet. Válasszon egyetlen visszajelentési csatornát. Ha ugyanazokat a műveleteket párhuzamosan rögzítik az MRPeasy Internet-kiosk és a SkyPlanner rendszerében, két eltérő nyilvántartás jön létre.

6. Adatgazdák és ütközéskezelési szabályok. Rögzítse ezeket az éles indulás előtt:

Rendelésre tervezés és gyártás. Egy már megvalósított MRPeasy-projektben minden ügyfélprojekthez egy főtermék és egy–három félkész termék tartozik. Mindegyiknek saját darabjegyzéke és technológiai útvonala van az MRPeasy rendszerben, a gyártási rendelés pedig mindkét rendszerben szerepel. Minden rendeléshez rendeljen állandó, közös azonosítót, hogy a frissítések soha ne hozzanak létre duplikátumokat.

• Az időadatok mezői felületenként eltérnek. A felhasználói felület Setup time, Cycle time és Capacity mezőinek az API-ban a fixed_time, variable_time és variable_quantity felel meg. Az 1 feletti Capacity érték kötegelt feldolgozást jelent, például egy kemencében. Ezt kötegelt gyártási feladatként képezze le, ne hosszabb ciklusként.
• Passive processing csoportok. A szárítási és hűtési csoportok 24/7 működnek, kapacitáskorlát nélkül. Várakozási időként képezze le őket, ne korlátozott kapacitású munkaállomásként.
• A v1 nem tartalmaz naptárakat. A work-centers csak a center_id, type_id, code és title mezőket adja vissza. Használja a v2 verziót, vagy tartsa karban a műszakokat a SkyPlanner rendszerben.
• Állásidő. A munkaállomás állásideje tartalmazza a karbantartásokat és a leállásokat. Szinkronizálja ezt is, különben a SkyPlanner leállított gépre is ütemez munkát.
• A technológiai útvonalak csoportokra hivatkoznak. Az MRPeasy a rendelkezésre állás alapján legkedvezőbb gépet választja ki. A SkyPlanner rendszerben a csoport munkaállomásai tényleges alternatívák, amelyek közül az ütemezőmotor választ.