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

A Fulcrum egységes, több-bérlős felhőszolgáltatás, így minden ügyfél ugyanazt az API-t használja. A fejlesztői portál így írja le a nyilvános API célját: “REST API calls directly into your Fulcrum site.” (REST API-hívások közvetlenül az Ön Fulcrum-környezetébe.)

• Specifikáció. OpenAPI “Fulcrum PublicAPI” v1, letölthető innen: https://api.fulcrumpro.com/swagger/v1/swagger.json. A Fulcrum azt javasolja, hogy ebből generáljon típusos klienst. A History oldal dátumokkal együtt sorolja fel az összes változást.
• Kiszolgálók. A standard környezetek címe https://api.fulcrumpro.com. Az ITAR-környezetek az api.fulcrumpro.us címet használják; az ITAR-tokenekkel a .com kiszolgáló 401-es választ ad.
• Hívási minta. A listák lekérésére POST .../list hívások szolgálnak, a kérés törzsében megadott szűrővel. A lapozást a Skip és a Take, a rendezést a Sort.Field / Sort.Dir vezérli. Sok objektum támogatja a PUT-ot, a gyártási feladatok pedig a JSON Patch-et is.

A gyártásütemezési integráció az alábbi végpontokat használja:

A Fulcrum saját integrációs oldala egyértelműen fogalmaz az elvégzendő munkáról: “Every system is a little bit different and requires some configuration.” (Minden rendszer egy kicsit más, és igényel némi konfigurálást.) A SkyPlanner csapata pontosan ezt a konfigurálást vállalja át a bevezetés során.

A Fulcrum támogatja a webhookokat, amelyeket egy rendszergazda állít be. 2026 szeptemberétől a hibás webhookok működése szünetel, és a rendszer naponta teszteli őket újra ahelyett, hogy vég nélkül próbálkozna. Az API History olyan eseményeket sorol fel, mint a PurchaseOrderUpdated és az ItemUpdated.

Az integráció a következőképpen olvassa ki a Fulcrum adatait:

• A nyitott gyártási feladatokat néhány percenként kérdezi le, scheduled és inProgress állapotra szűrve, hasIncompleteOperations: true feltétellel. Ezt a szűrőt maga a Fulcrum adja meg az ütemezési oldalán megjelenő adatok lekéréséhez.
• A beszerzési rendeléseket és a készletadatokat minden ütemezési futtatás előtt, vagy – ha be van állítva – a PurchaseOrderUpdated webhook hatására kérdezi le.
• A cikkeket, a technológiai útvonalakat, a berendezéseket és a műszakokat változáskor vagy éjszakánként kéri le.

A másik irányban a SkyPlanner saját webhookjai azonnal továbbítják az ütemezés változásait, így a visszaírás eseményvezérelt.

1. A törzsadatok kezdeti betöltése. Kérje le a cikkeket, anyagokat, technológiai útvonalakat, munkaállomásokat és berendezéseket, majd a részlegek műszakjait és az állásidőket. A Fulcrum minden munkaállomásából egy SkyPlanner-munkaállomás-csoport lesz, amelynek tagjai az adott munkaállomás berendezései. A technológiai útvonal egyes műveleteihez kiválasztott berendezések határozzák meg az adott művelethez engedélyezett munkaállomásokat. Az Unlimited Capacity beállítású berendezések, például a kemencék és a festőkabinok kötegelt gyártási feladatokként jelennek meg.

2. Rendelések szinkronizálása. Olvassa be a nyitott gyártási feladatokat a gyártandó tételeikkel és műveleteikkel együtt, valamint 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 rendelés Delivered állapotot kap. A rendszer minden újraütemezéskor ellenőrzi a készletet és a beérkező beszerzéseket.

3. Az ütemterv visszaírása. A Fulcrum maga számítja ki a scheduledStartUtc, scheduledEndUtc és scheduledEquipmentId értékeit, és csak olvasható formában adja vissza őket. A műveletek frissítésekor a customFields is megadható. A SkyPlanner minden gyártási feladat minden műveleténél egyéni mezőkbe írja a tervezett kezdést, a tervezett befejezést és a munkaállomást. A gyártási feladat tervezett befejezését a feladat egyik egyéni mezőjébe írja. Az értékesítés és a beszerzés így a Fulcrumban, a gyártási feladatnál látja a SkyPlanner által megadott dátumokat.

4. Üzemi visszajelentések. A gépkezelők a Mobile Confirmations, a Production Timer vagy a Quick Log Mode használatával rögzítik a munkát a SkyPlannerben. A SkyPlanner a /api/job-tracking-timers/start és a /stop végponton keresztül küldi el az időadatokat a Fulcrumnak, vagy lezárt időblokként a /api/timers végponton. A mennyiségeket az add-quantity-completed, a végleges darabszámot és a selejtet pedig a complete végponton továbbítja. Így a Fulcrumban a gyártási feladatok költségszámítása naprakész marad.

5. Adatgazdai és ütközéskezelési szabályok. A Fulcrum ütemezője „dictates the order of operations in Job Tracking.” (meghatározza a műveletek sorrendjét a Job Trackingben). Ezért minden művelethez egyetlen feladatkiadási csatornát válasszon: a SkyPlanner gépkezelői feladatsorát vagy a Fulcrum Job Trackinget. Az éles indulás előtt rögzítse írásban a szabályokat:

• A létszám a műszakonkénti korlátban jelenik meg. A Fulcrum műszakonkénti Max Equipment értéke „is usually determined by how many people you have working in a certain area at that time.” (általában attól függ, hogy az adott időpontban hányan dolgoznak az adott területen). A név szerinti gépkezelőket és műszakjaikat a SkyPlannerben kell beállítani. A neveket a /api/users felhasználói adatai biztosítják.
• Az ütemezés berendezésekre történik. A Fulcrum munkaállomásai egymással helyettesíthető berendezések csoportjai. A technológiai útvonalon pontosan adja meg a választható berendezéseket, mert az ütemezőmotor ezek közül választ.
• A gyártási rendelések gyártási feladatokat fognak össze. Egy gyártási rendelés több gyártási feladat műveleteit csoportosítja, például egy közös táblakiosztáshoz. Ha egy csoportosított műveleten indít időmérést, ehelyett a gyártási rendelés időmérője indul el, amely a csoport összes gyártási műveletére kiterjed.
• Az időmérés korlátai. Az utólag rögzített /api/timers időblokkokra ez a szabály vonatkozik: „may not be in the future, older than 30 days, or longer than 7 days.” (nem eshetnek a jövőbe, és sem a koruk, sem a hosszuk nem lépheti túl a megadott korlátot). Az időadatokat akkor továbbítsa, amikor a gépkezelők rögzítik őket.
• Az időformátumok eltérnek. A műszakok helyi idő szerinti HHmm értékeket használnak, az állásidők és az ütemezett időpontok UTC szerint szerepelnek, a becsült műveleti idők pedig másodpercben érkeznek.
• A berendezés frissítése a teljes rekordot lecseréli. A berendezésre küldött PUT kérés minden olyan mezőt töröl, amelyet nem tartalmaz. A SkyPlanner csak olvassa a berendezésadatokat, soha nem írja őket.
• ITAR-környezetek. Használja a .us hosztot és egy ITAR-tokent.