Integrációk / ERP / JobBOSS²
JobBOSS² integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez
Ez az integrációs útmutató bemutatja a partnereknek és az informatikai csapatoknak, hogyan kapcsolható össze az ECI JobBOSS² rendszere a SkyPlanner APS-sel. A SkyPlanner és a JobBOSS² között kétirányú az integráció, amely az ECI saját API-jait használja:
- A SkyPlannerbe kerülnek az Orders, Order Line Items, Order Routings, Estimates, Routings, Work Centers, Employees, Company Calendar és Job Requirements objektumok, valamint az anyagok és a beszerzési rendelések tételei.
- A tervezett kezdési és befejezési dátumok visszakerülnek az egyes Order Routing lépésekhez.
- Igény szerint a gépkezelők időráfordítási adatai is visszaírhatók Time Ticket Details formájában.
- A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A SkyPlanner csapata a bevezetés során az Ön JobBOSS²-konfigurációjához igazítja az integrációt, és az éles indulás után is támogatja azt. Ez az útmutató azoknak a partnereknek és fejlesztőknek szól, akik részt kívánnak venni a munkában, vagy maguk szeretnének a SkyPlanner dokumentált REST API-jára építeni (API-referencia). Egy amerikai bérgyártó üzem már pontosan ezt tette:
A JobBOSS² integrációs interfészei
Az ECI az ECI gyártási API-dokumentációs oldalán teszi közzé gyártási API-jait és azok OpenAPI-specifikációit. Az ütemezéshez két API lényeges:
- JobBOSS² API (v1). Kifejezetten a JobBOSS²-höz készült, REST- és JSON-alapú API. Olvassa és írja a rendeléseket, az Order Line Items, Order Routings, Estimates, Routings, Job Requirements, Work Centers, Company Calendar, Employees, Time Tickets és Time Ticket Details objektumokat, valamint az anyagokat és a beszerzési rendeléseket. Az ECI tájékoztatása szerint: “is currently only supported for JobBOSS² hosted (Cloud) customers.” (Jelenleg csak a hosztolt, felhőalapú JobBOSS² ügyfelei számára támogatott.)
- ECI ERP API (v2.1). Termékfüggetlen REST API a Deacom, az M1 és a JobBOSS² rendszerekhez. A JobBOSS² esetében a gyártási feladatokat, azok műveleteit és anyagait, a cikkeket és műveleteiket, a munkaállomásokat, a beszerzési rendelések tételeit és a munkaidő-nyilvántartás sorait kezeli. Az ECI megjegyzése szerint: “the actual ERP database could be a cloud hosted ERP or on premises install,” (az ERP tényleges adatbázisa lehet felhőben vagy helyben telepítve), ezért a helyben telepített JobBOSS²-höz ezt az API-t kell használni.
Mindkét API ugyanazokat a konvenciókat követi: használhatók például a lastModDate[gte]= típusú szűrőkifejezések, a fields= paraméter és a sort=, a lapozáshoz pedig a take és a skip. A take alapértelmezett értéke 200. “All dates submitted to the API are assumed to be in UTC.” (Az API a beküldött dátumokat UTC szerinti időpontként kezeli.)
Az ECI mindkettőre vonatkozó szabálya: “All APIs must be activated by ECI before use.” (Használat előtt minden API-t az ECI-nek kell aktiválnia.) Ezt időben kérje az ECI kapcsolattartójától.
Hitelesítés és hozzáférés
- API-felhasználók. Az integráció az ECI Integration Engine Management Console felületén létrehozott API-felhasználót használja. Ez határozza meg, hogy a hívások melyik terméket, ügyfelet és adatbázist érik el.
- OAuth 2.0 klienshitelesítő adatok. A kliensazonosítóval és a hozzá tartozó titkos kulccsal az Authentication API tokenvégpontján kérhető token. Ezután minden hívás elküldi az
Authorization: Bearer [token]fejlécet. - Jogosultsági kör. Az API-felhasználónak csak az alábbi megfeleltetési táblázat szerinti erőforrásokhoz adjon hozzáférést, semmi máshoz.
A SkyPlanner oldalán a REST API API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja Swagger/OpenAPI formátumú. Az integrációs útmutató végigvezeti az első hívásokon.
Események és időszakos lekérdezés
Egyik ECI API dokumentációja sem ír le webhookokat. A JobBOSS² adatait időszakos lekérdezéssel kell átvenni: a lastModDate alapján szűrje az Order Line Items, az Order Routings és a beszerzési rendelések tételeit az utolsó futás óta történt változásokra, majd lapozzon a take és a skip segítségével. A gyakoriságot üzemenként kell beállítani: a gyártási feladatoknál néhány percenkénti, a készletnél óránkénti lekérdezés is alkalmazható.
A SkyPlanner webhookot küld, ha megváltozik az állapot vagy az ütemterv, így a visszaírás eseményvezérelt.
Adatmegfeleltetés
| JobBOSS²-objektum (JobBOSS² API-erőforrás) | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
Estimates (/estimates), anyagok (/materials) | Termékek, anyagok, termékstruktúra | JobBOSS² → SkyPlanner | Kezdeti betöltés, majd változáskor |
Routings (/routings): munkaállomás, átállási idő, ciklusidő, csapatlétszám, a gyártási feladathoz tartozó gépek | Műveletek időtartammal és átállási idővel | JobBOSS² → SkyPlanner | Kezdeti betöltés, majd változáskor |
Work Centers (/work-centers): műszakonkénti óraszám, működés az 1–3. műszakban, munkanapok | Munkaállomások, munkaállomás-csoportok, hatékonysági értékek | JobBOSS² → SkyPlanner | Kezdeti betöltés, utána ritkán |
Company Calendar (/company-calendars), Employees (/employees) | Műszakok, munkamentes napok, személyzet | JobBOSS² → SkyPlanner | Naponta, vagy saját műszakok kezelése a SkyPlannerben |
Orders és Order Line Items (/order-line-items): gyártási feladat száma, határidő, prioritás, gyártandó mennyiség | Rendelések határidővel és prioritással | JobBOSS² → SkyPlanner | Lekérdezés néhány percenként |
Order Routings (/order-routings): a gyártási feladat lépései, állapot, hátralévő órák | Gyártási feladatok műveletenként | JobBOSS² → SkyPlanner | Lekérdezés néhány percenként |
Job Requirements (/job-requirements), beszerzési rendelések tételei (/purchase-order-line-items) | Anyagszükséglet, beszerzési rendelések szállítási dátum szerint | JobBOSS² → SkyPlanner | Lekérdezés óránként vagy az ütemezés futtatásakor |
Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Tervezett kezdés és befejezés, gép és gépkezelő műveletenként | SkyPlanner → JobBOSS² | Az ütemterv változásakor, SkyPlanner-webhookkal |
| Time Ticket Details (POST): gyártási feladat, művelet, munkaállomás, dolgozó, átállási idő, ciklusidő, elkészült és selejtes darabszám, kezdési és befejezési idő | Időráfordítási adatok és gépkezelői visszajelentések | SkyPlanner → JobBOSS² | Visszajelentésenként vagy műszakonként, ha ezt választják |
| Nincs a JobBOSS²-ben | Átállásiidő-mátrix, szerszámok korlátozott kapacitású erőforrásként, alternatív gépek és dolgozók | A SkyPlannerben karbantartva | Beállítás a bevezetés során |
Helyben telepített JobBOSS² esetén ugyanezek az objektumok az ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers és /purchase-order-lines erőforrásain keresztül olvashatók be, az időráfordítási adatok pedig a /timecard-lines végpontra küldhetők.
Integrációs minták
1. A törzsadatok kezdeti betöltése. Olvassa be az Estimates, Routings, Work Centers, Company Calendar és Employees objektumokat, valamint az anyagokat. Gondosan tervezze meg a munkaállomások megfeleltetését: egy négy esztergából álló munkaállomásból egy munkaállomás-csoport vagy négy munkaállomás lesz, így a SkyPlanner minden gépre külön ütemez.
2. A gyártási feladatok szinkronizálása. Olvassa be a nyitott Order Line Items objektumokat a hozzájuk tartozó Order Routings és Job Requirements objektumokkal, valamint a nyitott beszerzési rendelések tételeivel együtt. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumától tekinti elérhetőnek, és a rendelés Delivered állapotba kerülésekor frissíti a készletet. A felfüggesztett és lezárt gyártási feladatokat hagyja ki.
3. Az ütemterv visszaírása. Amikor az ütemezőmotor elhelyez vagy áthelyez egy műveletet, egy SkyPlanner-webhook PATCH-kérést indít a /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber} végpontra. Ez UTC szerint beállítja az estimatedStartDate és az estimatedEndDate értékét, továbbá a workCenter és az employeeCode értékét is, ha a SkyPlanner másik géphez vagy dolgozóhoz rendelte a műveletet. A dátumok azokhoz a műveletekhez kerülnek, amelyeket a Whiteboard, a Planning Board és a Scheduling Advisor már megjelenít.
4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével rögzítik a munkát, az időráfordítási adatok pedig naprakészen tartják az ütemtervet. Ön dönti el, hogy a tényleges idők visszakerüljenek-e a JobBOSS²-be. Ha igen, minden visszajelentésből egy Time Ticket Detail lesz, amely tartalmazza az átállási időt, a ciklusidőt és a darabszámot. Ha nem, az adatgyűjtés a JobBOSS²-ben marad, a SkyPlanner pedig az Order Routings objektumokból olvassa be az előrehaladást.
5. Adatgazdák és ütközéskezelési szabályok. Rögzítse ezeket az éles indulás előtt:
| Adatok | Adatgazda |
|---|---|
| Estimates, Routings, mennyiségek, határidők, gyártási feladat állapota | JobBOSS² |
| Műveleti sorrend, kezdési és befejezési idők, gép és gépkezelő műveletenként | SkyPlanner |
| Átállásiidő-mátrix, szerszám- és gépkezelői igények, alternatív erőforrások | SkyPlanner |
| Műszakok és munkamentes napok | Egyetlen rendszer, amelyet a felmérés során választanak ki |
| Munkaidőbizonylatok, anyagkiadások, bevételezések, költségszámítás | JobBOSS², ott rögzítve vagy a SkyPlanner időráfordítási adataiból átvéve |
Jelöljön ki egyetlen rendszert a műveleti dátumok írására. A SkyPlanner az általa ütemezett gyártási feladatoknál kiváltja a Whiteboardban végzett átütemezést: a tervezők a SkyPlannerben helyezik át a munkát, a dátumok pedig átkerülnek a JobBOSS²-be.
A projekt jellemző lépései
A megvalósítás általában a bevezetés megkezdésétől számított néhány héten belül lezárul. Előtte ellenőrizze az ütemtervet a 30 napos ingyenes próbaidőszakban, a JobBOSS²-ből CSV- vagy Excel-formátumban exportált Work Centers, technológiai útvonalak és nyitott gyártási feladatok adataival.
- Adatmegfeleltetés. Véglegesítse a megfeleltetési táblázatot, az adatgazdákra vonatkozó szabályokat és a szinkronizálás gyakoriságát, valamint döntse el, hogy az integráció visszaírja-e a munkaidőbizonylatokat.
- ECI-hozzáférés. Kérje meg az ECI-t a JobBOSS² API vagy az ERP API aktiválására és az API-felhasználó létrehozására. Ha rendelkezésre áll tesztvállalat, azon végezze el a teszteket.
- Kezdeti adatbetöltés. Estimates, Routings, Work Centers, naptár és munkatársak.
- Gyártási feladatok és beszerzési rendelések szinkronizálása. Rendszeres lekérdezés
lastModDateszűrőkkel, lapozással és újrapróbálkozásokkal. - Korlátok beállítása a SkyPlannerben. Átállásiidő-mátrix, szerszámok, gyártási feladatonkénti kezelői létszám, valamint alternatív gépek vagy munkatársak.
- Az ütemterv visszaírása. A SkyPlanner webhookjai által indított Order Routing PATCH hívások, valamint igény esetén Time Ticket Details.
- Párhuzamos tesztelés. Használja a SkyPlannert a jelenlegi tervezőtábla mellett, hasonlítsa össze a dátumokat, és javítsa a törzsadatokat.
- Éles indulás. Ha az adatok egyeznek, kapcsolja be a visszaírást.
Mire kell felkészülni a JobBOSS² integrációjánál?
- Szolgáltatónál vagy helyben üzemeltetett rendszer. A JobBOSS² API a szolgáltatónál üzemeltetett rendszerek ügyfeleit szolgálja ki. A helyi telepítések az ERP API-t használják, amelynek eltér az erőforráslistája. Az 1. lépésben döntse el, melyik kapcsolódási módot használják.
- Mindenhol UTC. Az API UTC szerint olvassa és írja az időpontokat. Váltsa át őket az üzem helyi idejére, különben a 7:00-s kezdés rossz időpontra kerül.
- Mi rejlik a munkaállomások mögött? Egy munkaállomás lehet gép, gépcsoport, gyártócella vagy munkatársak csoportja. A technológiai útvonal egyes műveleteinél megadott gépszám és csapatlétszám alapján tudja a SkyPlanner, hogy a művelet hány erőforrást igényel.
- Külső szolgáltatások. Azok a műveletek, amelyekhez munkaállomás helyett beszállító tartozik, az átfutási időt növelik, nem a saját kapacitást terhelik. Modellezze őket kizárólag időt igénylő műveletként.
- Átfedő és felügyelet nélküli műveletek. A technológiai útvonal műveleteinél jelölhető, hogy átfedéssel vagy felügyelet nélkül végezhetők. Mindkét jelölést vigye át, hogy a rendszer helyesen tervezze a felügyelet nélküli gyártást.
- Időegységek. Az átállási időnek és a ciklusidőnek saját mértékegysége van, a sorban állási idő pedig várakozás, nem gépidő. Importáláskor végezze el az átváltást, különben minden időtartam hibás lesz.
- Lapozás. Egy oldal alapértelmezés szerint 200 rekordot tartalmaz. Minden lekérdezésnél használjon lapozást.
Ki állítja be és támogatja a JobBOSS² integrációját?
- A SkyPlanner csapata a bevezetés során beállítja az integrációt, az éles indulás után pedig támogatást nyújt hozzá, az egyeztetett erőforrások és lekérdezési szabályok szerint. Minden üzem másképp használja a JobBOSS² rendszert; ezt a helyi tudást itt építjük be.
- Az Ön JobBOSS²-partnere is részt vehet a munkában. A partner ismeri a rendszer beállításait, és a SkyPlanner csapatával együttműködve egyeztethet az ECI-vel az API aktiválásáról és az API-felhasználó létrehozásáról.
- Saját fejlesztői is továbbfejleszthetik az integrációt a SkyPlanner REST API-ján keresztül, API-token használatával. Az induláshoz elég egy API-token, a SkyPlanner csapata pedig szükség esetén segít. További részleteket a SkyPlanner integrációs dokumentációjában talál.
A SkyPlanner havonta 199 €-tól érhető el, havi számlázással, 5 munkaállomással. Az integrációra a választott csomaggal együtt, előzetesen adunk árajánlatot az Ön folyamatai és igényei alapján. Tekintse meg az árakat, a JobBOSS² termelésütemezési lehetőségeit, a JobBOSS² oldalát, a SkyPlanner funkcióit és az ERP-integrációk áttekintését.
A SkyPlannert használó gyártóvállalatok
2 hmegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatok helyett már valós időben optimalizáljuk a gyártásunkat.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolótáblák és kapcsolóberendezések
A gyártástervezéssel hetente 2 munkaórát takarítanak meg, és az új feladatsor másodpercek alatt eljut a gyártósorra.
+90%gyártási hatékonyság
„A gyártás hatékonysága 90%-kal nőtt.”
Abdul Rucyinga, informatikai vezető
Laboratory & Allied · Gyógyszergyártás
A gyártás hatékonysága 90%-kal nőtt, és az összes munkaállomásra kiterjedő, háromhavi optimalizált terv kevesebb mint 30 perc alatt elkészül.
Több 1 000automatikusan ütemezett gyártási rendelés
„Egészen másképp tartjuk kézben a gyártást, és teljesen más szinten látjuk át a kapacitásunkat.”
Hannu Ryynänen, vezérigazgató
Mamec · Ipari keverők, szivattyúk és csúcstechnológiai bérgyártás
Gyártási rendelések ezreit ütemezik automatikusan, miközben az egész szervezet valós idejű képet kap a gyártásról.
98%szállítási határidők betartása a korábbi mintegy 50% helyett
„A SkyPlanner döntő szerepet játszik abban, hogy tartani tudjuk a szállítási határidőket.”
Hannu Lahtinen, ügyvezető igazgató
KJH-Comp · Lemezmegmunkálás és bérgyártás
A határidőre teljesített szállítások aránya mintegy 50%-ról egészen 98%-ig emelkedett, és az ütemezéshez ma már két művezető helyett egy is elég.
Gyakori kérdések
Van API a JobBOSS² rendszerhez?
Igen. Az ECI a JobBOSS² API-t és a termékfüggetlen ERP API-t teszi elérhetővé; mindkettő REST-alapú, OpenAPI-specifikációval. A szolgáltatónál üzemeltetett rendszerek ügyfelei számára a JobBOSS² API rendelések, Order Routings, Estimates, Work Centers, beszerzési rendelések és Time Tickets olvasását és írását teszi lehetővé.
Hogyan hitelesíti magát az integráció a JobBOSS² felé?
OAuth 2.0 client credentials használatával. Az ECI aktiválja az API-t, az API-felhasználót az Integration Engine Management Console felületén hozzák létre, és minden hívás Bearer tokent tartalmaz.
Támogatja a JobBOSS² a webhookokat?
Az ECI API-dokumentációja nem ismertet webhookokat, ezért az integráció üzemenként beállított gyakorisággal, lastModDate szűrőkkel kérdezi le a JobBOSS² adatait. A SkyPlanner saját webhookjai azonnal továbbítják az ütemterv változásait.
Hogyan kerülnek vissza a tervezett időpontok a JobBOSS² rendszerbe?
Gyártási műveletenként. A SkyPlanner PATCH hívással frissíti az egyes Order Routing rekordok estimatedStartDate és estimatedEndDate mezőit, valamint a workCenter és employeeCode mezőket is, ha a művelet másik géphez vagy kezelőhöz került.
Az ECI APS-t vagy a SkyPlannert ajánlja egy JobBOSS²-partner?
A SkyPlannert, ha az ügyfél heteken belül szeretne több erőforrást kezelő termelésütemezést használni. Az ECI APS külön kiegészítő, amely a LYNQ technológiájára épül. A SkyPlanner az ECI saját JobBOSS² API-ján keresztül kapcsolódik, megtervezi az átállásokat, a csapatok, a befogókészülékek és az anyagok használatát, automatikusan újraütemez, és havonta 199 €-tól érhető el.
Kipróbálhatjuk a SkyPlannert az integráció kiépítése előtt?
Igen. A 30 napos ingyenes próba során legfeljebb 20 munkaállomást használhat, a JobBOSS² adatait pedig CSV- vagy Excel-fájlból importálhatja. Bankkártya nem szükséges. Indítsa el a próbát, vagy egyeztessen értékesítőinkkel az integráció felméréséhez.
