Entegrasyonlar / ERP / SAP Business ByDesign
SkyPlanner APS ile Üretim Çizelgeleme için SAP Business ByDesign Entegrasyon Kılavuzu
Bu SAP Business ByDesign entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine ByDesign ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, SAP’nin kullanıma sunduğu web servisleri üzerinden ByDesign ile çift yönlü entegre olur:
- Serbest bırakılmış üretim emirleri ve operasyonları, Production Models, Bills of Material ve Bills of Operations, ekipman ve iş gücü kaynakları, malzemeler, stoklar ve satınalma siparişleri SkyPlanner’a aktarılır.
- Her üretim emrinin planlanan başlangıcı ve her operasyonun ana kaynağı ByDesign’a geri aktarılır.
- Teyit edilen miktarlar, hurda ve tamamlanan görevler üretim partilerine geri yazılabilir.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde REST API üzerinden ByDesign ortamınızla entegrasyonu 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’si üzerinden kendileri geliştirme yapmak isteyen iş ortakları ve geliştiriciler içindir (API başvuru kaynağı).
SAP ByDesign entegrasyon arayüzleri
ByDesign, kullanıma sunduğu A2X SOAP web servislerini her sürüm için web servisi API listesinde yayımlar. Çizelgeleme entegrasyonunda kullanılan servisler şunlardır:
- Manage Production Orders (ManageProductionOrderIn). READ_PROD_ORDER talep edilen, en erken ve en geç başlangıç ve bitiş zamanlarını, planlanan ve gerçekleşen süreleriyle birlikte kaynakları, önceliği, yürütme durumunu ve çizelgeleme durumunu döndürür. MAINTAIN_BUNDLE_V2, EarliestStartPeriod veya LatestEndPeriod alanını ve operasyonun MainResourceID alanını günceller (SAP yardımı).
- Manage Production Lots (ManageProductionLotsIn). MaintainBundle, üretim görevlerini oluşturur veya günceller: her raporlama noktası için teyit edilen miktar, hurda ve teyidin tamamlandığını belirten gösterge; görevi gerçekleştiren çalışan ve yürütme süresiyle birlikte görev tamamlama bilgisi; kaynak kullanımı (SAP yardımı).
- Sorgu servisleri. Query Production Orders, Query Production Lots, Query Production Model, Query Production Bill of Materials, Query Production Bill of Operations (kaynağa göre sorgulama da yapılabilir), Query Materials, Read Equipment Resources, Query Labour Resource, Query Purchase Orders, Query Identified Stocks ve Determine Availability of Products.
- OData. İş nesneleri için özel OData servislerinin yanı sıra veri kaynakları ve analitik raporlar için de OData sunulur. SAP, hangi iş nesnelerinin erişime açılacağı konusunda “companies are fully empowered to decide which business objects” (hangi iş nesnelerinin erişime açılacağına karar verme yetkisi tamamen şirketlerdedir) ifadesini kullanır (SAP entegrasyon senaryoları).
Okuma işlemleri için Query servislerini veya OData’yı, tüm yazma işlemleri içinse iki Manage servisini kullanın.
Kimlik doğrulama ve lisanslama
ByDesign tarafında SkyPlanner için bir iletişim sistemi, kullandığınız servisler için de iletişim düzenlemeleri oluşturun. Her düzenlemenin kendine ait bir teknik kullanıcısı vardır. SAP güvenlik kılavuzuna göre uygulama entegrasyonunda kimlik doğrulama için “user ID plus password, and the X.509 client certificate” (kullanıcı kimliği ve parola ile istemci sertifikası) kullanılır (Güvenlik Kılavuzu). OData için OAuth 2.0 yapılandırılabilir. Her servisin WSDL dosyasını iletişim düzenlemesinden veya Service Explorer üzerinden indirebilirsiniz.
SkyPlanner tarafında her çağrı, Authorization-Token başlığında bir API belirteci taşır. Belirteci SkyPlanner’da Settings > API bölümünden oluşturabilirsiniz. Geliştirmeye başlamak için bir API belirteci yeterlidir.
Olaylar ve periyodik sorgulama
SkyPlanner, her çizelge değişikliğinde webhook gönderir. Böylece plan değiştikçe güncellemeler ByDesign’a geri yazılır.
ByDesign’daki değişiklikleri almak için Query servislerini düzenli aralıklarla sorgulayın. Serbest bırakılmış üretim emirlerini ve üretim partilerini birkaç dakikada bir; malzemeleri, stokları ve satınalma siparişlerini ise daha uzun aralıklarla okuyun. Sorgu sonuçları QueryHitsMaximumNumberValue ve LastReturnedObjectID ile sayfalanır. SAP, varsayılan sayfa boyutunu web servisleri sayfasında açıklar.
Veri eşleme
| ByDesign nesnesi (arayüz) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
| Malzemeler (Query Materials) | Ürünler ve malzemeler | ByDesign → SkyPlanner | İlk yükleme, ardından periyodik sorgulama |
| Production Bill of Material (Query Production Bill of Materials) | Ürün yapısı, ürün başına malzemeler | ByDesign → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
| Production Bill of Operations: operasyonlar, Setup, Produce ve Tear down aktiviteleri (Query Production Bill of Operations) | Süreleriyle birlikte süreç adımları, hazırlık ve söküm süreleri | ByDesign → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Production Model (Query Production Model) | Tesis bazında ürün rotası | ByDesign → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Ekipman kaynakları ve kaynak grupları (Read Equipment Resources) | İş merkezleri, iş merkezi grupları, takımlar | ByDesign → SkyPlanner | İlk yükleme, sonrasında nadiren |
| İş gücü kaynakları, çalışma süreleri (Query Labour Resource) | Personel ve vardiyalar | ByDesign → SkyPlanner | Günlük veya SkyPlanner’da ayrı vardiya tanımları |
| Serbest bırakılmış üretim emirleri ve operasyonlar (Query Production Orders, READ_PROD_ORDER) | Termin tarihleri ve malzeme ihtiyaçlarıyla birlikte emirler ve işler | ByDesign → SkyPlanner | Birkaç dakikada bir sorgulama |
| Üretim partileri ve görevler (Query Production Lots) | İşin ilerleme durumu | ByDesign → SkyPlanner | Birkaç dakikada bir sorgulama |
| Tanımlı stok, ürün kullanılabilirliği (Query Identified Stocks, Determine Availability of Products) | Stok bakiyeleri | ByDesign → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
| Satınalma siparişleri (Query Purchase Orders) | Satınalma siparişleri, teslimat tarihine göre gelecek malzemeler | ByDesign → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
| EarliestStartPeriod, operasyonun MainResourceID alanı (Manage Production Orders, MAINTAIN_BUNDLE_V2) | Planlanan başlangıç, atanan iş merkezi | SkyPlanner → ByDesign | Çizelge değiştiğinde, SkyPlanner webhook’u üzerinden |
| Teyit edilen miktar, hurda, görev tamamlama (Manage Production Lots, MaintainBundle) | Zaman kayıtları ve operatör teyitleri | SkyPlanner → ByDesign | Tercih edilirse, her teyitte veya vardiyada |
| ByDesign’da bulunmaz | Hazırlık süresi matrisi, birden fazla operatör gereksinimi, alternatif makineler ve personel | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon akışları
1. Ana verilerin ilk yüklemesi. Malzemeleri, Production Models, Bills of Material ve Bills of Operations verilerini, ekipman ve iş gücü kaynaklarını okuyun. Kaynak eşlemesini bilinçli olarak yapın: dört makineli bir kaynak grubu, bir iş merkezi grubuna veya dört iş merkezine dönüşür. Takım niteliğindeki ekipman kaynakları, SkyPlanner’da sınırlı kapasiteye sahip takımlara dönüşür.
2. Üretim emirlerinin senkronizasyonu. Serbest bırakılmış üretim emirlerini operasyonları ve malzemeleriyle birlikte, ayrıca açık satınalma siparişlerini okuyun. SkyPlanner, sipariş edilen malzemeyi satınalma siparişinin teslimat tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoku günceller. Üretim önerileri, üretim emrine dönüşene kadar ByDesign Supply Planning içinde kalır.
3. Çizelgenin geri yazılması. Motor bir emri çizelgeye yerleştirdiğinde veya zamanını değiştirdiğinde, bir SkyPlanner webhook’u Manage Production Orders üzerindeki MAINTAIN_BUNDLE_V2 işlemini tetikler. Bu işlem, EarliestStartPeriod alanını ve SkyPlanner’ın seçtiği operasyonun MainResourceID alanını ayarlar.
4. Üretim sahası teyitleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder; zaman kayıtları da çizelgeyi güncel tutar. Gerçekleşen verilerin geri yazılıp yazılmayacağını siz seçersiniz. Geri yazma seçilirse, Manage Production Lots üzerindeki MaintainBundle; teyit edilen miktarı, hurdayı ve tamamlanan görevi, görevi gerçekleştiren çalışan bilgisiyle birlikte kaydeder. Seçilmezse teyitler eskisi gibi ByDesign’a girilir.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:
| Veri | Sorumlu sistem |
|---|---|
| Malzemeler, Production Models, miktarlar, emir ve parti durumları | ByDesign |
| Operasyon sırası, başlangıç ve bitiş zamanları, kaynak ataması | SkyPlanner |
| İşler arası geçiş 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 |
| Teyitler, mal hareketleri, maliyet hesaplama | ByDesign; veriler doğrudan girilir veya SkyPlanner zaman kayıtlarından aktarılır |
Emir tarihlerini yazacak tek bir sistem seçin. SkyPlanner’ın çizelgelediği kaynaklarda Load Leveling çalıştırmayın. Planlamayı çalıştırdığınızda, yönetimi SkyPlanner’a ait olan serbest bırakılmış emirlerin zamanının değişmediğini kontrol edin.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra normalde birkaç hafta içinde tamamlanır. Öncesinde, ByDesign’dan CSV veya Excel olarak dışa aktardığınız kaynaklar, Bills of Operations ve açık üretim emirleriyle 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 teyitlerin geri yazılıp yazılmayacağını kesinleştirin.
- ByDesign erişimi. İletişim sistemini ve iletişim düzenlemelerini oluşturun, WSDL dosyalarını indirin. Önce ByDesign test ortamınızda test edin.
- İlk yükleme. Malzemeler, Production Models, Bills of Material ve Bills of Operations, kaynaklar, çalışma süreleri.
- Üretim emirleri ve satınalma siparişlerinin senkronizasyonu. Sayfalama, filtreler ve yeniden denemelerle periyodik sorgulama.
- SkyPlanner’da kısıtların tanımlanması. Hazırlık ve geçiş süreleri matrisi, takımlar, iş başına operatör sayıları ve alternatif makineler veya personel.
- Çizelgenin geri yazılması. SkyPlanner webhook’larından MAINTAIN_BUNDLE_V2 çağrıları ve tercih edilirse parti teyitleri.
- 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 birbiriyle eşleştiğinde geri yazmayı etkinleştirin.
SAP ByDesign entegrasyonunda nelere dikkat edilmeli?
- Her çağrıda tek tarih. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (EarliestStartPeriod ve LatestEndPeriod birlikte güncellenemez.) Geri yazmada başlangıç tarihini esas alın.
- Kilitleme yok. A2X servisleri durum bilgisi tutmaz. Bu nedenle SAP, işlemsel veya mantıksal kilitlemenin uygulanamayacağını belirtir. Her yazma işleminden önce üretim emrini yeniden okuyun ve çakışmaları yönetin.
- Tamamlandı bilgisi geri alınamaz. “Confirmation Finished Indicator cannot be unchecked once it is set.” (Confirmation Finished Indicator işaretlendikten sonra işareti kaldırılamaz.) Tamamlandı bilgisini yalnızca operatör görevi kapattığında gönderin.
- Ana ve ek kaynaklar. ByDesign, çizelgelemede ana kaynakları dikkate alır. Çizelgeleme sırasında ek kaynaklardaki operatör ve takımların da kontrol edilmesi için bunları SkyPlanner’da kapasitesi sınırlı kaynaklar olarak modelleyin.
- Hazırlık ve söküm. Bills of Operations, hazırlık ve sökümü aktivite olarak içerir. Sıralamaya bağlı tip değişimi sürelerini hazırlık süresi matrisine aktarın.
SAP ByDesign 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 hizmet, üzerinde anlaşılan web servislerini ve OData sorgularını kapsar. Her şirket ByDesign’ı farklı kullanır; bu kullanıma ilişkin bilgi birikimi entegrasyonun yapılandırılmasında kullanılır.
- SAP ByDesign iş ortağınız da sürece katılabilir. İş ortağınız, size ayrılan ortamı, kapsam belirleme çalışmalarını ve genişletmeleri bilir; SkyPlanner ekibiyle birlikte iletişim düzenlemelerini yapılandırabilir.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için SkyPlanner’ın REST API arayüzünü,
Authorization-Tokenbaşlığında bir API belirteciyle kullanabilirler. SkyPlanner ekibi gerektiğinde yardımcı olur. Entegrasyon belgelerine SkyPlanner entegrasyon belgeleri sayfasından ulaşabilirsiniz.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlayan fiyatlarla sunulur 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 verilir. Fiyatlandırma, SAP ByDesign ile üretim çizelgeleme, SAP Business ByDesign sayfası ve ERP entegrasyonları sayfalarını inceleyin. Diğer SAP sistemleri için ayrı kılavuzlar bulunur: SAP Business One ve SAP S/4HANA.
Üreticilerin SkyPlanner yorumları
2 saathaftalık zaman tasarrufu
“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üresinden tasarruf ediliyor ve yeni iş sırası saniyeler içinde üretim hattına ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, Bilgi Teknolojileri Müdürü
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan üç aylık optimize edilmiş bir planı hazırlamak 30 dakikadan az sürüyor.
%1002021’den beri teslimat performansı
“SkyPlanner, kapasitemizi görünür kı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.
Daha azmalzeme eksikliğinden kaynaklanan duruş
“SkyPlanner’ın bize sağladığı değer, günlük kullanımda, özellikle teslimat tarihlerini belirlerken 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 olarak çizelgelenmesi sayesinde teslimat tarihleri daha doğru belirleniyor. Malzeme eksikliğinden kaynaklanan üretim duruşları da önemli ölçüde azaldı.
Sık sorulan sorular
SkyPlanner hangi SAP ByDesign API’lerini kullanır?
SAP’nin yayımladığı A2X web servislerini kullanır. Okuma işlemlerinde Query Production Orders ve Query Purchase Orders gibi Query servisleri veya özel OData kullanılır. Yazma işlemlerinde ise Manage Production Orders ve Manage Production Lots kullanılır.
SkyPlanner, ByDesign’a hangi verileri geri yazar?
Her üretim emrinde EarliestStartPeriod ve operasyonun MainResourceID alanlarını geri yazar. Tercihinize bağlı olarak teyit edilen miktarlar, fire ve tamamlanan görevler de üretim partisine kaydedilir.
ByDesign, SkyPlanner’a olay bildirimleri gönderir mi?
SkyPlanner, üretim emirleri ve partileri almak için ByDesign Query servislerini birkaç dakikada bir sorgular. SkyPlanner ise çizelgedeki her değişiklikte geri yazmayı tetikleyen webhook bildirimleri gönderir.
SkyPlanner, ByDesign’da kimlik doğrulamasını nasıl yapar?
SAP’nin güvenlik kılavuzunda açıklandığı gibi, teknik kullanıcı içeren bir iletişim sistemi ve iletişim düzenlemesi aracılığıyla kimliğini doğrular. SkyPlanner’ın kendi API’si ise Authorization-Token başlığında bir API belirteci kullanır.
Üretim önerileri SkyPlanner’a aktarılır mı?
SkyPlanner, serbest bırakılmış üretim emirlerini çizelgeler. Öneriler, üretim emrine dönüşene kadar ByDesign Supply Planning içinde kalır.
Entegrasyonu kim kurar?
SkyPlanner ekibi, entegrasyonu kurulum sürecinde yapılandırır ve canlıya geçişten sonra destekler. SAP ByDesign iş ortağınız veya kendi geliştiricileriniz de SkyPlanner’ın REST API arayüzünü bir API belirteciyle kullanarak entegrasyonu geliştirebilir.
