Integracijos / ERP / Monitor ERP
Monitor ERP integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame Monitor ERP integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti Monitor ERP (Monitor G5) su SkyPlanner APS. SkyPlanner keičiasi duomenimis su Monitor ERP abiem kryptimis per Monitor ERP API:
- Į SkyPlanner perduodami gamybos užsakymai, operacijos, darbo centrai, technologiniai maršrutai ir medžiagos.
- Kiekvienos operacijos planuojama pradžia, planuojama pabaiga ir darbo centras įrašomi atgal į Monitor.
- Užregistruoti laiko ir kiekio duomenys padeda išlaikyti abiejų sistemų duomenų suderinamumą.
- SkyPlanner per webhook sąsajas iškart perduoda tvarkaraščio pakeitimus.
Diegimo metu SkyPlanner komanda sukonfigūruoja integraciją pagal jūsų Monitor G5 aplinką, o pradėjus ją naudoti teikia palaikymą. Šis vadovas skirtas partneriams ir programuotojams, norintiems dalyvauti integravimo projekte arba patiems kurti sprendimus naudojant dokumentuotą SkyPlanner REST API (API žinynas).
Monitor ERP API
Dokumentuota Monitor G5 integravimo sąsaja yra Monitor ERP API v1. Joje derinami CQRS ir REST principai, o JSON duomenys perduodami per HTTPS. (Monitor ERP API)
- Užklausos nuskaito duomenis naudojant GET. Jos palaiko OData tipo parametrus:
$filter,$select,$expand,$orderby,$topir$skip. - Komandos įrašo duomenis naudojant POST, pavyzdžiui,
Manufacturing/ManufacturingOrderOperations/Update. - Batch vykdo kelias komandas viena transakcija per
POST /api/v1/Batch: įvykdomos visos komandos arba nė viena. Norėdami išbandyti komandų paketą ir atšaukti jo pakeitimus, pridėkite/Simulatearba/Validate. Taip saugiai įrašomas visas tvarkaraštis. (Batch)
Bazinis URL yra https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Įmonės numerį sudaro duomenų bazės numeris ir įmonės identifikatorius, pavyzdžiui, 004.1.
Apie licencijavimą Monitor nurodo: „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.” (Visi mūsų klientai gali nemokamai teikti užklausas ir gauti informaciją per API. Tačiau norint naudoti komandas ir įrašyti duomenis į ERP sistemą, reikia įsigyti Monitor ERP API.) Duomenų įrašymo licenciją įtraukite į projektą nuo pat pirmos dienos. (api.monitor.se)
Autentifikavimas
- Prisijungimas prie sesijos. Pateikus Monitor naudotojo vardą ir slaptažodį per
POST /{languageCode}/{companyNumber}/login, grąžinamaX-Monitor-SessionIdantraštė, skirta vėlesniems kreipiniams. Taip pat galima autentifikuotis naudojant MFA žetoną. - OIDC. Nuo Monitor 25.8 versijos taip pat galima prisijungti per Microsoft Entra ID naudojant Authorization Code ir PKCE. (Autentifikavimas)
- Atskiras API naudotojas. Integracijai sukurkite vieną naudotoją. Jam taikomos Monitor prieigos teisės, pavyzdžiui, Show manufacturing orders ir Replan existing manufacturing order.
SkyPlanner REST API autentifikavimui naudoja API žetoną (SkyPlanner Settings > API), o jos dokumentacija pateikiama Swagger/OpenAPI formatu. Integravimo pamokoje paaiškinama, kaip atlikti pirmuosius kreipinius.
Pakeitimų aptikimas ir periodinės užklausos
Monitor ERP API žinyne neaprašytos nei webhook sąsajos, nei įvykių prenumeratos. Pakeitimai aptinkami periodinėmis užklausomis:
Common/EntityChangeLogs(nuo 2.33 versijos) grąžinaChangeType(Update, Create, Delete),EntityTypeId,EntityIdirModifiedTimestamp. Siųskite užklausą kas kelias minutes ir gaukite tik pakeistus įrašus. (EntityChangeLog)- Gamybos užsakymų užklausose atrinkite tik neužbaigtus užsakymus, o rezultatams skaidyti į puslapius naudokite
$topir$skip.
Pasikeitus būsenai ar tvarkaraščiui, SkyPlanner per webhook sąsajas siunčia pranešimus, todėl duomenų įrašymą atgal į Monitor inicijuoja įvykiai.
Duomenų susiejimas
| Monitor ERP objektas (API) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
Part (Inventory/Parts) | Gaminiai ir medžiagos | Monitor → SkyPlanner | Pradinis įkėlimas, vėliau – pagal pakeitimų žurnalą |
BOM ir technologinis maršrutas: Manufacturing/MaterialRows, Manufacturing/OperationRows | Gaminio struktūra; proceso etapai su paruošimo ir vieneto gamybos trukme | Monitor → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Manufacturing/AlternativeOperationRows | Alternatyvūs kiekvieno etapo darbo centrai | Monitor → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
Darbo centras (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Darbo centrai, jų grupės ir efektyvumo rodikliai | Monitor → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Pamainos ir neatvykimai | Monitor → SkyPlanner | Kasdien arba pamainos tvarkomos pačioje SkyPlanner |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Užsakymai su įvykdymo terminais ir būsenomis | Monitor → SkyPlanner | Pakeitimų žurnalo užklausos kas kelias minutes |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Darbai su trukme ir likusiu kiekiu | Monitor → SkyPlanner | Pakeitimų žurnalo užklausos kas kelias minutes |
Manufacturing/ManufacturingOrderMaterials | Kiekvieno užsakymo medžiagų poreikis | Monitor → SkyPlanner | Periodinės pakeitimų žurnalo užklausos |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Atsargos; gaunamos medžiagos pagal jų pristatymo datą | Monitor → SkyPlanner | Užklausos kas valandą arba sudarant tvarkaraštį |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Kiekvienos operacijos planuojama pradžia ir pabaiga | SkyPlanner → Monitor | Pasikeitus tvarkaraščiui, per SkyPlanner webhook sąsają |
ManufacturingOrderOperations/SetWorkCenter | Planavimo variklio parinktas darbo centras | SkyPlanner → Monitor | Pasikeitus tvarkaraščiui |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Laiko įrašai ir kiekiai | Vienas kanalas, pasirinktas apibrėžiant apimtį | Po kiekvieno patvirtinimo arba pamainos |
| Monitor sistemoje nėra | Paruošimo trukmės matrica, įrankiai kaip riboti ištekliai, darbai su keliais operatoriais | Tvarkoma SkyPlanner sistemoje | Sukonfigūruojama diegimo metu |
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. Nuskaitykite darbo centrus, operacijų eilutes, alternatyvių operacijų eilutes, medžiagų eilutes, prekes ir grafikus. Apgalvotai susiekite kiekvieną darbo centrą su SkyPlanner darbo centru. Pool tipo darbo centras tampa darbo centrų grupe, o į jį įtraukti darbo centrai – ištekliais, iš kurių renkasi planavimo variklis.
2. Užsakymų sinchronizavimas. Nuskaitykite neužbaigtus gamybos užsakymus su jų mazgais, operacijomis ir medžiagomis, taip pat atsargas ir neužbaigtus pirkimo užsakymus. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakyme nurodytą pristatymo dieną ir atnaujina atsargas, kai užsakymui suteikiama būsena Delivered. Po pradinio įkėlimo pakeitimai gaunami per Common/EntityChangeLogs.
3. Tvarkaraščio įrašymas atgal į Monitor. Kiekvienai operacijai, kurią planavimo variklis suplanavo arba perkėlė, SkyPlanner siunčia ManufacturingOrderOperations/Update su PlannedStartDate ir PlannedFinishDate. Jei variklis perkėlė operaciją į kitą tos pačios grupės įrenginį, pirmiausia siunčiama SetWorkCenter. Vieno užsakymo komandos sujungiamos į vieną Batch, todėl Monitor priima jas visas arba nė vienos. Testuodami vykdykite komandų paketą per /Validate.
Ankstesnėse nei 24.5 Monitor versijose planuojamų datų negalima įrašyti per Update. Vietoj to naudokite ManufacturingOrders/ReplanOperation (nuo 2.40 versijos) su StartDate ir FinishDate, o RestrictToOrderBounds nustatykite pagal savo taisykles.
4. Darbų patvirtinimas ceche. Naudokite vieną duomenų registravimo kanalą:
- Duomenys ir toliau registruojami Monitor. Operatoriai, kaip ir dabar, registruoja duomenis per Recording terminal arba įrenginių integraciją. SkyPlanner nuskaito
ManufacturingOrderOperationReportingskaip darbų eigos duomenis ir perplanuoja tvarkaraštį. - Duomenys pradedami registruoti SkyPlanner. Operatoriai registruoja darbą naudodami Mobile Confirmations arba Production Timer, o SkyPlanner siunčia
ReportManufacturingOrderOperationį Monitor.
Registruojant abiejose sistemose, laiko ir kiekio duomenys dubliuojami.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Prekės, BOM ir technologinis maršrutas, kiekiai, užsakymo būsena | Monitor |
| Operacijų seka, planuojama pradžia ir pabaiga, darbo centras grupėje | SkyPlanner |
| Paruošimo trukmių matrica, įrankiai, operatorių skaičius, alternatyvūs ištekliai | SkyPlanner |
| Pamainos ir neatvykimai | Viena sistema, pasirinkta apibrėžiant apimtį |
| Operacijų vykdymo registravimas | Vienas kanalas, pasirinktas apibrėžiant apimtį |
Daugiausia konfliktų kyla, kai planuotojai ir toliau keičia prioritetinį planą. Rescheduling according to New finish ir eilučių vilkimas modulyje Priority planning perrašo SkyPlanner įrašytas datas. Kai už seką atsako SkyPlanner, Priority planning naudojamas tik peržiūrai. Su Autopilot SkyPlanner automatiškai perskaičiuoja tvarkaraštį pasikeitus gamybos situacijai.
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo diegimo proceso pradžios. Prieš tai sistemą galite nemokamai išbandyti 30 dienų su savo duomenimis. Eksportuokite nebaigtų gamybos užsakymų operacijas ir darbo centrus iš Monitor į Excel, importuokite juos ir patikrinkite tvarkaraštį dar prieš pradėdami integravimo darbus.
Patį projektą sudaro šie etapai:
- Apimties apibrėžimas. Suderinkite duomenų atitikmenų lentelę, atsakomybės už duomenis taisykles, periodinių užklausų intervalus, vykdymo registravimo kanalą ir Monitor versiją.
- Prieiga. Sukurkite API naudotoją, įsigykite Monitor ERP API rašymo licenciją ir atverkite tinklo prieigą per 8001 prievadą.
- Pradinis duomenų įkėlimas. Prekės, darbo centrai, operacijų eilutės, alternatyvos, medžiagos ir tvarkaraščiai.
- Užsakymų ir pirkimo užsakymų sinchronizavimas pagal pakeitimų žurnalą.
- Apribojimų nustatymas SkyPlanner sistemoje. Paruošimo trukmių matrica, įrankiai, operatorių skaičius ir alternatyvios staklės ar darbuotojai.
- Tvarkaraščio įrašymas atgal paketais, patikrinant su
/Validate. - Lygiagretus testavimas. Naudokite SkyPlanner kartu su prioritetiniu planu, palyginkite datas ir sutvarkykite pagrindinius duomenis.
- Darbo pradžia. Kai duomenys sutaps, įjunkite įrašymą atgal.
Į ką atsižvelgti planuojant Monitor ERP integraciją
- Prieinamumo koeficientas. Monitor perskaičiuoja bendrąjį pajėgumą į grynąjį pagal prieinamumo koeficientą. Naujam darbo centrui pagal numatytąją nuostatą taikoma 80 %. Taikykite jį tik vieną kartą: kaip SkyPlanner efektyvumo rodiklį arba trumpindami pamainas, bet niekada abiem būdais.
- Laiko tikslumas. Darbo centrų, kuriems naudojamas Day planning, pajėgumas nurodomas kaip bazinis dienos laikas, be pamainų pradžios ir pabaigos. Pagal gamybos darbo grafikus nustatykite tikrąsias pamainas SkyPlanner sistemoje, kad darbai būtų suplanuoti darbo valandomis.
- Laukimo laikas ir persidengimas. Operacijų eilutėse nurodomas laukimo laikas ir persidengimas procentais (%). Apibrėždami apimtį nuspręskite, kaip kiekvieną reikšmę perkelti į SkyPlanner, antraip pradėjus naudoti integraciją pasikeis užsakymų įvykdymo trukmės.
- Darbo centrų grupės. Į grupes sujungti darbo centrai planuojami naudojant Pool planning, o ne Priority planning. Nuskaitykite į grupę įtrauktus darbo centrus, ne tik pačios grupės eilutę.
- Versijų reikalavimai. Planuojamoms datoms įrašyti per Update reikia 24.5 versijos. Darbo centrų pajėgumo laukams API sąsajoje reikia 24.3, o OIDC – 25.8. Prieš apibrėždami apimtį patikrinkite naudojamą leidimą.
- Tinklas ir sertifikatas. Vietoje įdiegta Monitor teikia API per 8001 prievadą su savarankiškai pasirašytu sertifikatu. SkyPlanner veikia debesijoje, todėl numatykite ugniasienės taisyklę arba tarpinį perdavimo serverį ir aiškiai nustatykite, kad sertifikatu būtų pasitikima.
- Licencijos. Kiekvienai trečiosios šalies programai, kuri įrašo duomenis, reikia atskirų licencijuotų API naudotojų. Su kiekviena sistema pateikiamas vienas API naudotojas, turintis tik skaitymo teisę.
Monitor ERP integracija: kas ją konfigūruoja ir prižiūri
Darbai apima duomenų susiejimą su jūsų darbo centrais, operacijų eilutėmis ir užsakymų srautu. Taip pat nustatomi apribojimai, kurių Monitor nesaugo: paruošimo trukmių matrica, įrankiai, operatorių skaičius ir alternatyvūs ištekliai.
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją pradėjus naudoti. Ji atsako už SkyPlanner pusę ir sutartus Monitor ERP API iškvietimus. Kiekviena gamykla Monitor G5 naudoja savaip, todėl čia pritaikomos žinios apie jūsų darbo tvarką.
- Jūsų Monitor partneris taip pat gali dalyvauti. Partneris žino jūsų konfigūraciją, versiją ir prieigos teises, todėl gali parengti API naudotoją, licenciją ir tinklo prieigą. SkyPlanner suteikia REST API, Swagger/OpenAPI dokumentaciją ir įvykių pranešimus (webhooks).
- Jūsų programuotojai gali kurti savo sprendimus naudodami tą pačią dokumentuotą REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Viešą dokumentaciją rasite skiltyje SkyPlanner dokumentacija.
Sujungus sistemas, Arcturus variklis sudaro tvarkaraštį pagal aktualius Monitor užsakymus, o suplanuotos datos įrašomos į gamybos užsakymų operacijas. SkyPlanner kainuoja nuo 199 € per mėnesį, įskaitant 5 darbo centrus, mokant kas mėnesį. Integracijos kaina pagal jūsų procesą ir poreikius pateikiama iš anksto kartu su pasirinktu planu, todėl visas išlaidas žinosite dar prieš pradėdami. Peržiūrėkite kainas, palyginkite su pačios Monitor planavimo galimybėmis straipsnyje Monitor ERP gamybos planavimas pagal realius įrenginių ir darbuotojų pajėgumus, susipažinkite su apžvalga Monitor ERP puslapyje ir kitomis ERP sistemomis 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ę sutaupomos 2 darbo valandos, 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ų.
1 000-iaiautomatiškai suplanuotų gamybos užsakymų
„Dabar gamybą valdome kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoninės maišyklės, siurbliai ir aukštųjų technologijų užsakomoji gamyba
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija gamybos situaciją mato realiuoju laiku.
6 mėnesiųlaisvus pajėgumus mato pardavimų komanda
„SkyPlanner suteikia tvirtą ir patikimą pagrindą visam gamybos planavimui.“
Anu Järvinen, gamybos vadovė
Fredman Operations · Su maistu liestis tinkamas pakavimo popierius
Pardavimų komanda mato laisvus pajėgumus šešiems mėnesiams į priekį, o į užklausas dėl tvarkaraščio pakeitimų, kurioms anksčiau reikėdavo valandos ar daugiau, dabar atsakoma per kelias sekundes.
Dažniausiai užduodami klausimai
Ar Monitor ERP turi API gamybos užsakymams?
Taip. Monitor ERP API leidžia užklausomis pasiekti Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations ir ManufacturingOrderMaterials. Tokios komandos kaip ManufacturingOrderOperations/Update ir ReplanOperation įrašo suplanuotas datas į Monitor.
Ar duomenims įrašyti į Monitor per API reikia papildomos licencijos?
Taip. Visi Monitor klientai gali nemokamai skaityti duomenis per API. Duomenis įrašančioms komandoms reikia Monitor parduodamos Monitor ERP API licencijos. Kainos pasiūlymą pateikia jūsų Monitor partneris arba Monitor pardavimų komanda.
Ar Monitor ERP API palaiko įvykių pranešimus (webhooks)?
Įvykių pranešimai (webhooks) dokumentacijoje neaprašyti. Integracija kas kelias minutes siunčia užklausas į Common/EntityChangeLogs ir nuskaito tik pasikeitusius įrašus. Priešinga kryptimi pačios SkyPlanner įvykių pranešimai perduoda tvarkaraščio pakeitimus vos jiems įvykus.
Kokios Monitor versijos mums reikia?
Planuojamai pradžiai ir pabaigai įrašyti per ManufacturingOrderOperations/Update reikia Monitor 24.5 arba naujesnės versijos. Senesniuose G5 leidimuose nuo 2.40 naudojama ReplanOperation. Apibrėždami apimtį patvirtiname, kuris būdas tinka jūsų leidimui.
Kas kuria Monitor ERP integraciją?
SkyPlanner komanda diegimo metu sukonfigūruoja abipusę integraciją pagal jūsų Monitor G5 konfigūraciją ir prižiūri ją pradėjus naudoti. Jūsų Monitor partneris arba jūsų programuotojai taip pat gali kurti sprendimus naudodami dokumentuotą SkyPlanner REST API. Pradžiai pakanka API prieigos rakto.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti duomenis iš Monitor Excel arba CSV formatu. Kredito kortelės nereikia. Išbandykite nemokamai arba susisiekite su pardavimų komanda, kad apibrėžtumėte integracijos apimtį.
