Integracije / ERP / proALPHA ERP
Vodnik za integracijo proALPHA s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako povezati Proalpha ERP s SkyPlanner APS. Integracija med SkyPlanner in Proalpha deluje v obeh smereh:
- V SkyPlanner se prenašajo artikli, delovni nalogi z operacijami, viri, koledarji, zaloge in nabavna naročila.
- Planirani začetek in konec vsake operacije se zapisujeta nazaj prek setWorkOrderOperationDates.
- Spremembe virov se zapisujejo nazaj prek changeWorkOrderOperationResource.
- Potrditve operaterjev se zapisujejo nazaj prek operationDataEntry.
- SkyPlanner prek obvestil webhook pošilja spremembe terminskega plana takoj, ko nastanejo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši konfiguraciji Proalpha in zanjo zagotavlja podporo tudi po zagonu. Vodnik je namenjen partnerjem in razvijalcem, ki želijo pri tem sodelovati ali sami razvijati rešitve z dokumentiranim REST API za SkyPlanner (referenčna dokumentacija API).
Vmesniki Proalpha
Proalpha ERP deluje na platformi Progress OpenEdge, z izdajo Release 9 pa je prešel na OpenEdge 12. (Proalpha) Za terminiranje so pomembni štirje vmesniki.
- Proalpha ERP REST APIs. Javni Proalpha API Portal navaja 108 specifikacij OpenAPI 3.0 pod
api/web/v1. Ti vmesniki omogočajo povratni zapis ter branje artiklov in zalog. - Integration Workbench (INWB). Kot navaja Proalpha, INWB “is a central platform which connects different IT systems, machines, sites” (je osrednja platforma, ki povezuje različne sisteme IT, stroje in lokacije) in “converts the data into the format of the target system.” (pretvarja podatke v obliko ciljnega sistema). (Proalpha) Sporočila pAX prejema prek
POST /api/web/v1/inwb/message. Uporabite ga za prenos delovnih nalogov iz sistema Proalpha in vanj. - Proalpha Integration Platform. Platforma, ki je bila napovedana aprila 2026 in temelji na n8n, “will be available to customers either on-premises or in the cloud.” (bo strankam na voljo za lokalno namestitev ali v oblaku). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (se bo opiral na referenčno arhitekturo, osredotočeno na API, in vmesnike REST). (Proalpha)
- EDI in izvoz v datoteke. INWB podpira datotečne formate za posamezne panoge, izvoz v datoteke pa zadostuje za preizkus SkyPlanner.
Končne točke za proizvodnjo
| Proalpha API | Končna točka | Uporaba pri integraciji |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Planirani začetek in konec vsake operacije (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Vir, izbran pri terminiranju (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Potrditve: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artikli s polji partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Zaloga po območjih MRP |
Avtentikacija
Objavljene specifikacije Proalpha uporabljajo avtentikacijo HTTP Basic. Končne točke so na vašem strežniku Proalpha ali v Proalpha Cloud. Njihovi naslovi so odvisni od okolja in imajo obliko {schema}://{host}:{port}/api/web/v1/.... Ustvarite namenskega tehničnega uporabnika s pravicami, omejenimi na objekte v tabeli preslikav. Z ekipo IT načrtujte omrežni dostop iz oblaka SkyPlanner do te končne točke.
REST API na strani SkyPlanner za avtentikacijo uporablja žeton API (SkyPlanner Settings > API) in je dokumentiran v Swagger/OpenAPI. Za začetek zadostuje žeton API. Navodila za integracijo vas vodijo skozi prve klice.
Dogodki in periodično poizvedovanje
Proalpha API Portal ne navaja API za naročanje na obvestila webhook. Spremembe iz sistema Proalpha se prenašajo prek:
- toka sporočil INWB, ki pošilja nove in spremenjene delovne naloge z njihovimi operacijami
- delovnega toka n8n na Proalpha Integration Platform
- periodičnega poizvedovanja o zalogah prek Material API
SkyPlanner ob spremembi stanja ali terminskega plana pošilja obvestila webhook, zato povratni zapis v Proalpha sprožajo dogodki.
Preslikava podatkov
| Objekt ali API v Proalpha | Objekt v SkyPlanner | Smer | Pogostost |
|---|---|---|---|
| Part (Part API) | Izdelki in materiali | Proalpha → SkyPlanner | Začetni prenos, nato ob spremembi |
| Procesni model izdelka: process, activities; postavke kosovnice delovnega naloga | Struktura izdelka, podizdelki, koraki procesa | Proalpha → SkyPlanner | Začetni prenos, nato ob spremembi |
| Delovni nalog (Fertigungsauftrag) s količino in rokom | Naročilo in operacije z rokom in prednostno stopnjo | Proalpha → SkyPlanner | Pošiljanje prek INWB ali n8n oziroma vsakih nekaj minut |
| Operacije delovnega naloga: targetSetupTime, targetProcessTime, resource | Koraki procesa s pripravljalnimi časi in trajanji | Proalpha → SkyPlanner | Skupaj z delovnim nalogom |
| Viri, skupine virov, alternativne skupine virov | Delovni centri, skupine delovnih centrov, alternativni delovni centri | Proalpha → SkyPlanner | Začetni prenos |
| Časovni bloki v koledarju vira s poljema intensity in overloadIntensity | Izmene in učinkovitost delovnih centrov | Proalpha → SkyPlanner | Začetni prenos; nato dnevno ali vzdrževanje v SkyPlanner |
| Zaloga po območjih MRP | Zaloga materiala | Proalpha → SkyPlanner | Vsako uro ali pred vsakim zagonom terminiranja |
| Nabavna naročila z datumom dobave | Prihodni material na datum dobave | Proalpha → SkyPlanner | Vsako uro ali pred vsakim zagonom terminiranja |
| setWorkOrderOperationDates | Začetek in konec vsake operacije po terminskem planu | SkyPlanner → Proalpha | Ob spremembi terminskega plana prek obvestila webhook iz SkyPlanner |
| changeWorkOrderOperationResource | Delovni center, ki ga izbere pogon za terminiranje | SkyPlanner → Proalpha | Ob spremembi terminskega plana |
| operationDataEntry (setup, process, combined) | Časovni zapisi in količine iz Mobile Confirmations | SkyPlanner → Proalpha | Ob vsaki potrditvi ali ob vsaki izmeni |
| Pravila terminiranja v SkyPlanner | Matrika časov prehodov, orodja kot viri z omejeno zmogljivostjo, število operaterjev | Vzdrževanje v SkyPlanner | Nastavitev med uvajanjem |
Načini integracije
1. Začetni prenos matičnih podatkov. Artikle preberite prek Part API, vire, skupine virov in koledarje pa enkratno prenesite prek INWB ali izvoza v datoteko. Skrbno določite, kateremu delovnemu centru v SkyPlanner ustreza vsak vir v Proalpha. Alternativne skupine virov se preslikajo v alternativne delovne centre.
2. Sinhronizacija nalogov. Tok sporočil INWB ali delovni tok n8n pošilja odprte delovne naloge z operacijami, ciljnimi časi in viri. Podatki o zalogi prihajajo prek Material API za vsako območje MRP, odprta nabavna naročila pa prek INWB. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko je naročilo označeno s statusom Delivered.
3. Zapis terminskega plana nazaj v ERP. Za vsako operacijo, ki jo je mehanizem razporedil ali premaknil, integracija pokliče setWorkOrderOperationDates ter posreduje guid operacije, začetek in konec. Če je mehanizem izbral drug vir, sledi klic changeWorkOrderOperationResource.
4. Potrjevanje dela v proizvodnji. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer. Časovni zapisi sproti posodabljajo terminski plan in se prek operationDataEntry knjižijo v Proalpha. Če v obratu delo že potrjujete na terminalih PDC, ohranite en kanal, da preprečite podvojeno knjiženje.
5. Pravila o pristojnostih za podatke in reševanju neskladij. Zapišite jih pred prehodom v produkcijo:
| Podatki | Pristojni sistem |
|---|---|
| Artikli, procesni modeli, količine, status delovnih nalogov | Proalpha |
| Zaporedje operacij, časi začetka in konca, dodelitev virov | SkyPlanner |
| Matrika časov prehodov, orodja, število operaterjev | SkyPlanner |
| Izmene in odsotnosti | En sistem, izbran pri opredelitvi obsega |
| Potrditve in knjiženje zalog | Proalpha, ki prejema časovne zapise iz SkyPlanner ali podatke iz PDC |
Če je Proalpha APS ali Feinplanung aktiven, določite, kateri sistem je pristojen za termine operacij. Če dva sistema za terminiranje zapisujeta iste termine, drug drugemu prepisujeta podatke. S funkcijo Autopilot SkyPlanner ob spremembah v proizvodnji samodejno prilagodi terminski plan.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem lahko v 30-dnevnem brezplačnem preizkusu uporabite svoje podatke. Iz Proalpha izvozite odprte delovne naloge, operacije in vire v CSV ali Excel, jih uvozite in preverite terminski plan.
- Delavnica za preslikavo podatkov. S svojim partnerjem za Proalpha dokončno določite tabelo preslikav, pristojnosti za podatke, pogostost sinhronizacije in kanal za potrjevanje.
- Nastavitev vmesnikov. Omogočite vmesnike REST API in tokove INWB, ustvarite tehničnega uporabnika in omogočite omrežni dostop. Najprej v testnem sistemu, nato v produkcijskem.
- Začetni uvoz. Artikli, viri, skupine virov in koledarji.
- Sinhronizacija nalogov, zalog in nabavnih naročil. Potisno pošiljanje delovnih nalogov prek INWB ali n8n ter periodično poizvedovanje o zalogi, s ponovnimi poskusi ob napakah.
- Nastavitev omejitev v SkyPlanner. Matrika časov prehodov, orodja, število operaterjev in alternativni delovni centri.
- Zapis terminskega plana nazaj v ERP. setWorkOrderOperationDates in changeWorkOrderOperationResource; v tem koraku se doda tudi operationDataEntry.
- Vzporedno delovanje. Primerjajte termine iz SkyPlanner z obstoječim planom in popravite matične podatke.
- Prehod v produkcijo. Ko se podatki ujemajo, vklopite zapisovanje nazaj v ERP.
Kaj upoštevati pri integraciji s Proalpha
- Ni objekta za tehnološki postopek. Proalpha planira na podlagi procesnih modelov izdelkov. Orodja, prevzeta iz projektov SAP ali Business Central, iščejo tehnološke postopke in zato spregledajo podatke. Iz delovnega naloga preberite operacije in postavke BOM.
- Intenzivnost v koledarju. Koledarski bloki vsebujejo polji intensity in overloadIntensity. Preslikajte ju v izmene in vrednosti učinkovitosti v SkyPlanner, namesto da zgolj kopirate ure.
- Merske enote. Preverite quantityUnitCode in ali je ciljni pripravljalni čas podan na nalog ali na kos. Napačne enote popačijo vse čase trajanja.
- Končne točke na strežniku stranke. Plast REST deluje na vašem strežniku Proalpha. Nastavitve požarnih zidov, vrat in certifikatov določajo, kdaj se projekt lahko začne, zato jih uredite zgodaj.
- Različica sistema. Preden dokončno določite preslikave, s partnerjem preverite, katere vmesnike REST API ponuja vaša različica Proalpha.
- Dokumentacija zahteva prijavo. Spletna pomoč za Proalpha je dostopna prek Documentation Portal. Imena polj preverite s partnerjem, namesto da ugibate.
Integracija s Proalpha: kdo jo nastavi in zagotavlja podporo
- Ekipa SkyPlanner nastavi integracijo med uvajanjem in zagotavlja podporo po prehodu v produkcijo. Vsaka namestitev Proalpha je modelirana drugače in prav pri tem pride to strokovno znanje do izraza.
- Sodeluje lahko tudi vaš partner za Proalpha. Partner pozna vaše procesne modele, tokove INWB in različico sistema ter lahko nastavi dostop do API. SkyPlanner zagotavlja REST API, dokumentacijo Swagger/OpenAPI in spletne kavlje.
- Vaši razvijalci lahko integracijo nadgradijo prek istega REST API z žetonom API. Ekipa SkyPlanner po potrebi pomaga. Dokumentacija izdelka je javno dostopna na strani Dokumentacija SkyPlanner.
SkyPlanner je na voljo od 199 € na mesec z vključenimi 5 delovnimi centri in mesečnim obračunom. Ponudbo za integracijo pripravimo vnaprej glede na vaše procese in potrebe, skupaj z izbranim paketom, tako da pred začetkom poznate celoten strošek. Kako Proalpha planira zmogljivosti, preberite v članku Ali proALPHA omogoča terminiranje proizvodnje z upoštevanjem razpoložljivih zmogljivosti?. Pregled najdete na strani proALPHA, druge sisteme pa na strani z integracijami ERP.
Mnenja proizvodnih podjetij o sistemu SkyPlanner
2 hprihranka vsak teden
»Z uporabo sistema SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Planiranje proizvodnje vsak teden prihrani 2 uri delovnega časa, nov seznam operacij pa doseže proizvodno linijo v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
99,2%zanesljivost dobav
»SkyPlanner nam je omogočil boljši pregled nad proizvodnjo, da lažje prepoznamo ozka grla, in jasnejše vodenje proizvodnje.«
Toni Tuori, vodja proizvodnje
Piristeel · Strešni varnostni elementi in sistemi za odvajanje deževnice
Zanesljivost dobav je letos dosegla 99,2%, terminiranje pa prihrani do štiri ure delovnega časa na dan.
Manjzastojev zaradi pomanjkanja materiala
»Vrednost sistema SkyPlanner je za nas v tem, da je orodje, ki se obnese pri vsakodnevnem delu, zlasti pri določanju dobavnih rokov.«
Tommi Männistö, vodja planiranja proizvodnje
Eskomatic · Pogodbena strojna obdelava
Samodejno razporejanje obremenitev omogoča natančnejše dobavne roke, število zastojev v proizvodnji zaradi pomanjkanja materiala pa se je močno zmanjšalo.
Pogosta vprašanja
Katere vmesnike Proalpha uporablja integracija?
Vmesnike Proalpha REST API za artikle, zalogo ter zapisovanje terminov, virov in potrditev nazaj v ERP. Tokovi sporočil INWB ali Integration Platform na osnovi n8n prenašajo delovne naloge z operacijami. Za preizkus in množične uvoze se uporabljajo izvozne datoteke.
Kam se v Proalpha zapišejo planirani termini?
Na operacijo delovnega naloga, prek setWorkOrderOperationDates s časovnima točkama začetka in konca. Če je mehanizem operacijo premaknil na drug stroj, changeWorkOrderOperationResource posodobi vir.
Ali Proalpha podpira spletne kavlje?
Proalpha API Portal ne navaja API za naročanje na spletne kavlje. Spremembe pridejo v SkyPlanner prek tokov sporočil INWB, delovnih tokov n8n ali periodičnega poizvedovanja. Spletni kavlji sistema SkyPlanner omogočajo, da zapisovanje nazaj v ERP sprožijo dogodki.
Ali se lahko potrditve operaterjev knjižijo v Proalpha?
Da. Časovni zapisi iz SkyPlanner Mobile Confirmations se knjižijo prek operationDataEntry, skupaj s podatki o količini, času dela zaposlenih in času uporabe virov. Če uporabljate tudi terminale PDC, ohranite en kanal za potrjevanje.
Ali potrebujemo Proalpha APS in kaj, če ga že uporabljamo?
Ne potrebujete ga. SkyPlanner sam izdela terminski plan z upoštevanjem razpoložljivih zmogljivosti na podlagi vaših delovnih nalogov, operacij in virov, Autopilot pa ga sproti posodablja. Če je Proalpha APS aktiven, pri opredelitvi obsega določite, kateri sistem je pristojen za termine operacij. SkyPlanner nato zapisuje samo termine, za katere je pristojen, zato plana nikoli ne prepisujeta drug drugega.
Ali lahko SkyPlanner preizkusimo pred vzpostavitvijo integracije?
Da. V 30-dnevnem brezplačnem preizkusu lahko uporabite do 20 delovnih centrov in svoje delovne naloge, izvožene v CSV ali Excel. Kreditne kartice ne potrebujete. Začnite preizkus ali se obrnite na prodajno ekipo, da opredelite obseg integracije.
