Entegrasyonlar / ERP / Monitor ERP
Monitor ERP Entegrasyon Kılavuzu SkyPlanner APS ile Üretim Çizelgeleme
Bu Monitor ERP entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine Monitor ERP’yi (Monitor G5) SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, Monitor ERP API üzerinden Monitor ERP ile çift yönlü entegre olur:
- Üretim emirleri, operasyonlar, iş merkezleri, rotalar ve malzemeler SkyPlanner’a aktarılır.
- Her operasyonun planlanan başlangıcı, planlanan bitişi ve iş merkezi Monitor’a geri yazılır.
- Bildirilen süreler ve miktarlar, iki sistemin eşzamanlı kalmasını sağlar.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Monitor G5 yapılandırmanıza göre ayarlar ve canlıya geçişten sonra da destek verir. Bu kılavuz, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API’sini (API referansı) kullanarak kendi çözümlerini geliştirmek isteyen iş ortakları ve geliştiriciler içindir.
Monitor ERP API
Monitor G5’in belgelenmiş entegrasyon arayüzü Monitor ERP API v1‘dir. CQRS ve REST yaklaşımlarını birleştirir; HTTPS üzerinden JSON kullanır. (Monitor ERP API)
- Sorgular GET ile veri okur. OData tarzı seçenekleri destekler:
$filter,$select,$expand,$orderby,$topve$skip. - Komutlar POST ile veri yazar. Örneğin:
Manufacturing/ManufacturingOrderOperations/Update. - Batch,
POST /api/v1/Batchüzerinden birden fazla komutu, ya tümünün uygulandığı ya da hiçbirinin uygulanmadığı tek bir işlemde çalıştırır. Bir komut grubunu test edip işlemi geri almak için sonuna/Simulateveya/Validateekleyin. Çizelgenin tamamını güvenle yazmanın yolu budur. (Batch)
Temel URL https://{host}:8001/{languageCode}/{companyNumber}/api/v1/ şeklindedir. Şirket numarası, veritabanı numarası ile şirket kimliğini birleştirir; örneğin 004.1.
Monitor, lisanslama konusunda şunu belirtir: “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.” (Tüm müşterilerimiz API üzerinden ücretsiz sorgulama yapabilir ve bilgi alabilir. Ancak komutları kullanmak ve ERP sistemine veri yazmak için Monitor ERP API satın alınmalıdır.) Yazma lisansını ilk günden proje planına dahil edin. (api.monitor.se)
Kimlik doğrulama
- Oturum açma. Bir Monitor kullanıcısının kullanıcı adı ve parolasıyla yapılan
POST /{languageCode}/{companyNumber}/loginçağrısı, sonraki çağrılarda kullanılacak birX-Monitor-SessionIdbaşlığı döndürür. MFA belirteciyle kimlik doğrulama akışı da mevcuttur. - OIDC. Monitor 25.8’den itibaren Authorization Code ve PKCE kullanılarak Microsoft Entra ID üzerinden de oturum açılabilir. (Kimlik doğrulama)
- Entegrasyona özel API kullanıcısı. Entegrasyon için bir kullanıcı oluşturun. Show manufacturing orders ve Replan existing manufacturing order gibi Monitor izinleri bu kullanıcı için de geçerlidir.
SkyPlanner tarafında REST API, API belirteciyle kimlik doğrular (SkyPlanner Settings > API); dokümantasyonu Swagger/OpenAPI’de bulunur. Entegrasyon eğitiminde ilk çağrılar adım adım anlatılır.
Değişiklikleri algılama ve periyodik sorgulama
Monitor ERP API referansında webhook veya olay aboneliği belgelenmemiştir. Değişiklikler periyodik sorgulamayla alınır:
Common/EntityChangeLogs(2.33’ten itibaren),ChangeType(Update, Create, Delete),EntityTypeId,EntityIdveModifiedTimestampdöndürür. Birkaç dakikada bir sorgulayın ve yalnızca değişen kayıtları alın. (EntityChangeLog)- Üretim emri sorgularını yalnızca açık emirleri getirecek şekilde filtreleyin;
$topve$skipile sayfalama yapın.
SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Bu nedenle geri yazma tarafı olay güdümlü çalışır.
Veri eşleme
| Monitor ERP nesnesi (API) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Part (Inventory/Parts) | Ürünler ve malzemeler | Monitor → SkyPlanner | İlk yükleme, ardından değişiklik günlüğü üzerinden |
BOM ve rota: Manufacturing/MaterialRows, Manufacturing/OperationRows | Ürün yapısı; hazırlık ve birim süreleriyle birlikte işlem adımları | Monitor → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
Manufacturing/AlternativeOperationRows | Her adım için alternatif iş merkezleri | Monitor → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
İş merkezi (Manufacturing/WorkCenters): Type, TimePrecision, BasicTime, NumberOfPlanningUnits, AvailabilityFactor | İş merkezleri, iş merkezi grupları, verimlilik oranları | Monitor → SkyPlanner | İlk yükleme, sonrasında nadiren |
Manufacturing/ProductionCalendarExceptions, TimeRecording/Schedules | Vardiyalar ve devamsızlıklar | Monitor → SkyPlanner | Günlük veya SkyPlanner’da ayrı vardiya tanımları |
Manufacturing/ManufacturingOrders, ManufacturingOrderNodes | Termin tarihleri ve durumlarıyla birlikte emirler | Monitor → SkyPlanner | Birkaç dakikada bir değişiklik günlüğü sorgulaması |
Manufacturing/ManufacturingOrderOperations: Priority, WorkCenterId, PlannedQuantity, RestQuantity, PlannedSetupTime, PlannedUnitTime | Süreleri ve kalan miktarlarıyla birlikte işler | Monitor → SkyPlanner | Birkaç dakikada bir değişiklik günlüğü sorgulaması |
Manufacturing/ManufacturingOrderMaterials | Emir bazında malzeme ihtiyaçları | Monitor → SkyPlanner | Değişiklik günlüğü sorgulaması |
Inventory/PartLocations (Balance), Purchase/PurchaseOrderRows (DeliveryDate, RestQuantity) | Stok; teslim tarihinde gelecek malzeme | Monitor → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
ManufacturingOrderOperations/Update: PlannedStartDate, PlannedFinishDate (24.5+) | Operasyon bazında planlanan başlangıç ve bitiş | SkyPlanner → Monitor | Çizelge değiştiğinde, SkyPlanner webhook’u üzerinden |
ManufacturingOrderOperations/SetWorkCenter | Motorun seçtiği iş merkezi | SkyPlanner → Monitor | Çizelge değiştiğinde |
ReportManufacturingOrderOperation / ManufacturingOrderOperationReportings | Zaman kayıtları ve miktarlar | Kapsam belirleme sırasında seçilen tek kanal | Her teyitte veya her vardiyada |
| Monitor’da bulunmaz | Hazırlık süresi matrisi, sınırlı kaynak olarak takımlar, birden fazla operatör gerektiren işler | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon modelleri
1. Ana verilerin ilk yüklemesi. İş merkezlerini, operasyon satırlarını, alternatif operasyon satırlarını, malzeme satırlarını, parçaları ve çalışma çizelgelerini okuyun. Her iş merkezinin SkyPlanner’da hangi iş merkeziyle eşleşeceğini dikkatle belirleyin. Pool türündeki bir iş merkezi, iş merkezi grubuna dönüşür. Bünyesindeki iş merkezleri ise motorun aralarından seçim yaptığı iş merkezleri olur.
2. Emir senkronizasyonu. Açık üretim emirlerini düğümleri, operasyonları ve malzemeleriyle birlikte okuyun; stokları ve açık satınalma siparişlerini de alın. SkyPlanner, sipariş edilen malzemeyi satınalma siparişinin teslim tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoku günceller. İlk yüklemeden sonra yalnızca değişen verilerin aktarımı Common/EntityChangeLogs üzerinden yürütülür.
3. Çizelgeyi geri yazma. SkyPlanner, motorun çizelgeye yerleştirdiği veya yerini değiştirdiği her operasyon için PlannedStartDate ve PlannedFinishDate alanlarıyla ManufacturingOrderOperations/Update gönderir. Motor bir operasyonu havuzdaki başka bir makineye taşıdıysa önce SetWorkCenter çalıştırılır. Bir emre ait komutlar tek bir Batch içinde gönderilir; böylece Monitor ya hepsini kabul eder ya da hiçbirini kabul etmez. Test sırasında komut grubunu /Validate üzerinden çalıştırın.
24.5’ten önceki Monitor sürümlerinde planlanan tarihler Update üzerinden yazılamaz. Bunun yerine StartDate ve FinishDate ile ManufacturingOrders/ReplanOperation kullanın (2.40’tan itibaren) ve RestrictToOrderBounds alanını kurallarınıza uygun şekilde ayarlayın.
4. Üretim sahası teyitleri. Tek bir bildirim kanalı kullanın:
- Bildirim kanalı Monitor olarak kalır. Operatörler mevcut düzende olduğu gibi Recording terminal veya makine entegrasyonu üzerinden bildirim yapar. SkyPlanner, ilerlemeyi
ManufacturingOrderOperationReportingsüzerinden okur ve çizelgeyi yeniden oluşturur. - Bildirim kanalı SkyPlanner olur. Operatörler Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder; SkyPlanner da Monitor’a
ReportManufacturingOrderOperationgönderir.
Her iki taraftan da bildirim yapılması, sürelerin ve miktarların mükerrer kaydedilmesine yol açar.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:
| Veri | Veri sahibi |
|---|---|
| Parçalar, BOM ve rota, miktarlar, emir durumu | Monitor |
| Operasyon sırası, planlanan başlangıç ve bitiş, havuz içindeki iş merkezi | SkyPlanner |
| Hazırlık süresi matrisi, takımlar, operatör sayıları, alternatif kaynaklar | SkyPlanner |
| Vardiyalar ve devamsızlıklar | Kapsam belirleme aşamasında seçilen tek bir sistem |
| Operasyon bildirimi | Kapsam belirleme aşamasında seçilen tek bir kanal |
Çakışmaların başlıca nedeni, planlamacıların öncelik planında değişiklik yapmaya devam etmesidir. Rescheduling according to New finish işlemi ve Priority planning içinde satırların sürüklenmesi, SkyPlanner’ın yazdığı tarihlerin üzerine yazar. Sıralamayı SkyPlanner yönetmeye başladığında Priority planning yalnızca bir görüntüleme ekranı olarak kullanılır. Autopilot ile SkyPlanner, üretimde değişiklik olduğunda çizelgeyi otomatik olarak yeniden oluşturur.
Tipik proje adımları
Uygulama, kurulum süreci başladıktan sonra genellikle birkaç hafta içinde tamamlanır. Bunun öncesinde, 30 günlük ücretsiz denemede kendi verilerinizi kullanırsınız. Açık üretim emirlerinin operasyonlarını ve iş merkezlerini Monitor’dan Excel’e aktarın, ardından bu verileri içe aktararak entegrasyon çalışmalarına başlamadan önce çizelgeyi doğrulayın.
Proje şu adımlardan oluşur:
- Kapsam belirleme. Eşleme tablosunu, hangi veriyi hangi sistemin yöneteceğini, sorgulama aralıklarını, bildirim kanalını ve Monitor sürümünü netleştirin.
- Erişim. API kullanıcısını oluşturun, Monitor ERP API yazma lisansını satın alın ve 8001 portuna ağ erişimini açın.
- İlk veri yüklemesi. Parçaları, iş merkezlerini, operasyon satırlarını, alternatifleri, malzemeleri ve çizelgeleri yükleyin.
- Değişiklik günlüğü üzerinden üretim emirlerini ve satın alma siparişlerini senkronize edin.
- SkyPlanner’da kısıtların tanımlanması. Hazırlık süresi matrisini, takımları, operatör sayılarını ve alternatif makineleri veya personeli tanımlayın.
- Çizelgeyi toplu olarak geri yazın ve
/Validateile test edin. - Paralel test. SkyPlanner’ı öncelik planıyla paralel çalıştırın, tarihleri karşılaştırın ve ana verileri düzeltin.
- Canlıya geçiş. Veriler eşleştiğinde geri yazmayı etkinleştirin.
Monitor ERP entegrasyonunda dikkate alınması gerekenler
- Kullanılabilirlik katsayısı. Monitor, brüt kapasiteden net kapasiteye geçerken kullanılabilirlik katsayısını uygular. Yeni bir iş merkezinde bu katsayı varsayılan olarak %80’dir. Katsayıyı SkyPlanner’da ya verimlilik olarak ya da vardiyaları kısaltarak yalnızca bir kez uygulayın; iki yöntemi asla birlikte kullanmayın.
- Zaman hassasiyeti. Day planning kullanan iş merkezlerinde kapasite, vardiya saatleri olmadan günlük temel süre olarak tutulur. İşlerin çalışma saatleri içine yerleştirilmesi için üretim takvimlerindeki gerçek vardiyaları SkyPlanner’da eşleyin.
- Kuyruk süresi ve örtüşme. Operasyon satırlarında kuyruk süresi ve % cinsinden örtüşme bilgisi bulunur. Her birinin SkyPlanner’a nasıl aktarılacağını kapsam belirleme aşamasında kararlaştırın; aksi takdirde canlıya geçişten sonra termin süreleri değişir.
- Havuzlar. Havuz iş merkezleri Priority planning içinde değil, Pool planning içinde planlanır. Yalnızca havuz satırını değil, havuza dahil olan iş merkezlerini de okuyun.
- Sürüm gereksinimleri. Planlanan tarihleri Update üzerinden yazmak için 24.5 gerekir. API’deki iş merkezi kapasite alanları için 24.3, OIDC için ise 25.8 gerekir. Kapsam belirleme öncesinde kurulu sürümü kontrol edin.
- Ağ ve sertifika. Yerel sunucuda çalışan Monitor, API’yi kendinden imzalı bir sertifikayla 8001 portundan sunar. SkyPlanner bulutta çalıştığından bir güvenlik duvarı kuralı veya aracı sunucu planlayın ve sertifikayı açıkça güvenilir olarak tanımlayın.
- Lisanslar. Veri yazan her üçüncü taraf uygulama için ayrı API lisanslı kullanıcılar gerekir. Her sistemle birlikte salt okunur erişime sahip bir API kullanıcısı sunulur.
Monitor ERP entegrasyonunu kim yapılandırır ve destekler?
Çalışma; iş merkezlerinizin, operasyon satırlarınızın ve sipariş akışınızın eşlenmesini, ayrıca Monitor’da tutulmayan kısıtların tanımlanmasını kapsar. Bu kısıtlar hazırlık süresi matrisi, takımlar, operatör sayıları ve alternatif kaynaklardır.
- SkyPlanner ekibi entegrasyonu kurulum sürecinde yapılandırır ve canlıya geçişten sonra destekler. Bu destek, SkyPlanner tarafını ve üzerinde anlaşılmış Monitor ERP API çağrılarını kapsar. Her tesis Monitor G5’i farklı kullanır; bu bilgi birikimi de yapılandırmaya yansıtılır.
- Monitor iş ortağınız da sürece katılabilir. İş ortağınız yapılandırmanızı, sürümünüzü ve izinlerinizi bilir; API kullanıcısını, lisansı ve ağ erişimini hazırlayabilir. SkyPlanner, REST API, Swagger/OpenAPI dokümantasyonu ve webhook’lar sağlar.
- Kendi geliştiricileriniz de entegrasyonu genişletebilir. Bunun için aynı dokümante edilmiş REST API’yi bir API belirteciyle kullanabilirler. Başlamak için bir API belirteci yeterlidir; SkyPlanner ekibi gerektiğinde yardımcı olur. Herkese açık dokümantasyona SkyPlanner dokümanları sayfasından ulaşabilirsiniz.
Bağlantı kurulduğunda Arcturus motoru, Monitor’daki güncel siparişlere göre çizelgeleme yapar ve planlanan tarihler üretim emri operasyonlarına yazılır. SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Entegrasyon için süreçlerinize ve ihtiyaçlarınıza göre, paketinizle birlikte önceden teklif verilir. Böylece başlamadan önce toplam maliyeti görürsünüz. Fiyatları inceleyin; Monitor’ın kendi planlama özellikleriyle karşılaştırma için Monitor ERP ile üretim çizelgeleme sayfasına, genel bilgiler için Monitor ERP sayfasına, diğer ERP sistemleri için ise ERP entegrasyonları merkezine göz atın.
Üreticilerin SkyPlanner yorumları
2 saather hafta kazanılan zaman
“SkyPlanner, üretim planlamamızı Excel tablolarından gerçek zamanlı üretim optimizasyonuna taşıdı.”
Kalle Kalliomäki, Tedarik Zinciri Uzmanı
UTU · Elektrik panoları ve şalt ekipmanları
Üretim planlamasında her hafta 2 saatlik çalışma süresi kazanılıyor ve yeni iş kuyruğu üretim hattına saniyeler içinde ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, BT Müdürü
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan üç aylık optimize edilmiş bir plan, 30 dakikadan kısa sürede hazırlanıyor.
1.000’lerceotomatik çizelgelenen iş emri
“Üretimi artık farklı bir şekilde kontrol altında tutuyoruz ve kapasitemize ilişkin bilgimiz bambaşka bir seviyeye ulaştı.”
Hannu Ryynänen, CEO
Mamec · Endüstriyel karıştırıcılar, pompalar ve yüksek teknolojili fason üretim
Binlerce iş emri otomatik olarak çizelgeleniyor ve tüm kuruluş üretimi gerçek zamanlı olarak görebiliyor.
6 aylıksatış ekibinin görebildiği boş kapasite
“SkyPlanner, tüm üretim planlamasına temel oluşturuyor ve güvenilirlik sağlıyor.”
Anu Järvinen, Üretim Müdürü
Fredman Operations · Gıdayla temasa uygun ambalaj kâğıtları
Satış ekibi boş kapasiteyi altı ay önceden görüyor. Daha önce yanıtlanması bir saat veya daha uzun süren çizelge değişikliği talepleri artık saniyeler içinde yanıtlanıyor.
Sık sorulan sorular
Monitor ERP’nin üretim emirleri için bir API’si var mı?
Evet. Monitor ERP API; Manufacturing/ManufacturingOrders, ManufacturingOrderNodes, ManufacturingOrderOperations ve ManufacturingOrderMaterials için sorgu erişimi sunar. ManufacturingOrderOperations/Update ve ReplanOperation gibi komutlar, planlanan tarihleri geri yazar.
API üzerinden Monitor’a veri yazmak ek lisans gerektirir mi?
Evet. API üzerinden veri okumak tüm Monitor müşterileri için ücretsizdir. Veri yazan komutlar için Monitor’ın sattığı Monitor ERP API gerekir. Fiyat teklifini Monitor iş ortağınız veya Monitor satış ekibi verir.
Monitor ERP API webhook’ları destekliyor mu?
Dokümantasyonda webhook desteği belirtilmiyor. Entegrasyon, birkaç dakikada bir Common/EntityChangeLogs üzerinden sorgulama yapar ve yalnızca değişen kayıtları alır. Ters yönde ise SkyPlanner’ın kendi webhook’ları, çizelge değişikliklerini gerçekleştiği anda iletir.
Hangi Monitor sürümüne ihtiyacımız var?
Planlanan başlangıç ve bitiş tarihlerini ManufacturingOrderOperations/Update üzerinden yazmak için Monitor 24.5 veya üzeri gerekir. Daha eski G5 sürümlerinde, 2.40’tan itibaren ReplanOperation kullanılır. Kurulu sürümünüze uygun yöntemi kapsam belirleme aşamasında netleştiririz.
Monitor ERP entegrasyonunu kim geliştirir?
SkyPlanner ekibi, kurulum sürecinde çift yönlü entegrasyonu Monitor G5 yapılandırmanıza göre ayarlar ve canlıya geçişten sonra destekler. Monitor iş ortağınız veya kendi geliştiricileriniz de SkyPlanner’ın dokümante edilmiş REST API’si üzerinden geliştirme yapabilir. Başlamak için bir API belirteci yeterlidir.
Entegrasyonu geliştirmeden önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, Monitor’dan Excel veya CSV ile veri aktararak 20 iş merkezine kadar kullanım sunar; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
