Entegrasyonlar / ERP / JobBOSS²
SkyPlanner APS ile Üretim Çizelgeleme için JobBOSS² Entegrasyon Kılavuzu
Bu JobBOSS² entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine ECI’nin JobBOSS² ürününü SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, ECI’nin kendi API’lerini kullanarak JobBOSS² ile çift yönlü entegrasyon sağlar:
- Orders ve Order Line Items, Order Routings, Estimates, Routings ve malzemeler, Work Centers, Employees, Company Calendar, Job Requirements ve satın alma siparişi satırları SkyPlanner’a aktarılır.
- Planlanan başlangıç ve bitiş tarihleri her Order Routing adımına geri yazılır.
- İsterseniz operatörlerin süre kayıtları Time Ticket Details olarak geri aktarılabilir.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu JobBOSS² 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 referansı) kullanarak kendi çözümlerini geliştirmek isteyen iş ortakları ve geliştiriciler içindir. ABD’de sipariş üzerine üretim yapan bir atölye tam da bunu yaptı:
JobBOSS² entegrasyon arayüzleri
ECI, üretim API’lerini OpenAPI tanımlarıyla birlikte ECI üretim API’leri dokümantasyonu sitesinde yayımlar. Bunlardan ikisi çizelgeleme için önemlidir:
- JobBOSS² API (v1). JobBOSS²’ye özel olarak REST ve JSON kullanır. Siparişler, Order Line Items, Order Routings, Estimates, Routings, malzemeler, Job Requirements, Work Centers, Company Calendar, Employees, satın alma siparişleri, Time Tickets ve Time Ticket Details için okuma ve yazma işlemleri yapar. ECI’nin açıklaması şöyledir: “is currently only supported for JobBOSS² hosted (Cloud) customers.” (Şu anda yalnızca barındırılan JobBOSS² hizmetini kullanan bulut müşterileri için desteklenmektedir.)
- ECI ERP API (v2.1). Deacom, M1 ve JobBOSS² için üründen bağımsız bir REST API’dir. JobBOSS² için işleri, iş operasyonlarını, iş malzemelerini, parçaları, parça operasyonlarını, iş merkezlerini, satın alma siparişi satırlarını ve çalışma süresi satırlarını kapsar. ECI, “the actual ERP database could be a cloud hosted ERP or on premises install,” (ERP veritabanı bulutta barındırılabilir veya şirket içinde kurulu olabilir) açıklamasını yapar. Bu nedenle şirket içinde kurulu JobBOSS² için bu API kullanılır.
Her iki API de aynı kuralları kullanır: lastModDate[gte]= gibi filtre ifadeleri, fields= parametresi, sort= ve take ile skip üzerinden sayfalama. take için varsayılan değer 200’dür. “All dates submitted to the API are assumed to be in UTC.” (API’ye gönderilen tüm tarihlerin UTC olduğu varsayılır.)
ECI’nin her ikisi için de kuralı aynıdır: “All APIs must be activated by ECI before use.” (Tüm API’lerin kullanımdan önce ECI tarafından etkinleştirilmesi gerekir.) ECI müşteri temsilcinize erkenden başvurun.
Kimlik doğrulama ve erişim
- API kullanıcıları. Entegrasyon, ECI’nin Integration Engine Management Console arayüzünde oluşturulan bir API kullanıcısını kullanır. Çağrıların hangi ürüne, müşteriye ve veritabanına ulaşacağını API kullanıcısı belirler.
- OAuth 2.0 istemci kimlik bilgileri. İstemci kimliği ve gizli anahtarı kullanılarak Authentication API token uç noktasından bir token alınır. Ardından her çağrıda
Authorization: Bearer [token]gönderilir. - Yetki kapsamı. API kullanıcısına yalnızca aşağıdaki eşleme tablosunun gerektirdiği kaynaklara erişim yetkisi verin.
SkyPlanner tarafında REST API, API token ile kimlik doğrular (SkyPlanner Settings > API). Dokümantasyonu Swagger/OpenAPI biçimindedir. Entegrasyon eğitimi, ilk çağrıları adım adım açıklar.
Olaylar ve periyodik sorgulama
ECI’nin iki API’sinin dokümantasyonunda da webhook yer almaz. JobBOSS² tarafı periyodik olarak sorgulanır: son çalıştırmadan bu yana değişen Order Line Items, Order Routings ve satın alma siparişi satırlarını almak için lastModDate ile filtreleme yapın; take ve skip ile sayfalama kullanın. Sorgulama sıklığı işletmeye göre belirlenir; işler için birkaç dakikada bir, stok için saatte bir olabilir.
SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Bu nedenle geri yazma işlemleri olay güdümlüdür.
Veri eşleme
| JobBOSS² nesnesi (JobBOSS² API kaynağı) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Estimates (/estimates), malzemeler (/materials) | Ürünler, malzemeler, ürün yapısı | JobBOSS² → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
Routings (/routings): iş merkezi, hazırlık süresi, çevrim süresi, ekip büyüklüğü, iş için kullanılacak makineler | Süreleri ve hazırlık süreleriyle birlikte işlem adımları | JobBOSS² → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
Work Centers (/work-centers): vardiya başına çalışma saati, 1 ile 3 arasındaki vardiyalarda çalışma durumu, çalışma günleri | İş merkezleri, iş merkezi grupları, verimlilik oranları | JobBOSS² → SkyPlanner | İlk yüklemede, sonrasında nadiren |
Company Calendar (/company-calendars), Employees (/employees) | Vardiyalar, çalışılmayan günler, personel | JobBOSS² → SkyPlanner | Günlük aktarım veya vardiyaların SkyPlanner’da yönetilmesi |
Orders ve Order Line Items (/order-line-items): iş numarası, teslim tarihi, öncelik, üretilecek miktar | Teslim tarihleri ve öncelikleriyle birlikte siparişler | JobBOSS² → SkyPlanner | Birkaç dakikada bir sorgulama |
Order Routings (/order-routings): iş adımları, durum, kalan saat | Her işlem adımı için işler | JobBOSS² → SkyPlanner | Birkaç dakikada bir sorgulama |
Job Requirements (/job-requirements), satın alma siparişi satırları (/purchase-order-line-items) | Malzeme ihtiyaçları, teslim tarihine göre satın alma siparişleri | JobBOSS² → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Her adım için planlanan başlangıç ve bitiş, makine ve operatör | SkyPlanner → JobBOSS² | Çizelge değiştiğinde SkyPlanner webhook’u aracılığıyla |
| Time Ticket Details (POST): iş, adım, iş merkezi, çalışan, hazırlık süresi, çevrim süresi, tamamlanan ve hurdaya ayrılan parça sayıları, başlangıç ve bitiş zamanı | Süre kayıtları ve operatör bildirimleri | SkyPlanner → JobBOSS² | Tercih edilirse her bildirimde veya vardiyada |
| JobBOSS²’de yok | Hazırlık ve geçiş süreleri matrisi, sınırlı kaynak olarak takımlar, alternatif makineler ve personel | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Şirket içinde kurulu JobBOSS² için aynı nesneler ERP API kaynakları olan /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers ve /purchase-order-lines üzerinden okunur. Süre kayıtları ise /timecard-lines kaynağına gönderilir.
Entegrasyon yöntemleri
1. Ana verilerin ilk yüklemesi. Estimates, Routings, malzemeler, Work Centers, Company Calendar ve Employees verilerini okuyun. İş merkezlerini nasıl eşleyeceğinizi dikkatle belirleyin: dört torna tezgâhı bulunan bir iş merkezi, bir iş merkezi grubuna veya dört iş merkezine dönüşür. Böylece SkyPlanner her makinedeki işleri sıralar.
2. İşlerin senkronizasyonu. Açık Order Line Items kayıtlarını, bunlara ait Order Routings, Job Requirements ve açık satın alma siparişi satırlarıyla birlikte okuyun. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslim tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoku günceller. Beklemeye alınan ve kapanmış işleri atlayın.
3. Çizelgenin geri yazılması. Çizelgeleme motoru bir adımı yerleştirdiğinde veya taşıdığında, SkyPlanner webhook’u /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber} adresine bir PATCH isteği tetikler. Bu istek estimatedStartDate ve estimatedEndDate alanlarını UTC olarak günceller. SkyPlanner adımı başka bir makineye veya kişiye taşıdıysa workCenter ve employeeCode alanları da güncellenir. Tarihler, Whiteboard, Planning Board ve Scheduling Advisor’da zaten gösterilen iş adımlarına yazılır.
4. Üretim sahası bildirimleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder. Bu süre kayıtları çizelgeyi güncel tutar. Gerçekleşen sürelerin JobBOSS²’ye geri aktarılıp aktarılmayacağını siz seçersiniz. Aktarım seçilirse her bildirim, hazırlık süresi, çevrim süresi ve parça adetlerini içeren bir Time Ticket Detail kaydına dönüşür. Seçilmezse veri toplama JobBOSS²’de kalır ve SkyPlanner işlerin ilerleyişini Order Routings üzerinden okur.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hâle getirin:
| Veri | Verinin sahibi |
|---|---|
| Estimates, Routings, miktarlar, teslim tarihleri, iş durumu | JobBOSS² |
| Adımların sırası, başlangıç ve bitiş zamanları, her adımın makinesi ve operatörü | 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 |
| Çalışma süresi kayıtları, malzeme çıkışları, mal kabulleri, maliyetlendirme | JobBOSS²; veriler doğrudan girilir veya SkyPlanner süre kayıtlarından aktarılır |
İş adımlarının tarihlerini yalnızca tek bir sistemin yazmasını sağlayın. SkyPlanner, çizelgelediği işlerde Whiteboard üzerinden yeniden çizelgelemenin yerini alır. Planlamacılar işleri SkyPlanner’da taşır, tarihler de JobBOSS²’ye aktarılır.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra normalde haftalar içinde tamamlanır. Öncesinde, JobBOSS²’den CSV veya Excel olarak dışa aktardığınız Work Centers, rotalar ve açık işlerle 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 çalışma süresi kayıtlarının geri aktarılıp aktarılmayacağını kesinleştirin.
- ECI erişimi. ECI’den JobBOSS² API veya ERP API erişimini etkinleştirmesini ve API kullanıcısını oluşturmasını isteyin. Test şirketiniz varsa testleri bu ortamda yapın.
- İlk veri aktarımı. Estimates, Routings, Work Centers, takvim ve çalışanlar.
- İş ve satın alma siparişi senkronizasyonu.
lastModDatefiltreleri, sayfalama ve yeniden deneme mekanizmasıyla 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ı üzerinden Order Routing PATCH çağrıları; tercih edilirse Time Ticket Details aktarımı.
- Paralel test. SkyPlanner’ı mevcut planlama panosuyla birlikte ç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.
JobBOSS² entegrasyonunda dikkat edilmesi gerekenler
- Barındırılan veya yerel kurulum. JobBOSS² API, barındırılan sürümü kullanan müşterilere hizmet verir. Yerel kurulumlarda, kaynak listesi farklı olan ERP API kullanılır. Hangi yolu izleyeceğinizi 1. adımda netleştirin.
- Her yerde UTC. API, saatleri UTC olarak okur ve yazar. Fabrikanın yerel saatine dönüştürün; aksi hâlde 7:00’de başlaması gereken iş yanlış saate çizelgelenir.
- İş merkezlerinin arkasındaki makineler. Bir iş merkezi; bir makineyi, bir grubu, bir hücreyi veya çalışanları temsil edebilir. Her rota adımındaki makine sayısı ve ekip büyüklüğü, SkyPlanner’a o adım için kaç kaynak gerektiğini bildirir.
- Dışarıdan alınan hizmetler. İş merkezi yerine tedarikçi atanan adımlar kendi kapasitenizi değil, lead time’ı temsil eder. Bunları yalnızca süre içeren adımlar olarak modelleyin.
- Örtüşen ve operatörsüz adımlar. Rota adımları, birbiriyle örtüşecek veya operatörsüz çalışacak şekilde işaretlenebilir. Operatörsüz üretimin doğru planlanması için her iki işareti de aktarın.
- Zaman birimleri. Hazırlık ve çevrim sürelerinin kendi birimleri vardır. Kuyruk süresi ise makine çalışma süresi değil, bekleme süresidir. İçe aktarım sırasında birimleri dönüştürün; aksi halde tüm süreler yanlış olur.
- Sayfalama. Varsayılan olarak her sayfa 200 kayıt içerir. Her okuma işleminde sayfalama kullanın.
JobBOSS² entegrasyonunu kim yapılandırır ve destekler?
- SkyPlanner ekibi, entegrasyonu devreye alma sürecinde yapılandırır ve canlıya geçişten sonra destekler. Bu hizmet, üzerinde anlaşılmış kaynakları ve periyodik sorgulama kurallarını kapsar. Her üretim işletmesi JobBOSS²’yi farklı kullanır; bu kullanım bilgisi yapılandırmaya yansıtılır.
- JobBOSS² iş ortağınız da sürece katılabilir. İş ortağınız kurulumunuzu tanır. SkyPlanner ekibiyle birlikte ECI ile görüşerek API erişiminin etkinleştirilmesini ve API kullanıcısının oluşturulmasını sağlayabilir.
- 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. Entegrasyon belgelerine SkyPlanner entegrasyon dokümantasyonundan 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, seçtiğiniz planla birlikte önceden fiyat teklifi verilir. Fiyatlandırmayı, JobBOSS² ile üretim çizelgelemeyi, JobBOSS² sayfasını, SkyPlanner özelliklerini ve ERP entegrasyonları sayfasını inceleyin.
SkyPlanner kullanan üreticiler
2 saather hafta 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 donanımları
Üretim planlamasında her hafta 2 saatlik çalışma süresinden tasarruf ediliyor ve yeni iş kuyruğu üretim hattına saniyeler içinde 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 plan 30 dakikadan kısa sürede hazırlanıyor.
1.000’lerceotomatik çizelgelenen iş emri
“Üretimi artık bambaşka 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 tüm kuruluş üretimi gerçek zamanlı olarak takip edebiliyor.
%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 üretim sorumlusu yeterli oluyor.
Sık sorulan sorular
JobBOSS²’nin API arayüzü var mı?
Evet. ECI, JobBOSS² API ve üründen bağımsız ERP API arayüzlerini sunar. Her ikisi de REST tabanlıdır ve OpenAPI spesifikasyonlarına sahiptir. JobBOSS² API, barındırılan sürümü kullanan müşteriler için siparişleri, Order Routings, Estimates, Work Centers, satın alma siparişlerini ve Time Tickets verilerini okur ve yazar.
Entegrasyon, JobBOSS² ile kimlik doğrulamasını nasıl yapar?
OAuth 2.0 istemci kimlik bilgileriyle. ECI, API erişimini etkinleştirir; Integration Engine Management Console üzerinden bir API kullanıcısı oluşturulur ve her çağrıda bir Bearer token gönderilir.
JobBOSS² webhook desteği sunuyor mu?
ECI’nin API belgelerinde webhook desteği belirtilmediği için entegrasyon, her işletme için belirlenen aralıklarla JobBOSS²’yi lastModDate filtreleriyle sorgular. SkyPlanner’ın kendi webhook’ları ise çizelge değişikliklerini anında iletir.
Planlanan tarihler JobBOSS²’ye nasıl geri yazılır?
Her iş adımı için ayrı ayrı yazılır. SkyPlanner, her Order Routing kaydını PATCH çağrısıyla güncelleyerek estimatedStartDate ve estimatedEndDate alanlarını yazar. Adım başka bir makineye veya operatöre taşındıysa workCenter ve employeeCode alanlarını da günceller.
Bir JobBOSS² iş ortağı ECI APS’yi mi, SkyPlanner’ı mı önermeli?
Müşteri, birden fazla kaynağın gerçek kapasitesini dikkate alan üretim çizelgelemeyi haftalar içinde devreye almak istiyorsa SkyPlanner’ı önermeli. ECI APS, LYNQ altyapısını kullanan ayrı bir eklentidir. SkyPlanner, ECI’nin kendi JobBOSS² API arayüzü üzerinden bağlanır; iş değişimlerini, ekipleri, fikstürleri ve malzemeyi planlar, otomatik olarak yeniden planlama yapar. Fiyatı aylık 199 €’dan başlar.
Entegrasyonu kurmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, JobBOSS²’den CSV veya Excel ile veri aktararak 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.
