Průvodce integrací Epicor Kinetic pro rozvrhování výroby v SkyPlanner APS

Epicor uvádí: „All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.“ (Všechny služby Kinetic, včetně business objektů, procesů, sestav, BAQ a Epicor Functions, jsou dostupné prostřednictvím endpointů REST.) Integrace pro rozvrhování výroby stojí na čtyřech technologiích Epicor:

1. Kinetic REST API v2 (OData v4). Podnikové objekty jsou dostupné jako služby s názvem Erp.BO.<Name>Svc. Obvyklá cesta je /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 je stále k dispozici, ale jde o starší rozhraní, proto integraci stavte na v2. Sady entit a metody pro svou verzi si ověřte v REST Help na adrese /api/help/v2/.
2. Business Activity Queries (BAQ) přes REST. BAQ je dostupný na adrese /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Jde o praktický způsob, jak pro plánování načítat data spojená z JobHead, JobOper, JobMtl, PartWhse a PORel jediným voláním (příklad z komunity).
3. Epicor Functions (EFx). Serverové funkce, které lze volat na adrese /api/v2/efx/{Company}/{Library}/{Function}. Epicor uvádí: „can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.“ (lze je spouštět z více vstupních bodů, včetně BPM, služeb REST, časových plánů a událostí aplikace).
4. Direktivy BPM. Method Directives a Data Directives se spouštějí při změně výrobní zakázky nebo operace a mohou zavolat funkci, která odešle data do externího systému.

Při práci se soubory zajišťuje DMT import dat a exporty BAQ jejich výstup. Epicor nabízí také Epicor Automation Studio, které popisuje jako „a low-code app for integration-led automations“ (low-code aplikaci pro automatizaci založenou na integracích). Přímý přístup k databázi nepoužívejte: REST, BAQ a funkce fungují stejně v místním prostředí i na Kinetic Cloud.

Epicor nemá zdokumentované obecné API pro odchozí webhooky, takže se změny z Kinetic dostávají do SkyPlanner jedním ze dvou způsobů:

• Reakce na události. Direktiva BPM Data Directive pro JobHead nebo JobOper zavolá funkci Epicor Function, která odešle změněný výrobní příkaz do REST API systému SkyPlanner.
• Pravidelné dotazování. Dotaz BAQ filtrovaný podle data změny se spouští každých několik minut nebo každou hodinu. Toto řešení se snáze spravuje i obnovuje po chybě.

V opačném směru odesílá SkyPlanner změny stavu a rozvrhu prostřednictvím svých webhooků. Váš middleware nebo endpoint EFx je přijímá a zapisuje do Kinetic.

1. Úvodní načtení kmenových dat. Načtěte díly, skupiny výrobních zdrojů, výrobní zdroje, způsobilosti, kalendáře a zaměstnance. Z výrobních zdrojů v Kinetic vytvořte pracoviště v SkyPlanner a ze skupin zdrojů skupiny pracovišť. Při načítání velkých objemů použijte stránkování pomocí $top a $skip nebo data načtěte hromadně přes BAQ.

2. Synchronizace zakázek. Odesílejte uvolněné a pevně potvrzené výrobní příkazy včetně operací a materiálů. Strom výrobního příkazu načítejte pomocí GetDatasetForTree nebo BAQ, nikoli po jednotlivých entitách. Nepotvrzené výrobní příkazy z MRP ponechte v Kinetic, dokud nebudou pevně potvrzeny. Spolu se skladovými zásobami synchronizujte i otevřené dílčí dodávky nákupních objednávek a jejich termíny. SkyPlanner považuje objednaný materiál za dostupný k datu dodání a aktualizuje zásoby, když je nákupní objednávka označena stavem Delivered. Rozvrh tak zohledňuje jak skladové zásoby, tak očekávané nákupy.

3. Zpětný zápis rozvrhu. Webhook systému SkyPlanner odesílá plánovaný začátek, konec a pracoviště každé operace na endpoint EFx (/api/v2/efx/{Company}/{Library}/{Function}). Funkce zapisuje přes plánovací jádro Kinetic, tedy stejný podnikový objekt, který využívá rozvrhování v Job Entry i plánovací tabule (příklad z komunity):

1. ScheduleEngine.GetNewParamsForJob vytvoří pro výrobní příkaz datovou sadu plánovacího jádra.
2. Funkce nastaví číslo výrobního příkazu, pořadové číslo sestavy a operace a plánované datum a čas zahájení. Poté zavolá ScheduleEngine.MoveJobItem.
3. Pokud SkyPlanner přiřadil operaci jinému výrobnímu zdroji ve skupině, ScheduleEngine.ChangeResource ji na tento zdroj přesune. Samotné volání MoveJobItem ponechá výchozí zdroj skupiny.
4. Funkce uzamkne rozvrh výrobního příkazu (JobHead.SchedLocked, volba Lock v Job Entry), aby Global Scheduling zachoval termíny ze SkyPlanner.

