Integrácie / ERP / JobBOSS²
Sprievodca integráciou JobBOSS² na rozvrhovanie výroby v SkyPlanner APS
Tento sprievodca integráciou JobBOSS² ukazuje partnerom a IT tímom, ako prepojiť JobBOSS² od ECI so SkyPlanner APS. SkyPlanner sa s JobBOSS² prepája obojsmerne prostredníctvom vlastných API spoločnosti ECI:
- Do SkyPlanner sa načítavajú Orders a Order Line Items, Order Routings, Estimates, Routings a materiály, Work Centers, Employees, Company Calendar, Job Requirements a riadky nákupných objednávok.
- Plánované dátumy začiatku a konca sa zapisujú späť do každého kroku Order Routing.
- Ak si to zvolíte, časové záznamy operátorov sa môžu zapisovať späť ako Time Ticket Details.
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas úvodného nasadenia prispôsobí integráciu vášmu nastaveniu JobBOSS² a poskytuje jej podporu aj po spustení ostrej prevádzky. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami vyvíjať riešenia s využitím zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API). Jedna americká firma so zákazkovou výrobou to už urobila:
Integračné rozhrania JobBOSS²
ECI zverejňuje svoje API pre výrobu vrátane špecifikácií OpenAPI na stránke dokumentácie ECI Manufacturing API. Pre rozvrhovanie sú dôležité dve:
- JobBOSS² API (v1). Rozhranie využívajúce REST a JSON, určené výhradne pre JobBOSS². Umožňuje čítať a zapisovať objednávky, Order Line Items, Order Routings, Estimates, Routings, materiály, Job Requirements, Work Centers, Company Calendar, Employees, nákupné objednávky, Time Tickets a Time Ticket Details. ECI uvádza, že rozhranie „is currently only supported for JobBOSS² hosted (Cloud) customers.“ (v súčasnosti je podporované len pre zákazníkov s hostovaným JobBOSS² v cloude).
- ECI ERP API (v2.1). REST API nezávislé od konkrétneho produktu, určené pre Deacom, M1 a JobBOSS². V JobBOSS² pokrýva zákazky, operácie zákaziek, materiály zákaziek, diely, operácie dielov, pracoviská, riadky nákupných objednávok a riadky pracovných výkazov. ECI poznamenáva, že „the actual ERP database could be a cloud hosted ERP or on premises install,“ (samotná databáza ERP môže byť hostovaná v cloude alebo nainštalovaná lokálne), preto sa toto rozhranie používa pre lokálne inštalácie JobBOSS².
Obe API používajú rovnaké konvencie: filtrovacie výrazy ako lastModDate[gte]=, parameter fields=, sort= a stránkovanie pomocou take a skip, pričom predvolená hodnota take je 200. „All dates submitted to the API are assumed to be in UTC.“ (Všetky dátumy odoslané do API sa považujú za dátumy v UTC.)
Pre obe rozhrania platí pravidlo ECI: „All APIs must be activated by ECI before use.“ (Všetky API musí pred použitím aktivovať ECI.) Obráťte sa preto včas na svojho obchodného zástupcu ECI.
Autentifikácia a prístup
- Používatelia API. Integrácia používa používateľský účet API vytvorený v Integration Engine Management Console od ECI. Tento účet určuje, ku ktorému produktu, zákazníkovi a databáze budú volania smerovať.
- Klientske prihlasovacie údaje OAuth 2.0. Pomocou ID klienta a tajného kľúča sa získa token z tokenového endpointu Authentication API. Každé volanie potom odosiela
Authorization: Bearer [token]. - Rozsah oprávnení. Používateľovi API povoľte prístup len k prostriedkom potrebným podľa mapovacej tabuľky nižšie, k žiadnym ďalším.
Na strane SkyPlanner sa REST API autentifikuje pomocou API tokenu (SkyPlanner Settings > API) a je zdokumentované vo formáte Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Udalosti a pravidelné načítavanie
Ani jedno z API spoločnosti ECI nemá zdokumentované webhooky. Údaje z JobBOSS² sa načítavajú pravidelne: Order Line Items, Order Routings a riadky nákupných objednávok filtrujte podľa lastModDate od posledného spustenia a stránkujte pomocou take a skip. Frekvencia sa nastavuje pre každý výrobný podnik osobitne, od niekoľkých minút pri zákazkách až po hodinový interval pri zásobách.
SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis je riadený udalosťami.
Mapovanie dát
| Objekt JobBOSS² (prostriedok JobBOSS² API) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
Estimates (/estimates), materiály (/materials) | Produkty, materiály, štruktúra produktu | JobBOSS² → SkyPlanner | Úvodné načítanie, potom pri zmene |
Routings (/routings): pracovisko, čas nastavenia, čas cyklu, veľkosť tímu, stroje pre operáciu | Kroky procesu s trvaním a časmi nastavenia | JobBOSS² → SkyPlanner | Úvodné načítanie, potom pri zmene |
Work Centers (/work-centers): počet hodín na zmenu, prevádzka na zmenách 1 až 3, pracovné dni | Pracoviská, skupiny pracovísk, efektívnosť | JobBOSS² → SkyPlanner | Úvodné načítanie, potom len zriedka |
Company Calendar (/company-calendars), Employees (/employees) | Pracovné zmeny, nepracovné dni, personál | JobBOSS² → SkyPlanner | Denne alebo vlastná správa zmien v SkyPlanner |
Orders a Order Line Items (/order-line-items): číslo zákazky, termín dodania, priorita, množstvo na výrobu | Objednávky s termínmi dodania a prioritami | JobBOSS² → SkyPlanner | Načítavanie každých pár minút |
Order Routings (/order-routings): kroky zákazky, stav, zostávajúce hodiny | Operácie pre jednotlivé kroky procesu | JobBOSS² → SkyPlanner | Načítavanie každých pár minút |
Job Requirements (/job-requirements), riadky nákupných objednávok (/purchase-order-line-items) | Materiálové potreby, nákupné objednávky podľa dátumu dodania | JobBOSS² → SkyPlanner | Načítavanie každú hodinu alebo pri spustení rozvrhovania |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Plánovaný začiatok a koniec, stroj a operátor pre každý krok | SkyPlanner → JobBOSS² | Pri zmene rozvrhu cez webhook SkyPlanner |
| Time Ticket Details (POST): zákazka, krok, pracovisko, zamestnanec, čas nastavenia, čas cyklu, počet dokončených a nepodarkových kusov, čas začiatku a konca | Časové záznamy a potvrdenia operátorov | SkyPlanner → JobBOSS² | Pri každom potvrdení alebo za každú zmenu, ak si to zvolíte |
| Nie je v JobBOSS² | Matica časov prestavenia, nástroje ako zdroje s obmedzenou kapacitou, alternatívne stroje a personál | Spravuje sa v SkyPlanner | Nastavenie počas úvodného nasadenia |
Pri lokálnej inštalácii JobBOSS² sa tie isté objekty načítavajú cez prostriedky ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers a /purchase-order-lines. Časové záznamy sa zapisujú do /timecard-lines.
Integračné postupy
1. Úvodné načítanie kmeňových dát. Načítajte Estimates, Routings, materiály, Work Centers, Company Calendar a Employees. Mapovanie pracovísk si dôkladne premyslite: pracovisko so štyrmi sústruhmi sa zmení na jednu skupinu pracovísk alebo štyri pracoviská, aby SkyPlanner rozvrhoval prácu na každom stroji.
2. Synchronizácia zákaziek. Načítajte otvorené Order Line Items spolu s ich Order Routings, Job Requirements a otvorenými riadkami nákupných objednávok. SkyPlanner považuje objednaný materiál za dostupný v deň dodania nákupnej objednávky a aktualizuje zásoby, keď je objednávka označená stavom Delivered. Pozastavené a uzavreté zákazky vynechajte.
3. Spätný zápis rozvrhu. Keď plánovací algoritmus zaradí alebo presunie krok, webhook SkyPlanner spustí požiadavku PATCH na /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Nastaví estimatedStartDate a estimatedEndDate v UTC. Ak SkyPlanner presunul krok na iný stroj alebo ho priradil inému pracovníkovi, nastaví aj workCenter a employeeCode. Dátumy sa zapíšu ku krokom zákazky, ktoré už zobrazujú Whiteboard, Planning Board a Scheduling Advisor.
4. Potvrdzovanie práce vo výrobe. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer a časové záznamy udržiavajú rozvrh aktuálny. Vy rozhodujete, či sa skutočné časy zapíšu späť do JobBOSS². Ak áno, z každého potvrdenia vznikne Time Ticket Detail s časom nastavenia, časom cyklu a počtom kusov. Ak nie, zber dát zostáva v JobBOSS² a SkyPlanner načítava priebeh z Order Routings.
5. Pravidlá vlastníctva dát a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Vlastník |
|---|---|
| Estimates, Routings, množstvá, termíny dodania, stav zákazky | JobBOSS² |
| Poradie krokov, časy začiatku a konca, stroj a operátor pre každý krok | SkyPlanner |
| Matica časov prestavenia, požiadavky na nástroje a operátorov, alternatívne zdroje | SkyPlanner |
| Pracovné zmeny a nepracovné dni | Jeden systém zvolený pri definovaní rozsahu |
| Pracovné výkazy, výdaj materiálu, príjemky, kalkulácia nákladov | JobBOSS², s priamym zadávaním alebo zápisom z časových záznamov SkyPlanner |
Na zápis dátumov krokov zákazky určte jeden systém. Pri zákazkách, ktoré rozvrhuje SkyPlanner, nahrádza zmeny rozvrhu vo Whiteboard. Plánovači preto presúvajú prácu v SkyPlanner a dátumy sa prenášajú do JobBOSS².
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku úvodného nasadenia. Ešte predtým si overte rozvrh počas 30-dňového bezplatného skúšobného obdobia s údajmi Work Centers, technologickými postupmi a otvorenými zákazkami exportovanými z JobBOSS² do CSV alebo Excelu.
- Mapovanie. Dohodnite mapovaciu tabuľku, pravidlá vlastníctva dát, frekvencie synchronizácie a to, či sa pracovné výkazy budú zapisovať späť.
- Prístup od ECI. Požiadajte ECI o aktiváciu JobBOSS² API alebo ERP API a vytvorenie používateľa API. Ak máte k dispozícii testovaciu spoločnosť, testujte na nej.
- Úvodné načítanie. Estimates, Routings, Work Centers, kalendár a zamestnanci.
- Synchronizácia zákaziek a nákupných objednávok. Pravidelné dopytovanie s filtrami
lastModDate, stránkovaním a opakovanými pokusmi. - Nastavenie obmedzení v SkyPlanner. Matica časov prestavenia, nástroje, počty operátorov na operáciu a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu. Volania PATCH pre Order Routing spúšťané webhookmi SkyPlanner a prípadne aj zápis Time Ticket Details, ak si túto možnosť zvolíte.
- Paralelné testovanie. Používajte SkyPlanner súbežne so súčasnou plánovacou tabuľou, porovnávajte termíny a opravte kmeňové dáta.
- Spustenie do ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii JobBOSS²
- Hostované alebo lokálne nasadenie. JobBOSS² API je určené zákazníkom s hostovaným riešením. Lokálne inštalácie používajú ERP API, ktoré má odlišný zoznam zdrojov. Spôsob pripojenia si ujasnite v kroku 1.
- Všade UTC. API číta aj zapisuje čas v UTC. Prepočítajte ho na miestny čas závodu, inak sa začiatok o 7:00 nastaví na nesprávny čas.
- Čo sa skrýva za pracoviskom. Pracovisko môže predstavovať stroj, skupinu strojov, výrobnú bunku alebo ľudí. Počet strojov a veľkosť tímu pri každom kroku technologického postupu určujú, koľko zdrojov daný krok v SkyPlanner potrebuje.
- Externé služby. Kroky, ktoré majú namiesto pracoviska dodávateľa, ovplyvňujú priebežnú dobu výroby, nie vašu kapacitu. Modelujte ich ako kroky, ktoré zaberajú iba čas.
- Prekrývanie krokov a práca bez obsluhy. Kroky technologického postupu môžu mať príznak prekrývania alebo chodu bez obsluhy. Prenášajte oba príznaky, aby sa práca bez obsluhy plánovala správne.
- Časové jednotky. Časy nastavenia a časy cyklu majú vlastné jednotky. Čas vo fronte znamená čakanie, nie strojový čas. Pri importe jednotky prepočítajte, inak budú všetky trvania nesprávne.
- Stránkovanie. Predvolená stránka obsahuje 200 záznamov. Pri každom čítaní používajte stránkovanie.
Kto nastavuje integráciu JobBOSS² a poskytuje podporu
- Tím SkyPlanner integráciu nastaví počas zavádzania a poskytuje podporu aj po spustení do ostrej prevádzky, v dohodnutom rozsahu prostriedkov API a podľa dohodnutých pravidiel dopytovania. Každý výrobný podnik používa JobBOSS² inak a práve pri tomto nastavení sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner pre JobBOSS². Pozná vaše nastavenie a spolu s tímom SkyPlanner môže s ECI zabezpečiť aktiváciu API a vytvorenie používateľa API.
- Integráciu môžu ďalej rozvíjať aj vaši vývojári cez REST API systému SkyPlanner s tokenom API. Na začiatok stačí token API a tím SkyPlanner v prípade potreby pomôže. Dokumentáciu nájdete v dokumentácii integrácií SkyPlanner.
Cena SkyPlanner sa začína na 199 € mesačne a zahŕňa 5 pracovísk s mesačnou fakturáciou. Cenovú ponuku integrácie dostanete vopred spolu s ponukou predplatného podľa vašich procesov a potrieb. Pozrite si cenník, plánovanie výroby s JobBOSS² so zohľadnením reálnych kapacít strojov a pracovníkov, stránku JobBOSS², funkcie SkyPlanner a prehľad integrácií ERP.
Výrobcovia, ktorí používajú SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme pri plánovaní výroby prešli od excelových tabuliek k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista na dodávateľský reťazec
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby šetrí každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa dostane na linku v priebehu sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90%.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90% a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
1 000 a viacautomaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou úplne inak a náš prehľad o kapacitách je na celkom inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky náročná zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
98%spoľahlivosť dodávok, nárast z približne 50%
„SkyPlanner zohráva rozhodujúcu úlohu pri udržiavaní spoľahlivosti našich dodávok.“
Hannu Lahtinen, výkonný riaditeľ
KJH-Comp · Spracovanie plechov a zákazková výroba
Spoľahlivosť dodávok vzrástla z približne 50% až na 98% a na rozvrhovanie teraz stačí jeden majster namiesto dvoch.
Často kladené otázky
Má JobBOSS² rozhranie API?
Áno. ECI poskytuje JobBOSS² API a produktovo nezávislé ERP API. Obe rozhrania sú REST API so špecifikáciami OpenAPI. JobBOSS² API umožňuje zákazníkom s hostovaným riešením čítať a zapisovať objednávky, Order Routings, Estimates, Work Centers, nákupné objednávky a Time Tickets.
Ako sa integrácia autentifikuje v JobBOSS²?
Pomocou klientskych prihlasovacích údajov OAuth 2.0. ECI aktivuje API, v Integration Engine Management Console sa vytvorí používateľ API a každé volanie obsahuje token Bearer.
Podporuje JobBOSS² webhooky?
Dokumentácia rozhraní API od ECI neuvádza žiadne webhooky. Integrácia preto pravidelne dopytuje JobBOSS² s filtrami lastModDate podľa intervalu nastaveného pre konkrétny výrobný podnik. Vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Ako sa plánované termíny zapisujú späť do JobBOSS²?
Samostatne pre každý krok operácie. SkyPlanner aktualizuje každý Order Routing volaním PATCH s poľami estimatedStartDate a estimatedEndDate. Ak sa krok presunul na iný stroj alebo k inému operátorovi, pridá aj workCenter a employeeCode.
Má partner pre JobBOSS² odporučiť ECI APS alebo SkyPlanner?
SkyPlanner, ak chce zákazník v priebehu niekoľkých týždňov spustiť plánovanie výroby, ktoré zohľadňuje reálnu kapacitu viacerých zdrojov. ECI APS je samostatný doplnok založený na LYNQ. SkyPlanner sa pripája cez vlastné JobBOSS² API od ECI, plánuje prestavby, pracovné tímy, prípravky aj materiál a automaticky preplánováva výrobu. Jeho cena sa začína na 199 € mesačne.
Môžeme SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk a importy CSV alebo Excel zo systému JobBOSS². Platobnú kartu nepotrebujete. Spustite skúšobnú verziu alebo kontaktujte obchodný tím, aby ste spoločne definovali rozsah integrácie.
