Entegrasyonlar / ERP / Senior ERP
Senior ERP Entegrasyon Rehberi: SkyPlanner APS ile Üretim Çizelgeleme
Bu rehber, iş ortaklarına ve BT ekiplerine Senior Sistemas’ın Senior ERP çözümünü (Senior X ile Gestão Empresarial | ERP XT) SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, Senior’ın kendi arayüzlerini kullanarak Senior ERP ile çift yönlü entegre olur:
- Üretim emirleri (OP), aşamalarıyla birlikte SkyPlanner’a aktarılır. Rotalar (roteiros), kaynaklar ve kaynak merkezleri, SKU’lar, ürün yapıları, stok ve satın alma siparişleri de aktarılır.
- Her OP aşamasının planlanan başlangıcı ve bitişi ile o aşama için seçilen kaynak, OP’ye geri yazılır.
- Tercih ederseniz operatörlerin zaman kayıtları, apontamentos de produção olarak geri yazılır.
- Senior X Events Hub, bir OP aşamasının durumu değiştiğinde SkyPlanner’a bildirir. SkyPlanner webhook’ları da çizelge değişikliklerini gerçekleştiği anda iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Senior ERP kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destek sağlar. Bu rehber, sürece katılmak veya SkyPlanner’ın dokümante edilmiş REST API’siyle (API referansı) kendi çözümlerini geliştirmek isteyen iş ortakları ve geliştiriciler içindir.
Senior ERP’nin entegrasyon arayüzleri
ERP XT hibrit bir sistemdir. Senior dokümantasyonu, Gestão Empresarial XT için “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions” (bulut çözümleriyle entegre, şirket içinde çalışan yerel bir hibrit sisteme dönüşür) ifadesini kullanır (Senior dokümantasyonu, çeviri). Bir çizelgeleme sistemi, Senior’ın üç arayüzünü kullanır:
- G5 web servisleri (SOAP). Senior sunucunuzda çalışan bu servisler modüle göre adlandırılır (com.senior.g5.co.<module>…). Her biri üç WSDL sürümüyle yayımlanır: sapiens_Sync, sapiens_Async ve sapiens_Scheduled. Üretim servisleri arasında com.senior.g5.co.mpr.pcp.ordemproducao bulunur. Senior dokümantasyonu bu servisi “calls the same production order generation routine” (aynı üretim emri oluşturma yordamını çağırır) ifadesiyle açıklar; burada ERP ekranının çağırdığı yordam kastedilir (Senior dokümantasyonu, çeviri). Ürün servisleri (com.senior.g5.co.ger.cad.produto) ve üretim bildirimi servisleri de bulunur.
- Senior X Platform REST API’leri. api.senior.com.br adresinde sunulur. Senior’ın Senior X üzerinden erişime açtığı ürünler ve satış siparişleri gibi ERP alanlarını kapsar (Senior dokümantasyonu).
- Events Hub webhook’ları. Senior X içinde Tecnologia > Customização > Events Hub > Webhooks yolundan oluşturulur. Üretim modülü, bir OP aşamasının durumu değiştiğinde erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus olayını yayımlar (Senior dokümantasyonu).
Kimlik doğrulama ve erişim
- Senior X Platform. Entegrasyon, platform.senior.com.br üzerindeki /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login adresine POST isteği göndererek oturum açar. Kullanıcı, user@tenant biçiminde belirtilir. Yanıt bir Bearer erişim belirteci ve bir yenileme belirteci içerir. Uygulama anahtarlarıyla loginWithKey (access key, secret, tenant) üzerinden oturum açılabilir. REST çağrıları, authorization başlığını ve bağlanan uygulamayı tanımlayan client_id başlığını taşır. Bu uygulama Senior API portalında kayıtlıdır ve ERP’deki bir rolle ilişkilendirilmiştir.
- G5 web servisleri. Çağrılar kullanıcı, parola ve şifreleme parametrelerini taşır. Senior X belirteci kullanıldığında parola yerine bu belirteç gönderilir (Senior dokümantasyonu).
- Yetkiler. Entegrasyon için ayrı bir Senior kullanıcısı oluşturun. Bu kullanıcıya, entegrasyonun okuyup yazacağı PCP, mühendislik, stok ve satın alma verilerine erişim yetkisi verin.
SkyPlanner tarafında REST API, Authorization-Token başlığında gönderilen bir API belirteciyle kimlik doğrular (SkyPlanner Settings > API). API dokümantasyonu Swagger/OpenAPI biçimindedir. Entegrasyon eğitiminde ilk çağrılar adım adım anlatılır.
Olaylar ve periyodik sorgulama
Events Hub, üretim sahasındaki değişiklikleri kapsar: bir OP aşamasının durumu değiştiğinde webhook SkyPlanner’a ulaşır ve çizelge güncellenir. Diğer veriler periyodik olarak sorgulanır. Kesinleşmiş ve serbest bırakılmış OP’ler ile son değişikliklere göre filtrelenen sorgular, yeni işleri alır. Sorgulama sıklığı tesise göre belirlenir; OP’ler için birkaç dakikada bir, stok için saatte bir olabilir.
Durum veya çizelge değiştiğinde SkyPlanner webhook gönderir; dolayısıyla geri yazma işlemleri olay tabanlıdır.
Veri eşleme
| Senior ERP nesnesi (arayüz) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
| SKU: produto ve derivação, ölçü birimleri (G5 web servisleri veya Senior X varlıkları) | Ürünler ve malzemeler | Senior → SkyPlanner | İlk yükleme, ardından periyodik sorgulama |
| Ürün yapısı (engenharia do SKU) | Ürün yapısı, alt ürünler, ürün başına malzemeler | Senior → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Aşamalarıyla (estágios) Roteiro: sıralama, önceki aşamaya bağımlılık | Sıralı işlem adımları | Senior → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | İş merkezleri, süreler, hazırlık ve söküm süreleri, verimlilikler | Senior → SkyPlanner | İlk yükleme, sonrasında nadiren |
| Centro de recurso | İş merkezi grupları | Senior → SkyPlanner | İlk yükleme, sonrasında nadiren |
| Calendário: Feriados, vardiya bazında üretim takvimi | Vardiyalar ve çalışılmayan günler | Senior → SkyPlanner | Günlük aktarım veya SkyPlanner’da ayrı vardiya tanımları |
| Aşamaları ve malzemeleriyle Ordens de produção (Firme, Liberada) | Terminleri ve malzeme ihtiyaçlarıyla birlikte emirler ve işler | Senior → SkyPlanner | Birkaç dakikada bir sorgulama |
| OP aşamasının durumu (Events Hub orderProductionStageChangeStatus) | İşin ilerleme durumu | Senior → SkyPlanner | Webhook üzerinden gerçek zamanlı |
| SKU bazında Estoque | Stok bakiyeleri | Senior → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
| Teslimat tarihleriyle Ordens de compra | Satın alma siparişleri, teslimat tarihine göre gelecek malzemeler | Senior → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
| OP aşaması: planlanan başlangıç ve bitiş, kaynak | İş bazında planlanan başlangıç ve bitiş, atanan iş merkezi | SkyPlanner → Senior | Çizelge değiştiğinde SkyPlanner webhook’u üzerinden |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, başlangıç ve bitiş tarihi ile saati | Zaman kayıtları ve operatör teyitleri | SkyPlanner → Senior | Tercih edilirse her teyitte veya her vardiyada |
| Senior ERP’de bulunmaz | Hazırlık süresi matrisi, sınırlı kapasiteli kaynak olarak takımlar, 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 modelleri
1. Ana verilerin ilk yüklemesi. SKU’ları, yapıları, roteiros, recursos, centros de recurso ve üretim takvimini okuyun. Kaynak merkezlerini nasıl eşleştireceğinize dikkatle karar verin: dört makine içeren bir centro de recurso, bir iş merkezi grubuna veya dört iş merkezine dönüşür. Fator de carga değerini ya SkyPlanner iş merkezi verimliliğine ya da vardiyalara dönüştürün; ikisine birden uygulamayın.
2. OP senkronizasyonu. Firme ve Liberada durumundaki OP’leri aşamaları ve malzemeleriyle birlikte, ayrıca açık satın alma siparişlerini okuyun. Planejada durumundaki OP’ler MRP tarafından hâlâ değiştirilebilir veya silinebilir. Bu nedenle bunları yalnızca ileriyi görmek istiyorsanız çizelgeleyin. 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.
3. Çizelgenin geri yazılması. Çizelgeleme motoru bir aşamayı yerleştirdiğinde veya taşıdığında, bir SkyPlanner webhook’u geri yazmayı tetikler. Her OP aşamasının planlanan başlangıcı ve bitişi ile seçilen kaynak yazılır. Bunlar, planlamacının Programação de produção içinde düzenlediği alanlarla aynıdır. SkyPlanner ekibi, kapsam belirleme sürecinde sizinle ve Senior iş ortağınızla kullanılacak web servisini netleştirir.
4. Üretim sahası teyitleri. Operatörler çalışmalarını SkyPlanner Mobile Confirmations veya Production Timer ile kaydeder; zaman kayıtları da çizelgeyi güncel tutar. Gerçekleşen sürelerin Senior’a geri yazılıp yazılmayacağına siz karar verirsiniz. Geri yazma seçilirse her teyit, OP aşamasında üretilen miktarı, hurdayı, başlangıç ve bitiş saatlerini içeren bir apontamento de produção kaydına dönüşür. Senior, üretim bildirimlerini yalnızca Liberada veya Andamento durumundaki OP’ler için kabul eder. Bildirimleri Fábrica ao Vivo üzerinden yapıyorsanız SkyPlanner ilerlemeyi bunun yerine Events Hub üzerinden okur.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:
| Veri | Yetkili sistem |
|---|---|
| SKU’lar, yapılar, roteiros, OP miktarları ve durumu | Senior ERP |
| Aşama sıralaması, başlangıç ve bitiş saatleri, kaynak ataması | SkyPlanner |
| Hazırlık süresi matrisi, takım ve operatör gereksinimleri, alternatif kaynaklar | SkyPlanner |
| Üretim takvimi ve vardiyalar | Kapsam belirleme sürecinde seçilen tek bir sistem |
| Apontamentos, stok hareketleri, maliyet hesaplama | Senior ERP; doğrudan girilir veya SkyPlanner zaman kayıtlarından aktarılır |
Aşama tarihlerini yazacak tek bir sistem seçin. Planlamacılar aynı OP’leri Programação de produção veya Gantt grafiğinde sıralamaya devam ediyorsa hangi OP’lerin SkyPlanner tarafından yönetileceğini kararlaştırın.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra normalde birkaç hafta içinde tamamlanır. Öncesinde, Senior’dan CSV veya Excel olarak dışa aktarılan kaynaklar, roteiros ve açık OP’lerle 30 günlük ücretsiz deneme süresinde çizelgeyi doğrulayın.
- Eşleme. Eşleme tablosunu, veri sahipliği kurallarını, senkronizasyon sıklıklarını ve apontamentos kayıtlarının geri yazılıp yazılmayacağını kesinleştirin.
- Senior erişimi. Entegrasyon kullanıcısını oluşturun, uygulamayı Senior API portalına kaydedin, G5 web servislerini ve Events Hub webhook’unu etkinleştirin. Önce bir kabul testi veritabanında test edin.
- İlk yükleme. SKU’lar, yapılar, roteiros, recursos, centros de recurso, takvim.
- OP ve satın alma siparişi senkronizasyonu. Filtreler ve yeniden denemelerle periyodik sorgulama; ayrıca aşama durumu webhook’u.
- SkyPlanner’da kısıtların tanımlanması. Hazırlık süresi matrisi, takımlar, iş başına operatör sayıları ve alternatif makineler veya personel.
- Çizelgenin geri yazılması. SkyPlanner webhook’larından aşama tarihleri ve kaynaklar; tercih edilirse apontamentos kayıtları.
- 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 eşleştiğinde geri yazmayı etkinleştirin.
Senior ERP entegrasyonunda nelere hazırlıklı olmalısınız?
- Kaynak başına dört süre. Recurso; işlem, hazırlık, yükleme ve boşaltma ile transfer sürelerini içerir. Yükleme ve transfer süreleri makine süresi değil, elleçleme süresi olabilir. Her sürenin nasıl eşleneceğine kaynak bazında karar verin; aksi hâlde tüm süreler yanlış olur.
- Kaynak başına tek hazırlık süresi. Senior’daki Tempo setup tek bir değerdir. Devreye alma sürecinde SkyPlanner’daki hazırlık süresi matrisini gerçek iş değişimlerinize göre oluşturun.
- Varyantlar. Senior’da bir SKU, ürün ve derivação birleşiminden oluşur. Rotalar (roteiros) varyanta göre farklılık gösterebilir. Varyant kodunu SkyPlanner ürün anahtarlarına dahil edin.
- OP durumları. Yalnızca Liberada ve Andamento durumundaki OP’ler üretim bildirimlerini kabul eder. Durum değişikliklerini Senior’da yönetin ve SkyPlanner’ın bunları Events Hub üzerinden takip etmesini sağlayın.
- Hibrit kurulum. G5 web servisleri Senior sunucunuzda, Events Hub ise Senior X üzerinde çalışır. Her ikisi için de ağ erişimini planlayın.
- Sayı biçimi. Senior web servisleri binlik ayırıcı içeren sayıları kabul etmez ve ondalık ayırıcı olarak virgül gerektirir. Sayıları bu biçimde gönderin.
Senior ERP 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 destek, üzerinde anlaşılan web servislerini, Senior X API’lerini ve Events Hub webhook’larını kapsar. Her tesis Senior ERP’yi farklı kullanır; ekibin bu konudaki deneyimi burada devreye girer.
- Senior iş ortağınız da sürece katılabilir. İş ortağınız mevcut kurulumunuzu, özelleştirmelerinizi ve lisanslarınızı bilir. SkyPlanner ekibiyle birlikte entegrasyon kullanıcısını oluşturabilir, API portal kaydını yapabilir ve web servislerini yapılandırabilir.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için bir API token ile SkyPlanner’ın REST API’sini kullanabilirler. Başlamak için bir API token 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 için sürecinize ve ihtiyaçlarınıza göre hazırlanan teklif, planınızla birlikte önceden sunulur. Fiyatlandırmayı, Senior ERP ile üretim çizelgeleme sayfasını, Senior ERP sayfasını ve ERP entegrasyonları merkezini inceleyin.
Üreticilerin SkyPlanner yorumları
2 hher hafta kazanılan süre
“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 saat tasarruf sağlanıyor ve yeni iş sırası saniyeler içinde üretim hattına 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ş bir plan, 30 dakikadan kısa sürede hazırlanıyor.
1.000’lerceiş emri otomatik olarak çizelgeleniyor
“Üretimi artık farklı bir şekilde kontrol altında tutuyoruz ve kapasitemize ilişkin anlayışımız bambaşka bir düzeye 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 izleyebiliyor.
Daha azmalzeme eksikliğinden kaynaklanan duruş
“SkyPlanner’ın bize sağladığı değer, özellikle teslimat tarihlerini belirlerken günlük kullanımda işimizi gören 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 önemli ölçüde azaldı.
Sık sorulan sorular
Senior ERP’de üretim emirleri için bir API var mı?
Evet. G5 web servisi com.senior.g5.co.mpr.pcp.ordemproducao, ERP ekranındakiyle aynı yordamı kullanarak OP’ler oluşturur. Diğer G5 servisleri ise ürünleri ve üretim bildirimlerini kapsar. Senior X Platform ayrıca Bearer token ile oturum açılan REST API’leri ve Events Hub webhook’ları sunar.
Senior ERP webhook’ları destekliyor mu?
Evet. Senior X Events Hub, bir OP aşamasının durumu değiştiğinde orderProductionStageChangeStatus dahil olmak üzere webhook’lar gönderir. SkyPlanner, üretim sahasındaki ilerlemeyi gerçek zamanlı izlemek için bunları kullanır. Kendi webhook’ları da çizelge değişikliklerini geri iletir.
Planlanan tarihler Senior ERP’ye nasıl geri yazılır?
SkyPlanner, her OP aşamasının planlanan başlangıcını, bitişini ve bu aşama için seçilen kaynağı belirler. Bunlar, planlamacının Programação de produção ekranında düzenlediği alanlarla aynıdır. Çizelge her değiştiğinde bir SkyPlanner webhook’u geri yazma işlemini tetikler. Bu işlem, SkyPlanner ekibinin devreye alma sürecindeki kapsam belirleme çalışmasında Senior kurulumunuz için belirlediği yol üzerinden yürütülür.
Entegrasyon Senior X ve ERP XT ile çalışır mı?
Evet. ERP XT sunucunuzda çalışır ve Senior X üzerindeki bulut servislerini kullanır. Entegrasyon, sunucudaki G5 web servisleri ile buluttaki Senior X API’lerini ve Events Hub’ı kullanır.
Entegrasyonu kurmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz denemede, Senior’dan CSV veya Excel ile veri aktararak 20 iş merkezine kadar çalışabilirsiniz. Kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
