Ghid de integrare Monitor ERP pentru programarea producției cu SkyPlanner APS
Acest ghid de integrare Monitor ERP le arată partenerilor și echipelor IT cum să conecteze Monitor ERP (Monitor G5) la SkyPlanner APS. SkyPlanner se integrează bidirecțional cu Monitor ERP prin Monitor ERP API:
- În SkyPlanner sunt preluate comenzile de fabricație, operațiile, centrele de lucru, fluxurile tehnologice și materialele.
- Datele planificate de început și de sfârșit, precum și centrul de lucru pentru fiecare operație sunt transmise către Monitor.
- Timpii și cantitățile raportate mențin cele două sisteme sincronizate.
- Webhook-urile SkyPlanner transmit modificările programului pe măsură ce apar.
În etapa de implementare inițială, echipa SkyPlanner configurează integrarea în funcție de configurația dumneavoastră Monitor G5 și asigură suport după punerea în funcțiune. Acest ghid se adresează partenerilor și dezvoltatorilor care doresc să participe sau să dezvolte singuri soluții folosind interfața REST API documentată a SkyPlanner (documentația API).
Monitor ERP API
Interfața de integrare documentată pentru Monitor G5 este Monitor ERP API v1. Aceasta combină CQRS și REST și utilizează JSON prin HTTPS. (Monitor ERP API)
- Interogările citesc date prin GET. Acceptă opțiuni de tip OData:
$filter,$select,$expand,$orderby,$topși$skip. - Comenzile scriu date prin POST, de exemplu
Manufacturing/ManufacturingOrderOperations/Update. - Batch execută mai multe comenzi într-o singură tranzacție de tip „totul sau nimic”, prin
POST /api/v1/Batch. Adăugați/Simulatesau/Validatepentru a testa un lot de comenzi și a anula modificările. Aceasta este modalitatea sigură de a scrie un program de producție complet. (Batch)
URL-ul de bază este https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Numărul companiei combină numărul bazei de date cu identificatorul companiei, de exemplu 004.1.
În privința licențierii, Monitor precizează: “It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.” (Toți clienții noștri pot interoga și extrage gratuit informații prin API. Pentru a utiliza comenzi și a scrie date în sistemul ERP, trebuie însă să achiziționeze Monitor ERP API.) Includeți licența pentru scrierea datelor în proiect încă din prima zi. (api.monitor.se)
Autentificare
- Autentificare pe bază de sesiune. Apelul
POST /{languageCode}/{companyNumber}/login, cu numele și parola unui utilizator Monitor, returnează un antetX-Monitor-SessionIdpentru apelurile ulterioare. Este disponibil și un flux cu token MFA. - OIDC. Începând cu Monitor 25.8, autentificarea funcționează și prin Microsoft Entra ID, cu Authorization Code și PKCE. (Autentificare)
- Utilizator API dedicat. Creați un singur utilizator pentru integrare. Acestuia i se aplică permisiunile din Monitor, precum Show manufacturing orders și Replan existing manufacturing order.
În SkyPlanner, interfața REST API folosește un token API pentru autentificare (SkyPlanner Settings > API) și este documentată în Swagger/OpenAPI. Tutorialul de integrare vă ghidează prin primele apeluri.
Detectarea modificărilor și interogarea periodică
Documentația Monitor ERP API nu descrie webhook-uri sau abonamente la evenimente. Modificările sunt preluate prin interogare periodică:
Common/EntityChangeLogs(începând cu 2.33) returneazăChangeType(Update, Create, Delete),EntityTypeId,EntityIdșiModifiedTimestamp. Interogați acest endpoint la fiecare câteva minute și preluați doar înregistrările modificate. (EntityChangeLog)- Filtrați interogările comenzilor de fabricație pentru a include doar comenzile deschise și paginați rezultatele cu
$topși$skip.
SkyPlanner trimite webhook-uri când se modifică starea sau programul de producție, astfel încât transmiterea datelor către Monitor este declanșată de evenimente.
Maparea datelor
| Obiect Monitor ERP (API) | Obiect SkyPlanner | Direcție | Frecvență |
|---|---|---|---|
Part (Inventory/Parts) | Produse și materiale | Monitor → SkyPlanner | Încărcare inițială, apoi pe baza jurnalului de modificări |
BOM și flux tehnologic: Manufacturing/MaterialRows, Manufacturing/OperationRows | Structura produsului; etape de proces cu timpi de pregătire și timpi unitari | Monitor → SkyPlanner | Încărcare inițială, apoi la modificare |
Manufacturing/AlternativeOperationRows | Centre de lucru alternative pentru fiecare etapă | Monitor → SkyPlanner | Încărcare inițială, apoi la modificare |
Centru de lucru (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Centre de lucru, grupuri de centre de lucru, randamente | Monitor → SkyPlanner | Încărcare inițială, apoi rar |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Schimburi și absențe | Monitor → SkyPlanner | Zilnic sau schimburi proprii în SkyPlanner |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Comenzi cu termene și stare | Monitor → SkyPlanner | Interogarea jurnalului de modificări la fiecare câteva minute |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Lucrări cu durate și cantitate rămasă | Monitor → SkyPlanner | Interogarea jurnalului de modificări la fiecare câteva minute |
Manufacturing/ManufacturingOrderMaterials | Necesar de materiale pentru fiecare comandă | Monitor → SkyPlanner | Interogarea periodică a jurnalului de modificări |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Stoc; materiale în curs de aprovizionare, la data livrării | Monitor → SkyPlanner | Interogare la fiecare oră sau la fiecare recalculare a programului de producție |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Începutul și sfârșitul planificate pentru fiecare operație | SkyPlanner → Monitor | La modificarea programului de producție, prin webhook SkyPlanner |
ManufacturingOrderOperations/SetWorkCenter | Centrul de lucru ales de motorul de programare | SkyPlanner → Monitor | La modificarea programului de producție |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Înregistrări de timp și cantități | Un singur canal, ales la definirea domeniului | La fiecare confirmare sau la fiecare schimb |
| Nu există în Monitor | Matricea timpilor de pregătire, scule ca resurse cu capacitate finită, lucrări 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 centrele de lucru, rândurile de operații, rândurile de operații alternative, rândurile de materiale, articolele și programele de lucru. Stabiliți cu atenție corespondența dintre fiecare centru de lucru și un centru de lucru SkyPlanner. Un centru de lucru de tip Pool devine un grup de centre de lucru, iar centrele incluse în acesta devin centrele de lucru între care alege motorul de programare.
2. Sincronizarea comenzilor. Citiți comenzile de fabricație deschise, cu nodurile, operațiile și materialele lor, precum și stocul și comenzile de achiziție deschise. SkyPlanner consideră materialul comandat disponibil la data de livrare a comenzii de achiziție și actualizează stocul când comanda este marcată Delivered. După prima încărcare, actualizările incrementale se bazează pe Common/EntityChangeLogs.
3. Transmiterea programului de producție către Monitor. Pentru fiecare operație programată sau mutată de motor, SkyPlanner trimite ManufacturingOrderOperations/Update cu PlannedStartDate și PlannedFinishDate. Dacă motorul a mutat o operație pe alt utilaj dintr-un grup, se execută mai întâi SetWorkCenter. Comenzile aferente unei comenzi de fabricație sunt incluse într-un singur Batch, astfel încât Monitor le acceptă pe toate sau pe niciuna. În timpul testării, rulați lotul de comenzi prin /Validate.
În versiunile Monitor anterioare versiunii 24.5, datele planificate nu pot fi scrise prin Update. Folosiți în schimb ManufacturingOrders/ReplanOperation (începând cu 2.40), cu StartDate și FinishDate, și configurați RestrictToOrderBounds conform regulilor dumneavoastră.
4. Confirmări din producție. Păstrați un singur canal de raportare:
- Monitor rămâne canalul de raportare. Operatorii raportează în Recording terminal sau prin integrarea cu utilajele, ca și până acum. SkyPlanner citește
ManufacturingOrderOperationReportingspentru a urmări progresul și reface programarea. - SkyPlanner devine canalul de raportare. Operatorii înregistrează lucrul prin Mobile Confirmations sau Production Timer, iar SkyPlanner trimite
ReportManufacturingOrderOperationcătre Monitor.
Raportarea din ambele sisteme dublează timpii și cantitățile.
5. Responsabilitatea asupra datelor și regulile de gestionare a conflictelor. Documentați-le înainte de punerea în funcțiune:
| Date | Sistem responsabil |
|---|---|
| Articole, BOM și flux tehnologic, cantități, starea comenzilor | Monitor |
| Succesiunea operațiilor, începutul și sfârșitul planificate, centrul de lucru din cadrul unui grup | SkyPlanner |
| Matricea timpilor de pregătire, scule, numărul de operatori, resurse alternative | SkyPlanner |
| Schimburi și absențe | Un singur sistem, ales la definirea domeniului |
| Raportarea operațiilor | Un singur canal, ales la definirea domeniului |
Principala sursă de conflicte este continuarea modificării planului de priorități de către planificatori. Rescheduling according to New finish și mutarea rândurilor prin glisare în Priority planning suprascriu datele calendaristice înscrise de SkyPlanner. Odată ce SkyPlanner stabilește succesiunea, Priority planning se folosește doar pentru vizualizare. Cu Autopilot, SkyPlanner reface automat programarea 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 configurării inițiale. Înainte de această etapă, puteți folosi perioada de probă gratuită de 30 de zile cu propriile date. Exportați în Excel operațiile comenzilor de fabricație deschise și centrele de lucru din Monitor, importați-le și validați programul de producție înainte de a începe lucrările de integrare.
Proiectul propriu-zis cuprinde:
- Definirea domeniului. Stabiliți tabelul de corespondență, regulile privind sistemul responsabil pentru fiecare tip de date, intervalele de interogare, canalul de raportare și versiunea Monitor.
- Acces. Creați utilizatorul API, achiziționați licența de scriere pentru Monitor ERP API și permiteți accesul prin rețea la portul 8001.
- Încărcarea inițială. Articole, centre de lucru, rânduri de operații, alternative, materiale și programe de lucru.
- Sincronizarea comenzilor și a comenzilor de achiziție pe baza jurnalului de modificări.
- Configurarea constrângerilor în SkyPlanner. Matricea timpilor de pregătire, scule, numărul de operatori și utilaje sau personal alternativ.
- Transmiterea programului de producție către Monitor în loturi, testată cu
/Validate. - Testarea în paralel. Rulați SkyPlanner în paralel cu planul de priorități, comparați datele calendaristice și corectați nomenclatoarele.
- Punerea în producție. Activați transmiterea datelor către Monitor odată ce datele corespund.
Ce trebuie să aveți în vedere la integrarea cu Monitor ERP
- Factorul de disponibilitate. Monitor calculează capacitatea netă din capacitatea brută folosind factorul de disponibilitate, setat implicit la 80 % pentru un centru de lucru nou. Aplicați-l o singură dată: fie ca eficiență în SkyPlanner, fie prin schimburi mai scurte, niciodată prin ambele metode.
- Precizia temporală. Pentru centrele de lucru configurate în Day planning, capacitatea este exprimată ca timp de bază pe zi, fără orele schimburilor. Configurați în SkyPlanner schimburile reale pe baza programelor de lucru din producție, astfel încât lucrările să fie programate în orele de lucru.
- Timpul de așteptare și suprapunerea. Rândurile de operații conțin timpul de așteptare și suprapunerea în %. Stabiliți la definirea domeniului cum se transpune fiecare în SkyPlanner; altfel, duratele de realizare se vor modifica după punerea în producție.
- Grupuri de centre de lucru. Centrele de lucru de tip grup se planifică în Pool planning, nu în Priority planning. Citiți datele centrelor de lucru incluse, nu doar rândul grupului.
- Cerințe de versiune. Scrierea datelor calendaristice planificate prin Update necesită versiunea 24.5. Câmpurile de capacitate ale centrelor de lucru din API necesită 24.3, iar OIDC necesită 25.8. Verificați versiunea exactă înainte de definirea domeniului.
- Rețea și certificat. Monitor instalat local expune API-ul pe portul 8001, cu un certificat autosemnat. SkyPlanner rulează în cloud, așa că prevedeți o regulă de firewall sau un releu și configurați explicit certificatul ca fiind de încredere.
- Licențe. Fiecare aplicație terță care scrie date are nevoie de propriii utilizatori cu licență API. Fiecare sistem include un utilizator API cu acces doar pentru citire.
Integrarea cu Monitor ERP: cine o configurează și oferă asistență
Lucrările includ stabilirea corespondențelor cu centrele de lucru, rândurile de operații și fluxul comenzilor dumneavoastră, precum și configurarea constrângerilor care nu sunt păstrate în Monitor: matricea timpilor de pregătire, sculele, numărul de operatori și resursele alternative.
- Echipa SkyPlanner configurează integrarea în etapa inițială și oferă asistență după punerea în producție, atât pentru partea SkyPlanner, cât și pentru apelurile convenite către Monitor ERP API. Fiecare fabrică folosește Monitor G5 în mod diferit, iar aici este pusă în practică această experiență.
- Partenerul dumneavoastră Monitor poate participa. Acesta cunoaște configurația, versiunea și permisiunile dumneavoastră și poate pregăti utilizatorul API, licența și accesul prin rețea. SkyPlanner pune la dispoziție REST API, documentația Swagger/OpenAPI și webhook-uri.
- Dezvoltatorii dumneavoastră pot dezvolta soluții pe această bază folosind același REST API documentat, cu un token API. Pentru a începe este suficient un token API, iar echipa SkyPlanner oferă ajutor la nevoie. Documentația publică este disponibilă la SkyPlanner docs.
După conectare, motorul Arcturus programează producția pe baza comenzilor actualizate din Monitor, iar datele calendaristice planificate sunt înscrise în operațiile comenzilor de fabricație. SkyPlanner pornește de la 199 € pe lună, cu 5 centre de lucru incluse și facturare lunară. Oferta pentru integrare se stabilește de la început, în funcție de procesul și nevoile dumneavoastră, împreună cu abonamentul, astfel încât să cunoașteți costul total înainte de a începe. Consultați prețurile, comparația cu planificarea proprie din Monitor în programarea cu capacitate finită în Monitor ERP, prezentarea generală de pe pagina Monitor ERP și celelalte sisteme ERP din 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 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 lucrări ajunge pe 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ă sub 30 de minute.
Peste 1.000 de comenzi de lucru programate automat
„Controlăm producția într-un mod diferit, iar capacitatea de producție o înțelegem acum la un cu totul alt nivel.”
Hannu Ryynänen, director general
Mamec · Mixere industriale, pompe și producție la comandă de înaltă tehnologie
Mii de comenzi de lucru sunt programate automat, iar întreaga organizație are o imagine în timp real asupra producției.
6 luniîn avans: capacitatea disponibilă este vizibilă echipei de vânzări
„SkyPlanner oferă o bază solidă și siguranță pentru întreaga planificare a producției.”
Anu Järvinen, manager de producție
Fredman Operations · Hârtie pentru ambalaje destinată contactului cu alimentele
Echipa de vânzări vede capacitatea disponibilă cu șase luni înainte, iar cererile de modificare a programului, care necesitau o oră sau mai mult, primesc răspuns în câteva secunde.
Întrebări frecvente
Monitor ERP are un API pentru comenzile de fabricație?
Da. Monitor ERP API expune Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations și ManufacturingOrderMaterials pentru interogare. Comenzi precum ManufacturingOrderOperations/Update și ReplanOperation scriu datele calendaristice planificate înapoi în Monitor.
Scrierea în Monitor prin API necesită o licență suplimentară?
Da. Citirea prin API este gratuită pentru toți clienții Monitor. Comenzile care scriu date necesită Monitor ERP API, comercializat de Monitor. Partenerul dumneavoastră Monitor sau echipa de vânzări Monitor vă oferă o cotație.
Monitor ERP API acceptă webhook-uri?
Nu sunt documentate webhook-uri. Integrarea interoghează Common/EntityChangeLogs la fiecare câteva minute și preia doar înregistrările modificate. În sens invers, webhook-urile proprii SkyPlanner transmit modificările programului de producție imediat ce apar.
De ce versiune Monitor avem nevoie?
Scrierea datelor planificate de început și de sfârșit prin ManufacturingOrderOperations/Update necesită Monitor 24.5 sau o versiune ulterioară. Versiunile G5 mai vechi, începând cu 2.40, folosesc ReplanOperation. La definirea domeniului, confirmăm metoda potrivită pentru versiunea dumneavoastră.
Cine realizează integrarea cu Monitor ERP?
Echipa SkyPlanner configurează integrarea bidirecțională pentru configurația dumneavoastră Monitor G5 în etapa inițială și oferă asistență după punerea în producție. Partenerul dumneavoastră Monitor sau propriii dezvoltatori pot realiza, de asemenea, dezvoltări folosind REST API documentat al SkyPlanner, iar pentru a începe este suficient un token API.
Putem testa SkyPlanner înainte de realizarea integrării?
Da. Perioada de probă gratuită de 30 de zile permite până la 20 de centre de lucru, cu importuri Excel sau CSV din Monitor, fără card de credit. Începeți proba gratuită sau discutați cu echipa de vânzări pentru definirea domeniului integrării.
