Integrációk / ERP / proALPHA ERP
proALPHA-integrációs útmutató a SkyPlanner APS gyártásütemezéséhez
Ez a Proalpha-integrációs útmutató bemutatja a partnereknek és az informatikai csapatoknak, hogyan kapcsolható össze a Proalpha ERP a SkyPlanner APS rendszerrel. A SkyPlanner és a Proalpha közötti integráció kétirányú:
- A SkyPlanner átveszi a cikkeket, a gyártási rendeléseket a műveleteikkel együtt, az erőforrásokat, a naptárakat, a készletadatokat és a beszerzési rendeléseket.
- A műveletenként tervezett kezdési és befejezési időpontokat a setWorkOrderOperationDates hívással írja vissza.
- Az erőforrás-változásokat a changeWorkOrderOperationResource hívással írja vissza.
- A gépkezelői visszajelentéseket az operationDataEntry hívással írja vissza.
- A SkyPlanner webhookjai azonnal továbbítják az ütemterv változásait.
A bevezetés során a SkyPlanner csapata az Ön Proalpha-környezetéhez igazítja az integrációt, és az éles indulás után is támogatja azt. Ez az útmutató azoknak a partnereknek és fejlesztőknek szól, akik részt szeretnének venni a munkában, vagy saját maguk szeretnének fejleszteni a SkyPlanner dokumentált REST API-jára építve (API-referencia).
A Proalpha interfészei
A Proalpha ERP Progress OpenEdge alapon fut; a Release 9 verzióval a platform OpenEdge 12-re váltott. (Proalpha) Az ütemezés szempontjából négy interfész lényeges.
- Proalpha ERP REST API-k. A nyilvános Proalpha API Portal 108 OpenAPI 3.0 specifikációt sorol fel az
api/web/v1alatt. Ezen az útvonalon történik a visszaírás, valamint a cikkek és készletadatok olvasása. - Integration Workbench (INWB). A Proalpha leírása szerint az INWB „is a central platform which connects different IT systems, machines, sites” (különböző informatikai rendszereket, gépeket és telephelyeket összekapcsoló központi platform), és „converts the data into the format of the target system.” (az adatokat a célrendszer formátumára alakítja). (Proalpha) A pAX-üzeneteket a
POST /api/web/v1/inwb/messagevégponton fogadja. Ezt használja a gyártási rendelések adatainak továbbítására a Proalpha rendszerből és a Proalpha rendszerbe. - Proalpha Integration Platform. A 2026 áprilisában bejelentett, n8n-alapú platform „will be available to customers either on-premises or in the cloud.” (az ügyfelek számára helyben telepítve és felhőben is elérhető lesz). A Proalpha „will rely on an API-centric reference architecture and REST interfaces.” (API-központú referenciaarchitektúrára és REST-interfészekre fog támaszkodni). (Proalpha)
- EDI és fájlexport. Az INWB kezeli az iparágspecifikus fájlformátumokat, a SkyPlanner kipróbálásához pedig elegendő a fájlexport.
Gyártási végpontok
| Proalpha API | Végpont | Szerepe az integrációban |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Műveletenként tervezett kezdési és befejezési időpont (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Az ütemezés során kiválasztott erőforrás (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Visszajelentések: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Cikkek a partNumber, partType, quantityUnitCode mezőkkel |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Készlet MRP-területenként |
Hitelesítés
A közzétett Proalpha-specifikációk HTTP Basic hitelesítést használnak. A végpontok környezetfüggők: {schema}://{host}:{port}/api/web/v1/..., és az Ön Proalpha-szerverén vagy a Proalpha Cloud környezetben érhetők el. Hozzon létre külön technikai felhasználót, amelynek jogosultságai csak a megfeleltetési táblázatban szereplő objektumokra terjednek ki. Informatikai csapatával tervezze meg a hálózati hozzáférést a SkyPlanner felhőjéből ehhez a végponthoz.
A SkyPlanner oldalán a REST API API-tokennel hitelesít (SkyPlanner Settings > API), dokumentációja Swagger/OpenAPI formátumú. Az induláshoz elegendő egy API-token. Az integrációs oktatóanyag végigvezeti az első hívásokon.
Események és időszakos lekérdezés
A Proalpha API Portal nem sorol fel webhook-feliratkozási API-t. A kimenő változásokat az alábbi módokon lehet továbbítani:
- INWB-üzenetfolyamattal, amely az új és módosított gyártási rendeléseket a műveleteikkel együtt küldi el
- a Proalpha Integration Platform n8n-munkafolyamatával
- a készletadatok ütemezett lekérdezésével a Material API-n keresztül
A SkyPlanner webhookokat küld, amikor az állapot vagy az ütemterv megváltozik, így a Proalpha rendszerbe történő visszaírás eseményvezérelt.
Adatmegfeleltetés
| Proalpha-objektum vagy API | SkyPlanner-objektum | Irány | Gyakoriság |
|---|---|---|---|
| Part (Part API) | Termékek és anyagok | Proalpha → SkyPlanner | Kezdeti betöltés, majd változáskor |
| Termékfolyamat-modell: process, activities; a gyártási rendelés BOM-sorai | Termékstruktúra, résztermékek, folyamatlépések | Proalpha → SkyPlanner | Kezdeti betöltés, majd változáskor |
| Gyártási rendelés (Fertigungsauftrag) mennyiséggel és határidővel | Rendelés és gyártási feladatok határidővel és prioritással | Proalpha → SkyPlanner | INWB- vagy n8n-adatküldéssel, illetve néhány percenként |
| A gyártási rendelés műveletei: targetSetupTime, targetProcessTime, resource | Folyamatlépések átállási időkkel és időtartamokkal | Proalpha → SkyPlanner | A gyártási rendeléssel együtt |
| Erőforrások, erőforráscsoportok, alternatív erőforráscsoportok | Munkaállomások, munkaállomás-csoportok, alternatív munkaállomások | Proalpha → SkyPlanner | Kezdeti betöltés |
| Az erőforrásnaptár időblokkjai intensity és overloadIntensity mezőkkel | Műszakok és a munkaállomások hatékonysága | Proalpha → SkyPlanner | Kezdeti betöltés; utána naponta vagy a SkyPlannerben karbantartva |
| Készlet MRP-területenként | Anyagkészlet | Proalpha → SkyPlanner | Óránként vagy minden ütemezési futtatás előtt |
| Beszerzési rendelések szállítási dátummal | Beérkező anyag a szállítás dátumán | Proalpha → SkyPlanner | Óránként vagy minden ütemezési futtatás előtt |
| setWorkOrderOperationDates | Ütemezett kezdési és befejezési időpont műveletenként | SkyPlanner → Proalpha | Az ütemterv változásakor, SkyPlanner-webhookon keresztül |
| changeWorkOrderOperationResource | Az ütemezőmotor által kiválasztott munkaállomás | SkyPlanner → Proalpha | Az ütemterv változásakor |
| operationDataEntry (setup, process, combined) | Mobile Confirmations: időbejegyzések és mennyiségek | SkyPlanner → Proalpha | Visszajelentésenként vagy műszakonként |
| A SkyPlanner ütemezési szabályai | Átállásiidő-mátrix, szerszámok korlátozott kapacitású erőforrásként, gépkezelői létszámok | A SkyPlannerben karbantartva | Beállítás a bevezetés során |
Integrációs minták
1. A törzsadatok kezdeti betöltése. Olvassa be a cikkeket a Part API-n keresztül, az erőforrásokat, erőforráscsoportokat és naptárakat pedig töltse be egyszer az INWB vagy fájlexport segítségével. Körültekintően rendelje hozzá az egyes Proalpha-erőforrásokat a SkyPlanner munkaállomásaihoz. Az alternatív erőforráscsoportokból alternatív munkaállomások lesznek.
2. Rendelések szinkronizálása. Egy INWB-üzenetfolyam vagy n8n-munkafolyamat továbbítja a nyitott gyártási rendeléseket a műveleteikkel, célidőikkel és erőforrásaikkal együtt. A készletadatok MRP-területenként a Material API-ból, a nyitott beszerzési rendelések pedig az INWB-n keresztül érkeznek. A SkyPlanner a megrendelt anyagot a beszerzési rendelés szállítási dátumától tekinti elérhetőnek, és akkor frissíti a készletet, amikor a rendelés Delivered állapotba kerül.
3. Az ütemterv visszaírása. Az integráció minden olyan művelethez meghívja a setWorkOrderOperationDates függvényt, amelyet az ütemezőmotor elhelyezett vagy áthelyezett. A hívásban átadja a művelet guid azonosítóját, valamint a kezdő és befejező időpontot. Ha a motor másik erőforrást választott, ezt a changeWorkOrderOperationResource hívása követi.
4. Üzemi visszajelentések. A gépkezelők a SkyPlanner Mobile Confirmations vagy a Production Timer segítségével rögzítik a munkát. Az időbejegyzések naprakészen tartják az ütemtervet, és az operationDataEntry híváson keresztül bekerülnek a Proalpha rendszerbe. Ha az üzemben már PDC-terminálokon végzik a visszajelentést, csak egy csatornát használjon, hogy elkerülje a kétszeres könyvelést.
5. Adatgazdai és ütközéskezelési szabályok. Az éles indulás előtt rögzítse őket írásban:
| Adatok | Adatgazda |
|---|---|
| Cikkek, folyamatmodellek, mennyiségek, gyártási rendelések állapota | Proalpha |
| Műveleti sorrend, kezdő és befejező időpontok, erőforrás-hozzárendelés | SkyPlanner |
| Átállásiidő-mátrix, szerszámok, gépkezelői létszámok | SkyPlanner |
| Műszakok és távollétek | Egyetlen rendszer, amelyet a felmérés során választanak ki |
| Visszajelentések és készletkönyvelések | Proalpha, a SkyPlanner időbejegyzéseiből vagy a PDC-ből kapott adatokkal |
Ha a Proalpha APS vagy a Feinplanung aktív, döntse el, melyik rendszer kezeli a műveletek időpontjait. Ha két ütemező ugyanazokat az időpontokat írja, felülírják egymás adatait. Az Autopilot segítségével a SkyPlanner automatikusan újraütemez, amikor változás történik a termelésben.
A projekt jellemző lépései
A bevezetés rendszerint a betanulási és beállítási folyamat kezdetétől számított néhány héten belül lezárul. Ezt megelőzően a 30 napos ingyenes próba során a saját adataival dolgozhat. Exportálja a Proalpha rendszerből a nyitott gyártási rendeléseket, műveleteket és erőforrásokat CSV- vagy Excel-fájlba, importálja őket, majd ellenőrizze az ütemtervet.
- Adatmegfeleltetési műhelymunka. Proalpha partnerével közösen véglegesítse a megfeleltetési táblát, az adatgazdai szabályokat, a szinkronizálás gyakoriságát és a visszajelentési csatornát.
- Interfészek beállítása. Engedélyezze a REST API-kat és az INWB-folyamatokat, hozza létre a technikai felhasználót, és biztosítsa a hálózati hozzáférést. Először a tesztrendszerben, majd az éles rendszerben végezze el a beállításokat.
- Kezdeti adatbetöltés. Cikkek, erőforrások, erőforráscsoportok és naptárak.
- Rendelések, készletek és beszerzési rendelések szinkronizálása. A gyártási rendelések továbbítása INWB-n vagy n8n-en keresztül, a készletadatok időszakos lekérdezése, újrapróbálkozásokkal.
- Korlátok beállítása a SkyPlanner rendszerben. Átállásiidő-mátrix, szerszámok, gépkezelői létszámok és alternatív munkaállomások.
- Az ütemterv visszaírása. setWorkOrderOperationDates és changeWorkOrderOperationResource; ebben a lépésben kapcsolódik be az operationDataEntry is.
- Párhuzamos működés. Hasonlítsa össze a SkyPlanner időpontjait a jelenlegi tervvel, és javítsa a törzsadatokat.
- Éles indulás. Kapcsolja be a visszaírást, amint az adatok egyeznek.
Mire figyeljen a Proalpha-integráció tervezésekor?
- Nincs technológiai útvonalat leíró objektum. A Proalpha a termékek folyamatmodelljei alapján tervez. Az SAP- vagy Business Central-projektekből átvett eszközök technológiai útvonalakat keresnek, ezért egyes adatok kimaradnak. A műveleteket és a BOM-sorokat a gyártási rendelésből olvassa ki.
- Naptárintenzitás. A naptárblokkok tartalmazzák az intensity és overloadIntensity mezőket. A nyers óraszámok másolása helyett feleltesse meg ezeket a SkyPlanner műszakjainak és hatékonysági értékeinek.
- Mértékegységek. Ellenőrizze a quantityUnitCode mezőt, valamint azt, hogy a tervezett átállási idő rendelésre vagy darabra vonatkozik-e. A hibás mértékegységek minden időtartamot eltorzítanak.
- Az ügyfél szerverén futó végpontok. A REST-réteg az Ön Proalpha szerverén fut. A projekt kezdete a tűzfalak, portok és tanúsítványok beállításától függ, ezért időben gondoskodjon a hozzáférésről.
- Verzió. A megfeleltetések véglegesítése előtt egyeztesse partnerével, hogy az Ön Proalpha-verziójában mely REST API-k érhetők el.
- Bejelentkezéshez kötött dokumentáció. A Proalpha online súgója a Documentation Portal felületén érhető el. Találgatás helyett egyeztesse a mezőneveket a partnerével.
Ki állítja be és támogatja a Proalpha-integrációt?
- A SkyPlanner csapata végzi a beállítást a bevezetés során, és az éles indulás után is támogatást nyújt. Minden Proalpha-rendszer modellezése eltérő; a csapat szakértelme ezeknek a különbségeknek a kezelésében hasznosul.
- Proalpha-partnere is részt vehet a munkában. A partner ismeri az Ön folyamatmodelljeit, INWB-folyamatait és rendszerverzióját, és be tudja állítani az API-hozzáférést. A SkyPlanner biztosítja a REST API-t, a Swagger/OpenAPI-dokumentációt és a webhookokat.
- Saját fejlesztői is építhetnek rá, ugyanazt a REST API-t használva, API-tokennel. A SkyPlanner csapata szükség esetén segít. A termék dokumentációja nyilvánosan elérhető a SkyPlanner dokumentációs oldalán.
A SkyPlanner havi díja 199 €-tól indul, 5 munkaállomással, havi számlázással. Az integrációra a folyamatai és igényei alapján előre adunk árajánlatot a csomagjával együtt, így már az indulás előtt látja a teljes költséget. A Támogatja a proALPHA a termelésütemezést? című cikkből megismerheti a Proalpha kapacitástervezését. Áttekintést a proALPHA oldalán, további rendszereket pedig az ERP-integrációk gyűjtőoldalán talál.
Gyártóvállalatok véleménye a SkyPlannerről
2 hmegtakarítás hetente
„A SkyPlannerrel az Excel-táblázatokra épülő gyártástervezésről áttértünk a termelés valós idejű optimalizálására.”
Kalle Kalliomäki, ellátásilánc-szakértő
UTU · Elektromos kapcsolótáblák és kapcsolóberendezések
A gyártástervezés hetente 2 óra munkaidőt takarít meg, az új feladatsor pedig másodpercek alatt eljut a gyártósorra.
+90%termelési hatékonyság
„A termelés hatékonysága 90%-kal nőtt.”
Abdul Rucyinga, informatikai vezető
Laboratory & Allied · Gyógyszergyártás
A termelési hatékonyság 90%-kal nőtt, és az összes munkaállomásra kiterjedő, három hónapot lefedő optimalizált terv kevesebb mint 30 perc alatt elkészül.
99,2%szállítási határidők betartása
„A SkyPlanner láthatóvá tette a szűk keresztmetszeteket, és átláthatóbbá tette a termelésirányítást.”
Toni Tuori, termelési vezető
Piristeel · Tetőbiztonsági és esővíz-elvezető rendszerek
A határidőre teljesített szállítások aránya idén elérte a 99,2%-ot, az ütemezés pedig naponta akár négy óra munkaidőt takarít meg.
Kevesebbanyaghiány miatti leállás
„Számunkra a SkyPlanner értékét az adja, hogy a napi munkában jól használható eszköz, különösen a szállítási határidők meghatározásához.”
Tommi Männistö, gyártástervezési vezető
Eskomatic · Bérforgácsolás
A terhelések automatikus ütemezése pontosabb szállítási határidőket eredményez, az anyaghiány okozta termelési leállások pedig jelentősen csökkentek.
Gyakori kérdések
Mely Proalpha-interfészeket használja az integráció?
A cikkek és készletek lekéréséhez, valamint az időpontok, erőforrások és visszajelentések visszaírásához a Proalpha REST API-kat használja. A gyártási rendeléseket a műveleteikkel együtt INWB-üzenetfolyamok vagy az n8n-alapú Integration Platform továbbítja. A próbaidőszakhoz és a tömeges betöltésekhez fájlexportok használhatók.
Hová kerülnek a tervezett időpontok a Proalpha rendszerben?
A gyártási rendelés műveletéhez, a kezdő és befejező időpontot átadó setWorkOrderOperationDates hívással. Ha a motor másik gépre helyezte át a gyártási feladatot, a changeWorkOrderOperationResource frissíti az erőforrást.
Támogatja a Proalpha a webhookokat?
A Proalpha API Portal nem sorol fel webhook-feliratkozási API-t. A változások INWB-üzenetfolyamokon, n8n-munkafolyamatokon vagy időszakos lekérdezéseken keresztül jutnak el a SkyPlannerhez. A SkyPlanner saját webhookjai eseményvezéreltté teszik a visszaírást.
Átadhatók a gépkezelői visszajelentések a Proalpha rendszernek?
Igen. A SkyPlanner Mobile Confirmations időbejegyzései az operationDataEntry híváson keresztül kerülnek át, a mennyiséggel, valamint a dolgozói és erőforrásidővel együtt. Ha PDC-terminálokat is használnak, csak egy visszajelentési csatornát tartson meg.
Szükségünk van a Proalpha APS-re, és mi a teendő, ha már használjuk?
Nincs rá szükség. A SkyPlanner a gyártási rendelésekből, műveletekből és erőforrásokból maga készíti el a kapacitáskorlátokat figyelembe vevő ütemtervet, az Autopilot pedig naprakészen tartja azt. Ha a Proalpha APS aktív, a felmérés során döntse el, melyik rendszer kezeli a műveletek időpontjait. A SkyPlanner ezután csak a hozzá rendelt időpontokat írja vissza, így a két terv soha nem írja felül egymást.
Kipróbálhatjuk a SkyPlannert az integráció kiépítése előtt?
Igen. A 30 napos ingyenes próba során legfeljebb 20 munkaállomással próbálhatja ki a SkyPlannert, a gyártási rendelések CSV- vagy Excel-exportját használva. Bankkártya megadása nem szükséges. Indítsa el a próbát, vagy egyeztessen értékesítőinkkel az integráció felméréséről.