Integracijos / ERP / proALPHA ERP
proALPHA integravimo vadovas gamybos tvarkaraščiams sudaryti su SkyPlanner APS
Šiame Proalpha integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti Proalpha ERP su SkyPlanner APS. SkyPlanner ir Proalpha keičiasi duomenimis abiem kryptimis:
- Į SkyPlanner perduodami duomenys apie detales, gamybos užsakymus su operacijomis, išteklius, kalendorius, atsargas ir pirkimo užsakymus.
- Suplanuotas kiekvienos operacijos pradžios ir pabaigos laikas grąžinamas per setWorkOrderOperationDates.
- Išteklių pakeitimai grąžinami per changeWorkOrderOperationResource.
- Operatorių patvirtinimai grąžinami per operationDataEntry.
- SkyPlanner siunčia pranešimus apie tvarkaraščio pakeitimus per webhook vos jiems įvykus.
Diegimo metu SkyPlanner komanda sukonfigūruoja integraciją pagal jūsų Proalpha aplinką, o pradėjus dirbti teikia jos palaikymą. Šis vadovas skirtas partneriams ir programuotojams, norintiems prisidėti prie integravimo arba patiems kurti sprendimus naudojant dokumentuotą SkyPlanner REST API (API dokumentacija).
Proalpha sąsajos
Proalpha ERP veikia Progress OpenEdge platformoje, o išleidus Release 9 pereita prie OpenEdge 12. (Proalpha) Tvarkaraščiams sudaryti svarbios keturios sąsajos.
- Proalpha ERP REST API. Viešajame portale Proalpha API Portal pateiktos 108 OpenAPI 3.0 specifikacijos, kurių kelias prasideda
api/web/v1. Šios sąsajos naudojamos duomenims įrašyti atgal, taip pat detalių ir atsargų duomenims nuskaityti. - Integration Workbench (INWB). Pasak Proalpha, INWB „is a central platform which connects different IT systems, machines, sites“ (yra centrinė platforma, jungianti skirtingas IT sistemas, įrenginius ir padalinius) ir „converts the data into the format of the target system.“ (konvertuoja duomenis į paskirties sistemos formatą). (Proalpha) Ji gauna pAX pranešimus per
POST /api/web/v1/inwb/message. Naudokite ją gamybos užsakymams perduoti iš Proalpha ir į Proalpha. - Proalpha Integration Platform. Apie šią n8n pagrindu veikiančią platformą paskelbta 2026 m. balandį. Ji „will be available to customers either on-premises or in the cloud.“ (klientams bus prieinama tiek jų infrastruktūroje, tiek debesijoje). Proalpha „will rely on an API-centric reference architecture and REST interfaces.“ (remsis į API orientuota etalonine architektūra ir REST sąsajomis). (Proalpha)
- EDI ir eksportas į failus. INWB apdoroja konkrečioms pramonės šakoms skirtus failų formatus, o bandomajam SkyPlanner naudojimui pakanka eksporto į failus.
Gamybos API galiniai taškai
| Proalpha API | Galinis taškas | Paskirtis integracijoje |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Suplanuotas kiekvienos operacijos pradžios ir pabaigos laikas (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Sudarant tvarkaraštį parinktas išteklius (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Patvirtinimai: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Detalės su laukais partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Atsargos pagal MRP sritį |
Autentifikavimas
Paskelbtose Proalpha specifikacijose naudojamas HTTP Basic autentifikavimas. Galinių taškų adresai priklauso nuo aplinkos: {schema}://{host}:{port}/api/web/v1/... jūsų Proalpha serveryje arba Proalpha Cloud. Sukurkite atskirą techninio naudotojo paskyrą ir suteikite jai teises tik į susiejimo lentelėje nurodytus objektus. Su savo IT komanda suplanuokite tinklo prieigą iš SkyPlanner debesijos prie to galinio taško.
SkyPlanner REST API autentifikavimui naudoja API prieigos raktą (SkyPlanner Settings > API), o jos dokumentacija pateikta Swagger/OpenAPI formatu. Pradžiai pakanka API prieigos rakto. Integravimo pamokoje žingsnis po žingsnio paaiškinama, kaip atlikti pirmąsias užklausas.
Įvykiai ir periodinės užklausos
Portale Proalpha API Portal nepateikta API, skirta webhook prenumeruoti. Pakeitimai iš Proalpha perduodami šiais būdais:
- per INWB pranešimų srautą, kuriuo siunčiami nauji ir pakeisti gamybos užsakymai su jų operacijomis
- per n8n darbo eigą Proalpha Integration Platform platformoje
- pagal grafiką siunčiant užklausas į Material API atsargoms gauti
Pasikeitus būsenai arba tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, todėl duomenų įrašymą atgal į Proalpha inicijuoja įvykiai.
Duomenų susiejimas
| Proalpha objektas arba API | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
| Part (Part API) | Gaminiai ir medžiagos | Proalpha → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Gaminio proceso modelis: process, activities; gamybos užsakymo BOM eilutės | Gaminio struktūra, gaminio dalys, proceso etapai | Proalpha → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Gamybos užsakymas (Fertigungsauftrag) su kiekiu ir įvykdymo terminu | Užsakymas ir užduotys su įvykdymo terminu ir prioritetu | Proalpha → SkyPlanner | Siunčiama per INWB ar n8n arba kas kelias minutes |
| Gamybos užsakymo operacijos: targetSetupTime, targetProcessTime, resource | Proceso etapai su paruošimo laiku ir trukme | Proalpha → SkyPlanner | Kartu su gamybos užsakymu |
| Ištekliai, išteklių grupės, alternatyvios išteklių grupės | Darbo centrai, darbo centrų grupės, alternatyvūs darbo centrai | Proalpha → SkyPlanner | Pradinis įkėlimas |
| Išteklių kalendoriaus blokai su intensity ir overloadIntensity | Pamainos ir darbo centrų našumo rodikliai | Proalpha → SkyPlanner | Pradinis įkėlimas; vėliau – kasdien arba tvarkoma SkyPlanner sistemoje |
| Atsargos pagal MRP sritį | Medžiagų atsargos | Proalpha → SkyPlanner | Kas valandą arba prieš kiekvieną tvarkaraščio sudarymą |
| Pirkimo užsakymai su pristatymo data | Gaunamos medžiagos pagal jų pristatymo datą | Proalpha → SkyPlanner | Kas valandą arba prieš kiekvieną tvarkaraščio sudarymą |
| setWorkOrderOperationDates | Tvarkaraštyje numatytas kiekvienos operacijos pradžios ir pabaigos laikas | SkyPlanner → Proalpha | Pasikeitus tvarkaraščiui, per SkyPlanner webhook |
| changeWorkOrderOperationResource | Planavimo variklio parinktas darbo centras | SkyPlanner → Proalpha | Pasikeitus tvarkaraščiui |
| operationDataEntry (setup, process, combined) | Laiko įrašai ir kiekiai iš Mobile Confirmations | SkyPlanner → Proalpha | Po kiekvieno patvirtinimo arba kiekvieną pamainą |
| SkyPlanner tvarkaraščio sudarymo taisyklės | Pasiruošimo ir perėjimo tarp užduočių laiko matrica, įrankiai kaip riboti ištekliai, operatorių skaičius | Tvarkoma SkyPlanner sistemoje | Sukonfigūruojama diegimo metu |
Integravimo scenarijai
1. Pradinis pagrindinių duomenų įkėlimas. Detalių duomenis nuskaitykite per Part API, o išteklius, jų grupes ir kalendorius vieną kartą įkelkite per INWB arba eksportuotą failą. Kiekvieną Proalpha išteklių apgalvotai susiekite su SkyPlanner darbo centru. Alternatyvios išteklių grupės tampa alternatyviais darbo centrais.
2. Užsakymų sinchronizavimas. INWB pranešimų srautas arba n8n darbo eiga perduoda atvirus gamybos užsakymus su jų operacijomis, planinėmis trukmėmis ir ištekliais. Atsargų duomenys gaunami per Material API pagal MRP sritį, o atviri pirkimo užsakymai – per INWB. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakyme nurodytą pristatymo dieną ir atnaujina atsargas, kai pirkimo užsakymui priskiriama būsena Delivered.
3. Tvarkaraščio įrašymas atgal. Kiekvienai operacijai, kurią planavimo variklis įtraukė į tvarkaraštį arba perkėlė, integracija iškviečia setWorkOrderOperationDates ir perduoda operacijos guid, pradžią bei pabaigą. Jei variklis parinko kitą išteklių, po to iškviečiama changeWorkOrderOperationResource.
4. Atlikto darbo patvirtinimai. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer. Pagal darbo laiko įrašus atnaujinamas tvarkaraštis, o patys įrašai perduodami į Proalpha per operationDataEntry. Jei jūsų gamykloje darbas jau patvirtinamas PDC terminaluose, palikite vieną kanalą, kad įrašai nesidubliuotų.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užfiksuokite jas prieš pradėdami naudoti integraciją gamybinėje aplinkoje:
| Duomenys | Atsakinga sistema |
|---|---|
| Detalės, procesų modeliai, kiekiai, gamybos užsakymo būsena | Proalpha |
| Operacijų seka, pradžios ir pabaigos laikai, išteklių priskyrimas | SkyPlanner |
| Paruošimo laiko matrica, įrankiai, operatorių skaičius | SkyPlanner |
| Pamainos ir neatvykimai į darbą | Viena sistema, pasirinkta apibrėžiant apimtį |
| Atlikto darbo patvirtinimai ir atsargų judėjimo įrašai | Proalpha, gaunanti duomenis iš SkyPlanner darbo laiko įrašų arba PDC |
Jei naudojate Proalpha APS arba Feinplanung, nuspręskite, kuri sistema bus atsakinga už operacijų datas. Dvi planavimo sistemos, įrašančios tas pačias datas, perrašo viena kitos duomenis. Naudodama Autopilot, SkyPlanner automatiškai atnaujina tvarkaraštį, kai gamyboje įvyksta pokyčių.
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo pasirengimo naudoti sistemą pradžios. Prieš tai galite 30 dienų nemokamai išbandyti sistemą su savo duomenimis. Eksportuokite atvirus gamybos užsakymus, operacijas ir išteklius iš Proalpha į CSV arba Excel, importuokite juos ir patikrinkite tvarkaraštį.
- Duomenų susiejimo sesija. Su savo Proalpha partneriu suderinkite susiejimo lentelę, atsakomybės už duomenis taisykles, sinchronizavimo dažnį ir atlikto darbo patvirtinimo kanalą.
- Sąsajų paruošimas. Įjunkite REST API ir INWB srautus, sukurkite techninį naudotoją ir suteikite tinklo prieigą. Pirmiausia tai atlikite bandomojoje, tada gamybinėje aplinkoje.
- Pradinis duomenų įkėlimas. Detalės, ištekliai, išteklių grupės ir kalendoriai.
- Gamybos užsakymų, atsargų ir pirkimo užsakymų sinchronizavimas. Gamybos užsakymai siunčiami per INWB arba n8n, atsargos tikrinamos periodinėmis užklausomis; numatomi pakartotiniai bandymai.
- Apribojimų nustatymas SkyPlanner sistemoje. Paruošimo laiko matrica, įrankiai, operatorių skaičius ir alternatyvūs darbo centrai.
- Tvarkaraščio įrašymas atgal. setWorkOrderOperationDates ir changeWorkOrderOperationResource; šiame etape taip pat pridedama operationDataEntry.
- Lygiagretus naudojimas. Palyginkite SkyPlanner datas su esamu planu ir pataisykite pagrindinius duomenis.
- Darbo pradžia gamybinėje aplinkoje. Kai duomenys sutampa, įjunkite įrašymą atgal.
Ką numatyti integruojant Proalpha
- Nėra technologinio maršruto objekto. Proalpha planavimui naudoja gaminių procesų modelius. Iš SAP arba Business Central projektų perkelti įrankiai ieško technologinių maršrutų ir neaptinka dalies duomenų. Iš gamybos užsakymo nuskaitykite operacijas ir BOM eilutes.
- Kalendoriaus intensyvumas. Kalendoriaus blokuose yra intensity ir overloadIntensity reikšmės. Susiekite jas su SkyPlanner pamainomis ir efektyvumo rodikliais, užuot tiesiog kopijavę valandas.
- Matavimo vienetai. Patikrinkite quantityUnitCode ir tai, ar planinis paruošimo laikas nurodytas visam užsakymui, ar vienam vienetui. Neteisingi vienetai iškraipo visas trukmes.
- Kliento serveryje veikiantys galiniai taškai. REST sluoksnis veikia jūsų Proalpha serveryje. Nuo užkardų, prievadų ir sertifikatų paruošimo priklauso projekto pradžios data, todėl prieiga pasirūpinkite iš anksto.
- Sistemos versija. Prieš galutinai suderindami duomenų susiejimą, su partneriu patikrinkite, kurios REST API prieinamos jūsų Proalpha versijoje.
- Dokumentacija pasiekiama tik prisijungus. Proalpha internetinis žinynas pasiekiamas per Documentation Portal. Užuot spėlioję laukų pavadinimus, pasitikslinkite juos su partneriu.
Proalpha integracija: kas ją konfigūruoja ir teikia pagalbą
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir teikia pagalbą pradėjus ją naudoti gamybinėje aplinkoje. Kiekvienoje Proalpha sistemoje duomenys modeliuojami skirtingai, todėl čia ši patirtis ir praverčia.
- Gali dalyvauti ir jūsų Proalpha partneris. Partneris žino jūsų procesų modelius, INWB srautus bei sistemos versiją ir gali paruošti API prieigą. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir „webhook“ pranešimus.
- Jūsų programuotojai gali toliau plėtoti integraciją, naudodami tą pačią REST API ir API prieigos raktą. Prireikus padeda SkyPlanner komanda. Produkto dokumentacija viešai pasiekiama skiltyje SkyPlanner dokumentacija.
SkyPlanner kaina prasideda nuo 199 € per mėnesį, įskaitant 5 darbo centrus, mokant kas mėnesį. Integracijos kaina pagal jūsų procesus ir poreikius pateikiama iš anksto kartu su plano kaina, todėl visas išlaidas žinote dar prieš pradėdami. Kaip Proalpha planuoja pajėgumus, skaitykite straipsnyje Ar proALPHA palaiko gamybos planavimą pagal realius įrenginių ir darbuotojų pajėgumus?, apžvalgą rasite proALPHA puslapyje, o kitas sistemas – ERP integracijų skiltyje.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skydai ir skirstomieji įrenginiai
Planuojant gamybą kas savaitę sutaupoma 2 valandos darbo laiko, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
99,2%pristatymo patikimumas
„SkyPlanner padėjo aiškiau matyti gamybos kliūtis ir suteikė daugiau aiškumo valdant gamybą.“
Toni Tuori, gamybos vadovas
Piristeel · Stogo saugos ir lietaus nuvedimo sistemos
Šiemet pristatymo patikimumas pasiekė 99,2%, o sudarant gamybos tvarkaraščius sutaupoma iki keturių valandų darbo laiko per dieną.
Mažiauprastovų dėl medžiagų trūkumo
„SkyPlanner mums vertingas tuo, kad tai kasdienėje veikloje pasiteisinantis įrankis, ypač nustatant pristatymo datas.“
Tommi Männistö, gamybos planavimo vadovas
Eskomatic · Užsakomasis mechaninis apdirbimas
Automatiškai planuojant apkrovą tiksliau nustatomos pristatymo datos, o gamybos prastovų dėl medžiagų trūkumo gerokai sumažėjo.
Dažniausiai užduodami klausimai
Kokias Proalpha sąsajas naudoja integracija?
Proalpha REST API naudojamos detalėms ir atsargoms nuskaityti bei datoms, ištekliams ir atlikto darbo patvirtinimams įrašyti atgal. INWB pranešimų srautai arba n8n pagrindu veikianti Integration Platform perduoda gamybos užsakymus su jų operacijomis. Bandomuoju laikotarpiu ir masiniam duomenų įkėlimui naudojamas eksportas į failus.
Kur Proalpha sistemoje įrašomos suplanuotos datos?
Jos įrašomos į gamybos užsakymo operaciją per setWorkOrderOperationDates, perduodant pradžios ir pabaigos laiko momentus. Jei planavimo variklis perkėlė užduotį į kitą įrenginį, changeWorkOrderOperationResource atnaujina priskirtą išteklių.
Ar Proalpha palaiko „webhook“ pranešimus?
Proalpha API Portal nenurodyta „webhook“ pranešimų prenumeratos API. Pokyčiai SkyPlanner pasiekia per INWB pranešimų srautus, n8n darbo eigas arba periodines užklausas. SkyPlanner siunčiami „webhook“ pranešimai leidžia įrašymą atgal inicijuoti pagal įvykius.
Ar operatorių atlikto darbo patvirtinimus galima perduoti į Proalpha?
Taip. SkyPlanner Mobile Confirmations darbo laiko įrašai perduodami per operationDataEntry kartu su kiekiu, darbuotojo darbo laiku ir ištekliaus naudojimo laiku. Jei naudojami ir PDC terminalai, palikite vieną patvirtinimų kanalą.
Ar mums reikia Proalpha APS ir ką daryti, jei ją jau naudojame?
Jos nereikia. SkyPlanner pati sudaro tvarkaraštį pagal jūsų gamybos užsakymus, operacijas ir išteklius, atsižvelgdama į realius įrenginių bei darbuotojų pajėgumus, o Autopilot jį nuolat atnaujina. Jei naudojate Proalpha APS, apibrėždami apimtį nuspręskite, kuri sistema bus atsakinga už operacijų datas. Tada SkyPlanner įrašo tik tas datas, už kurias yra atsakinga, todėl abu planai niekada neperrašo vienas kito duomenų.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų, įkėlę į CSV arba Excel eksportuotus gamybos užsakymus. Kredito kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimo komanda, kad apibrėžtumėte integracijos apimtį.
