Sprievodca integráciou Epicor Kinetic na rozvrhovanie výroby so SkyPlanner APS

Epicor uvádza: „All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.“ (Všetky služby systému Kinetic vrátane podnikových objektov, procesov, zostáv, BAQs a Epicor Functions sú dostupné cez koncové body REST.) Integrácia rozvrhovania stojí na štyroch technológiách Epicor:

1. Kinetic REST API v2 (OData v4). Biznis objekty sú dostupné ako služby s názvami Erp.BO.<Name>Svc. Bežná cesta je /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 je stále dostupné, ale ide o staršiu verziu, preto integráciu postavte na v2. Sady entít a metódy pre vašu verziu si overte v REST Help na adrese /api/help/v2/.
2. Business Activity Queries (BAQ) cez REST. BAQ je dostupný na adrese /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Je to praktický spôsob načítania dát na plánovanie, ktorý v jednom volaní spája JobHead, JobOper, JobMtl, PartWhse a PORel (príklad z komunity).
3. Epicor Functions (EFx). Serverové funkcie, ktoré možno volať na adrese /api/v2/efx/{Company}/{Library}/{Function}. Epicor uvádza, že tieto funkcie „can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.“ (možno spúšťať z viacerých vstupných bodov vrátane BPM, služieb REST, časových plánov a udalostí aplikácie).
4. Direktívy BPM. Method and Data Directives sa spúšťajú pri zmene výrobného príkazu alebo operácie a môžu volať funkciu, ktorá odošle dáta do externého systému.

Pri práci so súbormi zabezpečuje DMT import a exporty BAQ výstupné dáta. Epicor ponúka aj Epicor Automation Studio, ktoré opisuje ako „a low-code app for integration-led automations“ (aplikáciu na automatizáciu prostredníctvom integrácií s minimom programovania). Vyhnite sa priamemu prístupu do databázy: REST, BAQs a funkcie fungujú rovnako pri lokálnom nasadení aj v Kinetic Cloud.

Epicor nemá zdokumentované všeobecné API na odosielanie webhookov, preto sa zmeny zo systému Kinetic dostávajú do SkyPlanner jedným z dvoch spôsobov:

• Na základe udalostí. BPM Data Directive pre JobHead alebo JobOper zavolá funkciu Epicor Function, ktorá odošle zmenenú výrobnú zákazku do REST API systému SkyPlanner.
• Pravidelné dopytovanie. BAQ s filtrom podľa dátumu zmeny sa spúšťa každých pár minút alebo každú hodinu. Tento spôsob sa jednoduchšie spravuje aj obnovuje po zlyhaní.

V opačnom smere SkyPlanner odosiela zmeny stavu a rozvrhu prostredníctvom webhookov. Prijíma ich váš middleware alebo koncový bod EFx a zapisuje ich do systému Kinetic.

1. Úvodné načítanie kmeňových dát. Načítajte diely, skupiny zdrojov, zdroje, spôsobilosti, kalendáre a zamestnancov. Zo zdrojov v Kinetic vytvorte pracoviská v SkyPlanner a zo skupín zdrojov vytvorte skupiny pracovísk. Pri načítaní veľkého objemu dát použite stránkovanie pomocou $top a $skip alebo dáta načítajte hromadne cez BAQ.

2. Synchronizácia zákaziek. Odosielajte uvoľnené a potvrdené výrobné zákazky spolu s ich operáciami a materiálmi. Celú stromovú štruktúru zákazky načítajte pomocou GetDatasetForTree alebo BAQ, nie po jednotlivých entitách. Nepotvrdené výrobné zákazky MRP ponechajte v Kinetic, kým nebudú potvrdené. Spolu so skladovými zásobami synchronizujte aj otvorené dodávky nákupných objednávok a ich termíny dodania. SkyPlanner považuje objednaný materiál za dostupný v deň dodania a aktualizuje zásoby, keď sa nákupná objednávka označí stavom Delivered. Pri rozvrhovaní tak kontroluje skladové zásoby aj očakávané dodávky z nákupu.

3. Spätný zápis rozvrhu. Webhook systému SkyPlanner odosiela plánovaný začiatok, koniec a pracovisko každej operácie do endpointu EFx (/api/v2/efx/{Company}/{Library}/{Function}). Funkcia zapisuje údaje cez rozvrhovací mechanizmus systému Kinetic. Ide o ten istý biznis objekt, ktorý zabezpečuje rozvrhovanie v Job Entry aj na rozvrhovacích tabuliach (príklad z komunity):

1. ScheduleEngine.GetNewParamsForJob vytvorí pre výrobnú zákazku dátovú sadu rozvrhovacieho mechanizmu.
2. Funkcia nastaví číslo výrobnej zákazky, poradové čísla zostavy a operácie a plánovaný dátum a čas začiatku. Potom zavolá ScheduleEngine.MoveJobItem.
3. Ak SkyPlanner umiestnil operáciu na iný zdroj v skupine, ScheduleEngine.ChangeResource ju naň presunie. Samotné volanie MoveJobItem ponechá predvolený zdroj skupiny.
4. Funkcia uzamkne rozvrh výrobnej zákazky (JobHead.SchedLocked, voľba Lock v Job Entry), takže Global Scheduling zachová termíny zo SkyPlanner.

