Integrácie / ERP / proALPHA ERP
Sprievodca integráciou proALPHA na rozvrhovanie výroby so SkyPlanner APS
Tento sprievodca integráciou Proalpha ukazuje partnerom a IT tímom, ako prepojiť Proalpha ERP so SkyPlanner APS. SkyPlanner sa s Proalpha integruje obojsmerne:
- Do SkyPlanner sa prenášajú diely, výrobné príkazy s operáciami, zdroje, kalendáre, zásoby a nákupné objednávky.
- Plánovaný začiatok a koniec každej operácie sa zapisujú späť cez setWorkOrderOperationDates.
- Zmeny zdrojov sa zapisujú späť cez changeWorkOrderOperationResource.
- Hlásenia operátorov sa zapisujú späť cez operationDataEntry.
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas úvodného nasadenia nakonfiguruje integráciu podľa vášho nastavenia Proalpha a po spustení do prevádzky poskytuje podporu. Tento sprievodca je určený partnerom a vývojárom, ktorí sa chcú zapojiť alebo sami vytvoriť riešenie na zdokumentovanom REST API SkyPlanner (referenčná dokumentácia API).
Rozhrania Proalpha
Proalpha ERP beží na Progress OpenEdge. Vo verzii Release 9 platforma prešla na OpenEdge 12. (Proalpha) Pre rozvrhovanie sú dôležité štyri rozhrania.
- Proalpha ERP REST APIs. Verejný Proalpha API Portal uvádza 108 špecifikácií OpenAPI 3.0 pod
api/web/v1. Tieto rozhrania slúžia na spätný zápis aj na čítanie údajov o dieloch a zásobách. - Integration Workbench (INWB). Podľa Proalpha INWB „is a central platform which connects different IT systems, machines, sites“ (je centrálna platforma, ktorá prepája rôzne IT systémy, stroje a prevádzky) a „converts the data into the format of the target system.“ (konvertuje dáta do formátu cieľového systému). (Proalpha) Prijíma správy pAX cez
POST /api/web/v1/inwb/message. Použite ho na prenos výrobných príkazov z Proalpha aj do Proalpha. - Proalpha Integration Platform. Platforma založená na n8n bola oznámená v apríli 2026 a „will be available to customers either on-premises or in the cloud.“ (bude zákazníkom dostupná vo vlastnej infraštruktúre alebo v cloude). Proalpha „will rely on an API-centric reference architecture and REST interfaces.“ (bude využívať referenčnú architektúru orientovanú na API a rozhrania REST). (Proalpha)
- EDI a exporty súborov. INWB spracúva súborové formáty špecifické pre jednotlivé odvetvia. Na skúšobné používanie SkyPlanner postačujú exporty súborov.
Koncové body pre výrobu
| Proalpha API | Koncový bod | Použitie v integrácii |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Plánovaný začiatok a koniec každej operácie (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Zdroj vybraný pri rozvrhovaní (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Hlásenia: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Diely s poľami partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Zásoby podľa oblasti MRP |
Autentifikácia
Zverejnené špecifikácie Proalpha používajú autentifikáciu HTTP Basic. Koncové body majú adresy podľa konkrétneho prostredia, {schema}://{host}:{port}/api/web/v1/..., na vašom serveri Proalpha alebo v Proalpha Cloud. Vytvorte vyhradeného technického používateľa s oprávneniami obmedzenými na objekty v mapovacej tabuľke. Spolu s IT tímom naplánujte sieťový prístup z cloudu SkyPlanner k tomuto koncovému bodu.
REST API na strane SkyPlanner používa na autentifikáciu token API (SkyPlanner Settings > API) a je zdokumentované vo formáte Swagger/OpenAPI. Na začiatok stačí token API. Prvými volaniami vás prevedie návod na integráciu.
Udalosti a pravidelné dopytovanie
Proalpha API Portal neuvádza žiadne API na prihlásenie na odber webhookov. Zmeny sa z Proalpha odosielajú prostredníctvom:
- toku správ INWB, ktorý odosiela nové a zmenené výrobné príkazy aj s ich operáciami
- pracovného postupu n8n na Proalpha Integration Platform
- pravidelného dopytovania Material API na stav zásob
SkyPlanner odosiela webhooky pri zmene stavu alebo rozvrhu, takže spätný zápis do Proalpha je riadený udalosťami.
Mapovanie dát
| Objekt alebo API Proalpha | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
| Part (Part API) | Produkty a materiály | Proalpha → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Procesný model produktu: process, activities; položky BOM výrobného príkazu | Štruktúra produktu, podprodukty, kroky procesu | Proalpha → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Výrobný príkaz (Fertigungsauftrag) s množstvom a termínom dokončenia | Zákazka a operácie s termínom dokončenia a prioritou | Proalpha → SkyPlanner | Odosielanie cez INWB alebo n8n, prípadne každých niekoľko minút |
| Operácie výrobného príkazu: targetSetupTime, targetProcessTime, resource | Kroky procesu s časmi nastavenia a trvaním | Proalpha → SkyPlanner | Spolu s výrobným príkazom |
| Zdroje, skupiny zdrojov, alternatívne skupiny zdrojov | Pracoviská, skupiny pracovísk, alternatívne pracoviská | Proalpha → SkyPlanner | Úvodné načítanie |
| Bloky v kalendári zdrojov s poľami intensity a overloadIntensity | Zmeny a efektivita pracovísk | Proalpha → SkyPlanner | Úvodné načítanie; potom denne alebo správa v SkyPlanner |
| Zásoby podľa oblasti MRP | Zásoby materiálu | Proalpha → SkyPlanner | Každú hodinu alebo pred každým spustením rozvrhovania |
| Nákupné objednávky s dátumom dodania | Prichádzajúci materiál k dátumu dodania | Proalpha → SkyPlanner | Každú hodinu alebo pred každým spustením rozvrhovania |
| setWorkOrderOperationDates | Rozvrhnutý začiatok a koniec každej operácie | SkyPlanner → Proalpha | Pri zmene rozvrhu cez webhook SkyPlanner |
| changeWorkOrderOperationResource | Pracovisko vybrané plánovacím algoritmom | SkyPlanner → Proalpha | Pri zmene rozvrhu |
| operationDataEntry (setup, process, combined) | Časové záznamy a množstvá z Mobile Confirmations | SkyPlanner → Proalpha | Pri každom hlásení alebo za každú zmenu |
| Pravidlá rozvrhovania v SkyPlanner | Matica časov prestavenia, nástroje ako zdroje s obmedzenou kapacitou, počty operátorov | Správa v SkyPlanner | Nastavenie počas úvodného nasadenia |
Postupy integrácie
1. Úvodné načítanie kmeňových dát. Načítajte diely cez Part API a jednorazovo preneste zdroje, skupiny zdrojov a kalendáre cez INWB alebo export súboru. Pri mapovaní každého zdroja Proalpha na pracovisko SkyPlanner postupujte uvážene. Alternatívne skupiny zdrojov sa zmenia na alternatívne pracoviská.
2. Synchronizácia príkazov. Tok správ INWB alebo pracovný postup n8n odosiela otvorené výrobné príkazy spolu s operáciami, cieľovými časmi a zdrojmi. Údaje o zásobách sa načítavajú cez Material API pre každú oblasť MRP a otvorené nákupné objednávky cez INWB. SkyPlanner považuje objednaný materiál za dostupný v deň dodania uvedený v nákupnej objednávke a aktualizuje zásoby, keď objednávka dostane stav Delivered.
3. Spätný zápis rozvrhu. Pre každú operáciu, ktorú plánovací mechanizmus zaradil alebo presunul, integrácia volá setWorkOrderOperationDates s identifikátorom guid operácie a časmi začiatku a konca. Ak mechanizmus vybral iný zdroj, nasleduje volanie changeWorkOrderOperationResource.
4. Odvádzanie výroby. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer. Časové záznamy udržiavajú rozvrh aktuálny a zapisujú sa do Proalpha cez operationDataEntry. Ak už vo vašom závode odvádzate výrobu cez terminály PDC, ponechajte len jeden kanál, aby nevznikali duplicitné zápisy.
5. Pravidlá zodpovednosti za dáta a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Diely, procesné modely, množstvá, stav výrobného príkazu | Proalpha |
| Poradie operácií, časy začiatku a konca, priradenie zdrojov | SkyPlanner |
| Matica časov prestavenia, nástroje, počty operátorov | SkyPlanner |
| Zmeny a neprítomnosti | Jeden systém vybraný pri definovaní rozsahu |
| Odvádzanie výroby a skladové zápisy | Proalpha, s údajmi z časových záznamov SkyPlanner alebo z PDC |
Ak je aktívny Proalpha APS alebo Feinplanung, rozhodnite, ktorý systém bude zodpovedať za termíny operácií. Ak dva plánovacie systémy zapisujú tie isté termíny, navzájom si ich prepisujú. S funkciou Autopilot SkyPlanner automaticky preplánuje rozvrh pri zmenách vo výrobe.
Typický priebeh projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Predtým si môžete systém 30 dní bezplatne skúšať na vlastných dátach. Exportujte z Proalpha otvorené výrobné príkazy, operácie a zdroje do CSV alebo Excelu, importujte ich a overte rozvrh.
- Workshop k mapovaniu. S partnerom Proalpha dohodnite konečnú mapovaciu tabuľku, pravidlá zodpovednosti za dáta, frekvencie synchronizácie a kanál odvádzania výroby.
- Nastavenie rozhraní. Aktivujte rozhrania REST API a toky INWB, vytvorte technického používateľa a povoľte sieťový prístup. Najprv v testovacom systéme, potom v produkčnom.
- Úvodné načítanie. Diely, zdroje, skupiny zdrojov a kalendáre.
- Synchronizácia výrobných príkazov, zásob a nákupných objednávok. Výrobné príkazy sa odosielajú cez INWB alebo n8n, zásoby sa načítavajú pravidelným dopytovaním. Súčasťou sú opakované pokusy pri zlyhaní.
- Nastavenie obmedzení v SkyPlanner. Matica časov prestavenia, nástroje, počty operátorov a alternatívne pracoviská.
- Spätný zápis rozvrhu. setWorkOrderOperationDates a changeWorkOrderOperationResource; v tomto kroku sa pridáva aj operationDataEntry.
- Súbežná prevádzka. Porovnajte termíny zo SkyPlanner s aktuálnym plánom a opravte kmeňové dáta.
- Spustenie ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
S čím počítať pri integrácii s Proalpha
- Bez objektu technologického postupu. Proalpha plánuje na základe procesných modelov výrobkov. Nástroje prevzaté z projektov SAP alebo Business Central hľadajú technologické postupy, a preto nezachytia všetky dáta. Z výrobného príkazu načítavajte operácie a riadky kusovníka.
- Intenzita v kalendári. Bloky kalendára obsahujú polia intensity a overloadIntensity. Namiesto kopírovania samotných hodín ich namapujte na zmeny a efektivitu v SkyPlanner.
- Merné jednotky. Skontrolujte quantityUnitCode a to, či je cieľový čas nastavenia uvedený na príkaz alebo na kus. Nesprávne jednotky skreslia každý údaj o trvaní.
- Koncové body na serveri zákazníka. Vrstva REST beží na vašom serveri Proalpha. Od nastavenia firewallov, portov a certifikátov závisí termín začiatku projektu, preto potrebné prístupy zabezpečte včas.
- Verzia systému. Pred uzavretím mapovania si s partnerom overte, ktoré rozhrania REST API vaša verzia Proalpha sprístupňuje.
- Dokumentácia dostupná po prihlásení. Online pomoc Proalpha je dostupná cez Documentation Portal. Názvy polí si overte s partnerom, neodhadujte ich.
Integrácia s Proalpha: kto ju nastavuje a zabezpečuje podporu
- Tím SkyPlanner ju nastaví počas zavádzania a zabezpečuje podporu aj po spustení ostrej prevádzky. Každá inštalácia Proalpha má odlišný dátový model a práve pri nastavení integrácie sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner Proalpha. Pozná vaše procesné modely, toky INWB aj verziu systému a môže nastaviť prístup k API. SkyPlanner poskytuje REST API, dokumentáciu Swagger/OpenAPI a webhooky.
- Integráciu môžu ďalej rozvíjať aj vaši vývojári cez rovnaké REST API s tokenom API. Tím SkyPlanner v prípade potreby pomôže. Produktová dokumentácia je verejne dostupná v dokumentácii SkyPlanner.
Cena SkyPlanner sa začína od 199 € mesačne a zahŕňa 5 pracovísk s mesačnou fakturáciou. Cenovú ponuku na integráciu pripravíme vopred podľa vašich procesov a potrieb spolu s cenou predplatného, takže celkové náklady poznáte ešte pred začiatkom. O plánovaní kapacít v Proalpha sa dočítate v článku Podporuje proALPHA plánovanie výroby so zohľadnením reálnych kapacít strojov a pracovníkov?. Prehľad nájdete na stránke proALPHA a ďalšie systémy v prehľade integrácií s ERP.
Ako výrobné firmy hodnotia SkyPlanner
2 hušetrené každý týždeň
„SkyPlanner posunul naše plánovanie výroby od tabuliek v Exceli k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
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é poradie operácií sa dostane na linku v priebehu sekúnd.
+90%efektivita výroby
„Efektivita výroby vzrástla o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrástla o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej ako 30 minút.
99,2%spoľahlivosť dodávok
„Vďaka SkyPlanner lepšie vidíme úzke miesta a riadenie výroby je prehľadnejšie.“
Toni Tuori, vedúci výroby
Piristeel · Strešné bezpečnostné prvky a systémy na odvod dažďovej vody
Spoľahlivosť dodávok tento rok dosiahla 99,2 % a rozvrhovanie šetrí až štyri hodiny pracovného času denne.
Menejprestojov pre nedostatok materiálu
„Prínos SkyPlanner pre nás spočíva v tom, že je to nástroj, ktorý funguje v každodennej praxi, najmä pri určovaní termínov dodania.“
Tommi Männistö, vedúci plánovania výroby
Eskomatic · Zákazkové obrábanie
Automatické plánovanie vyťaženia umožňuje presnejšie určovať termíny dodania a prestoje vo výrobe spôsobené nedostatkom materiálu výrazne klesli.
Často kladené otázky
Ktoré rozhrania Proalpha integrácia používa?
Rozhrania REST API systému Proalpha na načítanie dielov a zásob a na spätný zápis termínov, zdrojov a odvedenej výroby. Toky správ INWB alebo Integration Platform založená na n8n prenášajú výrobné príkazy spolu s operáciami. Na skúšobnú prevádzku a hromadné načítanie slúžia exporty súborov.
Kam sa v Proalpha zapisujú naplánované termíny?
Do operácie výrobného príkazu cez setWorkOrderOperationDates s časmi začiatku a konca. Ak plánovací mechanizmus presunul operáciu na iný stroj, changeWorkOrderOperationResource aktualizuje priradený zdroj.
Podporuje Proalpha webhooky?
Proalpha API Portal neuvádza žiadne API na prihlásenie na odber webhookov. Zmeny sa do SkyPlanner dostávajú cez toky správ INWB, pracovné postupy n8n alebo pravidelné dopytovanie. Vlastné webhooky SkyPlanner umožňujú spúšťať spätný zápis na základe udalostí.
Dá sa výroba odvedená operátormi zapisovať do Proalpha?
Áno. Časové záznamy zo SkyPlanner Mobile Confirmations sa zapisujú cez operationDataEntry spolu s množstvom, údajom o pracovníkovi a časom zdroja. Ak používate aj terminály PDC, ponechajte len jeden kanál odvádzania výroby.
Potrebujeme Proalpha APS a čo ak ho už používame?
Nepotrebujete ho. SkyPlanner sám vytvára plán výroby z vašich výrobných príkazov, operácií a zdrojov, pričom rešpektuje reálne kapacity strojov a pracovníkov. Autopilot ho udržiava aktuálny. Ak je Proalpha APS aktívny, pri definovaní rozsahu rozhodnite, ktorý systém bude zodpovedať za termíny operácií. SkyPlanner potom zapisuje iba termíny, za ktoré zodpovedá, takže sa tieto dva plány nikdy navzájom neprepíšu.
Môžeme si SkyPlanner vyskúšať pred vytvorením integrácie?
Áno. Počas 30-dňovej bezplatnej skúšobnej verzie môžete používať až 20 pracovísk s exportom výrobných príkazov do CSV alebo Excelu. Kreditnú kartu nepotrebujete. Spustite skúšobnú verziu alebo kontaktujte obchodný tím a dohodnite rozsah integrácie.
