Integrācijas / ERP / Monitor ERP
Monitor ERP integrācijas ceļvedis ražošanas grafiku sastādīšanai ar SkyPlanner APS
Šajā Monitor ERP integrācijas ceļvedī partneriem un IT komandām skaidrots, kā savienot Monitor ERP (Monitor G5) ar SkyPlanner APS. SkyPlanner nodrošina divvirzienu integrāciju ar Monitor ERP, izmantojot Monitor ERP API:
- SkyPlanner saņem datus par ražošanas pasūtījumiem, operācijām, darba centriem, tehnoloģiskajiem procesiem un materiāliem.
- Katras operācijas plānotais sākums, plānotās beigas un darba centrs tiek ierakstīti atpakaļ Monitor sistēmā.
- Reģistrētais laiks un daudzumi nodrošina abu sistēmu datu saskaņotību.
- SkyPlanner nosūta grafika izmaiņas ar webhook palīdzību, tiklīdz tās notiek.
Ieviešanas laikā SkyPlanner komanda konfigurē integrāciju atbilstoši jūsu Monitor G5 iestatījumiem un nodrošina tās atbalstu arī pēc ekspluatācijas sākuma. Šis ceļvedis ir paredzēts partneriem un izstrādātājiem, kuri vēlas piedalīties integrācijas izveidē vai paši izstrādāt risinājumus, izmantojot dokumentēto SkyPlanner REST API (API uzziņa).
Monitor ERP API
Monitor G5 dokumentētā integrācijas saskarne ir Monitor ERP API v1. Tā apvieno CQRS un REST pieeju un pārsūta JSON datus, izmantojot HTTPS. (Monitor ERP API)
- Vaicājumi nolasa datus ar GET. Tie atbalsta OData tipa parametrus:
$filter,$select,$expand,$orderby,$topun$skip. - Komandas ieraksta datus ar POST, piemēram,
Manufacturing/ManufacturingOrderOperations/Update. - Batch izpilda vairākas komandas vienā transakcijā pēc principa “visu vai neko”, izmantojot
POST /api/v1/Batch. Pievienojiet/Simulatevai/Validate, lai pārbaudītu komandu pakotni un atsauktu tās izmaiņas. Tas ir drošs veids, kā ierakstīt visu grafiku. (Batch)
Bāzes URL ir https://{host}:8001/{languageCode}/{companyNumber}/api/v1/. Uzņēmuma numuru veido datubāzes numurs un uzņēmuma ID, piemēram, 004.1.
Par licencēšanu Monitor norāda: “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ūsu klienti var bez maksas veikt vaicājumus un iegūt informāciju no API. Taču, lai izmantotu komandas un ierakstītu datus ERP sistēmā, ir jāiegādājas Monitor ERP API.) Jau no pirmās dienas paredziet projektā licenci datu ierakstīšanai. (api.monitor.se)
Autentifikācija
- Pieteikšanās sesijā. Pieprasījums
POST /{languageCode}/{companyNumber}/loginar Monitor lietotājvārdu un paroli atgriež galveniX-Monitor-SessionId, ko izmanto turpmākajos izsaukumos. Ir pieejama arī autentifikācijas plūsma ar MFA pilnvaru. - OIDC. Sākot ar Monitor 25.8, var pieteikties arī ar Microsoft Entra ID, izmantojot Authorization Code un PKCE. (Autentifikācija)
- Atsevišķs API lietotājs. Integrācijai izveidojiet vienu lietotāju. Uz to attiecas Monitor piekļuves tiesības, piemēram, Show manufacturing orders un Replan existing manufacturing order.
SkyPlanner pusē REST API autentifikācijai izmanto API pilnvaru (SkyPlanner Settings > API), un tā dokumentācija ir pieejama Swagger/OpenAPI formātā. Integrācijas pamācībā soli pa solim aprakstīti pirmie izsaukumi.
Izmaiņu noteikšana un periodiska aptauja
Monitor ERP API uzziņā nav dokumentēti webhook mehānismi vai notikumu abonēšana. Izmaiņas tiek iegūtas, periodiski veicot aptauju:
Common/EntityChangeLogs(sākot ar 2.33) atgriežChangeType(Update, Create, Delete),EntityTypeId,EntityIdunModifiedTimestamp. Veiciet aptauju ik pēc dažām minūtēm un iegūstiet tikai mainītos ierakstus. (EntityChangeLog)- Ražošanas pasūtījumu vaicājumos atlasiet tikai atvērtos pasūtījumus un sadaliet rezultātus lapās ar
$topun$skip.
Mainoties stāvoklim vai grafikam, SkyPlanner nosūta webhook paziņojumus, tāpēc datu ierakstīšanu atpakaļ Monitor sistēmā ierosina notikumi.
Datu kartēšana
| Monitor ERP objekts (API) | SkyPlanner objekts | Virziens | Biežums |
|---|---|---|---|
Part (Inventory/Parts) | Produkti un materiāli | Monitor → SkyPlanner | Sākotnējā ielāde, turpmāk — pēc izmaiņu žurnāla |
BOM un tehnoloģiskais process: Manufacturing/MaterialRows, Manufacturing/OperationRows | Produkta struktūra; procesa posmi ar sagatavošanas laiku un laiku vienas vienības apstrādei | Monitor → SkyPlanner | Sākotnējā ielāde, pēc tam — rodoties izmaiņām |
Manufacturing/AlternativeOperationRows | Alternatīvie darba centri katram posmam | Monitor → SkyPlanner | Sākotnējā ielāde, pēc tam — rodoties izmaiņām |
Darba centrs (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | Darba centri, darba centru grupas, efektivitātes rādītāji | Monitor → SkyPlanner | Sākotnējā ielāde, turpmāk reti |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Maiņas un prombūtnes | Monitor → SkyPlanner | Katru dienu vai atsevišķi veidotas maiņas SkyPlanner sistēmā |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Pasūtījumi ar izpildes termiņiem un statusu | Monitor → SkyPlanner | Izmaiņu žurnāla aptauja ik pēc dažām minūtēm |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Darbi ar ilgumu un atlikušo daudzumu | Monitor → SkyPlanner | Izmaiņu žurnāla aptauja ik pēc dažām minūtēm |
Manufacturing/ManufacturingOrderMaterials | Materiālu vajadzības katram pasūtījumam | Monitor → SkyPlanner | Izmaiņu žurnāla aptauja |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Krājumi; ienākošie materiāli to piegādes datumā | Monitor → SkyPlanner | Aptauja reizi stundā vai grafika aprēķina laikā |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Katras operācijas plānotais sākums un beigas | SkyPlanner → Monitor | Mainoties grafikam, ar SkyPlanner webhook |
ManufacturingOrderOperations/SetWorkCenter | Plānošanas dzinēja izvēlētais darba centrs | SkyPlanner → Monitor | Mainoties grafikam |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Laika uzskaites ieraksti un daudzumi | Viens kanāls, ko izvēlas tvēruma noteikšanas laikā | Pēc katra apstiprinājuma vai katras maiņas |
| Nav Monitor sistēmā | Sagatavošanas laiku matrica, instrumenti kā ierobežoti resursi, darbi ar vairākiem operatoriem | Uztur SkyPlanner sistēmā | Konfigurē ieviešanas laikā |
Integrācijas risinājumi
1. Sākotnējā pamatdatu ielāde. Nolasiet darba centrus, operāciju rindas, alternatīvo operāciju rindas, materiālu rindas, nomenklatūras vienības un grafikus. Rūpīgi nosakiet, kuram SkyPlanner darba centram atbilst katrs Monitor darba centrs. Pool tipa darba centrs kļūst par darba centru grupu, bet tajā iekļautie darba centri — par darba centriem, no kuriem izvēlas plānošanas dzinējs.
2. Pasūtījumu sinhronizācija. Nolasiet atvērtos ražošanas pasūtījumus ar to mezgliem, operācijām un materiāliem, kā arī krājumus un atvērtos iepirkuma pasūtījumus. SkyPlanner uzskata pasūtītos materiālus par pieejamiem iepirkuma pasūtījuma piegādes datumā un atjaunina krājumus, kad iepirkuma pasūtījumam piešķir statusu Delivered. Pēc pirmās ielādes izmaiņas nosaka pēc Common/EntityChangeLogs.
3. Grafika ierakstīšana atpakaļ Monitor sistēmā. Katrai operācijai, ko plānošanas dzinējs ieplānojis vai pārvietojis, SkyPlanner nosūta ManufacturingOrderOperations/Update ar PlannedStartDate un PlannedFinishDate. Ja dzinējs pārvietojis operāciju uz citu grupas iekārtu, vispirms tiek izpildīts SetWorkCenter. Viena pasūtījuma komandas apvieno vienā Batch, lai Monitor pieņemtu vai nu tās visas, vai nevienu. Testēšanas laikā izpildiet pakotni ar /Validate.
Monitor versijās pirms 24.5 plānotos datumus nevar ierakstīt ar Update. Tā vietā izmantojiet ManufacturingOrders/ReplanOperation (sākot ar 2.40) ar StartDate un FinishDate un iestatiet RestrictToOrderBounds atbilstoši saviem noteikumiem.
4. Darba izpildes apstiprinājumi ražotnē. Izmantojiet vienu uzskaites kanālu:
- Uzskaite paliek Monitor sistēmā. Operatori tāpat kā līdz šim reģistrē darbu ar Recording terminal vai iekārtu integrācijas palīdzību. SkyPlanner nolasa
ManufacturingOrderOperationReportingskā izpildes progresa datus un pārplāno grafiku. - Uzskaiti pārceļ uz SkyPlanner. Operatori reģistrē darbu ar Mobile Confirmations vai Production Timer, un SkyPlanner nosūta Monitor sistēmai
ReportManufacturingOrderOperation.
Ja darbu reģistrē abās sistēmās, laiks un daudzumi tiek uzskaitīti divreiz.
5. Atbildība par datiem un pretrunu risināšanas noteikumi. Dokumentējiet tos pirms ekspluatācijas sākuma:
| Dati | Atbildīgā sistēma |
|---|---|
| Nomenklatūras vienības, BOM un tehnoloģiskais process, daudzumi, pasūtījuma statuss | Monitor |
| Operāciju secība, plānotais sākums un beigas, darba centrs grupā | SkyPlanner |
| Sagatavošanas laiku matrica, instrumenti, operatoru skaits, alternatīvie resursi | SkyPlanner |
| Maiņas un prombūtnes | Viena sistēma, ko izvēlas tvēruma noteikšanas laikā |
| Operāciju izpildes reģistrēšana | Viens kanāls, ko izvēlas tvēruma noteikšanas laikā |
Galvenais konfliktu cēlonis ir tas, ka plānotāji turpina mainīt prioritāšu plānu. Rescheduling according to New finish un rindu vilkšana sadaļā Priority planning pārraksta SkyPlanner ierakstītos datumus. Kad secību nosaka SkyPlanner, Priority planning izmanto tikai datu apskatei. Ar Autopilot SkyPlanner automātiski pārplāno grafiku, kad ražošanā rodas izmaiņas.
Tipiskie projekta posmi
Ieviešanu parasti pabeidz dažu nedēļu laikā pēc sākotnējās sagatavošanas sākuma. Pirms tam 30 dienu bezmaksas izmēģinājumā varat strādāt ar saviem datiem. Eksportējiet no Monitor uz Excel atvērto ražošanas pasūtījumu operācijas un darba centrus, importējiet tos un pārbaudiet grafiku, pirms sākat integrācijas darbus.
Pats projekts ietver šādus posmus:
- Tvēruma noteikšana. Vienojieties par datu atbilstības tabulu, noteikumiem par atbildību par datiem, aptaujas intervāliem, izpildes reģistrēšanas kanālu un Monitor versiju.
- Piekļuve. Izveidojiet API lietotāju, iegādājieties Monitor ERP API licenci ar rakstīšanas tiesībām un atveriet tīkla piekļuvi portam 8001.
- Sākotnējā datu ielāde. Nomenklatūras vienības, darba centri, operāciju rindas, alternatīvas, materiāli un grafiki.
- Pasūtījumu un iepirkuma pasūtījumu sinhronizācija, izmantojot izmaiņu žurnālu.
- Ierobežojumu iestatīšana SkyPlanner. Sagatavošanas laiku matrica, instrumenti, operatoru skaits un alternatīvas iekārtas vai darbinieki.
- Grafika ierakstīšana atpakaļ sistēmā pa paketēm, pārbaudot ar
/Validate. - Paralēlā testēšana. Lietojiet SkyPlanner paralēli prioritāšu plānam, salīdziniet datumus un izlabojiet pamatdatus.
- Darba sākšana. Ieslēdziet datu ierakstīšanu atpakaļ sistēmā, kad dati sakrīt.
Kas jāņem vērā, plānojot Monitor ERP integrāciju
- Pieejamības koeficients. Monitor aprēķina neto jaudu no bruto jaudas, izmantojot pieejamības koeficientu. Jaunam darba centram tas pēc noklusējuma ir 80 %. Piemērojiet to tikai vienreiz — kā SkyPlanner efektivitātes rādītāju vai kā īsākas maiņas, nekad abējādi.
- Laika precizitāte. Darba centriem, kuri izmanto Day planning, jauda ir norādīta kā pamatlaiks dienā bez maiņu laikiem. Iestatiet SkyPlanner faktiskās maiņas atbilstoši ražošanas grafikiem, lai darbi tiktu ieplānoti darba laikā.
- Gaidīšanas laiks un pārklāšanās. Operāciju rindās ir norādīts gaidīšanas laiks un pārklāšanās %. Tvēruma noteikšanas laikā vienojieties, kā katru no šiem parametriem sasaistīt ar SkyPlanner parametriem, citādi pēc integrācijas darbības sākšanas mainīsies izpildes laiks.
- Grupas. Grupās apvienotos darba centrus plāno sadaļā Pool planning, nevis Priority planning. Nolasiet arī grupā iekļautos darba centrus, ne tikai grupas rindu.
- Versiju prasības. Plānoto datumu ierakstīšanai ar Update nepieciešama versija 24.5. Darba centru jaudas laukiem API nepieciešama versija 24.3, bet OIDC — 25.8. Pirms tvēruma noteikšanas pārbaudiet sistēmas laidienu.
- Tīkls un sertifikāts. Lokāli instalēts Monitor nodrošina API portā 8001 ar pašparakstītu sertifikātu. SkyPlanner darbojas mākonī, tāpēc ieplānojiet ugunsmūra kārtulu vai starpniekserveri un skaidri norādiet sertifikātu kā uzticamu.
- Licences. Katrai trešās puses lietotnei, kas ieraksta datus, nepieciešami savi lietotāji ar API licenci. Katrā sistēmā ir iekļauts viens API lietotājs tikai ar lasīšanas tiesībām.
Monitor ERP integrācija: kas to konfigurē un nodrošina atbalstu
Darbs ietver datu sasaisti ar jūsu darba centriem, operāciju rindām un pasūtījumu plūsmu, kā arī to ierobežojumu iestatīšanu, kuri netiek glabāti Monitor: sagatavošanas laiku matricu, instrumentus, operatoru skaitu un alternatīvos resursus.
- SkyPlanner komanda konfigurē integrāciju ieviešanas laikā un nodrošina atbalstu pēc darba sākšanas. Tas aptver SkyPlanner pusi un saskaņotos Monitor ERP API izsaukumus. Katrā rūpnīcā Monitor G5 izmanto atšķirīgi, un konfigurācijā tiek ņemtas vērā šīs zināšanas.
- Var piedalīties arī jūsu Monitor partneris. Partneris pārzina jūsu konfigurāciju, versiju un piekļuves tiesības un var sagatavot API lietotāju, licenci un piekļuvi tīklam. SkyPlanner nodrošina REST API, Swagger/OpenAPI dokumentāciju un tīmekļa aizķeres.
- Arī jūsu izstrādātāji var veidot savus risinājumus, izmantojot to pašu dokumentēto REST API un API pilnvaru. Lai sāktu, pietiek ar API pilnvaru, un SkyPlanner komanda vajadzības gadījumā palīdzēs. Publiskā dokumentācija ir pieejama sadaļā SkyPlanner dokumentācija.
Pēc savienojuma izveides Arcturus dzinis sastāda grafiku, balstoties uz aktuālajiem Monitor pasūtījumiem, un plānotie datumi tiek ierakstīti ražošanas pasūtījumu operācijās. SkyPlanner cena sākas no 199 € mēnesī, iekļaujot 5 darba centrus, ar ikmēneša norēķiniem. Integrācijas piedāvājumu sagatavojam iepriekš atbilstoši jūsu procesam un vajadzībām kopā ar izvēlēto plānu, lai visas izmaksas būtu zināmas pirms darba sākšanas. Skatiet cenas, Monitor plānošanas iespēju salīdzinājumu sadaļā Monitor ERP ražošanas plānošana, ievērojot reālo iekārtu un personāla jaudu, pārskatu Monitor ERP lapā un citas ERP sistēmas ERP integrāciju sadaļā.
Ražotāju atsauksmes par SkyPlanner
2 hietaupītas katru nedēļu
“Ar SkyPlanner esam pārgājuši no ražošanas plānošanas Excel tabulās uz ražošanas optimizāciju reāllaikā.”
Kalle Kalliomäki, piegādes ķēdes speciālists
UTU · Elektrosadales skapji un sadales iekārtas
Ražošanas plānošana katru nedēļu ietaupa 2 darba stundas, un jaunā darbu rinda nonāk līdz ražošanas līnijai dažu sekunžu laikā.
+90%ražošanas efektivitāte
“Ražošanas efektivitāte ir pieaugusi par 90%.”
Abdul Rucyinga, IT vadītājs
Laboratory & Allied · Zāļu ražošana
Ražošanas efektivitāte ir pieaugusi par 90%, un optimizēta trīs mēnešu plāna izveide visiem darba centriem aizņem mazāk nekā 30 minūtes.
1 000-iemdarba uzdevumu ieplānoti automātiski
“Tagad ražošanu kontrolējam citādi, un mūsu izpratne par jaudu ir pavisam citā līmenī.”
Hannu Ryynänen, izpilddirektors
Mamec · Rūpnieciskie maisītāji, sūkņi un augsto tehnoloģiju līgumražošana
Tūkstošiem darba uzdevumu tiek ieplānoti automātiski, un visa organizācija var sekot ražošanai reāllaikā.
6 mēnešusuz priekšu pārdošanas komanda redz brīvo jaudu
“SkyPlanner nodrošina uzticamu pamatu visai ražošanas plānošanai.”
Anu Järvinen, ražošanas vadītāja
Fredman Operations · Papīrs pārtikas iepakojumam
Pārdošanas komanda redz brīvo jaudu sešus mēnešus uz priekšu, un uz grafika izmaiņu pieprasījumiem, kas agrāk prasīja stundu vai ilgāk, tagad atbild dažu sekunžu laikā.
Biežāk uzdotie jautājumi
Vai Monitor ERP ir API ražošanas pasūtījumiem?
Jā. Monitor ERP API nodrošina vaicājumus Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations un ManufacturingOrderMaterials. Tādas komandas kā ManufacturingOrderOperations/Update un ReplanOperation ieraksta plānotos datumus atpakaļ sistēmā.
Vai datu ierakstīšanai Monitor caur API ir vajadzīga papildu licence?
Jā. Datu lasīšana caur API ir bez maksas visiem Monitor klientiem. Komandām, kas ieraksta datus, nepieciešama Monitor ERP API licence, ko pārdod Monitor. Piedāvājumu sagatavo jūsu Monitor partneris vai Monitor pārdošanas komanda.
Vai Monitor ERP API atbalsta tīmekļa aizķeres?
Tīmekļa aizķeres dokumentācijā nav aprakstītas. Integrācija ik pēc dažām minūtēm aptaujā Common/EntityChangeLogs un izgūst tikai mainītos ierakstus. Pretējā virzienā SkyPlanner tīmekļa aizķeres nosūta grafika izmaiņas, tiklīdz tās notiek.
Kāda Monitor versija mums nepieciešama?
Plānotā sākuma un beigu ierakstīšanai ar ManufacturingOrderOperations/Update nepieciešama Monitor 24.5 vai jaunāka versija. Vecāki G5 laidieni, sākot no 2.40, izmanto ReplanOperation. Tvēruma noteikšanas laikā apstiprinām jūsu laidienam piemēroto risinājumu.
Kas izveido Monitor ERP integrāciju?
SkyPlanner komanda ieviešanas laikā konfigurē divvirzienu integrāciju atbilstoši jūsu Monitor G5 konfigurācijai un nodrošina atbalstu pēc darba sākšanas. Arī jūsu Monitor partneris vai pašu izstrādātāji var veidot risinājumus, izmantojot SkyPlanner dokumentēto REST API. Lai sāktu, pietiek ar API pilnvaru.
Vai varam izmēģināt SkyPlanner pirms integrācijas izveides?
Jā. 30 dienu bezmaksas izmēģinājumā varat izmantot līdz 20 darba centriem, importējot Monitor datus Excel vai CSV formātā. Kredītkarte nav nepieciešama. Sāciet izmēģinājumu vai sazinieties ar pārdošanas komandu, lai noteiktu integrācijas tvērumu.
