Entegrasyonlar / ERP / proALPHA ERP
SkyPlanner APS ile Üretim Çizelgeleme için proALPHA Entegrasyon Kılavuzu
Bu Proalpha entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine Proalpha ERP ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, Proalpha ile çift yönlü entegre olur:
- Parçalar, operasyonlarıyla birlikte üretim emirleri, kaynaklar, takvimler, stoklar ve satın alma siparişleri SkyPlanner’a aktarılır.
- Her operasyonun planlanan başlangıç ve bitiş zamanları setWorkOrderOperationDates üzerinden geri gönderilir.
- Kaynak değişiklikleri changeWorkOrderOperationResource üzerinden geri gönderilir.
- Operatör teyitleri operationDataEntry üzerinden geri gönderilir.
- SkyPlanner webhook’ları, çizelge değişikliklerini gerçekleştiği anda iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Proalpha yapılandırmanıza göre ayarlar ve canlıya geçişten sonra da destek sağlar. Bu kılavuz, sürece katılmak veya SkyPlanner’ın dokümante edilmiş REST API’sini (API referansı) kullanarak kendi entegrasyonunu geliştirmek isteyen iş ortakları ve geliştiriciler içindir.
Proalpha arayüzleri
Proalpha ERP, Progress OpenEdge üzerinde çalışır. Release 9 ile platform OpenEdge 12’ye taşınmıştır. (Proalpha) Çizelgeleme açısından dört arayüz önem taşır.
- Proalpha ERP REST API’leri. Herkese açık Proalpha API Portal,
api/web/v1altında 108 OpenAPI 3.0 spesifikasyonu listeler. Verileri geri yazmak, parça ve stok verilerini okumak için bu arayüz kullanılır. - Integration Workbench (INWB). Proalpha, INWB’yi “is a central platform which connects different IT systems, machines, sites” (farklı BT sistemlerini, makineleri ve tesisleri birbirine bağlayan merkezi bir platformdur) ve “converts the data into the format of the target system.” (verileri hedef sistemin biçimine dönüştürür) ifadeleriyle tanımlar. (Proalpha) INWB, pAX mesajlarını
POST /api/web/v1/inwb/messageüzerinden alır. Proalpha’ya giren ve Proalpha’dan çıkan üretim emri akışları için bu arayüzü kullanın. - Proalpha Integration Platform. Nisan 2026’da duyurulan ve n8n altyapısını kullanan platform için “will be available to customers either on-premises or in the cloud.” (müşterilere kendi sunucularında veya bulutta sunulacak) ifadesi kullanılıyor. Proalpha ayrıca “will rely on an API-centric reference architecture and REST interfaces.” (API merkezli bir referans mimarisini ve REST arayüzlerini temel alacak) diyor. (Proalpha)
- EDI ve dosya dışa aktarımları. INWB, sektöre özgü dosya biçimlerini işler. Dosya dışa aktarımları ise SkyPlanner denemesi için yeterlidir.
Üretim uç noktaları
| Proalpha API’si | Uç nokta | Entegrasyondaki kullanımı |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Her operasyonun planlanan başlangıç ve bitiş zamanları (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Çizelgelemede seçilen kaynak (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Teyitler: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | partNumber, partType, quantityUnitCode alanlarını içeren parçalar |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | MRP alanı bazında stok |
Kimlik doğrulama
Yayımlanan Proalpha spesifikasyonlarında HTTP Basic kimlik doğrulaması kullanılır. Uç noktalar ortama özeldir ve Proalpha sunucunuzda veya Proalpha Cloud üzerinde {schema}://{host}:{port}/api/web/v1/... biçimindedir. Yetkileri eşleme tablosundaki nesnelerle sınırlı, özel bir teknik kullanıcı oluşturun. SkyPlanner bulutundan bu uç noktaya ağ erişimini BT ekibinizle birlikte planlayın.
SkyPlanner tarafında REST API, API belirteciyle kimlik doğrular (SkyPlanner Settings > API); dokümantasyonu Swagger/OpenAPI biçimindedir. Başlamak için bir API belirteci yeterlidir. Entegrasyon eğitiminde ilk çağrılar adım adım açıklanır.
Olaylar ve periyodik sorgulama
Proalpha API Portal’da webhook aboneliği için bir API listelenmez. Proalpha’daki değişiklikler dışarıya şu yollarla aktarılır:
- Yeni ve değişen üretim emirlerini operasyonlarıyla birlikte gönderen bir INWB mesaj akışı
- Proalpha Integration Platform üzerinde bir n8n iş akışı
- Stok bilgisi için Material API’nin belirli aralıklarla sorgulanması
SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Böylece Proalpha’ya geri yazma işlemi olaylarla tetiklenir.
Veri eşleme
| Proalpha nesnesi veya API’si | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
| Part (Part API) | Ürünler ve malzemeler | Proalpha → SkyPlanner | İlk yükleme, ardından değişiklik oldukça |
| Ürün süreç modeli: process, activities; üretim emrinin BOM satırları | Ürün yapısı, alt ürünler, süreç adımları | Proalpha → SkyPlanner | İlk yükleme, ardından değişiklik oldukça |
| Miktar ve termin tarihi içeren üretim emri (Fertigungsauftrag) | Termin tarihi ve öncelik içeren sipariş ve işler | Proalpha → SkyPlanner | INWB veya n8n ile gönderim ya da birkaç dakikada bir |
| Üretim emri operasyonları: targetSetupTime, targetProcessTime, resource | Hazırlık ve işlem sürelerini içeren süreç adımları | Proalpha → SkyPlanner | Üretim emriyle birlikte |
| Kaynaklar, kaynak grupları, alternatif kaynak grupları | İş merkezleri, iş merkezi grupları, alternatif iş merkezleri | Proalpha → SkyPlanner | İlk yükleme |
| intensity ve overloadIntensity alanlarını içeren kaynak takvimi blokları | Vardiyalar ve iş merkezi verimlilikleri | Proalpha → SkyPlanner | İlk yükleme; ardından günlük aktarım veya SkyPlanner’da yönetim |
| MRP alanı bazında stok | Malzeme stoku | Proalpha → SkyPlanner | Saatte bir veya her çizelgeleme çalıştırmasından önce |
| Teslim tarihi içeren satın alma siparişleri | Teslim tarihinde gelecek malzeme | Proalpha → SkyPlanner | Saatte bir veya her çizelgeleme çalıştırmasından önce |
| setWorkOrderOperationDates | Her operasyonun çizelgelenen başlangıç ve bitiş zamanları | SkyPlanner → Proalpha | Çizelge değiştiğinde, SkyPlanner webhook’u üzerinden |
| changeWorkOrderOperationResource | Motorun seçtiği iş merkezi | SkyPlanner → Proalpha | Çizelge değiştiğinde |
| operationDataEntry (setup, process, combined) | Mobile Confirmations üzerinden gelen süre kayıtları ve miktarlar | SkyPlanner → Proalpha | Her teyitte veya her vardiyada |
| SkyPlanner çizelgeleme kuralları | Geçiş süresi matrisi, kapasitesi sınırlı kaynak olarak tanımlanan takımlar, operatör sayıları | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon yaklaşımları
1. Ana verilerin ilk yüklemesi. Parçaları Part API üzerinden okuyun; kaynakları, kaynak gruplarını ve takvimleri INWB veya dosya dışa aktarımı yoluyla bir kez yükleyin. Her Proalpha kaynağının hangi SkyPlanner iş merkezine eşleneceğini dikkatle belirleyin. Alternatif kaynak grupları, alternatif iş merkezlerine dönüşür.
2. Emir senkronizasyonu. INWB mesaj akışı veya n8n iş akışı, açık üretim emirlerini operasyonları, hedef süreleri ve kaynaklarıyla birlikte gönderir. Stok bilgileri MRP alanı bazında Material API üzerinden, açık satınalma siparişleri ise INWB üzerinden alınır. SkyPlanner, sipariş edilen malzemeyi satınalma siparişinin teslim tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoku günceller.
3. Çizelgenin geri yazılması. Entegrasyon, motorun yerleştirdiği veya taşıdığı her operasyon için operasyon guid değeri, başlangıç ve bitiş bilgileriyle setWorkOrderOperationDates çağrısı yapar. Motor başka bir kaynak seçtiyse ardından changeWorkOrderOperationResource çağrılır.
4. Üretim sahasından teyitler. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile yapılan işi kaydeder. Süre kayıtları çizelgeyi güncel tutar ve operationDataEntry üzerinden Proalpha’ya aktarılır. Tesisinizde teyitler zaten PDC terminallerinden veriliyorsa mükerrer kayıtları önlemek için tek bir kanal kullanın.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bu kuralları yazılı hale getirin:
| Veri | Sorumlu sistem |
|---|---|
| Parçalar, süreç modelleri, miktarlar, üretim emri durumu | Proalpha |
| Operasyon sırası, başlangıç ve bitiş zamanları, kaynak ataması | SkyPlanner |
| Hazırlık süresi matrisi, takımlar, operatör sayıları | SkyPlanner |
| Vardiyalar ve devamsızlıklar | Kapsam belirleme aşamasında seçilen tek bir sistem |
| Teyitler ve stok kayıtları | SkyPlanner süre kayıtları veya PDC ile beslenen Proalpha |
Proalpha APS veya Feinplanung etkinse operasyon tarihlerinden hangi sistemin sorumlu olacağına karar verin. İki planlama sistemi aynı tarihleri yazarsa birbirlerinin verilerinin üzerine yazar. Autopilot ile SkyPlanner, üretimde değişiklik olduğunda çizelgeyi otomatik olarak yeniden oluşturur.
Tipik proje adımları
Uygulama, genellikle devreye alma süreci başladıktan sonra birkaç hafta içinde tamamlanır. Bunun öncesinde, 30 günlük ücretsiz denemeyi kendi verilerinizle kullanabilirsiniz. Açık üretim emirlerini, operasyonları ve kaynakları Proalpha’dan CSV veya Excel dosyasına aktarın, SkyPlanner’a içe aktarın ve çizelgeyi doğrulayın.
- Eşleme çalıştayı. Proalpha iş ortağınızla birlikte eşleme tablosunu, veri sahipliği kurallarını, senkronizasyon sıklıklarını ve teyit kanalını kesinleştirin.
- Arayüz kurulumu. REST API’leri ve INWB akışlarını etkinleştirin, teknik kullanıcıyı oluşturun ve ağ erişimini açın. Önce test sisteminde, ardından canlı sistemde uygulayın.
- İlk veri yüklemesi. Parçalar, kaynaklar, kaynak grupları ve takvimler.
- Emir, stok ve satınalma siparişi senkronizasyonu. Üretim emirlerini INWB veya n8n üzerinden gönderin, stok bilgilerini periyodik sorgulamayla alın; başarısız aktarımlar için yeniden denemeyi yapılandırın.
- SkyPlanner’da kısıtların tanımlanması. Hazırlık süresi matrisi, takımlar, operatör sayıları ve alternatif iş merkezleri.
- Çizelgenin geri yazılması. setWorkOrderOperationDates ve changeWorkOrderOperationResource kullanılır; operationDataEntry de bu aşamada eklenir.
- Paralel çalışma. SkyPlanner’ın tarihlerini mevcut planla karşılaştırın ve ana verileri düzeltin.
- Canlıya geçiş. Veriler eşleştiğinde geri yazmayı etkinleştirin.
Proalpha entegrasyonunda dikkate alınması gerekenler
- Rota nesnesi yoktur. Proalpha, planlamayı ürün süreç modelleri üzerinden yapar. SAP veya Business Central projelerinden kopyalanan araçlar rota aradığı için bazı verileri atlar. Üretim emrindeki operasyonları ve BOM satırlarını okuyun.
- Takvim yoğunluğu. Takvim bloklarında intensity ve overloadIntensity alanları bulunur. Saatleri olduğu gibi kopyalamak yerine bu alanları SkyPlanner’daki vardiyalar ve verimlilik değerleriyle eşleyin.
- Ölçü birimleri. quantityUnitCode alanını ve hedef hazırlık süresinin emir başına mı, parça başına mı tanımlandığını kontrol edin. Yanlış birimler tüm süreleri hatalı hale getirir.
- Müşterinin barındırdığı uç noktalar. REST katmanı Proalpha sunucunuzda çalışır. Güvenlik duvarları, portlar ve sertifikalar projenin başlangıç tarihini belirler; bu nedenle gerekli erişimleri erkenden hazırlayın.
- Sürüm. Eşlemeyi kesinleştirmeden önce Proalpha sürümünüzün hangi REST API’leri sunduğunu iş ortağınızla doğrulayın.
- Oturum açmayı gerektiren dokümantasyon. Proalpha’nın çevrimiçi yardımına Documentation Portal üzerinden oturum açarak erişilir. Alan adlarını tahmin etmek yerine iş ortağınızla doğrulayın.
Proalpha entegrasyonunu kim yapılandırır, kim destekler?
- SkyPlanner ekibi, entegrasyonu devreye alma sürecinde yapılandırır ve canlıya geçişten sonra destekler. Her Proalpha kurulumunun modeli farklıdır; ekibin uzmanlığı bu farklılıkları ele almak için kullanılır.
- Proalpha iş ortağınız sürece katılabilir. İş ortağınız süreç modellerinizi, INWB akışlarınızı ve sürümünüzü bilir; API erişimini de yapılandırabilir. SkyPlanner, REST API’yi, Swagger/OpenAPI dokümantasyonunu ve webhook’ları sağlar.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için aynı REST API’yi bir API belirteciyle kullanabilirler. SkyPlanner ekibi gerektiğinde yardımcı olur. Ürün dokümantasyonuna SkyPlanner dokümantasyonu sayfasından herkes erişebilir.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlayan fiyatlarla sunulur ve aylık faturalandırılır. Entegrasyon için süreçlerinize ve ihtiyaçlarınıza göre önceden fiyat teklifi verilir. Bu teklif paketinizle birlikte sunulur; böylece başlamadan önce toplam maliyeti görürsünüz. Proalpha’nın kapasiteyi nasıl planladığını proALPHA’da gerçek kapasiteyi dikkate alan üretim çizelgeleme var mı? yazısından öğrenebilirsiniz. Genel bilgi için proALPHA sayfasına, diğer sistemler için ERP entegrasyonları merkezine göz atın.
Üreticilerin SkyPlanner değerlendirmeleri
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 planlamada her hafta 2 saatlik çalışma süresinden tasarruf ediliyor ve yeni iş sırası üretim hattına saniyeler içinde ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, BT Yöneticisi
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan üç aylık optimize edilmiş plan, 30 dakikadan kısa sürede hazırlanıyor.
%99,2teslimat performansı
“SkyPlanner, darboğazları belirlemek için ihtiyaç duyduğumuz görünürlüğü sağladı ve üretim yönetimini netleştirdi.”
Toni Tuori, Üretim Müdürü
Piristeel · Çatı güvenliği ve yağmur suyu sistemleri
Teslimat performansı bu yıl %99,2’ye ulaştı. Çizelgeleme sayesinde günde dört saate varan çalışma süresinden tasarruf ediliyor.
Daha azmalzeme eksikliğinden kaynaklanan duruş
“SkyPlanner’ın bize sağladığı değer, günlük kullanımda, özellikle teslimat tarihlerini belirlerken işe yarayan bir araç olması.”
Tommi Männistö, Üretim Planlama Müdürü
Eskomatic · Fason talaşlı imalat
İş yükünün otomatik çizelgelenmesi, teslimat tarihlerinin daha doğru belirlenmesini sağlıyor. Malzeme eksikliğinden kaynaklanan üretim duruşları da büyük ölçüde azaldı.
Sık sorulan sorular
Entegrasyon hangi Proalpha arayüzlerini kullanır?
Parça ve stok verileri ile tarihlerin, kaynakların ve teyitlerin geri yazılması için Proalpha REST API’leri kullanılır. INWB mesaj akışları veya n8n tabanlı Integration Platform, üretim emirlerini operasyonlarıyla birlikte aktarır. Deneme ve toplu veri yüklemeleri için dosya dışa aktarımları kullanılır.
Planlanan tarihler Proalpha’da nereye yazılır?
Başlangıç ve bitiş zamanları, setWorkOrderOperationDates üzerinden üretim emrinin operasyonuna yazılır. Motor işi başka bir makineye taşıdıysa changeWorkOrderOperationResource kaynağı günceller.
Proalpha webhook’ları destekliyor mu?
Proalpha API Portal’da webhook aboneliği için bir API listelenmiyor. Değişiklikler SkyPlanner’a INWB mesaj akışları, n8n iş akışları veya periyodik sorgulama yoluyla ulaşır. SkyPlanner’ın kendi webhook’ları, geri yazmanın olay bazlı çalışmasını sağlar.
Operatör teyitleri Proalpha’ya aktarılabilir mi?
Evet. SkyPlanner Mobile Confirmations süre kayıtları, miktar, çalışan süresi ve kaynak süresi bilgileriyle birlikte operationDataEntry üzerinden aktarılır. PDC terminalleri de kullanılıyorsa tek bir teyit kanalı kullanın.
Proalpha APS gerekli mi? Zaten kullanıyorsak ne yapmalıyız?
Gerekli değildir. SkyPlanner, üretim emirlerinizi, operasyonlarınızı ve kaynaklarınızı kullanarak gerçek kapasiteyi dikkate alan üretim çizelgesini kendisi oluşturur; Autopilot da bu çizelgeyi güncel tutar. Proalpha APS etkinse kapsam belirleme aşamasında operasyon tarihlerinden hangi sistemin sorumlu olacağına karar verin. SkyPlanner bu durumda yalnızca sorumlu olduğu tarihleri yazar; böylece iki plan birbirinin üzerine asla yazmaz.
Entegrasyonu kurmadan önce SkyPlanner’ı deneyebilir miyiz?
Evet. 30 günlük ücretsiz denemede, üretim emirlerinizi CSV veya Excel dosyasıyla aktararak 20 iş merkezine kadar kullanabilirsiniz; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
