Entegrasyonlar / ERP / HELIOS
SkyPlanner APS ile Üretim Çizelgeleme için HELIOS Entegrasyon Kılavuzu
Bu HELIOS entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine HELIOS iNuvio ve HELIOS Nephrite’ı SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, HELIOS’un kendi arayüzlerini kullanarak çift yönlü entegrasyon sağlar:
- Üretim emirleri (výrobní příkazy) ve bunlarla ilişkili operasyonlar, üretilen parçalar, ürün ağaçları, rotalar, çalışma yerleri, makineler, meslekler, personel kaynakları, stoklar ve satın alma siparişleri içe aktarılır.
- Planlanan başlangıç ve bitiş tarihleri üretim emirlerine geri yazılır.
- İsterseniz operatörlerin süre kayıtları, operasyon kayıtları (evidence výrobních operací) olarak geri yazılabilir.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu HELIOS kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destekler. Bu kılavuz, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API’sini (API başvuru kaynağı) kullanarak kendi geliştirmelerini yapmak isteyen HELIOS iş ortakları ve geliştiriciler içindir.
HELIOS’un entegrasyon arayüzleri
Helios Inuvio Server (Inuvio REST API). Asseco bunu, HELIOS iNuvio’nun işlev alanlarına REST API üzerinden erişim sağlayan ayrı bir bileşeni olarak tanımlar (Helios Inuvio Server yardımı). iNuvio dağıtımına dahildir; OpenAPI belirtimi ise Rapidoc ve Redoc biçimlerinde yayımlanır. API, her biri kendi kimliğine ve erişim haklarına sahip HELIOS liste görünümleri (browses) üzerinden çalışır:
- GET /browses/list ve GET /browses/meta, kullanılabilir liste görünümlerini ve bunların sütunlarını listeler.
- /browses/data, bir liste görünümündeki satırları okur; görünümün oluşturma, güncelleme ve silmeye izin verdiği durumlarda satırlara yazma işlemi de yapar.
- /api/v1/actions/meta ve /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent}, bir liste görünümü üzerinde harici eylemler çalıştırır. Şu anda Procedure, Browse ve Plugin türündeki harici eylemler desteklenir.
Çizelgeleme için kullanılan üretim liste görünümleri arasında üretim planı (výrobní plán), üretim emirleri (výrobní příkazy), üretim emrine ait parçalar, üretimde kullanılacak malzemeler ve yarı mamuller, meslekler, personel kaynakları, rota operasyonlarının ön ayarları ve operasyon kayıtları bulunur. Stoklara, girişlere, çıkışlara ve düzenlenen satın alma siparişlerine (vydané objednávky) de aynı şekilde erişilir.
HELIOS Nephrite REST API. Nephrite yol haritasında REST API geliştirmesi yer alır (HELIOS Nephrite yol haritası). SkyPlanner ekibi, kapsam belirleme aşamasında sizinle ve HELIOS iş ortağınızla birlikte kurulumunuzdaki Nephrite uç noktalarını doğrular. Aşağıdaki veri akışları değişmez.
Excel ve CSV. Tüm HELIOS liste görünümleri Microsoft Office’e aktarılabilir. Bu, deneme için veri yüklemeye yeterlidir.
Kimlik doğrulama ve lisanslama
- İki kimlik doğrulama yöntemi. iNuvio, eski ve kendine özgü bir kimlik doğrulama API’si (/api/token) ile RFC 6749 tabanlı daha yeni bir OAuth2 API’si (/oauth/token, /oauth/revoke) sunar. Belirteçler POST /oauth/token veya GET /api/token üzerinden yenilenir.
- Lisanslama. Helios Inuvio Server’ın kendisi ücretsizdir; REST API ise lisansa tabidir. 3.0.2026.0301 sürümünden itibaren sistem ve işlev alanı API’leri tek bir Inuvio REST API altında birleştirilmiştir. API erişimi artık kullanıcı sayısıyla sınırlı değildir.
- Erişim hakları. Entegrasyon kullanıcısının üretim ve stok liste görünümlerini okuma ve üzerinde anlaşılmış harici eylemleri çalıştırma yetkisi olmalıdır.
SkyPlanner tarafında REST API, kimlik doğrulama için Authorization-Token üstbilgisinde bir API belirteci kullanır (SkyPlanner Settings > API). API, Swagger/OpenAPI ile belgelenmiştir. Entegrasyon eğitimi, ilk çağrıları adım adım açıklar.
Olaylar ve periyodik sorgulama
SkyPlanner, HELIOS verilerini belirli aralıklarla okur. Açık üretim emirlerine ve son değişikliklere göre filtrelenen /browses/data çağrıları, yeni işleri alır. Sorgulama sıklığı tesise göre belirlenir; üretim emirleri için birkaç dakikada bir, stok için ise saatte bir olabilir.
SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Böylece geri yazma işlemleri olay bazlı yürütülür.
Veri eşleştirme
| HELIOS nesnesi (liste görünümü) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
| Stok kartları ve üretilen parçalar (vyráběné dílce), birimler | Ürünler ve malzemeler | HELIOS → SkyPlanner | İlk yükleme, ardından periyodik sorgulama |
| Geçerlilik tarihleriyle birlikte ürün ağaçları (kusovník, kusovníkové vazby) | Ürün yapısı, alt ürünler, ürün başına malzemeler | HELIOS → SkyPlanner | İlk yükleme, ardından her değişiklikte |
| Rotalar (technologický postup): operasyon, çalışma yeri, makine ve operatör hazırlık süresi, birim süre, bitirme süresi, operasyonlar arası süre | İşlem adımları ve bunların süreleri, hazırlık ve söküm süreleri | HELIOS → SkyPlanner | İlk yükleme, ardından her değişiklikte |
| Çalışma yerleri (pracoviště), makineler (stroje), alternatif çalışma yerleri | İş merkezleri, iş merkezi grupları, alternatif iş merkezleri | HELIOS → SkyPlanner | İlk yükleme, sonrasında nadiren |
| Meslekler (výrobní profese), personel kaynakları (výrobní personální zdroje) | Personel ve iş başına operatör sayıları | HELIOS → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Planlama takvimleri (plánovací kalendáře) | Vardiyalar ve çalışılmayan günler | HELIOS → SkyPlanner | Günlük veya SkyPlanner’da ayrıca tanımlanan vardiyalar |
| Üretim emirleri (výrobní příkazy), emirlere ait parçalar ve operasyonlar, üretim malzemeleri | Termin tarihleri ve malzeme ihtiyaçlarıyla birlikte emirler ve işler | HELIOS → SkyPlanner | Birkaç dakikada bir sorgulama |
| Stok (stav skladu) | Stok bakiyeleri | HELIOS → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
| Teslimat tarihleriyle birlikte düzenlenen satın alma siparişleri (vydané objednávky) | Satın alma siparişleri, teslimat tarihine göre gelecek malzemeler | HELIOS → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
| Üretim emrindeki her operasyon için planlanan başlangıç ve bitiş (harici eylem) | Her iş için planlanan başlangıç ve bitiş | SkyPlanner → HELIOS | Çizelge değiştiğinde, SkyPlanner webhook’u üzerinden |
| Operasyon kayıtları (evidence výrobních operací) | Süre kayıtları ve operatör bildirimleri | SkyPlanner → HELIOS | Tercih edilirse, her bildirimde veya her vardiyada |
| HELIOS’ta bulunmaz | Hazırlık süreleri matrisi, sınırlı kapasiteli 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. Üretilen parçaları, ürün ağaçlarını, rotaları, çalışma yerlerini, makineleri, meslekleri, personel kaynaklarını ve takvimleri TPV liste görünümlerinden okuyun. Her HELIOS kaynağında, kapasite planlamaya dahil edilip edilmeyeceğini belirleyen bir işaret bulunur. Bu nedenle SkyPlanner’ın neleri çizelgeleyeceğine her kaynak için karar verin. Dört makineli bir çalışma yeri, bir iş merkezi grubu veya dört iş merkezi olarak tanımlanır.
2. Emir senkronizasyonu. Üretim emirlerini parçaları, operasyonları ve malzemeleriyle birlikte okuyun; düzenlenen satın alma siparişlerini de alın. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslimat tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoku günceller. Serbest bırakılan üretim emirlerini çizelgeleyin. Üretim planındaki planlanan miktarlar, üretim emrine dönüşene kadar HELIOS’ta kalır.
3. Çizelgenin geri yazılması. Motor bir işi yerleştirdiğinde veya taşıdığında, bir SkyPlanner webhook’u /api/v1/actions/execute üzerinden üretim emirleri liste görünümünde harici bir eylemi tetikler. Bu eylem, kapsam belirleme aşamasında üzerinde anlaşılan bir HELIOS prosedürüdür ve emirdeki operasyonun planlanan başlangıç ve bitişini ayarlar. HELIOS, değişikliği kendi mantığı içinde doğrular.
4. Üretim sahası bildirimleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder; süre kayıtları da çizelgeyi güncel tutar. Gerçekleşen sürelerin HELIOS’a geri yazılıp yazılmayacağına siz karar verirsiniz. Geri yazmayı seçerseniz harici bir eylem, bu süreleri emirdeki her operasyon için operasyon kaydı olarak işler. Seçmezseniz operatörler HELIOS terminallerinden bildirim yapmaya devam eder ve SkyPlanner bu kayıtları okur.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:
| Veri | Sorumlu sistem |
|---|---|
| Stok kalemleri, ürün ağaçları, rotalar, miktarlar, emir durumu | HELIOS |
| Operasyon sırası, başlangıç ve bitiş saatleri, makine ataması | SkyPlanner |
| Hazırlık süresi matrisi, takım ve operatör gereksinimleri, alternatif kaynaklar | SkyPlanner |
| Vardiyalar ve çalışılmayan günler | Kapsam belirleme aşamasında seçilen tek bir sistem |
| Operasyon kayıtları, malzeme çıkışları ve girişleri | HELIOS; kayıtlar doğrudan burada girilir veya SkyPlanner süre kayıtlarından aktarılır |
Emir tarihlerini yazacak tek bir sistem seçin. HELIOS kapasite planlama veya Nephrite APS hâlâ tarih yazıyorsa SkyPlanner’ın çizelgelediği emirler için bu işlevi kapatın ya da HELIOS planını yalnızca test planı olarak tutun.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra normalde birkaç hafta içinde tamamlanır. Öncesinde, HELIOS’tan CSV veya Excel olarak dışa aktarılan çalışma yerleri, rotalar ve açık üretim emirleriyle 30 günlük ücretsiz denemede çizelgeyi doğrulayın.
- Eşleme. Eşleme tablosunu, veri sahipliği kurallarını, senkronizasyon sıklıklarını ve operasyon kayıtlarının geri yazılıp yazılmayacağını kesinleştirin.
- HELIOS erişimi. Helios Inuvio Server’ı, entegrasyon kullanıcısını, OAuth2 kimlik bilgilerini ve REST API lisansını hazırlayın. Önce veritabanının bir kopyasında test edin.
- İlk yükleme. Üretilen parçalar, ürün ağaçları, rotalar, çalışma yerleri, makineler, meslekler, takvimler.
- Emir ve satın alma siparişi senkronizasyonu. Filtreleme, sayfalama ve yeniden deneme mekanizmalarıyla periyodik sorgulama.
- SkyPlanner’da kısıtların yapılandırılması. Hazırlık süresi matrisi, takımlar, iş başına operatör sayıları ve alternatif makineler veya personel.
- Çizelgenin geri yazılması. Planlanan tarihler ve tercih edilirse operasyon kayıtları için harici eylemleri oluşturup test edin.
- Paralel test. SkyPlanner’ı mevcut planla paralel çalıştırın, tarihleri karşılaştırın ve ana verileri düzeltin.
- Canlıya geçiş. Veriler örtüştüğünde geri yazmayı etkinleştirin.
HELIOS entegrasyonunda dikkat edilmesi gerekenler
- Planlama işaretleri. Yalnızca kapasite planlama için işaretlenmiş kaynakların kapasite verileri güvenilirdir. İlk yüklemeden önce çalışma yerleri, makineler, meslekler ve fason işler üzerindeki işaretleri kontrol edin.
- Zaman birimleri. Hazırlık, birim ve bitirme süreleri saat, dakika veya saniye olarak girilebilir. İçe aktarırken birimleri dönüştürün; aksi halde tüm süreler yanlış olur.
- Operasyonlar arası süre. Sabit operasyonlar arası süre, makine çalışma süresi değil, operasyonlar arasındaki bekleme süresidir. Bunu kapasite olarak değil, bekleme olarak modelleyin.
- Fason operasyonlar (kooperace). Taşıma süresi hem gidiş hem de dönüş için geçerlidir. Fason operasyonları yalnızca süre içeren adımlar olarak modelleyin.
- Yazılabilir görünümler. Tüm görünümler okuma işlemini destekler, ancak yalnızca bazıları oluşturma, güncelleme ve silme işlemlerini destekler. browseCreateImplemented=1 filtresiyle yapılan GET /browses/list isteği, bunların hangileri olduğunu gösterir. Üretim emirlerinin görünümleri salt okunur olduğundan, planlanan tarihler kararlaştırılan harici eylem aracılığıyla geri yazılır.
HELIOS entegrasyonunu kim yapılandırır ve desteğini kim sağlar?
- SkyPlanner ekibi, entegrasyonu devreye alma sürecinde yapılandırır ve canlıya geçişten sonra destek sağlar. Bu hizmet, kararlaştırılan görünümleri ve harici eylemleri kapsar. Her tesis HELIOS’u farklı kullanır; bu kullanım bilgisi de yapılandırmaya yansıtılır.
- HELIOS iş ortağınız da sürece katılabilir. İş ortağınız kurulumunuzu, özel prosedürlerinizi ve lisanslarınızı bilir. SkyPlanner ekibiyle birlikte Helios Inuvio Server kurulumunu yapabilir ve harici eylemleri yapılandırabilir.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için SkyPlanner’ın REST API arayüzünü bir API belirteciyle kullanabilirler. Başlamak için bir API belirteci yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Entegrasyon belgelerine SkyPlanner entegrasyon dokümantasyonundan ulaşabilirsiniz.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Entegrasyon teklifi, süreçlerinize ve ihtiyaçlarınıza göre abonelik planınızla birlikte önceden sunulur. Fiyatlandırmayı, gerçek makine ve personel kapasitesini dikkate alan HELIOS ile üretim çizelgelemeyi, HELIOS sayfasını ve ERP entegrasyonları sayfasını inceleyin. Çizelgelemenin temelleri için üretim çizelgeleme sayfasına bakı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 donanımları
Üretim planlama sayesinde her hafta 2 saat çalışma süresinden tasarruf ediliyor ve yeni iş kuyruğu saniyeler içinde üretim hattına 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, optimize edilmiş üç aylık bir planın hazırlanması 30 dakikadan az sürüyor.
1.000’lerceiş emri otomatik olarak çizelgeleniyor
“Üretimi artık farklı bir şekilde kontrol altında tutuyoruz ve kapasitemizi çok daha iyi anlıyoruz.”
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 kuruluş genelinde herkes üretimi gerçek zamanlı olarak görebiliyor.
%1002021’den bu yana teslimat performansı
“SkyPlanner kapasitemizi görmemizi sağlıyor ve planlamayı öngörülebilir hale getiriyor.”
Dan Berglund, COO/CFO
Opes Corporation · Kimyasal ve gıda üretimi
SkyPlanner’ın kullanılmaya başlandığı 2021’den bu yana teslimat performansı kesintisiz olarak %100 seviyesinde.
Sık sorulan sorular
HELIOS’ta üretim emirleri için bir API var mı?
Evet. Helios Inuvio Server; üretim planı, üretim emirleri, üretim emirlerine ait parçalar, üretim malzemeleri ve operasyon kayıtları dahil olmak üzere HELIOS iNuvio görünümlerine REST erişimi sağlar. HELIOS Nephrite için SkyPlanner ekibi, devreye alma sürecindeki kapsam belirleme aşamasında sizinle ve HELIOS iş ortağınızla birlikte kurulumunuza uygun entegrasyon yöntemini belirler.
SkyPlanner, HELIOS’taki değişiklikleri nasıl alır?
SkyPlanner, her tesis için belirlenen aralıklarla HELIOS görünümlerini sorgular; sorgular açık üretim emirleri ve son değişikliklerle sınırlandırılır. SkyPlanner’ın kendi webhook’ları ise çizelge değişikliklerini anında gönderir.
Planlanan tarihler HELIOS’a nasıl geri yazılır?
Üretim emri görünümündeki bir harici eylem, /api/v1/actions/execute üzerinden çalıştırılır. Bu eylem, kapsam belirleme aşamasında kararlaştırılan bir HELIOS prosedürüdür. Böylece HELIOS, aldığı her tarihe kendi mantığını uygular.
Inuvio REST API hangi kimlik doğrulama yöntemini kullanır?
/oauth/token üzerinden RFC 6749’a uygun OAuth2 veya daha eski, sisteme özgü /api/token yöntemini kullanır. SkyPlanner’ın kendi API’si ise Authorization-Token başlığında bir API belirteci kullanır.
Bir HELIOS iş ortağı HELIOS APS’yi mi, SkyPlanner’ı mı önermeli?
Müşterinin planı sık değişiyorsa ve gerçek kapasite sınırlarının aşılmaması gerekiyorsa SkyPlanner’ı önermeli. HELIOS, planlama hesaplamalarını tek bir etkin plan üzerinde yürütür; tarihlere yetişmek için sınırsız kapasiteye geçebilir ve çakışmaları çözmeyi planlamacıya bırakır (HELIOS yardımı). SkyPlanner, REST API üzerinden bağlanır, otomatik olarak yeniden planlar; iş değişimlerini, takımları, ekipleri ve malzemeleri planlar. Aylık 199 €’dan başlayan fiyatıyla sınırsız kullanıcı sunar.
Entegrasyonu geliştirmeden önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, HELIOS’tan CSV veya Excel ile veri aktarımını ve 20 iş merkezine kadar kullanımı destekler; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
