Liidestused / ERP / Monitor ERP
Monitor ERP integratsiooni juhend tootmise ajakava koostamiseks SkyPlanner APS-iga
See Monitor ERP integratsiooni juhend selgitab partneritele ja IT-meeskondadele, kuidas ühendada Monitor ERP (Monitor G5) SkyPlanner APS-iga. SkyPlanner vahetab Monitor ERP-ga andmeid mõlemas suunas Monitor ERP API kaudu:
- SkyPlannerisse tuuakse tootmistellimused, operatsioonid, töökeskused, tehnoloogilised marsruudid ja materjalid.
- Iga operatsiooni planeeritud algus, lõpp ja töökeskus kirjutatakse tagasi Monitorisse.
- Registreeritud ajad ja kogused hoiavad mõlema süsteemi andmed kooskõlas.
- SkyPlanneri veebihaagid edastavad ajakava muudatused kohe, kui need toimuvad.
SkyPlanneri meeskond seadistab integratsiooni juurutamise käigus vastavalt teie Monitor G5 seadistusele ning pakub tuge ka pärast kasutuselevõttu. See juhend on mõeldud partneritele ja arendajatele, kes soovivad töös osaleda või ise SkyPlanneri dokumenteeritud REST API põhjal lahendusi luua (API teatmik).
Monitor ERP API
Monitor G5 dokumenteeritud integratsiooniliides on Monitor ERP API v1. See ühendab CQRS-i ja REST-i põhimõtted ning edastab JSON-andmeid HTTPS-i kaudu. (Monitor ERP API)
- Päringud loevad andmeid GET-meetodiga. Need toetavad OData-laadseid parameetreid:
$filter,$select,$expand,$orderby,$topja$skip. - Käsud kirjutavad andmeid POST-meetodiga, näiteks
Manufacturing/ManufacturingOrderOperations/Update. - Batch käivitab mitu käsku ühe tehinguna aadressil
POST /api/v1/Batch: kas täidetakse kõik käsud või mitte ühtegi. Käsupaketi testimiseks ja tagasipööramiseks lisage lõppu/Simulatevõi/Validate. Nii saab kogu ajakava turvaliselt kirjutada. (Batch)
Baas-URL on https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Ettevõtte number koosneb andmebaasi numbrist ja ettevõtte ID-st, näiteks 004.1.
Litsentsimise kohta ütleb Monitor: “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.” (Kõik meie kliendid saavad API kaudu andmeid tasuta pärida ja välja võtta. Käskude kasutamiseks ja ERP-süsteemi andmete kirjutamiseks tuleb aga osta Monitor ERP API.) Arvestage kirjutuslitsentsiga projektis kohe algusest peale. (api.monitor.se)
Autentimine
- Sessioonipõhine sisselogimine. Päring
POST /{languageCode}/{companyNumber}/loginMonitori kasutajanime ja parooliga tagastab päiseX-Monitor-SessionId, mida kasutatakse järgmistes väljakutsetes. Toetatud on ka MFA-tokeniga autentimisvoog. - OIDC. Alates Monitori versioonist 25.8 saab sisse logida ka Microsoft Entra ID kaudu, kasutades Authorization Code’i ja PKCE-d. (Autentimine)
- Eraldi API-kasutaja. Looge integratsiooni jaoks üks kasutaja. Sellele kehtivad Monitori enda kasutajaõigused, näiteks Show manufacturing orders ja Replan existing manufacturing order.
SkyPlanneri REST API kasutab autentimiseks API-tokenit (SkyPlanner Settings > API) ning on dokumenteeritud Swagger/OpenAPI vormingus. Integratsiooni õpetus juhendab esimeste väljakutsete tegemist.
Muudatuste tuvastamine ja pollimine
Monitor ERP API teatmikus ei ole dokumenteeritud veebihaake ega sündmuste tellimist. Muudatused tuvastatakse pollimisega:
Common/EntityChangeLogs(alates versioonist 2.33) tagastab väljadChangeType(Update, Create, Delete),EntityTypeId,EntityIdjaModifiedTimestamp. Pärige seda iga paari minuti järel ja tooge ainult muutunud kirjed. (EntityChangeLog)- Piirake tootmistellimuste päringud avatud tellimustega ning jagage tulemused lehekülgedeks parameetritega
$topja$skip.
SkyPlanner saadab oleku või ajakava muutumisel veebihaake, seega toimub tagasikirjutamine sündmuspõhiselt.
Andmete vastendamine
| Monitor ERP objekt (API) | SkyPlanneri objekt | Suund | Sagedus |
|---|---|---|---|
Artikkel (Inventory/Parts) | Tooted ja materjalid | Monitor → SkyPlanner | Esmane laadimine, seejärel muudatuste logi alusel |
BOM ja tehnoloogiline marsruut: Manufacturing/MaterialRows, Manufacturing/OperationRows | Toote struktuur; tootmisetapid koos seadistus- ja ühikuaegadega | Monitor → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Manufacturing/AlternativeOperationRows | Iga etapi alternatiivsed töökeskused | Monitor → SkyPlanner | Esmane laadimine, seejärel muudatuste korral |
Töökeskus (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Töökeskused, töökeskuste rühmad, efektiivsusnäitajad | Monitor → SkyPlanner | Esmane laadimine, hiljem harva |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Vahetused ja puudumised | Monitor → SkyPlanner | Iga päev või hallatakse vahetusi eraldi SkyPlanneris |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Tellimused koos tähtaegade ja olekuga | Monitor → SkyPlanner | Muudatuste logi pollimine iga paari minuti järel |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Tööd koos kestuse ja järelejäänud kogusega | Monitor → SkyPlanner | Muudatuste logi pollimine iga paari minuti järel |
Manufacturing/ManufacturingOrderMaterials | Materjalivajadus tellimuste kaupa | Monitor → SkyPlanner | Muudatuste logi pollimine |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Laoseis; saabuv materjal tarnekuupäeval | Monitor → SkyPlanner | Pollimine kord tunnis või ajakava koostamise käivitamisel |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Iga operatsiooni planeeritud algus ja lõpp | SkyPlanner → Monitor | Ajakava muutumisel SkyPlanneri veebihaagi kaudu |
ManufacturingOrderOperations/SetWorkCenter | Planeerimismootori valitud töökeskus | SkyPlanner → Monitor | Ajakava muutumisel |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Ajakirjed ja kogused | Üks kanal, mis valitakse ulatuse määramisel | Iga kinnituse või vahetuse järel |
| Monitoris puudub | Seadistusaegade maatriks, piiratud saadavusega tööriistad, mitme operaatoriga tööd | Hallatakse SkyPlanneris | Seadistatakse juurutamise käigus |
Integratsiooni teostus
1. Põhiandmete esmane laadimine. Lugege sisse töökeskused, operatsiooniread, alternatiivsed operatsiooniread, materjaliread, artiklid ja töögraafikud. Mõelge hoolikalt läbi, millisele SkyPlanneri töökeskusele iga Monitori töökeskus vastab. Pool-tüüpi töökeskusest saab töökeskuste rühm ning sellesse kuuluvatest töökeskustest saavad töökeskused, mille vahel planeerimismootor valib.
2. Tellimuste sünkroonimine. Lugege sisse avatud tootmistellimused koos nende sõlmede, operatsioonide ja materjalidega ning laoseis ja avatud ostutellimused. SkyPlanner loeb tellitud materjali kättesaadavaks ostutellimuse tarnekuupäeval ja uuendab laoseisu, kui ostutellimuse olekuks märgitakse Delivered. Pärast esmast laadimist tuvastatakse muudatused Common/EntityChangeLogs kaudu.
3. Ajakava tagasikirjutamine. Iga operatsiooni kohta, mille planeerimismootor ajakavasse paigutas või ümber tõstis, saadab SkyPlanner käsu ManufacturingOrderOperations/Update koos väljadega PlannedStartDate ja PlannedFinishDate. Kui mootor tõstis operatsiooni rühmas teisele masinale, saadetakse esmalt SetWorkCenter. Ühe tellimuse käsud saadetakse ühe Batch-paketina, nii et Monitor võtab vastu kas kõik käsud või mitte ühtegi. Testimisel käivitage pakett /Validate kaudu.
Monitori versioonides enne 24.5 ei saa planeeritud kuupäevi Update’i kaudu kirjutada. Kasutage selle asemel käsku ManufacturingOrders/ReplanOperation (alates versioonist 2.40) väljadega StartDate ja FinishDate ning seadistage RestrictToOrderBounds vastavalt oma reeglitele.
4. Tootmises tehtud töö kinnitused. Kasutage ainult üht aruandluskanalit:
- Kanaliks jääb Monitor. Operaatorid registreerivad tehtud töö endiselt Recording terminali või masinaliidestuse kaudu. SkyPlanner loeb töö edenemist
ManufacturingOrderOperationReportingskaudu ja koostab ajakava uuesti. - Kanaliks saab SkyPlanner. Operaatorid registreerivad töö funktsiooniga Mobile Confirmations või Production Timer ning SkyPlanner saadab Monitorisse käsu
ReportManufacturingOrderOperation.
Mõlemas süsteemis aruandlust tehes registreeritakse ajad ja kogused topelt.
5. Andmete haldamise ja vastuolude lahendamise reeglid. Pange need enne kasutuselevõttu kirja:
| Andmed | Vastutav süsteem |
|---|---|
| Artiklid, BOM ja tehnoloogiline marsruut, kogused, tellimuse olek | Monitor |
| Operatsioonide järjekord, planeeritud algus ja lõpp, töökeskus grupi sees | SkyPlanner |
| Seadistusaegade maatriks, tööriistad, operaatorite arv, alternatiivsed ressursid | SkyPlanner |
| Vahetused ja puudumised | Üks süsteem, mis valitakse ulatuse määramisel |
| Operatsioonide täitmise registreerimine | Üks kanal, mis valitakse ulatuse määramisel |
Vastuolud tekivad peamiselt siis, kui planeerijad muudavad endiselt prioriteediplaani. Rescheduling according to New finish ja ridade lohistamine moodulis Priority planning kirjutavad SkyPlanneri salvestatud kuupäevad üle. Kui järjekorra määrab SkyPlanner, kasutatakse moodulit Priority planning ainult vaatamiseks. Autopilotiga koostab SkyPlanner tootmise muutudes ajakava automaatselt ümber.
Projekti tavapärased etapid
Juurutamine saab tavaliselt valmis mõne nädala jooksul pärast kasutuselevõtu alustamist. Enne seda saate 30-päevase tasuta prooviperioodi jooksul kasutada oma andmeid. Eksportige avatud tootmistellimuste operatsioonid ja töökeskused Monitorist Excelisse, importige need SkyPlannerisse ning kontrollige ajakava enne integreerimistööde alustamist.
Projekt hõlmab järgmisi etappe:
- Ulatuse määramine. Leppige kokku vastendustabel, andmete haldamise vastutusreeglid, päringute intervallid, täitmise registreerimise kanal ja Monitori versioon.
- Juurdepääs. Looge API-kasutaja, ostke Monitor ERP API kirjutusõigusega litsents ja avage võrgujuurdepääs pordile 8001.
- Esmane andmete laadimine. Artiklid, töökeskused, operatsiooniread, alternatiivid, materjalid ja töögraafikud.
- Tellimuste ja ostutellimuste sünkroonimine muudatuste logi alusel.
- Piirangute seadistamine SkyPlanneris. Seadistusaegade maatriks, tööriistad, operaatorite arv ning alternatiivsed masinad või töötajad.
- Ajakava tagasikirjutamine pakettidena, mida kontrollitakse käsuga
/Validate. - Paralleeltestimine. Kasutage SkyPlannerit prioriteediplaani kõrval, võrrelge kuupäevi ja parandage põhiandmeid.
- Töösse võtmine. Lülitage tagasikirjutamine sisse, kui andmed ühtivad.
Millega Monitor ERP integreerimisel arvestada
- Kasutatavuse tegur. Monitor arvutab brutovõimsusest netovõimsuse kasutatavuse teguri abil. Uue töökeskuse vaikeväärtus on 80 %. Rakendage seda ainult üks kord: kas SkyPlanneri efektiivsusena või lühemate vahetustena, mitte kunagi mõlemana.
- Ajaline täpsus. Day planning arvestab töökeskuste võimsust päevase baasajana, ilma vahetuste kellaaegadeta. Seadistage SkyPlanneris tootmise töögraafikute põhjal tegelikud vahetused, et tööd jääksid tööaja sisse.
- Ooteaeg ja kattumine. Operatsiooniridadel on ooteaeg ja kattumine protsentides (%). Otsustage ulatuse määramisel, kuidas kumbki SkyPlannerisse vastendatakse, muidu muutuvad pärast töösse võtmist läbimisajad.
- Töökeskuste grupid. Gruppi kuuluvaid töökeskusi planeeritakse moodulis Pool planning, mitte Priority planning. Lugege andmeid ka gruppi kuuluvatest töökeskustest, mitte ainult grupi realt.
- Versiooninõuded. Planeeritud kuupäevade kirjutamine käsuga Update nõuab versiooni 24.5. Töökeskuse võimsuse väljad API-s nõuavad versiooni 24.3 ja OIDC versiooni 25.8. Kontrollige järku enne ulatuse määramist.
- Võrk ja sertifikaat. Kohapeal paigaldatud Monitor pakub API-t pordil 8001, kasutades iseallkirjastatud sertifikaati. SkyPlanner töötab pilves, seega kavandage tulemüürireegel või vahenduslahendus ning määrake sertifikaat eraldi usaldusväärseks.
- Litsentsid. Iga kolmanda osapoole rakendus, mis andmeid kirjutab, vajab eraldi API litsentsiga kasutajaid. Iga süsteemiga on kaasas üks ainult lugemisõigusega API kasutaja.
Kes seadistab Monitor ERP integratsiooni ja pakub tuge?
Töö hõlmab andmete vastendamist teie töökeskuste, operatsiooniridade ja tellimuste liikumisega. Lisaks seadistatakse piirangud, mida Monitoris ei hoita: seadistusaegade maatriks, tööriistad, operaatorite arv ja alternatiivsed ressursid.
- SkyPlanneri meeskond seadistab integratsiooni kasutuselevõtu käigus ja pakub tuge pärast töösse võtmist. Tugi hõlmab integratsiooni SkyPlanneri-poolset osa ja kokkulepitud Monitor ERP API päringuid. Igas tehases kasutatakse Monitor G5 eri viisil ning seadistamisel arvestatakse just nende eripäradega.
- Ka teie Monitori partner saab osaleda. Partner tunneb teie seadistust, versiooni ja õigusi ning saab ette valmistada API kasutaja, litsentsi ja võrgujuurdepääsu. SkyPlanner pakub REST API-t, Swagger/OpenAPI dokumentatsiooni ja veebihaake.
- Teie arendajad saavad lahendust edasi arendada, kasutades sama dokumenteeritud REST API-t ja API pääsmikku. Alustamiseks piisab API pääsmikust ning vajadusel aitab SkyPlanneri meeskond. Avaliku dokumentatsiooni leiate SkyPlanneri dokumentatsioonist.
Kui ühendus on loodud, koostab Arcturus ajakava Monitori ajakohaste tellimuste alusel ning planeeritud kuupäevad kirjutatakse tootmistellimuste operatsioonidele. SkyPlanneri hind algab 199 € kuus ja sisaldab 5 töökeskust. Arveldamine toimub kord kuus. Integratsiooni ja paketi hinnapakkumine koostatakse teie protsessi ja vajaduste järgi enne alustamist, nii et teate kogukulu juba ette. Vaadake hindu, võrrelge Monitori enda planeerimisvõimalusi lehel tootmise planeerimine Monitor ERP-s tegeliku masina- ja personalivõimsuse piires, lugege ülevaadet Monitor ERP lehelt ning tutvuge teiste ERP-dega ERP integratsioonide lehel.
Tootjate kogemused SkyPlanneriga
2 hajasäästu igal nädalal
„SkyPlanner on viinud meie tootmise planeerimise Exceli tabelitest tootmise reaalajas optimeerimiseni.“
Kalle Kalliomäki, tarneahelaspetsialist
UTU · Elektrikilbid ja jaotusseadmed
Tootmise planeerimisel säästetakse igal nädalal 2 tundi tööaega ning uus tööjärjekord jõuab tootmisliinile sekunditega.
+90%tootmise efektiivsust
„Tootmise efektiivsus on kasvanud 90%.“
Abdul Rucyinga, IT-juht
Laboratory & Allied · Ravimitootmine
Tootmise efektiivsus on kasvanud 90% ning kõiki töökeskusi hõlmava optimeeritud kolme kuu plaani koostamine võtab alla 30 minuti.
1 000-tetöökäskude ajakava koostatakse automaatselt
„Tootmine on hoopis teistmoodi kontrolli all ja meie arusaam tootmisvõimsusest on täiesti uuel tasemel.“
Hannu Ryynänen, tegevjuht
Mamec · Tööstuslikud segistid, pumbad ja kõrgtehnoloogiline lepinguline tootmine
Tuhanded töökäsud paigutatakse ajakavasse automaatselt ning kogu organisatsioonil on tootmisest reaalajas ülevaade.
6 kuudette näeb müügimeeskond vaba tootmisvõimsust
„SkyPlanner loob kogu tootmise planeerimisele kindla ja usaldusväärse aluse.“
Anu Järvinen, tootmisjuht
Fredman Operations · Toiduga kokkupuuteks sobivad pakkepaberid
Müügimeeskond näeb vaba tootmisvõimsust kuus kuud ette ning ajakava muutmise päringutele, millele vastamine võttis varem tunni või rohkem, vastatakse nüüd sekunditega.
Korduma kippuvad küsimused
Kas Monitor ERP-l on tootmistellimuste jaoks API?
Jah. Monitor ERP API võimaldab teha päringuid objektidele Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations ja ManufacturingOrderMaterials. Käsud nagu ManufacturingOrderOperations/Update ja ReplanOperation kirjutavad planeeritud kuupäevad tagasi.
Kas API kaudu Monitorisse kirjutamine nõuab lisalitsentsi?
Jah. API kaudu andmete lugemine on kõigile Monitori klientidele tasuta. Andmeid kirjutavad käsud vajavad Monitor ERP API litsentsi, mida müüb Monitor. Hinnapakkumise teeb teie Monitori partner või Monitori müügimeeskond.
Kas Monitor ERP API toetab veebihaake?
Veebihaake ei ole dokumenteeritud. Integratsioon teeb iga mõne minuti järel päringu Common/EntityChangeLogs kaudu ja hangib ainult muutunud kirjed. Vastassuunas saadavad SkyPlanneri enda veebihaagid ajakava muudatused edasi kohe nende tekkimisel.
Millist Monitori versiooni vajame?
Planeeritud alguse ja lõpu kirjutamine käsuga ManufacturingOrderOperations/Update nõuab Monitori versiooni 24.5 või uuemat. Vanemad G5 järgud alates versioonist 2.40 kasutavad käsku ReplanOperation. Teie järgule sobiva lahenduse kinnitame ulatuse määramisel.
Kes loob Monitor ERP integratsiooni?
SkyPlanneri meeskond seadistab kahesuunalise integratsiooni teie Monitor G5 lahenduse jaoks kasutuselevõtu käigus ja pakub tuge pärast töösse võtmist. Ka teie Monitori partner või oma arendajad saavad luua lahendusi SkyPlanneri dokumenteeritud REST API abil. Alustamiseks piisab API pääsmikust.
Kas saame SkyPlannerit enne integratsiooni loomist katsetada?
Jah. 30-päevasel tasuta prooviperioodil saab kasutada kuni 20 töökeskust ja importida Monitori andmeid Exceli või CSV kaudu. Krediitkaarti pole vaja. Alusta prooviperioodi või võta ühendust müügimeeskonnaga, et määrata integratsiooni ulatus.