Ak tieto volania zabalíte do jednej funkcie Epicor Function, zápis pre každú výrobnú zákazku zostane atómový a môžete pridať vlastnú validáciu. Ak závod uprednostňuje riešenie bez vlastnej funkcie, rovnakú postupnosť možno vykonať priamymi volaniami REST na Erp.BO.ScheduleEngineSvc. Nikdy nezapisujte priamo do ResourceTimeUsed ani do dátumových polí JobOper: obišli by ste tým rozvrhovací mechanizmus a pridelenia na rozvrhovacích tabuliach by prestali zodpovedať rozvrhu.

4. Odvádzanie výroby. Operátori zaznamenávajú prácu v SkyPlanner pomocou funkcií Mobile Confirmations, Production Timer alebo Quick Log Mode. Každý uzavretý časový záznam sa cez Erp.BO.LaborSvc zapíše do Kinetic ako odvedená práca: pre priebežné zaznamenávanie sa používajú StartActivity a EndActivityByEmp, pre dodatočné záznamy Labors s Update. Ak sa vo vašom závode vyžaduje schvaľovanie, zahrňte submitForApproval do postupu aj do rozsahu oprávnení.

5. Zodpovednosť za dáta a pravidlá riešenia konfliktov. Spíšte ich ešte pred spustením ostrej prevádzky:

Výrobné príkazy, ktoré rozvrhuje SkyPlanner, majú uzamknutý rozvrh, takže Global Scheduling ich termíny nemení. Pre zdroje, ktoré SkyPlanner neplánuje, ponechajte rozvrhovanie v systéme Kinetic.

Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Projekt pre Kinetic zahŕňa:

1. 30-dňové skúšobné používanie s exportmi výrobných príkazov, operácií a zdrojov vo formáte CSV alebo Excel ešte pred začatím vývoja.
2. Kľúč API, rozsah prístupu, samostatný integračný účet a BAQs, z ktorých integrácia číta dáta.
3. Mapovanie kmeňových dát: spôsobilostí, skupín zdrojov, zdrojov, kalendárov a zamestnancov na pracoviská, skupiny, zmeny a personál v SkyPlanner.
4. Úvodné načítanie položiek, výrobných metód (BOM a operácií) a zdrojov.
5. Synchronizácia výrobných zákaziek a nákupných objednávok (termíny dodania v PORel) aj skladových zásob z PartWhse.
6. Spätný zápis plánovaných termínov operácií cez ScheduleEngineSvc (MoveJobItem, ChangeResource) vo funkcii Epicor Function s uzamknutím rozvrhu výrobnej zákazky.
7. Zápis hlásení z výroby ako odvedenej práce cez LaborSvc.
8. Testovanie súbežne s aktuálnym rozvrhom v systéme Kinetic a následné spustenie ostrej prevádzky.

Žiadne dva závody nepoužívajú Kinetic rovnako. Technologické postupy založené na spôsobilostiach, kalendáre skupín zdrojov, návrh BAQ, direktívy BPM aj metódy spätného zápisu pre jednotlivé verzie sa medzi prevádzkami líšia. Od ich správneho nastavenia závisí, či plánovači budú rozvrhu dôverovať, alebo ho budú prerábať.

1. Tím SkyPlanner integráciu nakonfiguruje počas zavádzania a podporuje ju aj po spustení ostrej prevádzky. Zmapuje vaše zdroje, výrobné príkazy a rozpisy dodávok nákupných objednávok a nastaví čítanie cez BAQ, spúšťače BPM a funkciu spätného zápisu. Prepojí REST API a webhooky systému SkyPlanner s Kinetic REST v2. Podpora pokračuje aj pri zmenách vašich BAQs, BPMs alebo verzie systému Kinetic.
2. Váš partner Epicor. Partneri, ktorí už vytvárajú BAQs, BPMs a Epicor Functions, môžu pracovať s tým istým zdokumentovaným REST API systému SkyPlanner. Umožňuje čítať a zapisovať zákazky, produkty, materiály, technologické kroky a časové záznamy.
3. Vaši vlastní vývojári. Interné tímy so skúsenosťami s Kinetic REST môžu integráciu vyvinúť priamo alebo v Automation Studio, ak ho používate. Na začiatok stačí kľúč API pre SkyPlanner (návod na integráciu) a tím SkyPlanner v prípade potreby pomôže. Produktová dokumentácia je verejne dostupná v dokumentácii SkyPlanner.

Rovnaký spôsob prepojenia cez API a webhooky funguje v ostrej prevádzke aj s inými ERP systémami, napríklad v UTU. V spoločnosti Laboratory & Allied vytvoril interný IT tím integráciu so SAP Business One prevažne vlastnými silami s pomocou tímu SkyPlanner.

Každá cesta sa začína rovnako: najprv využite 30-dňové bezplatné skúšobné obdobie s importmi CSV, overte rozvrh a až potom vytvorte integráciu. Cena je od 199 € mesačne za 5 pracovísk, s mesačnou fakturáciou a možnosťou kedykoľvek zrušiť predplatné. Cenovú ponuku na integráciu podľa vašich procesov a potrieb dostanete vopred spolu s ponukou predplatného, takže celkové náklady poznáte ešte pred začiatkom.