Entegrasyonlar / ERP / ProShop ERP
ProShop ERP Entegrasyon Rehberi SkyPlanner APS ile Üretim Çizelgeleme
Bu ProShop entegrasyon rehberi, yöneticilere, danışmanlara ve BT ekiplerine ProShop ERP ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, ProShop’un kendi API’sini kullanarak ProShop ile çift yönlü entegre olur:
- Work Orders ve bunlara ait operasyonlar, Parts, Work Order BOM kayıtları, Work Cells, Users, Tools, Fixtures ve Purchase Orders SkyPlanner’a aktarılır.
- Planlanan başlangıç ve bitiş tarihleri üretim emirlerine geri yazılır.
- Tercih ederseniz operatörlerin çalışma süreleri ProShop Time Tracking’e geri aktarılabilir.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu ProShop yapılandırmanıza göre ayarlar ve canlıya geçişten sonra da destek verir. Bu rehber, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API’sini (API başvuru kaynağı) kullanarak kendi geliştirmelerini yapmak isteyen iş ortakları ve geliştiriciler içindir.
ProShop’un entegrasyon arayüzleri
ProShop, harici bir çizelgeleme sistemi için ProShop API Developer Documents’ta açıklanan iki yol sunar:
- ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (ProShop, HTTP(S) üzerinden erişilebilen bir GraphQL API sunar.) Tek bir uç nokta vardır: Her çağrı, JSON gövdesinde
query,variablesveoperationNameiçeren bir HTTP POST isteği olarak<proshop root>/api/graphqladresine gönderilir. Her modülde tek bir kayıt için tekil, listeler için çoğul sorgu bulunur. ListelerpageSize(varsayılan 20) vepageStartile sayfalanır;recordsvetotalRecordsdöndürür. Her modülün Advanced Search işlevine karşılık gelenfiltervequeryargümanlarını kabul eder. Şema, introspection ile incelenebilir. (ProShop API’ye giriş) - Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Basit bir REST arayüzü, harici entegrasyonların seçilen iki zaman noktası arasındaki bilgileri istemesine olanak tanır.)
<proshop root>/recentlyupdatedrecordsadresinistart(ISO 8601), isteğe bağlıendvefilterbyile çağırın; örneğinworkorders,workcells,purchaseorders,timetracking,deletions. Önce ProShop ekibinin indeksi etkinleştirmesi gerekir. (Recently Updated Records API)
Yazma işlemleri GraphQL mutations üzerinden yapılır. Belgelerdeki örnek Time Tracking Login’dir; yazma erişimi, yetki kapsamları aracılığıyla modül bazında verilir.
Kimlik doğrulama ve yetki kapsamları
- Her çağrıda erişim belirteci. Belirteci
Authorization: Bearer <token>olarak veyatokensorgu parametresiyle gönderin. - OAuth 2.0 Client Credentials (ProShop 5.2.3 ve sonrası). ProShop sistem yöneticisi System Config > Manage Authorizations bölümünü açar, Name ve Maximum Scope alanlarıyla bir Authorization oluşturur ve Direct Login ile Active seçeneklerini işaretler. Unique ID,
client_id; Shared Secret iseclient_secretolarak kullanılır. Uygulama,<proshop root>/home/member/oauth/accesstokenadresinegrant_type=client_credentialsgönderir veexpires_inbilgisiyle birlikte bir Bearer belirteci alır. Yenileme belirteci yoktur; bu nedenle süresi dolduğunda yeni bir belirteç isteyin. (İstemci kimlik bilgileri akışı) - Time Tracking Login gibi kullanıcı bağlamı gerektiren çağrılar için OAuth 2.0 Authorization Flow kullanılır.
- Yetki kapsamları. Biçim
SCOPE_NAME:[{r|w|d|p}]şeklindedir; harfler sırasıyla okuma, yazma, silme ve tercihleri ifade eder. Bir çizelgeleme sistemi genellikleworkorders:rw parts:r purchaseorders:r users:r tools:rkapsamlarını, süreler geri aktarılacaksa ayrıca Time Tracking erişimini ister. ProShop 5.1.9’dan itibaren “a scope grant request is now required on all connections to the API.” (API’ye yapılan tüm bağlantılarda artık kapsam yetkisi talebi zorunludur.) (Yetkilendirme kapsamları) - Denetim izi. İstemci kimlik bilgileriyle yapılan çağrılarda kullanıcı yerine uygulama adı görünür.
SkyPlanner tarafında REST API, Authorization-Token başlığındaki API belirteciyle kimlik doğrular (SkyPlanner Settings > API); belgeleri Swagger/OpenAPI’de yer alır. Entegrasyon kılavuzu, ilk çağrıları adım adım açıklar.
Olaylar ve periyodik sorgulama
ProShop’un geliştirici belgelerinde dışarıya gönderilen webhook’lar veya GraphQL abonelikleri açıklanmamaktadır. ProShop tarafındaki veriler periyodik sorgularla alınır. Recently Updated Records API bu işlemin yükünü azaltır: Son çalıştırmadan bu yana oluşturulan, değiştirilen veya silinen tüm kayıtları, çizelgenin ihtiyaç duyduğu kayıt türlerine göre filtreleyerek isteyin. Ardından değişen üretim emirlerini GraphQL üzerinden numaralarıyla alın. ProShop, bunun lastModifiedTime ile sorgulamaktan daha hızlı olduğunu belirtir.
Üretim emirleri ve süre takibi için beş dakikada bir, parçalar ve satın alma siparişleri için saatte bir sorgulama yaygın bir tercihtir. SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir; dolayısıyla geri yazma tarafı olay odaklı çalışır.
Veri eşleme
| ProShop nesnesi (API) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Parts, COTS (GraphQL parts kapsamı) | Ürünler ve malzemeler | ProShop → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
| Work Order BOM kayıtları | Ürün yapısı, sipariş bazında malzemeler | ProShop → SkyPlanner | Her üretim emriyle birlikte |
| Üretim emri operasyonları: iş hücresi, tahmini hazırlık ve çevrim süreleri (hedef süreler) | İşlem, hazırlık ve söküm süreleriyle birlikte proses adımları | ProShop → SkyPlanner | Her üretim emriyle birlikte |
| Work Cells (makine, tezgâh, ekipman) | İş merkezleri, iş merkezi grupları, verimlilik oranları | ProShop → SkyPlanner | İlk yüklemede, sonrasında nadiren |
| Kişilere atanmış Work Cells, Users | Personel ve operatör atamaları | ProShop → SkyPlanner | İlk yüklemede, ardından değişiklik oldukça |
| İş hücresi çalışma takvimleri (kullanılabilir saatler, vardiyalar) | Vardiyalar ve çalışılmayan günler | ProShop → SkyPlanner | Günlük veya vardiyalar SkyPlanner’da yönetilir |
| Work Orders (miktar, termin tarihi, durum) | Termin tarihleri ve öncelikleriyle birlikte siparişler ve işler | ProShop → SkyPlanner | Birkaç dakikada bir sorgulama |
| Tools, Toolpots, Fixtures, RTAs | Sınırlı ortak kaynak olarak takımlar | ProShop → SkyPlanner | İlk yüklemede, ardından değişiklik oldukça |
| Termin tarihleriyle birlikte Purchase Orders | Satın alma siparişleri, teslim tarihine göre gelecek malzemeler | ProShop → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
Üretim emrinin planlanan başlangıç ve bitişi (GraphQL mutation, workorders:w) | İş bazında planlanan başlangıç ve bitiş | SkyPlanner → ProShop | Çizelge değiştiğinde, SkyPlanner webhook’u aracılığıyla |
| Time Tracking: üretim emri operasyonu bazında hazırlık ve çalışma süreleri, tamamlanan parçalar | Süre kayıtları ve operatör bildirimleri | SkyPlanner → ProShop | Tercih edilirse her bildirimde veya vardiya bazında |
| ProShop’ta bulunmaz | Hazırlık süresi matrisi, birden fazla operatör gerektiren işler, alternatif makineler ve personel | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon yöntemleri
1. Ana verilerin ilk yüklemesi. GraphQL çoğul sorgularıyla Parts, Work Cells, Users, Tools ve Fixtures kayıtlarını sayfalar halinde alın. İlk yükleme için pageSize değerini yüksek tutun ve totalRecords değerine göre döngüyle ilerleyin. İş hücrelerinin nasıl eşleneceğini belirleyin: Makine iş hücreleri iş merkezlerine, kişi iş hücreleri ise personele dönüşür. Böylece aynı operasyon için hem makine hem de operatör birlikte rezerve edilebilir.
2. Üretim emri senkronizasyonu. Aktif üretim emirlerini operasyonları, hedef süreleri ve BOM kayıtlarıyla birlikte, ayrıca açık satın alma siparişlerini okuyun. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslim tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoğu günceller. Değişiklikler, Recently Updated Records üzerinden filterby=workorders,purchaseorders,deletions ile tespit edilir.
3. Çizelgenin geri yazılması. Çizelgeleme motoru bir işi yerleştirdiğinde veya taşıdığında, SkyPlanner webhook’u üretim emrinin planlanan tarihlerini ayarlayan bir GraphQL mutation tetikler. Bu işlem, workorders:w kapsamına sahip bir Authorization ile yapılır. Böylece ProShop’un zamanında tamamlama tahmini ve satın alma ihtiyaç tarihleri SkyPlanner’ın tarihlerini esas alır.
4. Üretim sahası bildirimleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder; süre kayıtları çizelgeyi güncel tutar. Gerçekleşen sürelerin ilgili üretim emri operasyonu için ProShop Time Tracking’e geri aktarılıp aktarılmayacağını siz seçersiniz. Aktarılmazsa operatörler sürelerini eskisi gibi ProShop’ta kaydeder ve SkyPlanner bunları timetracking üzerinden okur.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hâle getirin:
| Veri | Verinin sahibi |
|---|---|
| Parçalar, operasyonlar, hedef süreler, miktarlar, üretim emri durumu | ProShop |
| Operasyon sırası, başlangıç ve bitiş zamanları, makine ve operatör ataması | SkyPlanner |
| Hazırlık ve geçiş süreleri matrisi, takım ve operatör gereksinimleri, alternatif kaynaklar | SkyPlanner |
| Vardiyalar ve çalışılmayan günler | Kapsam belirleme sırasında seçilen tek bir sistem |
| Time Tracking, stok, satın alma, iş bazında maliyetlendirme | ProShop; veriler doğrudan burada girilir veya SkyPlanner süre kayıtlarından aktarılır |
Üretim emri tarihlerini yazacak tek bir sistem belirleyin. SkyPlanner bir iş hücresini çizelgelemeye başladıktan sonra planlamacılar o iş hücresinin ProShop’taki listesini yeniden sıralamayı bırakır. Böylece iki plan hiçbir zaman birbiriyle çelişmez.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra normalde birkaç hafta içinde tamamlanır. Öncesinde, ProShop’tan CSV veya Excel olarak dışa aktarılan iş hücreleri, operasyonlar ve açık üretim emirleriyle 30 günlük ücretsiz deneme sırasında çizelgeyi doğrulayın.
- Eşleme. Eşleme tablosunu, veri sahipliği kurallarını, senkronizasyon sıklıklarını ve sürelerin geri aktarılıp aktarılmayacağını kesinleştirin.
- ProShop erişimi. Yönetici, üzerinde anlaşılan Maximum Scope ile Authorization oluşturur ve ProShop ekibinden Recently Updated Records’u etkinleştirmesini ister.
- İlk yükleme. Parts, Work Cells, Users, Tools, Fixtures ve iş hücresi çalışma takvimleri yüklenir.
- Üretim emri ve satın alma siparişi senkronizasyonu. Değişiklikler, sayfalama ve yeniden deneme mekanizmalarıyla periyodik olarak sorgulanır.
- SkyPlanner’da kısıtların yapılandırılması. Hazırlık süresi matrisi, takımlar, operasyon başına operatör sayıları ve alternatif makineler veya personel tanımlanır.
- Çizelgenin geri yazılması. SkyPlanner webhook’larıyla tetiklenen mutation işlemleri ve tercih edilirse Time Tracking aktarımı yapılandırılır.
- Paralel test. SkyPlanner’ı mevcut ProShop çizelgesiyle birlikte çalıştırın, tarihleri karşılaştırın ve hedef süreleri düzeltin.
- Canlıya geçiş. Veriler eşleştiğinde geri yazmayı etkinleştirin.
ProShop entegrasyonunda dikkat edilecek noktalar
- Hedef süreler her şeyi belirler. ProShop, süreyi tahmini hazırlık ve çevrim sürelerinden hesaplar. İlk tahmini değil, güncel hedef süreleri alın. Hazırlık süresini işlem süresinden ayırın; böylece tek bir hazırlık değeri yerine hazırlık süresi matrisi kullanılabilir.
- Kişi olarak tanımlanan iş hücreleri. Bir iş hücresi bir kişiyi temsil edebilir. Bunları SkyPlanner’da makinelerle değil, personelle eşleştirin. Aksi halde her operatör paralel çalışan bir makineye dönüşür.
- Time Tracking için kullanıcı gerekir. Nisan 2026’dan bu yana Time Tracking Login mutasyonu “requires user context” (kullanıcı bağlamı gerektirir) koşuluna tabidir ve Client Credentials ile yetkilendirilemez. Operatör sürelerini OAuth 2.0 Authorization Flow üzerinden gönderin veya süre kayıtlarını ProShop’ta tutmaya devam edip oradan okuyun.
- Değişiklik indeksini etkinleştirin. Recently Updated Records, ancak ProShop ekibi etkinleştirdikten sonra çalışır. Bunu ilk hafta talep edin.
- ITAR kayıtları. ProShop, ITAR kısıtlamasına tabi kayıtları bağlantı bazında filtreler. Bu kayıtların null olarak mı döneceği yoksa sonuçlardan mı çıkarılacağı, Developer System Config içindeki bir seçenekle belirlenir. Entegrasyonun hangi üretim emirlerini göreceğini kararlaştırın ve her okuma işleminde null değerlerini ele alın.
- Fason işlemler. Tedarikçilerde yapılan operasyonlar sizin kapasitenizi kullanmaz; yalnızca geçen süre olarak hesaba katılır. Bunları yalnızca süre içeren adımlar olarak modelleyin.
ProShop entegrasyonunu kim yapılandırır ve destekler?
- SkyPlanner ekibi, entegrasyonu kurulum sürecinde yapılandırır ve canlıya geçişten sonra destekler. Bu destek, üzerinde anlaşılan GraphQL sorgularını, mutasyonları ve değişikliklerin periyodik olarak sorgulanmasını kapsar. Her işletme ProShop’ı farklı kullanır; bu kullanım bilgisi de yapılandırmaya yansıtılır.
- ProShop yöneticiniz veya danışmanınız sürece katılır. Authorization kaydını oluşturur, yetki kapsamlarını belirler ve değişiklik indeksini talep eder. İş hücrelerinizin nasıl yapılandırıldığını da bilir.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için bir API token ile SkyPlanner’ın REST API arayüzünü kullanabilirler. Başlamak için bir API token yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Ayrıntılar için SkyPlanner entegrasyon dokümantasyonuna bakın.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Entegrasyon için sürecinize ve ihtiyaçlarınıza göre, abonelik planınızla birlikte önceden fiyat teklifi sunulur. Fiyatlandırmayı, ProShop için gerçek makine ve personel kapasitesine göre üretim çizelgelemesini, ProShop ERP sayfasını, SkyPlanner özelliklerini ve ERP entegrasyonları merkezini inceleyin.
Ü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.
%98teslimat performansı; önceki oran yaklaşık %50
“SkyPlanner, teslimat performansımızı korumamızda belirleyici bir rol oynuyor.”
Hannu Lahtinen, Genel Müdür
KJH-Comp · Sac metal işleme ve fason üretim
Teslimat performansı yaklaşık %50’den %98’e kadar yükseldi. Çizelgeleme için artık iki yerine bir sorumlu yeterli oluyor.
1.000’lerceüretim emri otomatik ç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 üretim emri otomatik olarak çizelgeleniyor ve tüm kuruluş üretimi gerçek zamanlı olarak görebiliyor.
Sık sorulan sorular
ProShop’ın API arayüzü var mı?
Evet. ProShop’ın <proshop root>/api/graphql adresinde bir GraphQL API arayüzü bulunur. OAuth 2.0 veya Basic Authentication ile kimlik doğrulama ve modül bazında yetki kapsamları kullanılır. Recently Updated Records adlı REST uç noktası, belirli bir zaman aralığında oluşturulan, değiştirilen veya silinen kayıtları döndürür.
ProShop webhook desteği sunuyor mu?
ProShop’ın geliştirici dokümantasyonunda dışarıya veri gönderen webhook’lar tanımlanmamıştır. Entegrasyon, Recently Updated Records API arayüzünü her işletme için belirlenen aralıklarla sorgular. SkyPlanner’ın kendi webhook’ları ise çizelgedeki değişiklikleri gerçekleştiği anda iletir.
Planlanan tarihler ProShop’a nasıl geri yazılır?
Üretim emri üzerinde bir GraphQL mutasyonu kullanılarak yazılır. Bunun için workorders üzerinde yazma yetkisi olan bir Authorization gerekir. SkyPlanner, çizelge her değiştiğinde bu işlemi bir webhook üzerinden tetikler.
ProShop API kimlik bilgilerini kim oluşturur?
Bir ProShop sistem yöneticisi, System Config > Manage Authorizations bölümünden oluşturur. Direct Login, Client Credentials akışını etkinleştirir. Maximum Scope ise entegrasyonun hangi verileri okuyup yazabileceğini sınırlar.
Bir ProShop danışmanı, ProShop’ın çizelgelemesini mi yoksa SkyPlanner’ı mı önermeli?
Müşterinin iş sıralaması teslimatı belirliyorsa SkyPlanner’ı önermeli. ProShop çizelgesi, iş hücresi bazında öncelikleri ve zamanında tamamlanma tahminlerini gösterir; planlamacılar da öncelikleri ayarlar. SkyPlanner, GraphQL API üzerinden bağlanır, planın tamamını otomatik olarak optimize eder ve iş değişimlerini, operatörleri, takımları ve malzemeyi planlar. Aylık 199 €’dan başlayan fiyatla sınırsız kullanıcı sunar.
Entegrasyonu geliştirmeden önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, ProShop’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.
