Integraatiot / ERP / Monitor ERP
Monitor ERP -integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Monitor ERP -integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Monitor ERP (Monitor G5) yhdistetään SkyPlanner APS:ään. SkyPlanner integroituu Monitor ERP:hen kaksisuuntaisesti Monitor ERP API -rajapinnan kautta:
- Valmistustilaukset, työvaiheet, työpisteet, reititykset ja materiaalit tuodaan SkyPlanneriin.
- Kunkin työvaiheen suunniteltu alku, loppu ja työpiste kirjoitetaan takaisin Monitoriin.
- Raportoidut ajat ja määrät pitävät molemmat järjestelmät ajan tasalla.
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation Monitor G5 -ympäristöönne sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on tarkoitettu kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai toteuttaa itse ratkaisuja SkyPlannerin dokumentoidun REST API -rajapinnan avulla (rajapintakuvaus).
Monitor ERP API
Monitor G5:n dokumentoitu integraatiorajapinta on Monitor ERP API v1. Se yhdistää CQRS- ja REST-mallit ja siirtää JSON-tietoa HTTPS-yhteydellä. (Monitor ERP API)
- Kyselyt lukevat tietoja GET-metodilla. Ne tukevat OData-tyylisiä valintoja:
$filter,$select,$expand,$orderby,$topja$skip. - Komennot kirjoittavat tietoja POST-metodilla, esimerkiksi
Manufacturing/ManufacturingOrderOperations/Update. - Batch suorittaa useita komentoja yhtenä transaktiona kutsulla
POST /api/v1/Batch: joko kaikki onnistuvat tai mitään ei tallenneta. Lisää polun loppuun/Simulatetai/Validate, kun haluat testata erän ja perua sen muutokset. Näin koko aikataulu voidaan kirjoittaa turvallisesti. (Batch)
Perusosoite on https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Yritysnumero muodostuu tietokannan numerosta ja yrityksen tunnuksesta, esimerkiksi 004.1.
Monitor kertoo lisensoinnista näin: “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.” (Tietojen kysely ja haku rajapinnasta on kaikille asiakkaille maksutonta. Komentojen käyttö ja tietojen kirjoittaminen ERP-järjestelmään edellyttävät kuitenkin Monitor ERP API -lisenssin ostamista.) Huomioi kirjoitusoikeuden lisenssi projektissa alusta lähtien. (api.monitor.se)
Todennus
- Istuntopohjainen kirjautuminen. Kutsu
POST /{languageCode}/{companyNumber}/loginMonitor-käyttäjän käyttäjätunnuksella ja salasanalla palauttaaX-Monitor-SessionId-otsakkeen myöhempiä kutsuja varten. Myös MFA-tunnisteeseen perustuva kirjautumismenettely on käytettävissä. - OIDC. Monitorin versiosta 25.8 alkaen kirjautuminen onnistuu myös Microsoft Entra ID:n kautta Authorization Code -menettelyllä PKCE:tä käyttäen. (Tunnistautuminen)
- Oma API-käyttäjä. Luo integraatiolle yksi käyttäjä. Siihen sovelletaan Monitorin omia käyttöoikeuksia, kuten Show manufacturing orders ja Replan existing manufacturing order.
SkyPlannerin REST API käyttää tunnistautumiseen API-tunnistetta (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Integraatio-opas neuvoo ensimmäisten kutsujen tekemisessä.
Muutosten tunnistaminen ja pollaus
Monitor ERP API -rajapintakuvaus ei dokumentoi webhookeja eikä tapahtumatilauksia. Muutokset haetaan pollaamalla:
Common/EntityChangeLogs(versiosta 2.33 alkaen) palauttaa kentätChangeType(Update, Create, Delete),EntityTypeId,EntityIdjaModifiedTimestamp. Pollaa sitä muutaman minuutin välein ja hae vain muuttuneet tietueet. (EntityChangeLog)- Rajaa valmistustilauskyselyt avoimiin tilauksiin ja sivuta tulokset valinnoilla
$topja$skip.
SkyPlanner lähettää webhook-ilmoituksia tilan tai aikataulun muuttuessa, joten tietojen kirjoittaminen takaisin Monitoriin on tapahtumapohjaista.
Tietojen vastaavuudet
| Monitor ERP -objekti (API) | SkyPlanner-objekti | Suunta | Päivitystiheys |
|---|---|---|---|
Nimike (Inventory/Parts) | Tuotteet ja materiaalit | Monitor → SkyPlanner | Alkulataus, sen jälkeen muutoslokin perusteella |
BOM ja reititys: Manufacturing/MaterialRows, Manufacturing/OperationRows | Tuoterakenne; työvaiheet asetus- ja yksikköaikoineen | Monitor → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
Manufacturing/AlternativeOperationRows | Vaihtoehtoiset työpisteet työvaiheittain | Monitor → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
Työpiste (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Työpisteet, työpisteryhmät, tehokkuudet | Monitor → SkyPlanner | Alkulataus, sen jälkeen harvoin |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Työvuorot ja poissaolot | Monitor → SkyPlanner | Päivittäin, tai omat työvuorot SkyPlannerissa |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Tilaukset määräpäivineen ja tilatietoineen | Monitor → SkyPlanner | Muutoslokin pollaus muutaman minuutin välein |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Työt kestoineen ja jäljellä olevine määrineen | Monitor → SkyPlanner | Muutoslokin pollaus muutaman minuutin välein |
Manufacturing/ManufacturingOrderMaterials | Tilauskohtaiset materiaalitarpeet | Monitor → SkyPlanner | Muutoslokin pollaus |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Varastosaldot; saapuva materiaali toimituspäivänään | Monitor → SkyPlanner | Pollaus tunneittain tai suunnitteluajon yhteydessä |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Työvaihekohtainen suunniteltu alku ja loppu | SkyPlanner → Monitor | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
ManufacturingOrderOperations/SetWorkCenter | Laskentamoottorin valitsema työpiste | SkyPlanner → Monitor | Aikataulun muuttuessa |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Aikakirjaukset ja määrät | Yksi kanava, joka valitaan määrittelyssä | Kuittauksittain tai työvuoroittain |
| Ei Monitorissa | Asetusaikamatriisi, työkalut rajallisina resursseina, usean työntekijän työt | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutusmallit
1. Perustietojen alkulataus. Lue työpisteet, työvaiherivit, vaihtoehtoiset työvaiherivit, materiaalirivit, nimikkeet ja työvuorokalenterit. Määritä huolellisesti, mitä SkyPlannerin työpistettä kukin Monitorin työpiste vastaa. Pool-tyyppisestä työpisteestä muodostetaan työpisteryhmä ja siihen kuuluvista työpisteistä ne työpisteet, joiden välillä laskentamoottori tekee valinnan.
2. Tilausten synkronointi. Lue avoimet valmistustilaukset solmuineen, työvaiheineen ja materiaaleineen sekä varastosaldot ja avoimet ostotilaukset. SkyPlanner katsoo tilatun materiaalin olevan käytettävissä ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilaus merkitään Delivered-tilaan. Ensimmäisen latauksen jälkeen muutokset haetaan Common/EntityChangeLogs-muutoslokin perusteella.
3. Aikataulun kirjoittaminen takaisin Monitoriin. SkyPlanner lähettää jokaisesta laskentamoottorin sijoittamasta tai siirtämästä työvaiheesta ManufacturingOrderOperations/Update-komennon, jossa ovat mukana PlannedStartDate ja PlannedFinishDate. Jos moottori on siirtänyt työvaiheen poolin toiselle koneelle, ensin suoritetaan SetWorkCenter. Yhden tilauksen komennot lähetetään yhdessä Batch-erässä, joten Monitor hyväksyy joko kaikki komennot tai ei yhtäkään. Suorita erä testauksen aikana /Validate-polun kautta.
Monitorin versiota 24.5 vanhemmissa versioissa suunniteltuja päivämääriä ei voi kirjoittaa Update-komennolla. Käytä sen sijaan ManufacturingOrders/ReplanOperation-komentoa (versiosta 2.40 alkaen) kentillä StartDate ja FinishDate. Aseta RestrictToOrderBounds omien sääntöjesi mukaisesti.
4. Tuotannon kuittaukset. Käytä vain yhtä raportointikanavaa:
- Monitor säilyy raportointikanavana. Työntekijät raportoivat entiseen tapaan Recording terminal -päätteellä tai koneintegraation kautta. SkyPlanner lukee edistymistiedot
ManufacturingOrderOperationReportings-objektista ja suunnittelee aikataulun uudelleen. - SkyPlanner otetaan raportointikanavaksi. Työntekijät kirjaavat työnsä Mobile Confirmations- tai Production Timer -toiminnolla, ja SkyPlanner lähettää Monitoriin
ReportManufacturingOrderOperation-komennon.
Molemmista järjestelmistä raportoiminen kirjaa ajat ja määrät kahteen kertaan.
5. Tietojen omistajuus ja ristiriitatilanteiden säännöt. Kirjaa ne ennen tuotantokäytön aloittamista:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, BOM ja reititys, määrät, tilauksen tila | Monitor |
| Työvaiheiden järjestys, suunniteltu alku ja loppu, poolin sisäinen työpiste | SkyPlanner |
| Asetusaikamatriisi, työkalut, työntekijämäärät, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja poissaolot | Yksi järjestelmä, joka valitaan määrittelyssä |
| Työvaiheiden raportointi | Yksi kanava, joka valitaan määrittelyssä |
Ristiriitoja syntyy eniten silloin, kun suunnittelijat muokkaavat edelleen prioriteettisuunnitelmaa. Rescheduling according to New finish ja rivien vetäminen Priority planning -näkymässä korvaavat SkyPlannerin kirjoittamat päivämäärät. Kun SkyPlanner vastaa työjärjestyksestä, Priority planning toimii vain katselunäkymänä. Autopilot-toiminnon avulla SkyPlanner päivittää aikataulun automaattisesti tuotannon muuttuessa.
Projektin tyypilliset vaiheet
Toteutus valmistuu yleensä viikkojen kuluessa käyttöönoton aloituksesta. Sitä ennen voit kokeilla ohjelmistoa maksutta 30 päivän ajan omilla tiedoillasi. Vie avointen valmistustilausten työvaiheet ja työpisteet Monitorista Exceliin, tuo ne SkyPlanneriin ja tarkista aikataulu ennen integraatiotyön aloittamista.
Varsinainen projekti sisältää seuraavat vaiheet:
- Määrittely. Sovi tietojen vastaavuustaulukko, tietojen omistajuussäännöt, kyselyvälit, raportointikanava ja käytettävä Monitor-versio.
- Käyttöoikeudet ja yhteydet. Luo API-käyttäjä, hanki Monitor ERP API -kirjoituslisenssi ja avaa verkkoyhteys porttiin 8001.
- Alkulataus. Nimikkeet, työpisteet, työvaiherivit, vaihtoehdot, materiaalit ja aikataulut.
- Tilausten ja ostotilausten synkronointi muutoslokin perusteella.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työntekijämäärät sekä vaihtoehtoiset koneet tai työntekijät.
- Aikataulun kirjoittaminen takaisin. Kirjoita aikataulu erissä ja testaa erät
/Validate-kutsulla. - Rinnakkaistestaus. Käytä SkyPlanneria prioriteettisuunnitelman rinnalla, vertaa päivämääriä ja korjaa tuotannon perustiedot.
- Tuotantokäytön aloitus. Ota tietojen kirjoittaminen takaisin käyttöön, kun tiedot täsmäävät.
Mitä Monitor ERP -integraatiossa on huomioitava
- Käytettävyyskerroin. Monitor laskee bruttokapasiteetista nettokapasiteetin käytettävyyskertoimella, jonka oletusarvo uudella työpisteellä on 80 %. Huomioi kerroin vain kerran: joko SkyPlannerin tehokkuusasetuksena tai lyhyempinä työvuoroina, ei koskaan molempina.
- Aikatarkkuus. Day planning -tilassa työpisteiden kapasiteetti ilmoitetaan päiväkohtaisena perusaikana ilman työvuorojen kellonaikoja. Määritä todelliset työvuorot SkyPlanneriin tuotannon työaikataulujen perusteella, jotta työt sijoittuvat työajalle.
- Jonotusaika ja limitys. Työvaiheriveillä on jonotusaika ja limitys prosentteina (%). Päätä määrittelyssä, miten kumpikin siirretään SkyPlanneriin. Muuten läpimenoajat muuttuvat tuotantokäytön alkaessa.
- Poolit. Pooliin kuuluvien työpisteiden työt suunnitellaan Pool planning -toiminnossa, ei Priority planning -toiminnossa. Lue pooliin kuuluvat työpisteet, älä pelkkää pooliriviä.
- Versiovaatimukset. Suunniteltujen päivämäärien kirjoittaminen Update-kutsulla vaatii version 24.5. Työpisteiden kapasiteettikentät API:ssa vaativat version 24.3 ja OIDC version 25.8. Tarkista käytössä oleva ohjelmistoversio ennen määrittelyä.
- Verkkoyhteys ja varmenne. Paikallisesti asennetun Monitorin API käyttää porttia 8001 ja itse allekirjoitettua varmennetta. SkyPlanner toimii pilvessä, joten suunnittele palomuurisääntö tai välityspalvelu ja määritä varmenne erikseen luotetuksi.
- Lisenssit. Jokainen tietoja kirjoittava kolmannen osapuolen sovellus tarvitsee omat API-lisensoidut käyttäjänsä. Jokaiseen järjestelmään sisältyy yksi API-käyttäjä, jolla on vain lukuoikeus.
Monitor ERP -integraatio: kuka vastaa määrityksistä ja tuesta
Työssä määritetään, miten integraation tiedot vastaavat työpisteitäsi, työvaiherivejäsi ja tilausvirtaasi. Lisäksi määritetään rajoitteet, joita Monitorissa ei ole: asetusaikamatriisi, työkalut, työntekijämäärät ja vaihtoehtoiset resurssit.
- SkyPlanner-tiimi tekee määritykset käyttöönoton aikana ja vastaa tuesta tuotantokäytön alettua. Vastuu kattaa SkyPlannerin osuuden ja sovitut Monitor ERP API -kutsut. Jokainen tehdas käyttää Monitor G5:tä omalla tavallaan, ja tämä käytännön tuntemus otetaan huomioon määrityksissä.
- Monitor-kumppanisi voi osallistua toteutukseen. Kumppani tuntee määrityksesi, versiosi ja käyttöoikeutesi ja voi valmistella API-käyttäjän, lisenssin ja verkkoyhteydet. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Myös omat kehittäjäsi voivat toteuttaa integraatiota saman dokumentoidun REST API -rajapinnan kautta API-tunnisteella. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Julkiset ohjeet ovat SkyPlannerin dokumentaatiossa.
Kun yhteys on muodostettu, Arcturus-moottori laatii aikataulun Monitorin ajantasaisten tilausten perusteella. Suunnitellut päivämäärät tallentuvat valmistustilausten työvaiheille. SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja siihen sisältyy 5 työpistettä. Laskutus on kuukausittainen. Saat integraatiosta prosessiisi ja tarpeisiisi perustuvan tarjouksen etukäteen yhdessä tilaamasi paketin kanssa, joten tiedät kokonaiskustannukset ennen aloittamista. Tutustu hinnastoon ja Monitorin omien suunnittelutoimintojen vertailuun sivulla Monitor ERP ja hienokuormitus. Yleiskuvan löydät Monitor ERP -sivulta ja muut ERP-järjestelmät ERP-integraatioiden koontisivulta.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästyy joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kytkinlaitteet
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa viikossa, ja uusi työjono saadaan tuotantolinjalle sekunneissa.
+90 %tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikkien työpisteiden optimoitu suunnitelma kolmeksi kuukaudeksi syntyy alle 30 minuutissa.
1 000:ttyötilaukset suunnitellaan automaattisesti
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on täysin uudella tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansien työtilausten aikataulut laaditaan automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
6 kuukaudennäkymä vapaaseen kapasiteettiin myynnille
”SkyPlanner luo luotettavan perustan koko tuotannonsuunnittelulle.”
Anu Järvinen, tuotantopäällikkö
Fredman Operations · Elintarvikekelpoiset pakkauspaperit
Myynti näkee vapaan kapasiteetin kuusi kuukautta eteenpäin. Aikataulun muutospyyntöihin, joiden käsittely vei aiemmin tunnin tai enemmän, vastataan nyt sekunneissa.
Usein kysytyt kysymykset
Onko Monitor ERP:ssä API-rajapinta valmistustilauksille?
Kyllä. Monitor ERP API tarjoaa kyselyt Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations ja ManufacturingOrderMaterials. Suunnitellut päivämäärät kirjoitetaan takaisin esimerkiksi komennoilla ManufacturingOrderOperations/Update ja ReplanOperation.
Vaatiiko tietojen kirjoittaminen Monitoriin API:n kautta lisälisenssin?
Kyllä. Tietojen lukeminen API:n kautta on maksutonta kaikille Monitor-asiakkaille. Tietoja kirjoittavat komennot edellyttävät Monitorin myymää Monitor ERP API -lisenssiä. Saat tarjouksen Monitor-kumppaniltasi tai Monitorin myynnistä.
Tukeeko Monitor ERP API webhookeja?
Webhookeja ei ole dokumentoitu. Integraatio tekee kyselyn Common/EntityChangeLogs-rajapintaan muutaman minuutin välein ja hakee vain muuttuneet tietueet. Toiseen suuntaan SkyPlannerin omat webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
Minkä Monitor-version tarvitsemme?
Suunnitellun alun ja lopun kirjoittaminen ManufacturingOrderOperations/Update-kutsulla vaatii Monitor-version 24.5 tai uudemman. Vanhemmissa G5-versioissa versiosta 2.40 alkaen käytetään ReplanOperation-komentoa. Varmistamme käytössä olevaan versioosi sopivan tavan määrittelyn aikana.
Kuka toteuttaa Monitor ERP -integraation?
SkyPlanner-tiimi määrittää kaksisuuntaisen integraation Monitor G5 -ympäristöösi käyttöönoton aikana ja vastaa tuesta tuotantokäytön alettua. Myös Monitor-kumppanisi tai omat kehittäjäsi voivat toteuttaa integraatiota SkyPlannerin dokumentoidun REST API -rajapinnan kautta. Alkuun pääsee pelkällä API-tunnisteella.
Voimmeko kokeilla SkyPlanneria ennen integraation toteutusta?
Kyllä. Maksuttomassa 30 päivän kokeilussa voit käyttää enintään 20 työpistettä ja tuoda tiedot Monitorista Excel- tai CSV-tiedostoina. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
