Entegrasyonlar / ERP / Fulcrum
SkyPlanner APS ile Üretim Çizelgeleme için Fulcrum Entegrasyon Kılavuzu
Bu Fulcrum entegrasyon kılavuzu, danışmanlara ve BT ekiplerine Fulcrum’u (Fulcrum Pro) SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, Fulcrum Public API üzerinden Fulcrum ile çift yönlü entegre olur:
- İşler, üretilecek kalemleri ve operasyonlarıyla birlikte SkyPlanner’a aktarılır. Kalem rotaları, iş merkezleri, ekipmanlar, departman vardiyaları, duruşlar, stoklar ve satın alma siparişleri de aktarılır.
- Planlanan başlangıç, planlanan bitiş ve iş merkezi, her iş operasyonundaki özel alanlara yazılır.
- Operatör süreleri ve tamamlanan miktarlar, Fulcrum’a zamanlayıcı kayıtları ve miktar güncellemeleri olarak geri gönderilir.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Fulcrum yapılandırmanıza göre ayarlar 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 kendileri geliştirme yapmak isteyen danışmanlar ve geliştiriciler içindir.
Fulcrum Public API
Fulcrum, çok kiracılı tek bir bulut ürünüdür; bu nedenle tüm müşteriler aynı API’yi kullanır. Geliştirici portalına göre bu açık API, “REST API calls directly into your Fulcrum site.” (Doğrudan Fulcrum ortamınıza REST API çağrıları.) yapmak için kullanılır.
- Teknik tanım. OpenAPI “Fulcrum PublicAPI” v1,
https://api.fulcrumpro.com/swagger/v1/swagger.jsonadresinden indirilebilir. Fulcrum, bu tanımdan tip tanımlı bir istemci oluşturulmasını önerir. History sayfası tüm değişiklikleri tarihleriyle listeler. - Sunucu adresleri. Standart ortamlar için
https://api.fulcrumpro.comkullanılır. ITAR ortamlarıapi.fulcrumpro.usadresini kullanır; ITAR token’ları .com sunucusunda 401 yanıtı alır. - Kullanım biçimi. Listeler, filtre içeren bir istek gövdesiyle
POST .../listüzerinden alınır. Sayfalama içinSkipveTake, sıralama içinSort.Field/Sort.Dirkullanılır. Birçok nesne PUT kabul eder; işler ayrıca JSON Patch de kabul eder.
Çizelgeleme entegrasyonunda kullanılan uç noktalar:
| Alan | Uç noktalar |
|---|---|
| Kalemler ve rotalar | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| Üretim alanı yapılandırması | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| İşler | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| Malzeme | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| shop floor | /api/job-tracking-timers/start ve /stop, /api/timers, .../operations/{operationId}/add-quantity-completed, .../complete |
Fulcrum’un kendi entegrasyon sayfası, gereken çalışmayı açıkça ifade eder: “Every system is a little bit different and requires some configuration.” (Her sistem biraz farklıdır ve bir miktar yapılandırma gerektirir.) SkyPlanner ekibi, devreye alma sürecinde tam da bu yapılandırmayı üstlenir.
Kimlik doğrulama
Fulcrum, Authorization başlığında Bearer token kullanır. “A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.” (Fulcrum ortamınızda Business Setup -> System Data -> Public Api yolunu izleyerek bir açık API token’ı oluşturabilirsiniz.) Her token’ın bir adı, açıklaması ve son kullanma tarihi vardır. İhtiyacınız kadar token oluşturabilir, herhangi birini silerek iptal edebilirsiniz. SkyPlanner entegrasyonu için ayrı bir token oluşturun ve süresi dolmadan önce bir hatırlatıcı ayarlayın.
SkyPlanner tarafında REST API, Authorization-Token başlığındaki API token’ı ile kimlik doğrular (SkyPlanner Settings > API). API belgeleri Swagger/OpenAPI biçimindedir. Entegrasyon eğitiminde ilk çağrıların nasıl yapılacağı adım adım anlatılır.
Olaylar ve periyodik sorgulama
Fulcrum, yönetici tarafından yapılandırılan webhook’ları destekler. Eylül 2026’dan bu yana, başarısız olan webhook’lar sonsuza dek yeniden denenmek yerine duraklatılır ve her gün yeniden test edilir. API History sayfasında PurchaseOrderUpdated ve ItemUpdated gibi olaylar yer alır.
Entegrasyon, Fulcrum verilerini şu şekilde okur:
- Açık işler,
scheduledveinProgressdurumları ilehasIncompleteOperations: truekoşuluna göre filtrelenerek birkaç dakikada bir sorgulanır. Fulcrum’un kendi çizelge sayfasıyla aynı sonuçları almak için önerdiği filtre budur. - Satın alma siparişleri ve stoklar, çizelgeleme her çalıştırılmadan önce veya yapılandırılmışsa
PurchaseOrderUpdatedwebhook’u geldiğinde okunur. - Kalemler, rotalar, ekipmanlar ve vardiyalar, değişiklik olduğunda veya her gece okunur.
Diğer yönde ise SkyPlanner’ın kendi webhook’ları çizelge değişikliklerini anında iletir. Böylece geri yazma işlemleri olay tabanlı çalışır.
Veri eşleştirme
| Fulcrum nesnesi (uç nokta) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Item, Materials (/api/items, /api/materials) | Ürünler ve malzemeler | Fulcrum → SkyPlanner | İlk yükleme, ardından her gece |
Rotanın girdi kalemleri ve malzemeleri (/routing/input-items, /input-materials) | Ürün yapısı, alt ürünler, ürün başına malzemeler | Fulcrum → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
Rota operasyonları (/routing/operations): setupTime, laborTime, machineTime (sabit veya birim başına), selectedEquipmentIds | İşlem adımları, hazırlık süreleri, süreler, kullanılabilecek iş merkezleri | Fulcrum → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
Work Center (/api/work-centers) | İş merkezi grubu | Fulcrum → SkyPlanner | İlk yükleme, sonrasında nadiren |
Equipment (/api/equipment): unlimitedCapacity, canRunUnattended, status | İş merkezleri, parti işleri, gözetimsiz çalışma | Fulcrum → SkyPlanner | İlk yükleme, durum bilgisi için günlük |
Department Shifts (/api/department-shifts), Equipment Downtimes | Vardiyalar ve kullanılamayan zamanlar | Fulcrum → SkyPlanner | İlk yükleme, ardından günlük |
İş ve iş operasyonları (/api/jobs, .../items-to-make/{id}/operations): priority, productionDueDate, earliestStartDate, tahminler | Siparişler ve işler | Fulcrum → SkyPlanner | Birkaç dakikada bir sorgulama |
| Inventory, Expected Receive tarihleriyle Purchase Orders | Stok ve gelecek malzemeler | Fulcrum → SkyPlanner | Çizelgeleme her çalıştırılmadan önce |
İş operasyonunun customFields alanları (POST .../operations/{operationId}) | Planlanan başlangıç, planlanan bitiş, iş merkezi | SkyPlanner → Fulcrum | Çizelge değiştiğinde, SkyPlanner webhook’u üzerinden |
İşin customFields alanları (PUT /api/jobs/{jobId}/custom-fields) | İşin planlanan bitişi | SkyPlanner → Fulcrum | Çizelge değiştiğinde |
İş takibi zamanlayıcıları, /api/timers, add-quantity-completed, complete | Süre kayıtları, tamamlanan ve hurdaya ayrılan miktarlar | SkyPlanner → Fulcrum | Operatörler iş kaydı girdikçe |
| Fulcrum’da bulunmaz | İsimleriyle tanımlanan operatörler, hazırlık süresi matrisi, sınırlı sayıdaki takımlar, alternatif iş merkezleri | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon akışları
1. Ana verilerin ilk yüklemesi. Önce kalemleri, malzemeleri, rotaları, iş merkezlerini ve ekipmanları; ardından departman vardiyalarını ve duruşları alın. Her Fulcrum iş merkezi, ekipmanlarının üye olduğu bir SkyPlanner iş merkezi grubuna dönüşür. Her rota operasyonu için seçilen ekipmanlar da o operasyonda kullanılabilecek iş merkezlerini belirler. Fırınlar ve boya kabinleri gibi Unlimited Capacity ekipmanları, parti işleri olarak modellenir.
2. Sipariş eşitleme. Açık işleri, üretilecek kalemleri ve operasyonlarıyla birlikte okuyun; açık satın alma siparişlerini ve stokları da alın. 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. Her yeniden planlamada stoklar ve gelecek satın alımlar kontrol edilir.
3. Çizelgenin geri yazılması. Fulcrum, scheduledStartUtc, scheduledEndUtc ve scheduledEquipmentId değerlerini kendisi hesaplar ve salt okunur olarak döndürür. Operasyon güncelleme isteği customFields kabul eder. SkyPlanner, planlanan başlangıcı, planlanan bitişi ve iş merkezini her iş operasyonundaki özel alanlara yazar. İşin planlanan bitişini de iş düzeyindeki bir özel alana yazar. Satış ve satın alma ekipleri, SkyPlanner’ın tarihlerini Fulcrum’daki iş kaydında görür.
4. Üretim bildirimleri. Operatörler, Mobile Confirmations, Production Timer veya Quick Log Mode ile SkyPlanner’da iş kaydı tutar. SkyPlanner, süreyi /api/job-tracking-timers/start ve /stop üzerinden ya da tamamlanmış bir zaman bloğu olarak /api/timers üzerinden Fulcrum’a gönderir. Miktarlar add-quantity-completed üzerinden, fireyi de içeren son miktar ise complete üzerinden iletilir. Fulcrum’daki iş maliyetleri güncel kalır.
5. Veri sahipliği ve çakışma kuralları. Fulcrum’un çizelgeleme aracı “dictates the order of operations in Job Tracking.” (Job Tracking içindeki operasyonların sırasını belirler.) Bu nedenle her operasyon için tek bir iş yönlendirme kanalı seçin: SkyPlanner’ın operatör kuyruğu veya Fulcrum Job Tracking. Canlıya geçmeden önce kuralları yazılı hale getirin:
| Veri | Veri sahibi |
|---|---|
| Stok kartları, rotalar, tahminler, stok, satın alma, maliyetlendirme | Fulcrum |
| Operasyon sırası, başlangıç ve bitiş zamanları, iş merkezi ataması | SkyPlanner |
| Operatörler, hazırlık süresi matrisi, takımlar, alternatif kaynaklar | SkyPlanner |
| Vardiyalar ve duruşlar | Kapsam belirleme aşamasında seçilen tek bir sistem |
| Kaydedilen süreler ve tamamlanan miktarlar | SkyPlanner; Fulcrum’a aktarılır |
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra normalde birkaç hafta içinde tamamlanır. Öncesinde, 30 günlük ücretsiz denemede kendi verilerinizle çalışırsınız. Stok kartlarını, rotaları ve açık işleri Fulcrum tablolarından CSV olarak dışa aktarın, içe alın ve çizelgeyi doğrulayın.
Proje şu adımlardan oluşur:
- Token ve kapsam. Bir Public API token’ı oluşturun ve geri yazma için kullanılacak özel alanları kararlaştırın.
- Eşleştirme. Eşleştirme tablosunu, veri sahipliği kurallarını ve iş yönlendirme kanalını kesinleştirin.
- İlk veri yüklemesi. Stok kartları, malzemeler, rotalar, iş merkezleri, ekipmanlar, vardiyalar ve duruşlar.
- Sipariş ve satın alma siparişi senkronizasyonu. İşlerdeki değişikliklerin düzenli sorgulanması, satın alma siparişleri ve stok.
- SkyPlanner’da kısıtların tanımlanması. Operatörler ve vardiyaları, hazırlık süresi matrisi, takımlar ve alternatif iş merkezleri.
- Geri yazma. İş operasyonlarındaki ve işlerdeki özel alanlar.
- Üretim kayıtlarının aktarılması. Zamanlayıcıların ve miktarların Fulcrum’a gönderilmesi.
- Paralel test ve canlıya geçiş. SkyPlanner’ı Fulcrum çizelgesiyle paralel çalıştırın, tarihleri karşılaştırın, ana verileri düzeltin ve ardından işlerin dağıtımını SkyPlanner’a geçirin.
Fulcrum entegrasyonunda nelere hazırlıklı olmalısınız?
- İş gücü, vardiya başına ekipman sayısına yansır. Fulcrum’da vardiya başına Max Equipment değeri “is usually determined by how many people you have working in a certain area at that time.” (genellikle o sırada belirli bir alanda çalışan kişi sayısına göre belirlenir.) Operatörler ve vardiyaları SkyPlanner’da kişi bazında tanımlanır. İsimler
/api/usersiçindeki kullanıcı kayıtlarından alınır. - Çizelgeleme ekipman bazında yapılır. Fulcrum iş merkezleri, birbirinin yerine kullanılabilen ekipman gruplarıdır. Motorun aralarından seçim yapacağı alternatifleri rotada seçilen ekipmanlar oluşturur. Bu nedenle rotadaki ekipman seçimini doğru tutun.
- Üretim emirleri işleri gruplar. Bir üretim emri, birden fazla işin operasyonlarını, örneğin ortak bir kesim yerleşimi için gruplar. Gruplanmış bir operasyonda zamanlayıcı başlatıldığında, bunun yerine üretim emrinin zamanlayıcısı başlar ve gruptaki tüm iş operasyonlarını kapsar.
- Zamanlayıcı sınırları. Geriye dönük
/api/timersblokları “may not be in the future, older than 30 days, or longer than 7 days.” (gelecekte olamaz, otuz günden eski olamaz veya yedi günden uzun süremez.) Operatörler süre kaydı girdikçe bu kayıtları aktarın. - Zaman biçimleri farklıdır. Vardiyalar yerel saatle HHmm değerlerini kullanır. Duruşlar ve çizelgelenmiş tarihler UTC biçimindedir; tahmini operasyon süreleri ise saniye cinsinden gelir.
- Ekipman güncellemeleri tüm kaydın yerini alır. Ekipman için yapılan bir PUT isteği, istekte yer almayan tüm alanları temizler. SkyPlanner ekipman verilerini okur, ancak bu verilere hiçbir zaman yazmaz.
- ITAR ortamları.
.ussunucusunu ve bir ITAR token’ı kullanın.
Fulcrum entegrasyonunu kim yapılandırır, kim destekler?
Çalışma, departmanlarınızın, iş merkezlerinizin, ekipmanlarınızın ve rotalarınızın eşleştirilmesini kapsar. Fulcrum’da tutulmayan kısıtlar da buna dahildir: kişi bazında operatörler, hazırlık süresi matrisi, takımlar ve alternatif kaynaklar.
- SkyPlanner ekibi, devreye alma sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek verir. Her işletme Fulcrum’u farklı kullanır; işletmenizin bu konudaki deneyimi yapılandırmaya yansır.
- Fulcrum danışmanınız veya entegrasyon iş ortağınız entegrasyonu geliştirebilir. SkyPlanner, REST API, Swagger/OpenAPI dokümantasyonu ve webhook’lar sağlar.
- Kendi geliştiricileriniz de bu altyapı üzerinde geliştirme yapabilir. Başlamak için bir API token’ı yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Satın alma siparişleri ile ürün ve malzeme API’sini de kapsayan ürün dokümantasyonunu SkyPlanner dokümanlarında bulabilirsiniz.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Entegrasyon için süreçlerinize ve ihtiyaçlarınıza göre hazırlanan teklif, abonelik planınızla birlikte önceden sunulur. Böylece başlamadan önce toplam maliyeti görürsünüz. Fiyatları ve özellikleri inceleyin; Fulcrum’un kendi çizelgeleme aracıyla karşılaştırma için Fulcrum ile üretim çizelgeleme sayfasına bakın. Genel bilgileri Fulcrum sayfasında, diğer ERP’leri ise ERP entegrasyonları merkezinde bulabilirsiniz.
Ü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ı sayesinde her hafta 2 saat çalışma süresinden tasarruf sağlanıyor ve yeni bir 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 bir planın hazırlanması 30 dakikadan kısa sürüyor.
%99,2teslimat performansı
“SkyPlanner, darboğazları tespit etmek için gereken 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ı. Çizelgelemede her gün dört saate kadar çalışma süresinden tasarruf sağlanıyor.
%98teslimat performansı; yaklaşık %50’den yükseldi
“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.
Sık sorulan sorular
Fulcrum’un bir API’si var mı?
Evet. Fulcrum Public API, OpenAPI v1 spesifikasyonuna sahip bir REST API’dir. Kimlik doğrulama için Business Setup > System Data > Public Api altında oluşturulan bir Bearer token’ı kullanır. ITAR ortamları ayrı bir .us sunucusu kullanır.
SkyPlanner çizelgeyi Fulcrum’a geri yazabilir mi?
Evet. Fulcrum, kendi çizelge tarihlerini salt okunur olarak tutar. Bu nedenle SkyPlanner, planlanan başlangıcı, planlanan bitişi ve iş merkezini her iş operasyonundaki özel alanlara; planlanan bitişi de işe yazar. Operatör süreleri ve tamamlanan miktarlar, zamanlayıcı kayıtları ve miktar güncellemeleri olarak geri aktarılır.
Fulcrum değişiklikleri gerçek zamanlı olarak gönderir mi?
Fulcrum’da, PurchaseOrderUpdated gibi olaylar için yöneticinin yapılandırdığı webhook’lar bulunur. Açık işler, Fulcrum’un çizelge sayfasında kullandığı filtreyle birkaç dakikada bir sorgulanır. SkyPlanner’ın kendi webhook’ları ise çizelge değişikliklerini gerçekleştiği anda gönderir.
Fulcrum entegrasyonunu kim geliştirir?
SkyPlanner ekibi, devreye alma sürecinde çift yönlü entegrasyonu yapılandırır ve canlıya geçişten sonra destek verir. Fulcrum danışmanınız, bir entegrasyon iş ortağı veya kendi geliştiricileriniz de SkyPlanner’ın dokümante edilmiş REST API’si üzerinde geliştirme yapabilir.
Entegrasyonu geliştirmeden önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz denemede Fulcrum’dan CSV ile veri aktarabilir ve 20 iş merkezine kadar kullanabilirsiniz; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
