Integrări / ERP / proALPHA ERP
Ghid de integrare proALPHA pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Proalpha le arată partenerilor și echipelor IT cum să conecteze Proalpha ERP la SkyPlanner APS. Integrarea dintre SkyPlanner și Proalpha este bidirecțională:
- SkyPlanner preia articole, comenzi de producție cu operațiile aferente, resurse, calendare, stocuri și comenzi de achiziție.
- Începutul și sfârșitul planificate pentru fiecare operație sunt trimise înapoi prin setWorkOrderOperationDates.
- Modificările de resurse sunt trimise înapoi prin changeWorkOrderOperationResource.
- Confirmările operatorilor sunt trimise înapoi prin operationDataEntry.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Proalpha în etapa de implementare și oferă asistență după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care doresc să participe la integrare sau să dezvolte singuri soluții folosind interfața REST API documentată a SkyPlanner (documentația API).
Interfețele Proalpha
Proalpha ERP rulează pe Progress OpenEdge, iar odată cu Release 9, platforma a trecut la OpenEdge 12. (Proalpha) Patru interfețe sunt relevante pentru programarea producției.
- Proalpha ERP REST APIs. Portalul public Proalpha API Portal listează 108 specificații OpenAPI 3.0 sub
api/web/v1. Aceste API-uri permit scrierea datelor înapoi în Proalpha și citirea articolelor și a stocurilor. - Integration Workbench (INWB). Potrivit Proalpha, INWB “is a central platform which connects different IT systems, machines, sites” (este o platformă centrală care conectează diferite sisteme IT, utilaje și locații) și “converts the data into the format of the target system.” (convertește datele în formatul sistemului destinație). (Proalpha) Primește mesaje pAX prin
POST /api/web/v1/inwb/message. Folosiți această interfață pentru transferul comenzilor de producție din și către Proalpha. - Proalpha Integration Platform. Anunțată în aprilie 2026 și bazată pe n8n, platforma “will be available to customers either on-premises or in the cloud.” (va fi disponibilă clienților atât pentru instalare locală, cât și în cloud). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (se va baza pe o arhitectură de referință centrată pe API-uri și pe interfețe REST). (Proalpha)
- EDI și exporturi de fișiere. INWB gestionează formate de fișiere specifice industriei, iar exporturile de fișiere sunt suficiente pentru testarea SkyPlanner.
Endpoint-uri pentru producție
| API Proalpha | Endpoint | Utilizare în integrare |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Începutul și sfârșitul planificate pentru fiecare operație (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Resursa selectată la programare (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Confirmări: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Articole cu partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Stoc pe zonă MRP |
Autentificare
Specificațiile publicate de Proalpha folosesc autentificarea HTTP Basic. Endpoint-urile sunt specifice mediului, {schema}://{host}:{port}/api/web/v1/..., pe serverul dumneavoastră Proalpha sau în Proalpha Cloud. Creați un utilizator tehnic dedicat, cu drepturi limitate la obiectele din tabelul de mapare. Stabiliți împreună cu echipa IT accesul prin rețea de la cloud-ul SkyPlanner la acel endpoint.
În SkyPlanner, interfața REST API folosește un token API pentru autentificare (SkyPlanner Settings > API) și este documentată în Swagger/OpenAPI. Un token API este suficient pentru a începe. Tutorialul de integrare vă ghidează prin primele apeluri.
Evenimente și interogări periodice
Proalpha API Portal nu listează niciun API pentru abonarea la webhook-uri. Modificările din Proalpha sunt transmise prin:
- un flux de mesaje INWB care trimite comenzile de producție noi și modificate, împreună cu operațiile aferente
- un flux de lucru n8n pe Proalpha Integration Platform
- interogări periodice programate ale Material API pentru stocuri
SkyPlanner trimite webhook-uri când se modifică starea sau programul de producție, astfel că scrierea datelor înapoi în Proalpha este declanșată de evenimente.
Maparea datelor
| Obiect sau API Proalpha | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
| Part (Part API) | Produse și materiale | Proalpha → SkyPlanner | Încărcare inițială, apoi la fiecare modificare |
| Modelul procesului de fabricație al produsului: proces, activități; poziții BOM ale comenzii de producție | Structura produsului, subproduse, etape de proces | Proalpha → SkyPlanner | Încărcare inițială, apoi la fiecare modificare |
| Comandă de producție (Fertigungsauftrag) cu cantitate și termen de finalizare | Comandă și operații cu termen de finalizare și prioritate | Proalpha → SkyPlanner | Transmitere prin INWB sau n8n, ori la fiecare câteva minute |
| Operațiile comenzii de producție: targetSetupTime, targetProcessTime, resource | Etape de proces cu timpi de reglaj și durate | Proalpha → SkyPlanner | Odată cu comanda de producție |
| Resurse, grupuri de resurse, grupuri de resurse alternative | Centre de lucru, grupuri de centre de lucru, centre de lucru alternative | Proalpha → SkyPlanner | Încărcare inițială |
| Intervale din calendarul resurselor cu intensity și overloadIntensity | Schimburi și eficiența centrelor de lucru | Proalpha → SkyPlanner | Încărcare inițială; actualizare zilnică sau gestionare în SkyPlanner |
| Stoc pe zonă MRP | Stoc de materiale | Proalpha → SkyPlanner | La fiecare oră sau înainte de fiecare generare a programului |
| Comenzi de achiziție cu dată de livrare | Materiale de primit, disponibile la data livrării | Proalpha → SkyPlanner | La fiecare oră sau înainte de fiecare generare a programului |
| setWorkOrderOperationDates | Începutul și sfârșitul programate pentru fiecare operație | SkyPlanner → Proalpha | La modificarea programului, printr-un webhook SkyPlanner |
| changeWorkOrderOperationResource | Centrul de lucru ales de motorul de programare | SkyPlanner → Proalpha | La modificarea programului |
| operationDataEntry (setup, process, combined) | Înregistrări de timp și cantități din Mobile Confirmations | SkyPlanner → Proalpha | La fiecare confirmare sau pe schimb |
| Reguli de programare SkyPlanner | Matricea timpilor de pregătire și tranziție, scule ca resurse cu capacitate finită, număr de operatori | Gestionate în SkyPlanner | Configurate în etapa de implementare |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți articolele prin Part API și încărcați o singură dată resursele, grupurile de resurse și calendarele prin INWB sau printr-un export de fișiere. Stabiliți cu atenție corespondența dintre fiecare resursă Proalpha și un centru de lucru SkyPlanner. Grupurile de resurse alternative devin centre de lucru alternative.
2. Sincronizarea comenzilor. Un flux de mesaje INWB sau un flux de lucru n8n trimite comenzile de producție deschise, împreună cu operațiile, timpii planificați și resursele acestora. Stocurile sunt preluate prin Material API pentru fiecare arie MRP, iar comenzile de achiziție deschise, prin INWB. SkyPlanner consideră materialele comandate disponibile la data de livrare din comanda de achiziție și actualizează stocul când aceasta este marcată cu starea Delivered.
3. Scrierea programului înapoi în ERP. Pentru fiecare operație programată sau mutată de motor, integrarea apelează setWorkOrderOperationDates cu guid-ul operației și momentele de început și de sfârșit. Dacă motorul a ales o altă resursă, urmează apelul changeWorkOrderOperationResource.
4. Confirmările din producție. Operatorii înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer. Înregistrările de timp mențin programul la zi și sunt transmise în Proalpha prin operationDataEntry. Dacă fabrica dumneavoastră folosește deja terminale PDC pentru confirmări, păstrați un singur canal pentru a evita înregistrările duble.
5. Reguli privind responsabilitatea pentru date și soluționarea conflictelor. Documentați-le înainte de punerea în producție:
| Date | Sistem responsabil |
|---|---|
| Articole, modele de proces, cantități, starea comenzilor de producție | Proalpha |
| Succesiunea operațiilor, momentele de început și de sfârșit, alocarea resurselor | SkyPlanner |
| Matricea timpilor de pregătire și tranziție, scule, numărul de operatori | SkyPlanner |
| Schimburi și absențe | Un singur sistem, ales la definirea domeniului |
| Confirmări și înregistrări de stoc | Proalpha, alimentat cu înregistrări de timp din SkyPlanner sau PDC |
Dacă Proalpha APS sau Feinplanung este activ, stabiliți care sistem gestionează datele calendaristice ale operațiilor. Dacă două sisteme de planificare scriu aceleași date, se suprascriu reciproc. Cu Autopilot, SkyPlanner reface automat programul când apar schimbări în producție.
Etapele obișnuite ale proiectului
Implementarea se finalizează de regulă în câteva săptămâni de la începerea procesului de configurare inițială. Înainte de aceasta, puteți folosi propriile date în perioada de testare gratuită de 30 de zile. Exportați din Proalpha comenzile de producție deschise, operațiile și resursele în format CSV sau Excel, importați-le și validați programul.
- Atelier de mapare. Stabiliți împreună cu partenerul dumneavoastră Proalpha tabelul de corespondențe, regulile privind responsabilitatea pentru date, frecvențele de sincronizare și canalul de confirmare.
- Configurarea interfețelor. Activați interfețele REST API și fluxurile INWB, creați utilizatorul tehnic și permiteți accesul prin rețea. Mai întâi în mediul de testare, apoi în cel de producție.
- Încărcarea inițială. Articole, resurse, grupuri de resurse și calendare.
- Sincronizarea comenzilor de producție, a stocurilor și a comenzilor de achiziție. Comenzile de producție sunt trimise prin INWB sau n8n, iar stocurile sunt preluate prin interogări periodice, cu reîncercări.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire și tranziție, scule, numărul de operatori și centre de lucru alternative.
- Scrierea programului înapoi în ERP. setWorkOrderOperationDates și changeWorkOrderOperationResource; în această etapă se adaugă și operationDataEntry.
- Rularea în paralel. Comparați datele calendaristice din SkyPlanner cu planul curent și corectați nomenclatoarele.
- Punerea în producție. Activați scrierea înapoi în ERP după ce datele concordă.
Ce trebuie să aveți în vedere la integrarea cu Proalpha
- Nu există un obiect pentru fluxul tehnologic. Proalpha planifică pe baza modelelor de proces ale produselor. Instrumentele preluate din proiecte SAP sau Business Central caută fluxuri tehnologice și omit date. Citiți operațiile și pozițiile BOM din comanda de producție.
- Intensitatea din calendar. Blocurile din calendar conțin câmpurile intensity și overloadIntensity. Mapați-le la schimburile și eficiențele din SkyPlanner, în loc să copiați pur și simplu orele.
- Unitățile de măsură. Verificați quantityUnitCode și dacă timpul de reglaj planificat este definit pe comandă sau pe bucată. Unitățile greșite denaturează toate duratele.
- Endpointuri găzduite de client. Componenta REST rulează pe serverul dumneavoastră Proalpha. Configurarea firewallurilor, a porturilor și a certificatelor determină data de începere a proiectului, așa că pregătiți-le din timp.
- Versiunea instalată. Înainte de a definitiva maparea, verificați împreună cu partenerul ce interfețe REST API sunt expuse de versiunea dumneavoastră Proalpha.
- Documentație accesibilă doar după autentificare. Ajutorul online Proalpha este disponibil prin Documentation Portal. Verificați denumirile câmpurilor cu partenerul, în loc să le ghiciți.
Integrarea cu Proalpha: cine o configurează și asigură asistența
- Echipa SkyPlanner configurează integrarea în etapa inițială și oferă asistență după punerea în producție. Fiecare instalare Proalpha are propriul model de date și procese, iar configurarea integrării necesită cunoașterea acestuia.
- Partenerul dumneavoastră Proalpha poate participa. Acesta cunoaște modelele de proces, fluxurile INWB și versiunea instalată și poate configura accesul la API. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhookuri.
- Dezvoltatorii dumneavoastră pot extinde integrarea folosind aceeași interfață REST API și un token API. Echipa SkyPlanner oferă asistență când este nevoie. Documentația produsului este publică și disponibilă în documentația SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Primiți de la început o ofertă pentru integrare, adaptată procesului și nevoilor dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Aflați cum planifică Proalpha capacitatea în Oferă proALPHA programare cu capacitate finită?, consultați prezentarea generală de pe pagina proALPHA și descoperiți alte sisteme în secțiunea de integrări ERP.
Ce spun producătorii despre SkyPlanner
2 heconomisite în fiecare săptămână
„Cu SkyPlanner, am trecut de la planificarea producției în foi de calcul Excel la optimizarea producției în timp real.”
Kalle Kalliomäki, specialist în lanțul de aprovizionare
UTU · Tablouri electrice și aparataj de comutație
Planificarea producției economisește 2 ore de lucru în fiecare săptămână, iar o nouă listă de operații ajunge la linia de producție în câteva secunde.
+90%eficiență în producție
„Eficiența în producție a crescut cu 90%.”
Abdul Rucyinga, director IT
Laboratory & Allied · Producție farmaceutică
Eficiența în producție a crescut cu 90%, iar realizarea unui plan optimizat pe trei luni, pentru toate centrele de lucru, durează mai puțin de 30 de minute.
99,2%respectarea termenelor de livrare
„SkyPlanner ne-a oferit vizibilitatea necesară pentru identificarea blocajelor și a adus claritate în gestionarea producției.”
Toni Tuori, director de producție
Piristeel · Sisteme de siguranță pentru acoperișuri și sisteme pluviale
Rata de respectare a termenelor de livrare a ajuns la 99,2% anul acesta, iar programarea economisește până la patru ore de lucru pe zi.
Mai puțineopriri cauzate de lipsa materialelor
„Valoarea pe care ne-o aduce SkyPlanner este că funcționează în activitatea de zi cu zi, mai ales pentru stabilirea termenelor de livrare.”
Tommi Männistö, manager de planificare a producției
Eskomatic · Prelucrări mecanice la comandă
Programarea automată a încărcării resurselor oferă termene de livrare mai precise, iar opririle de producție cauzate de lipsa materialelor s-au redus semnificativ.
Întrebări frecvente
Ce interfețe Proalpha folosește integrarea?
Interfețele REST API Proalpha pentru articole, stocuri și transmiterea înapoi în Proalpha a datelor calendaristice, a resurselor și a confirmărilor. Fluxurile de mesaje INWB sau Integration Platform, bazată pe n8n, transferă comenzile de producție împreună cu operațiile acestora. Pentru testare și încărcări în masă se folosesc exporturi de fișiere.
Unde sunt scrise datele calendaristice planificate în Proalpha?
În operația comenzii de producție, prin setWorkOrderOperationDates, cu momentele de început și de sfârșit. Dacă motorul a mutat operația pe alt utilaj, changeWorkOrderOperationResource actualizează resursa.
Proalpha acceptă webhookuri?
Proalpha API Portal nu listează niciun API de abonare la webhookuri. Modificările ajung în SkyPlanner prin fluxuri de mesaje INWB, fluxuri de lucru n8n sau interogări periodice. Webhookurile proprii SkyPlanner declanșează transmiterea datelor înapoi în Proalpha pe baza evenimentelor.
Confirmările operatorilor pot fi înregistrate în Proalpha?
Da. Înregistrările de timp din SkyPlanner Mobile Confirmations sunt transmise prin operationDataEntry, împreună cu cantitatea și timpii aferenți angajatului și resursei. Păstrați un singur canal de confirmare dacă folosiți și terminale PDC.
Avem nevoie de Proalpha APS și ce facem dacă îl folosim deja?
Nu aveți nevoie de el. SkyPlanner realizează singur programarea cu capacitate finită pe baza comenzilor de producție, a operațiilor și a resurselor dumneavoastră, iar Autopilot o menține la zi. Dacă Proalpha APS este activ, stabiliți la definirea domeniului care sistem gestionează datele calendaristice ale operațiilor. SkyPlanner scrie apoi doar datele pentru care este responsabil, astfel încât cele două planuri să nu se suprascrie niciodată.
Putem testa SkyPlanner înainte de a realiza integrarea?
Da. Perioada de testare gratuită de 30 de zile permite utilizarea a până la 20 de centre de lucru, pe baza unui export CSV sau Excel al comenzilor dumneavoastră de producție, fără card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
