Ghid de integrare HELIOS pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare HELIOS le arată partenerilor și echipelor IT cum să conecteze HELIOS iNuvio și HELIOS Nephrite la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu HELIOS, folosind interfețele proprii ale HELIOS:
- În SkyPlanner sunt preluate ordinele de producție (výrobní příkazy) cu operațiile aferente, piesele fabricate, listele de materiale, fluxurile tehnologice, locurile de muncă, utilajele, meseriile, resursele de personal, stocurile și comenzile de achiziție.
- Datele planificate de început și de sfârșit sunt transmise înapoi către ordinele de producție.
- Dacă doriți, pontajele operatorilor pot fi transmise înapoi ca înregistrări ale operațiilor (evidence výrobních operací).
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
Echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră HELIOS în etapa de implementare inițială și asigură asistență după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor HELIOS care doresc să participe sau să dezvolte singuri soluții folosind REST API documentat al SkyPlanner (documentația API).
Interfețele de integrare HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco îl descrie ca pe o componentă separată a HELIOS iNuvio, care oferă acces prin REST API la registrele HELIOS iNuvio (documentația Helios Inuvio Server). Este inclus în distribuția iNuvio, iar specificația OpenAPI este publicată în formatele Rapidoc și Redoc. API-ul lucrează cu listele HELIOS (browses), fiecare având propriul ID și propriile drepturi de acces:
- GET /browses/list și GET /browses/meta enumeră listele disponibile și coloanele acestora.
- /browses/data citește rândurile unei liste și permite scrierea lor acolo unde lista acceptă crearea, actualizarea și ștergerea.
- /api/v1/actions/meta și /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} execută acțiuni externe asupra unei liste. În prezent, sunt acceptate acțiuni externe de tip Procedure, Browse și Plugin.
Listele de producție folosite de un planificator includ planul de producție (výrobní plán), ordinele de producție (výrobní příkazy), piesele aferente ordinelor de producție, materialele și semifabricatele pentru producție, meseriile, resursele de personal, setările predefinite ale operațiilor din fluxul tehnologic și înregistrările operațiilor. Stocurile, intrările, ieșirile și comenzile de achiziție emise (vydané objednávky) sunt disponibile în același mod.
HELIOS Nephrite REST API. Planul de dezvoltare Nephrite include dezvoltarea REST API (planul de dezvoltare HELIOS Nephrite). În etapa de definire a domeniului proiectului, echipa SkyPlanner confirmă împreună cu dumneavoastră și partenerul HELIOS endpoint-urile Nephrite pentru instalarea dumneavoastră. Fluxurile de date de mai jos rămân aceleași.
Excel și CSV. Fiecare listă HELIOS permite exportul în Microsoft Office, suficient pentru încărcarea datelor în perioada de testare.
Autentificare și licențiere
- Două metode de autentificare. iNuvio oferă un API proprietar de autentificare mai vechi (/api/token) și un API OAuth2 mai nou, bazat pe RFC 6749 (/oauth/token, /oauth/revoke). Tokenurile sunt reînnoite prin POST /oauth/token sau GET /api/token.
- Licențiere. Helios Inuvio Server în sine este gratuit, iar REST API necesită licență. Începând cu versiunea 3.0.2026.0301, API-urile de sistem și cele pentru registre sunt reunite într-un singur Inuvio REST API, iar accesul la API nu mai este limitat de numărul de utilizatori.
- Drepturi de acces. Utilizatorul dedicat integrării are nevoie de drepturi de citire pentru listele de producție și de stocuri, precum și de dreptul de a executa acțiunile externe convenite.
În SkyPlanner, autentificarea la REST API se face cu un token API în antetul Authorization-Token (SkyPlanner Settings > API), iar documentația este disponibilă în Swagger/OpenAPI. Tutorialul de integrare explică pas cu pas primele apeluri.
Evenimente și interogare periodică
SkyPlanner citește datele din HELIOS la intervale stabilite. Apelurile către /browses/data, filtrate pentru ordinele de producție deschise și modificările recente, preiau noile lucrări. Frecvența se stabilește pentru fiecare fabrică: de la câteva minute pentru ordinele de producție până la o oră pentru stocuri.
SkyPlanner trimite notificări webhook când se schimbă starea sau programul de producție, astfel încât transmiterea datelor înapoi este declanșată de evenimente.
Maparea datelor
| Obiect HELIOS (listă) | Obiect SkyPlanner | Sens | Frecvență |
|---|---|---|---|
| Fișe de articole și piese fabricate (vyráběné dílce), unități de măsură | Produse și materiale | HELIOS → SkyPlanner | Încărcare inițială, apoi interogare periodică |
| Liste de materiale (kusovník, kusovníkové vazby) cu perioadă de valabilitate | Structura produsului, produse intermediare, materiale pentru fiecare produs | HELIOS → SkyPlanner | Încărcare inițială, apoi la modificare |
| Fluxuri tehnologice (technologický postup): operație, loc de muncă, timp de pregătire a utilajului și a operatorului, timp unitar, timp de încheiere, timp între operații | Etape de proces cu durate, timpi de pregătire și de încheiere | HELIOS → SkyPlanner | Încărcare inițială, apoi la modificare |
| Locuri de muncă (pracoviště), utilaje (stroje), locuri de muncă alternative | Centre de lucru, grupuri de centre de lucru, centre de lucru alternative | HELIOS → SkyPlanner | Încărcare inițială, rar ulterior |
| Meserii (výrobní profese), resurse de personal (výrobní personální zdroje) | Personal și număr de operatori pentru fiecare operație | HELIOS → SkyPlanner | Încărcare inițială, apoi la modificare |
| Calendare de planificare (plánovací kalendáře) | Schimburi și zile nelucrătoare | HELIOS → SkyPlanner | Zilnic sau schimburi proprii în SkyPlanner |
| Ordine de producție (výrobní příkazy), piesele și operațiile aferente, materiale pentru producție | Comenzi și operații cu termene de finalizare și necesar de materiale | HELIOS → SkyPlanner | Interogare la fiecare câteva minute |
| Stocuri (stav skladu) | Solduri de stoc | HELIOS → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
| Comenzi de achiziție emise (vydané objednávky) cu date de livrare | Comenzi de achiziție, materiale de recepționat în funcție de data livrării | HELIOS → SkyPlanner | Interogare la fiecare oră sau la rularea programării |
| Momentele planificate de început și de sfârșit pentru fiecare operație a ordinului de producție (acțiune externă) | Momentele planificate de început și de sfârșit pentru fiecare operație | SkyPlanner → HELIOS | La modificarea programului de producție, prin webhook SkyPlanner |
| Înregistrări ale operațiilor (evidence výrobních operací) | Pontaje și confirmări ale operatorilor | SkyPlanner → HELIOS | La fiecare confirmare sau la fiecare schimb, dacă se optează pentru aceasta |
| Nu există în HELIOS | Matricea timpilor de pregătire, scule ca resurse cu capacitate finită, operații cu mai mulți operatori | Gestionate în SkyPlanner | Configurate în etapa de implementare inițială |
Modele de integrare
1. Încărcarea inițială a nomenclatoarelor. Citiți piesele fabricate, listele de materiale, fluxurile tehnologice, locurile de muncă, utilajele, meseriile, resursele de personal și calendarele din listele TPV. Fiecare resursă HELIOS are un indicator pentru includerea în planificarea capacității de producție, așa că stabiliți pentru fiecare resursă ce va programa SkyPlanner. Un loc de muncă cu patru utilaje devine un grup de centre de lucru sau patru centre de lucru.
2. Sincronizarea ordinelor. Citiți ordinele de producție cu piesele, operațiile și materialele aferente, precum și comenzile de achiziție emise. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul când comanda este marcată Delivered. Programați ordinele de producție lansate. Cantitățile planificate din planul de producție rămân în HELIOS până când devin ordine de producție.
3. Transmiterea programului de producție înapoi în HELIOS. Când motorul programează sau mută o operație, un webhook SkyPlanner declanșează o acțiune externă asupra listei ordinelor de producție prin /api/v1/actions/execute. Acțiunea este o procedură HELIOS, convenită la definirea domeniului proiectului, care stabilește momentele planificate de început și de sfârșit ale operației din ordin. HELIOS validează modificarea conform propriei logici.
4. Confirmări din producție. Operatorii își înregistrează activitatea cu SkyPlanner Mobile Confirmations sau Production Timer, iar pontajele mențin programul de producție la zi. Dumneavoastră decideți dacă timpii efectivi sunt transmiși înapoi în HELIOS. Dacă da, o acțiune externă îi salvează ca înregistrări pentru fiecare operație a ordinului. Dacă nu, operatorii continuă să raporteze la terminalele HELIOS, iar SkyPlanner citește acele înregistrări.
5. Responsabilitatea pentru date și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Articole, liste de materiale, fluxuri tehnologice, cantități, starea ordinului | HELIOS |
| Succesiunea operațiilor, orele de început și de sfârșit, alocarea utilajelor | SkyPlanner |
| Matricea timpilor de pregătire, necesarul de scule și operatori, resurse alternative | SkyPlanner |
| Schimburi și zile nelucrătoare | Un singur sistem, ales la definirea domeniului |
| Înregistrări ale operațiilor, ieșiri și intrări de materiale | HELIOS, cu introducere directă sau transmitere din pontajele SkyPlanner |
Alegeți un singur sistem care să scrie datele calendaristice ale ordinelor. Dacă funcția de planificare a capacității de producție din HELIOS sau Nephrite APS încă scrie aceste date, dezactivați scrierea pentru ordinele programate de SkyPlanner sau păstrați planul HELIOS doar pentru testare.
Etapele obișnuite ale proiectului
În mod normal, implementarea se finalizează în câteva săptămâni de la începerea etapei inițiale. Înainte de aceasta, validați programul de producție în perioada de testare gratuită de 30 de zile, folosind locurile de muncă, fluxurile tehnologice și ordinele de producție deschise exportate din HELIOS în CSV sau Excel.
- Mapare. Stabiliți tabelul de mapare, regulile privind sistemul responsabil pentru date, frecvențele de sincronizare și dacă înregistrările operațiilor vor fi transmise înapoi.
- Acces la HELIOS. Configurați Helios Inuvio Server, utilizatorul dedicat integrării, datele de autentificare OAuth2 și licențierea REST API. Testați mai întâi pe o copie a bazei de date.
- Încărcare inițială. Piese fabricate, liste de materiale, fluxuri tehnologice, locuri de muncă, utilaje, meserii, calendare.
- Sincronizarea ordinelor de producție și a comenzilor de achiziție. Interogare periodică cu filtre, paginare și reîncercări.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire, sculele, numărul de operatori pentru fiecare operație și utilajele alternative sau personalul de înlocuire.
- Transmiterea programului de producție înapoi în HELIOS. Creați și testați acțiunile externe pentru datele planificate și, dacă optați pentru aceasta, pentru înregistrările operațiilor.
- Testare în paralel. Rulați SkyPlanner în paralel cu planul actual, comparați datele și corectați nomenclatoarele.
- Punerea în funcțiune. Activați transmiterea datelor înapoi după ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu HELIOS
- Indicatori de planificare. Numai resursele marcate pentru planificarea capacității de producție au date de capacitate fiabile. Verificați indicatorii pentru locurile de muncă, utilaje, meserii și subcontractări înainte de prima încărcare.
- Unități de timp. Timpii de pregătire, timpii unitari și timpii de încheiere pot fi introduși în ore, minute sau secunde. Convertiți-i la import; altfel, toate duratele vor fi greșite.
- Timpul dintre operații. Timpul constant dintre operații reprezintă așteptare, nu timp de funcționare a utilajului. Modelați-l ca timp de așteptare, nu ca necesar de capacitate.
- Operații subcontractate (kooperace). Timpul de transport se aplică atât la dus, cât și la întors. Modelați operațiile subcontractate ca etape care au doar o durată.
- Liste care permit scrierea. Toate listele permit citirea, dar numai unele permit crearea, actualizarea și ștergerea înregistrărilor. GET /browses/list cu filtrul browseCreateImplemented=1 arată care sunt acestea. Listele de ordine de producție permit doar citirea, așa că datele planificate sunt trimise înapoi prin acțiunea externă convenită.
Cine configurează integrarea cu HELIOS și asigură suportul
- Echipa SkyPlanner configurează integrarea în etapa de implementare și asigură suportul după punerea în funcțiune, pentru listele și acțiunile externe convenite. Fiecare fabrică folosește HELIOS în mod diferit, iar aceste particularități sunt luate în considerare aici.
- Partenerul dumneavoastră HELIOS poate participa. Acesta cunoaște instalarea, procedurile personalizate și licențele dumneavoastră și poate configura Helios Inuvio Server și acțiunile externe împreună cu echipa SkyPlanner.
- Propriii dezvoltatori pot extinde integrarea folosind REST API al SkyPlanner, cu un token API. Un token API este suficient pentru a începe, iar echipa SkyPlanner oferă asistență la nevoie. Detaliile sunt disponibile în documentația de integrare SkyPlanner.
SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Oferta pentru integrare este stabilită de la început, în funcție de procesul și nevoile dumneavoastră, împreună cu abonamentul. Consultați tarifele, programarea cu capacitate finită pentru HELIOS, pagina HELIOS și secțiunea de integrări ERP. Pentru noțiunile de bază, consultați pagina despre programarea producției.
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.
Mii (1.000+)de comenzi de producție programate automat
„Avem un alt nivel de control asupra producției, iar înțelegerea capacității noastre este la un nivel complet diferit.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție pe bază de contract cu tehnologii avansate
Mii de comenzi de producție sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
100%respectarea termenelor de livrare din 2021
„SkyPlanner ne oferă vizibilitate asupra capacității și face planificarea predictibilă.”
Dan Berglund, COO/CFO
Opes Corporation · Producție chimică și alimentară
Termenele de livrare au fost respectate în proporție de 100% pe întreaga perioadă de utilizare a SkyPlanner, din 2021.
Întrebări frecvente
HELIOS are un API pentru comenzile de producție?
Da. Helios Inuvio Server oferă acces REST la listele din HELIOS iNuvio, inclusiv la planul de producție, comenzile de producție, componentele comenzilor, materialele pentru producție și înregistrările operațiilor. Pentru HELIOS Nephrite, echipa SkyPlanner stabilește metoda de integrare pentru instalarea dumneavoastră împreună cu dumneavoastră și partenerul HELIOS, la definirea domeniului proiectului în etapa de implementare.
Cum preia SkyPlanner modificările din HELIOS?
SkyPlanner interoghează periodic listele HELIOS, la intervale stabilite pentru fiecare fabrică, folosind filtre pentru comenzile de producție deschise și modificările recente. Webhook-urile proprii ale SkyPlanner transmit modificările programului de producție pe măsură ce apar.
Cum sunt transmise înapoi și înregistrate în HELIOS datele planificate?
Printr-o acțiune externă asociată listei de comenzi de producție, executată cu /api/v1/actions/execute. Acțiunea este o procedură HELIOS convenită la definirea domeniului proiectului, astfel încât HELIOS își aplică propria logică fiecărei date primite.
Ce metodă de autentificare folosește Inuvio REST API?
OAuth2 conform RFC 6749, la /oauth/token, sau metoda proprietară mai veche, la /api/token. API-ul propriu al SkyPlanner folosește un token API în antetul Authorization-Token.
Ce ar trebui să propună un partener HELIOS: HELIOS APS sau SkyPlanner?
SkyPlanner, atunci când planul clientului se schimbă frecvent, iar programarea trebuie să respecte capacitatea finită. Planificarea în HELIOS se bazează pe calcule efectuate pe un singur plan activ, poate trece la capacitate nelimitată pentru a respecta termenele și lasă rezolvarea suprapunerilor în sarcina planificatorului (documentația de ajutor HELIOS). SkyPlanner se conectează prin REST API, reprogramează automat producția, planifică schimbările de serie, sculele, echipele și materialele și permite un număr nelimitat de utilizatori, de la 199 € pe lună.
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, cu importuri CSV sau Excel din HELIOS, fără a fi necesar un card de credit. Începeți testarea sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