Zapouzdření těchto volání do jedné funkce Epicor Function zajistí atomický zápis pro každý výrobní příkaz a umožní přidat vlastní validaci. Pokud závod nechce používat vlastní funkci, lze stejnou sekvenci provést přímými voláními REST na Erp.BO.ScheduleEngineSvc. Nikdy nezapisujte přímo do ResourceTimeUsed ani do polí s termíny v JobOper: obešli byste tím plánovací jádro a přidělení kapacit na plánovací tabuli by přestalo odpovídat rozvrhu.

4. Odvádění výroby. Operátoři zaznamenávají práci v SkyPlanner pomocí funkcí Mobile Confirmations, Production Timer nebo Quick Log Mode. Každý uzavřený časový záznam se přenese do Kinetic jako výkaz práce přes Erp.BO.LaborSvc: pro průběžný záznam se použijí StartActivity a EndActivityByEmp, pro dodatečné zápisy Labors s Update. Pokud váš závod vyžaduje schvalování, zahrňte submitForApproval do procesu i do rozsahu přístupových oprávnění.

5. Odpovědnost za data a pravidla řešení konfliktů. Sepište je před spuštěním ostrého provozu:

Výrobní zakázky rozvrhované v SkyPlanner mají uzamčený rozvrh, takže Global Scheduling jejich termíny nemění. Pro výrobní zdroje, které SkyPlanner neplánuje, ponechte rozvrhování v Kinetic.

Implementace je obvykle dokončena během několika týdnů od zahájení úvodního zavádění. Projekt integrace s Kinetic zahrnuje:

1. 30denní zkušební provoz s exporty výrobních zakázek, operací a výrobních zdrojů ve formátu CSV nebo Excel, ještě před zahájením vývoje.
2. Klíč API, rozsah přístupu, samostatný integrační účet a dotazy BAQ, ze kterých integrace čte.
3. Mapování kmenových dat: způsobilostí, skupin výrobních zdrojů, výrobních zdrojů, kalendářů a zaměstnanců na pracoviště, skupiny, směny a pracovníky v SkyPlanner.
4. Počáteční načtení položek, výrobních postupů (BOM a operací) a výrobních zdrojů.
5. Synchronizace výrobních příkazů a nákupních objednávek (termíny v PORel) i skladových zásob z PartWhse.
6. Zpětný zápis plánovaných termínů operací přes ScheduleEngineSvc (MoveJobItem, ChangeResource) ve funkci Epicor Function se zamknutím rozvrhu výrobního příkazu.
7. Přenos odvedené výroby jako výkazů práce přes LaborSvc.
8. Testování souběžně se stávajícím rozvrhem v Kinetic a následné spuštění ostrého provozu.

Každý závod používá Kinetic jinak. Technologické postupy založené na způsobilostech, kalendáře skupin výrobních zdrojů, návrh dotazů BAQ, direktivy BPM i metody zpětného zápisu pro konkrétní verze se mezi závody liší. Správné nastavení rozhoduje o tom, zda plánovači rozvrhu důvěřují, nebo jej musí přepracovávat.

1. Tým SkyPlanner integraci nastaví při úvodním zavádění a po spuštění ostrého provozu poskytuje podporu. Namapuje vaše výrobní zdroje, výrobní zakázky a dílčí dodávky nákupních objednávek a nastaví čtení z BAQ, spouštěče BPM i funkci zpětného zápisu. Propojí REST API a webhooky SkyPlanner s Kinetic REST v2. Podpora pokračuje i při změnách vašich BAQ, BPM nebo verze Kinetic.
2. Váš partner Epicor. Partneři, kteří již vytvářejí BAQ, BPM a Epicor Functions, mohou pracovat se stejným zdokumentovaným REST API SkyPlanner. To umožňuje číst a zapisovat zakázky, produkty, materiály, operace a časové záznamy.
3. Vaši vlastní vývojáři. Interní týmy se zkušenostmi s Kinetic REST mohou integraci vytvořit přímo nebo v Automation Studio, pokud jej používáte. Pro začátek stačí klíč API SkyPlanner (návod k integraci) a tým SkyPlanner v případě potřeby pomůže. Produktová dokumentace je veřejně dostupná v dokumentaci SkyPlanner.

Stejný způsob propojení přes API a webhooky funguje v ostrém provozu i s jinými systémy ERP, například ve společnosti UTU. Ve společnosti Laboratory & Allied vytvořil interní IT tým integraci se SAP Business One převážně vlastními silami s pomocí SkyPlanner.

Každá cesta začíná stejně: nejprve využijte 30denní zkušební verzi zdarma s importy CSV, ověřte rozvrh a teprve potom vytvořte integraci. Cena začíná od 199 € měsíčně za 5 pracovišť, s měsíční fakturací a možností kdykoli zrušit předplatné. Nabídku na integraci připravíme předem podle vašich procesů a potřeb společně s nabídkou tarifu, takže celkové náklady znáte ještě před zahájením.