Průvodce integrací JobBOSS² pro rozvrhování výroby se SkyPlanner APS
Tento průvodce integrací JobBOSS² ukazuje partnerům a IT týmům, jak propojit JobBOSS² od ECI se SkyPlanner APS. SkyPlanner se s JobBOSS² propojuje obousměrně prostřednictvím vlastních API společnosti ECI:
- Do SkyPlanner se načítají Orders a Order Line Items, Order Routings, Estimates, Routings a materiály, Work Centers, Employees, Company Calendar, Job Requirements a řádky nákupních objednávek.
- Plánované termíny zahájení a dokončení se zapisují zpět do každého kroku Order Routing.
- Pokud se tak rozhodnete, mohou se časové záznamy operátorů zapisovat zpět jako Time Ticket Details.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění nastaví integraci podle vaší konfigurace JobBOSS² a po spuštění ostrého provozu zajišťuje její podporu. Tento průvodce je určen partnerům a vývojářům, kteří se chtějí zapojit nebo sami vytvořit řešení s využitím zdokumentovaného REST API SkyPlanner (referenční dokumentace API). Přesně to už udělala jedna americká firma se zakázkovou výrobou:
Integrační rozhraní JobBOSS²
ECI zveřejňuje svá API pro výrobu včetně specifikací OpenAPI na webu Dokumentace výrobních API ECI. Pro rozvrhování výroby jsou důležitá dvě:
- JobBOSS² API (v1). Využívá REST a JSON a je určeno přímo pro JobBOSS². Umožňuje číst a zapisovat zakázky, 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ádí, že „is currently only supported for JobBOSS² hosted (Cloud) customers.“ (v současnosti je podporováno pouze pro zákazníky s hostovaným JobBOSS² v cloudu).
- ECI ERP API (v2.1). REST API nezávislé na konkrétním produktu, určené pro Deacom, M1 a JobBOSS². U JobBOSS² pokrývá zakázky, operace zakázek, materiály zakázek, díly, operace dílů, pracoviště, řádky nákupních objednávek a řádky časových výkazů. ECI uvádí, že „the actual ERP database could be a cloud hosted ERP or on premises install,“ (samotná databáze ERP může být hostována v cloudu nebo provozována lokálně), takže toto rozhraní je cestou k integraci lokálně provozovaného JobBOSS².
Obě API používají stejné konvence: filtrovací výrazy, například lastModDate[gte]=, parametr fields=, sort= a stránkování pomocí take a skip, přičemž výchozí hodnota take je 200. „All dates submitted to the API are assumed to be in UTC.“ (Všechna data a časy odeslané do API se považují za údaje v UTC.)
Pro obě rozhraní platí pravidlo ECI: „All APIs must be activated by ECI before use.“ (Všechna API musí před použitím aktivovat ECI.) Obraťte se proto včas na svého obchodního zástupce ECI.
Autentizace a přístup
- Uživatelé API. Integrace používá uživatelský účet API vytvořený v konzoli Integration Engine Management Console společnosti ECI. Tento účet určuje, ke kterému produktu, zákazníkovi a databázi budou volání směřovat.
- OAuth 2.0 client credentials. Pomocí ID klienta a tajného klíče získáte token na tokenovém endpointu Authentication API. Každé volání pak odesílá
Authorization: Bearer [token]. - Rozsah oprávnění. Uživateli API udělte přístup pouze k prostředkům potřebným podle níže uvedené mapovací tabulky a k žádným dalším.
Na straně SkyPlanner se REST API autentizuje pomocí API tokenu (SkyPlanner Settings > API) a je zdokumentováno ve Swagger/OpenAPI. Prvními voláními vás provede návod k integraci.
Události a pravidelné dotazování
Ani jedno API společnosti ECI nemá zdokumentované webhooky. Data z JobBOSS² se získávají pravidelným dotazováním: Order Line Items, Order Routings a řádky nákupních objednávek filtrujte podle lastModDate od posledního spuštění a stránkujte pomocí take a skip. Interval se nastavuje pro každý provoz zvlášť, od několika minut u zakázek po hodinu u skladových zásob.
SkyPlanner odesílá webhooky při změně stavu nebo rozvrhu, takže zpětný zápis se řídí událostmi.
Mapování dat
| Objekt JobBOSS² (prostředek JobBOSS² API) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
Estimates (/estimates), materiály (/materials) | Produkty, materiály, struktura produktu | JobBOSS² → SkyPlanner | Prvotní načtení, poté při změně |
Routings (/routings): pracoviště, čas seřízení, čas cyklu, velikost týmu, stroje pro zakázku | Kroky technologického postupu s dobou trvání a časy seřízení | JobBOSS² → SkyPlanner | Prvotní načtení, poté při změně |
Work Centers (/work-centers): počet hodin na směnu, provoz ve směnách 1 až 3, pracovní dny | Pracoviště, skupiny pracovišť, efektivita | JobBOSS² → SkyPlanner | Prvotní načtení, poté jen zřídka |
Company Calendar (/company-calendars), Employees (/employees) | Směny, nepracovní dny, pracovníci | JobBOSS² → SkyPlanner | Denně, nebo správa směn ve SkyPlanner |
Orders a Order Line Items (/order-line-items): číslo zakázky, termín dodání, priorita, množství k výrobě | Zakázky s termíny dodání a prioritami | JobBOSS² → SkyPlanner | Dotazování každých několik minut |
Order Routings (/order-routings): kroky zakázky, stav, zbývající hodiny | Operace pro jednotlivé kroky technologického postupu | JobBOSS² → SkyPlanner | Dotazování každých několik minut |
Job Requirements (/job-requirements), řádky nákupních objednávek (/purchase-order-line-items) | Materiálové potřeby, nákupní objednávky podle termínu dodání | JobBOSS² → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
Order Routing: estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Plánované zahájení a dokončení, stroj a operátor pro každý krok | SkyPlanner → JobBOSS² | Při změně rozvrhu prostřednictvím webhooku SkyPlanner |
| Time Ticket Details (POST): zakázka, krok, pracoviště, zaměstnanec, čas seřízení, čas cyklu, počet dokončených a zmetkových kusů, čas zahájení a dokončení | Časové záznamy a potvrzení operátorů | SkyPlanner → JobBOSS² | Při každém potvrzení nebo za směnu, pokud tuto možnost zvolíte |
| V JobBOSS² není | Matice časů seřízení a přechodů, nástroje jako výrobní zdroje s omezenou kapacitou, alternativní stroje a pracovníci | Spravuje se ve SkyPlanner | Nastavení během zavádění |
U lokálně provozovaného JobBOSS² se stejné objekty načítají prostřednictvím prostředků ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers a /purchase-order-lines. Časové záznamy se odesílají do /timecard-lines.
Způsoby integrace
1. Prvotní načtení kmenových dat. Načtěte Estimates, Routings, materiály, Work Centers, Company Calendar a Employees. Pečlivě zvolte mapování pracovišť: z pracoviště se čtyřmi soustruhy vznikne jedna skupina pracovišť nebo čtyři pracoviště, aby SkyPlanner rozvrhoval práci pro každý stroj.
2. Synchronizace zakázek. Načtěte otevřené Order Line Items spolu s jejich Order Routings, Job Requirements a otevřenými řádky nákupních objednávek. SkyPlanner považuje objednaný materiál za dostupný v termínu dodání nákupní objednávky a po jejím označení stavem Delivered aktualizuje skladové zásoby. Pozastavené a uzavřené zakázky vynechte.
3. Zpětný zápis rozvrhu. Když plánovací algoritmus zařadí nebo přesune krok, webhook SkyPlanner spustí požadavek PATCH na /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Ten nastaví estimatedStartDate a estimatedEndDate v UTC. Pokud SkyPlanner přesunul krok na jiný stroj nebo jej přiřadil jinému pracovníkovi, nastaví také workCenter a employeeCode. Termíny se zapíší do kroků zakázky, které už zobrazují Whiteboard, Planning Board a Scheduling Advisor.
4. Potvrzování práce ve výrobě. Operátoři zaznamenávají práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a časové záznamy udržují rozvrh aktuální. Sami si zvolíte, zda se skutečné časy budou zapisovat zpět do JobBOSS². Pokud ano, z každého potvrzení vznikne Time Ticket Detail s časem seřízení, časem cyklu a počtem kusů. Pokud ne, sběr dat zůstává v JobBOSS² a SkyPlanner načítá postup práce z Order Routings.
5. Odpovědnost za data a pravidla řešení konfliktů. Před spuštěním ostrého provozu je písemně stanovte:
| Data | Odpovědný systém |
|---|---|
| Estimates, Routings, množství, termíny dodání, stav zakázky | JobBOSS² |
| Pořadí kroků, časy zahájení a dokončení, stroj a operátor pro každý krok | SkyPlanner |
| Matice časů seřízení a přechodů, požadavky na nástroje a operátory, alternativní výrobní zdroje | SkyPlanner |
| Směny a nepracovní dny | Jeden systém zvolený při vymezení rozsahu |
| Časové výkazy, výdeje materiálu, příjmy, kalkulace nákladů | JobBOSS²; údaje se zadávají přímo v něm nebo se přenášejí z časových záznamů SkyPlanner |
Pro zápis termínů kroků zakázky určete jediný systém. U zakázek rozvrhovaných ve SkyPlanner provádějte změny rozvrhu v tomto systému místo ve Whiteboard. Plánovači tedy přesouvají práci ve SkyPlanner a termíny se přenášejí do JobBOSS².
Obvyklý postup projektu
Implementace bývá dokončena během několika týdnů od zahájení zavádění. Ještě předtím si rozvrh ověřte v rámci 30denního bezplatného zkušebního období s daty Work Centers, technologickými postupy a otevřenými zakázkami exportovanými z JobBOSS² do CSV nebo Excelu.
- Mapování. Stanovte konečnou podobu mapovací tabulky, odpovědnost za data, intervaly synchronizace a to, zda se budou časové výkazy zapisovat zpět.
- Přístup od ECI. Požádejte ECI o aktivaci JobBOSS² API nebo ERP API a vytvoření uživatele API. Pokud máte k dispozici testovací firmu, testujte na ní.
- Počáteční načtení. Estimates, Routings, Work Centers, kalendář a zaměstnanci.
- Synchronizace výrobních a nákupních objednávek. Pravidelné dotazování s filtry
lastModDate, stránkováním a opakováním neúspěšných požadavků. - Nastavení omezení v SkyPlanner. Matice časů seřízení, nástroje, počty pracovníků pro jednotlivé operace a alternativní stroje nebo pracovníci.
- Zpětný zápis rozvrhu. Volání PATCH pro Order Routing spouštěná webhooky SkyPlanner a případně také zápis do Time Ticket Details, pokud jej zvolíte.
- Souběžné testování. Používejte SkyPlanner souběžně se stávající plánovací tabulí, porovnávejte termíny a opravujte kmenová data.
- Spuštění ostrého provozu. Jakmile se data shodují, zapněte zpětný zápis.
S čím počítat při integraci JobBOSS²
- Hostované nebo místní nasazení. JobBOSS² API slouží zákazníkům s hostovaným řešením. Místní instalace používají ERP API, které nabízí jiný seznam prostředků. Způsob připojení si ujasněte v kroku 1.
- Všude UTC. API čte i zapisuje čas v UTC. Převádějte jej na místní čas závodu, jinak se začátek v 7:00 naplánuje na nesprávnou hodinu.
- Co se skrývá pod pracovištěm. Pracoviště může představovat stroj, skupinu strojů, výrobní buňku nebo pracovníky. Podle počtu strojů a velikosti týmu u každé operace technologického postupu SkyPlanner určí, kolik výrobních zdrojů operace potřebuje.
- Kooperace. Operace, které mají místo pracoviště dodavatele, se započítávají do průběžné doby výroby, ale nezatěžují vaši kapacitu. Modelujte je jako operace, které mají pouze dobu trvání.
- Překrývání operací a provoz bez obsluhy. Operace technologického postupu mohou mít příznak, který povoluje jejich překrývání nebo provoz bez obsluhy. Přenášejte oba příznaky, aby se práce bez obsluhy plánovala správně.
- Časové jednotky. Časy seřízení a časy cyklu mají vlastní jednotky. Čas ve frontě znamená čekání, nikoli strojní čas. Při importu jednotky převeďte, jinak budou všechny doby trvání chybné.
- Stránkování. Výchozí stránka obsahuje 200 záznamů. Stránkování používejte při každém čtení.
Kdo nastavuje integraci JobBOSS² a zajišťuje její podporu
- Tým SkyPlanner integraci nastaví při zavádění a po spuštění ostrého provozu zajišťuje její podporu, a to pro dohodnuté prostředky API a podle dohodnutých pravidel pravidelného dotazování. Každý výrobní podnik používá JobBOSS² jinak a právě při nastavení se tyto znalosti uplatní.
- Zapojit se může i váš partner pro JobBOSS². Zná vaše nastavení a společně s týmem SkyPlanner může u ECI zajistit aktivaci API a vytvoření uživatele API.
- Vaši vývojáři mohou integraci dále rozvíjet pomocí REST API systému SkyPlanner a API tokenu. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže. Dokumentaci najdete v dokumentaci integrací SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně za 5 pracovišť s měsíční fakturací. Cenu integrace stanovíme předem podle vašich procesů a potřeb, společně s cenou tarifu. Podívejte se na ceník, plánování výroby pro JobBOSS² s ohledem na skutečnou kapacitu strojů a pracovníků, stránku JobBOSS², funkce SkyPlanner a přehled integrací ERP.
Výrobní firmy, které používají SkyPlanner
2 hušetřené každý týden
„Se SkyPlanner jsme přešli od plánování výroby v excelových tabulkách k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozvaděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová fronta operací se na linku dostane během několika sekund.
+90 %efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
1 000 a víceautomaticky rozvržených výrobních příkazů
„Výrobu máme pod mnohem lepší kontrolou a náš přehled o kapacitách je na zcela jiné úrovni.“
Hannu Ryynänen, generální ředitel
Mamec · Průmyslová míchadla, čerpadla a technologicky náročná zakázková výroba
Tisíce výrobních příkazů se rozvrhují automaticky a celá firma má přehled o výrobě v reálném čase.
98 %včasnost dodávek, nárůst z přibližně 50 %
„SkyPlanner hraje rozhodující roli v tom, že dokážeme udržet včasnost dodávek.“
Hannu Lahtinen, výkonný ředitel
KJH-Comp · Zpracování plechu a zakázková výroba
Včasnost dodávek vzrostla z přibližně 50 % až na 98 % a rozvrhování nyní zvládá jeden mistr místo dvou.
Časté dotazy
Má JobBOSS² API?
Ano. ECI poskytuje JobBOSS² API a ERP API, které není vázané na konkrétní produkt. Obě rozhraní jsou typu REST a mají specifikace OpenAPI. JobBOSS² API umožňuje zákazníkům s hostovaným řešením číst a zapisovat objednávky, Order Routings, Estimates, Work Centers, nákupní objednávky a Time Tickets.
Jak se integrace autentizuje vůči JobBOSS²?
Pomocí přihlašovacích údajů klienta v OAuth 2.0. ECI aktivuje API, v Integration Engine Management Console se vytvoří uživatel API a každé volání obsahuje Bearer token.
Podporuje JobBOSS² webhooky?
Dokumentace API od ECI žádné webhooky neuvádí. Integrace se proto pravidelně dotazuje JobBOSS² s filtry lastModDate v intervalech nastavených pro konkrétní výrobní podnik. Vlastní webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Jak se plánované termíny zapisují zpět do JobBOSS²?
Pro každou operaci zvlášť. SkyPlanner aktualizuje každý Order Routing voláním PATCH s hodnotami estimatedStartDate a estimatedEndDate. Pokud se operace přesunula na jiný stroj nebo k jinému pracovníkovi, přidá také workCenter a employeeCode.
Má partner pro JobBOSS² nabídnout ECI APS, nebo SkyPlanner?
SkyPlanner, pokud chce zákazník během několika týdnů zprovoznit plánování výroby, které zohledňuje skutečnou kapacitu více výrobních zdrojů současně. ECI APS je samostatný doplněk založený na LYNQ. SkyPlanner se připojuje přes vlastní JobBOSS² API od ECI, plánuje přestavby, pracovní týmy, přípravky i materiál a automaticky přeplánovává výrobu. Jeho cena začíná na 199 € měsíčně.
Můžeme SkyPlanner vyzkoušet před vytvořením integrace?
Ano. Bezplatná zkušební verze na 30 dní podporuje až 20 pracovišť a importy z JobBOSS² ve formátu CSV nebo Excel. Platební kartu nepotřebujete. Vyzkoušejte SkyPlanner nebo kontaktujte obchodní tým a domluvte se na vymezení rozsahu integrace.
