Entegrasyonlar / ERP / Exact
SkyPlanner APS ile Üretim Çizelgeleme için Exact Online Entegrasyon Kılavuzu
Bu Exact Online entegrasyon kılavuzu, Exact iş ortaklarına ve BT ekiplerine Exact Online Manufacturing ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, Exact Online ile çift yönlü entegre çalışır:
- Üretim emirleri, rota adımları, malzeme planları, iş merkezleri, operasyonlar ve ürün ağaçları, Exact Online REST API üzerinden alınır.
- Stok kartları, stok durumları, satın alma siparişleri ve satış siparişleri alınır; değişiklikler Exact Online webhook’larıyla iletilir.
- Planlanan başlangıç ve bitiş tarihleri, her rota adımına ve üretim emrine geri yazılır.
- Operatörlerin süre kayıtları zaman hareketi olarak, tamamlanan miktarlar ise üretim emrinden stok girişi olarak kaydedilir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Exact Online yapılandırmanıza göre ayarlar ve canlıya geçişten sonra da destek sağlar. Bu kılavuz, sürece katılmak veya SkyPlanner’ın dokümante edilmiş REST API’siyle (API başvuru kaynağı) kendi çözümlerini geliştirmek isteyen iş ortakları ve geliştiriciler içindir. Kılavuzun sonunda Exact Globe+ hakkında kısa bir bölüm de yer alır.
Üretim için Exact Online REST API
Exact Online, verilerini tek bir REST API üzerinden sunar; kaynaklar servislere göre gruplandırılır. Temel yol /api/v1/{division}/<service>/<resource> şeklindedir. Buradaki division, Exact Online’daki şirketi belirtir. REST API başvuru kaynağı, üretim servisinde çizelgeleme için şu kaynakları listeler:
| Kaynak | İçerik | Metotlar |
|---|---|---|
manufacturing/ShopOrders | Üretim emri numarası, stok kartı, PlannedQuantity, PlannedStartDate, PlannedDate, durum, serbest bırakılma göstergesi | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Üretim emri bazında rota adımı: operasyon, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Üretim emri bazında malzeme satırları | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Kod, tür, üretim alanı, kapasite değeri, birim ücretler | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operasyonlar ve her birinin yürütüldüğü iş merkezi, hazırlık ve işlem süreleri | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | BOM sürümleri, bileşenler ve rota | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Üretim emri ve rota adımı bazında kaydedilen saatler | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Üretim emrinden stoğa alınan tamamlanmış miktarlar | GET, POST |
manufacturing/MaterialIssues | Üretim emrine verilen malzemeler | GET, POST |
manufacturing/ShopOrderPriorities | Üretim emri bazında öncelik modu | GET, PUT |
Diğer servislerdeki kaynaklar:
| Kaynak | İçerik |
|---|---|
logistics/Items | Stok kartı ana verileri |
inventory/ItemWarehouses | Stok kartı ve depo bazında stok miktarı |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Açık satın alma siparişleri ve mal kabul tarihleri |
salesorder/SalesOrders, SalesOrderLines | Müşteri talebi ve teslimat tarihleri |
Kimlik doğrulama ve erişim
Exact Online, yetkilendirme kodu akışı ve yenileme belirteçleriyle OAuth 2.0 kullanır. Exact’in açıklaması şöyledir: “Before you can start integration with Exact Online, you must first register your app in the App Store.” (Exact Online ile entegrasyona başlamadan önce uygulamanızı App Store’a kaydetmeniz gerekir.) (Exact Online yardımı) Uygulama kaydı için Exact Online Developer aboneliği gerekir (Exact App Store).
- Entegrasyon, bir yönlendirme URI’siyle uygulama olarak kaydedilir.
- Üretim, stok ve satın alma verilerine erişimi olan bir Exact Online kullanıcısı bir kez onay verir.
- Her istekte
Authorization: Bearer <access_token>gönderilir ve yolda division belirtilir. - Erişim belirteçleri, yenileme belirteciyle yenilenir. Exact, yeni belirteç talep etme sıklığını sınırlar. Bu nedenle belirteci süresi dolana kadar önbellekte tutun.
Exact ayrıca her uygulama ve şirket için dakikalık ve günlük çağrı sınırları koyar; çağrıların paralel değil, sıralı yapılmasını ister. Güncel sınırlar, Exact’in API sınırları makalesinde yer alır. Entegrasyon bu sınırlara göre tasarlanmıştır: filtreli okumalar için $filter ve $select, toplu değişiklikler için ise Sync API kullanılır.
SkyPlanner tarafında REST API, Authorization-Token başlığındaki API belirteciyle kimlik doğrular (SkyPlanner Settings > API). API dokümantasyonu Swagger/OpenAPI biçimindedir. Entegrasyon eğitimi, ilk çağrıların nasıl yapılacağını adım adım açıklar.
Webhook’lar ve periyodik sorgulama
Exact Online webhook’ları, abone olunan bir konuda değişiklik olduğunda geri çağırma URL’nize HMAC SHA256 özetiyle imzalanmış bir POST isteği gönderir (webhook’lar). Konular arasında Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders ve SalesOrderLines bulunur. Böylece stok, satın alma ve talep değişiklikleri gerçekleştiği anda SkyPlanner’a iletilir.
Üretim emirleri ve rota adımları belirli aralıklarla okunur. ShopOrders ve ShopOrderRoutingStepPlans kaynaklarını Modified alanına göre filtreleyin; toplu okumalar için Sync API kullanın (API kısıtlamaları).
Çizelge değiştiğinde SkyPlanner kendi webhook’larını gönderir. Böylece Exact Online’a geri yazma işlemi olaylara bağlı olarak gerçekleşir.
Veri eşleme
| Exact Online kaynağı | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Items | Ürünler ve malzemeler | Exact Online → SkyPlanner | İlk yükleme, ardından webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Ürün yapısı, alt ürünler, ürün bazında malzemeler | Exact Online → SkyPlanner | Değişiklik olduğunda |
Workcenters, OperationResources | İş merkezleri, iş merkezi grupları | Exact Online → SkyPlanner | İlk yükleme |
Operations, BillOfMaterialRoutings | Hazırlık ve işlem sürelerini içeren süreç adımları | Exact Online → SkyPlanner | Değişiklik olduğunda |
ShopOrders | Miktarı ve termin tarihiyle üretim emirleri | Exact Online → SkyPlanner | Birkaç dakikada bir |
ShopOrderRoutingStepPlans | Sıra, iş merkezi ve saat cinsinden hazırlık ve işlem sürelerini içeren işler | Exact Online → SkyPlanner | Birkaç dakikada bir |
ShopOrderMaterialPlans | İş bazında malzemeler | Exact Online → SkyPlanner | Birkaç dakikada bir |
ItemWarehouses, StockPosition | Stok bakiyeleri | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Beklenen teslim tarihleriyle birlikte satın alma siparişleri | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Müşteri teslim tarihleri ve öncelik | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Her adım için planlanan başlangıç, bitiş ve iş merkezi | SkyPlanner → Exact Online | Değişiklik olduğunda webhook üzerinden |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Üretim emrinin başlangıcı ve bitişi | SkyPlanner → Exact Online | Değişiklik olduğunda webhook üzerinden |
TimeTransactions (POST) | Süre kayıtları ve operatör bildirimleri | SkyPlanner → Exact Online | Her bildirimde veya vardiya bazında |
ShopOrderReceipts (POST) | Son adımda tamamlanan miktar | SkyPlanner → Exact Online | Her bildirimde |
| Exact Online’da tutulmaz | Hazırlık süresi matrisi, sınırlı kapasiteli kaynak olarak takımlar, iş başına operatörler, alternatif iş merkezleri, vardiyalar | SkyPlanner’da yönetilir | Devreye alma |
Entegrasyon akışları
1. Ana verilerin ilk yüklemesi. Önce Workcenters, Operations ve OperationResources verilerini, ardından stok kartlarını ve BOM sürümlerini rotalarıyla birlikte okuyun. Üç makineli bir iş merkezi, üç ayrı iş merkezi veya bir iş merkezi grubu olarak modellenir. Exact’te her iş merkezi için tek bir kapasite değeri tutulduğundan vardiyalar, devamsızlıklar ve fazla mesailer SkyPlanner’da tanımlanır.
2. Üretim emirlerinin eşitlenmesi. Açık ShopOrders kayıtlarını, bunlara ait ShopOrderRoutingStepPlans ve ShopOrderMaterialPlans verileriyle birlikte okuyun; stokları ve satın alma siparişi satırlarını da alın. Çizelgelemede hem mevcut stok hem de gelecek satın almalar kontrol edilir. MRP, Exact Online’da sipariş önerileri sunmaya devam eder; SkyPlanner ise oluşturduğunuz üretim emirlerini çizelgeler.
3. Çizelgenin geri yazılması. Motorun çizelgeye yerleştirdiği veya çizelgedeki yerini değiştirdiği her rota adımı için SkyPlanner, PlannedStartDate, PlannedEndDate ve Workcenter alanlarını içeren bir PUT isteğini ShopOrderRoutingStepPlans uç noktasına gönderir. Üretim emrinin PlannedStartDate ve PlannedDate değerleri, ilk ve son adımın tarihlerine göre belirlenir. Miktarlar, malzeme planları ve maliyetlendirme Exact Online’da kalır.
4. Üretim sahasından bildirimler. Operatörler yaptıkları işi SkyPlanner Mobile Confirmations veya Production Timer ile kaydeder; bu süre kayıtları çizelgeyi güncel tutar. Kaydedilen saatler, ilgili üretim emrine ve rota adımına hazırlık ya da çalışma süresi olarak TimeTransactions üzerinden işlenir. Son bildirimde, tamamlanan miktar için bir ShopOrderReceipts kaydı oluşturulur. Tesisinizde süreler zaten Shop Floor Control üzerinden kaydediliyorsa tek bir kayıt kanalı seçin.
5. Veri sorumluluğu ve çakışma kuralları. Canlı kullanıma geçmeden önce bu kuralları yazılı hale getirin:
| Veri | Sorumlu sistem |
|---|---|
| Stok kartları, BOM’lar, üretim emri miktarları, malzeme planları, maliyetler | Exact Online |
| Rota adımlarının sırası, başlangıç ve bitiş zamanları, iş merkezi ataması | SkyPlanner |
| Hazırlık süresi matrisi, takımlar, iş başına operatörler, alternatif kaynaklar, vardiyalar | SkyPlanner |
| Süre hareketleri ve üretimden girişler | Exact Online; veriler SkyPlanner’dan gelir |
Çakışmaların başlıca nedeni, tarihlerin elle değiştirilmesidir. Planlamacılar Exact Online’da üretim emri tarihlerini değiştirmeye devam ederse tarihleri iki sistem birden yönetir. Rota adımlarının tarihlerini SkyPlanner yönetsin. Autopilot ile SkyPlanner, üretimde değişiklik olduğunda çizelgeyi otomatik olarak yeniden oluşturur.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra genellikle birkaç hafta içinde tamamlanır. Bundan önce, açık üretim emirlerini ve rota adımlarını CSV veya Excel dosyası olarak dışa aktararak 30 günlük ücretsiz denemede çizelgeyi doğrulayın. Ardından proje şu adımlarla ilerler:
- Kapsam belirleme. Kullanılan sürümü, şirketleri, eşitleme sıklıklarını, süre kayıt kanalını ve üretimden girişlerin nasıl işleneceğini netleştirin.
- Uygulama kaydı ve izin. Uygulamayı kaydedin; ardından bir Exact Online kullanıcısı her şirket için OAuth izni verir.
- İlk yükleme. İş merkezleri, operasyonlar, stok kartları, BOM sürümleri ve rotalar yüklenir.
- Üretim emirlerinin eşitlenmesi. Üretim emirleri, rota adımı planları ve malzeme planları belirli aralıklarla; stok ve satın alma verileri ise webhook üzerinden eşitlenir.
- SkyPlanner’da kısıtların tanımlanması. Vardiyalar, hazırlık süresi matrisi, takımlar, iş başına operatör sayıları ve alternatif makineler veya personel tanımlanır.
- Çizelgenin geri yazılması. Önce rota adımlarının planlanan tarihleri, ardından süre hareketleri ve üretimden girişler Exact Online’a aktarılır.
- Paralel test ve canlı kullanıma geçiş. Tarihleri mevcut planla karşılaştırın, ana verileri düzeltin ve ardından geri yazmayı etkinleştirin.
Exact Online entegrasyonunda dikkat edilecek noktalar
- Rota adımlarının süreleri.
PlannedSetupHoursvePlannedRunHoursdeğerleri BOM rotasından gelir. Önce bu değerleri gerçekleşen çalışma süreleriyle karşılaştırın. - İş merkezlerinin gruplandırılması. Exact, her iş merkezi için tek bir kapasite değeri tutar. Her birinin SkyPlanner’da tek bir iş merkezi, birden fazla iş merkezi veya bir grup olarak mı tanımlanacağına karar verin.
- Takvimler. Vardiyalar, tatiller ve devamsızlıklar SkyPlanner’da tutulur. İlk çizelgeyi oluşturmadan önce bunları tanımlayın.
- API çağrı kotası. Exact, uygulama ve şirket başına çağrı sayısını sınırlar ve çağrıların sırayla yapılmasını bekler. Desteklenen konularda webhook kullanın;
Modifiedalanında$filter, toplu okumalar için de Sync API kullanın. - Birden fazla şirket. Exact Online’daki her şirketin (division) kendine ait bir yolu ve izni vardır. Her tesisi ilgili şirketle eşleştirin.
- Serbest bırakılmış üretim emirleri. SkyPlanner’ın hangi durumdaki emirlerin tarihlerini değiştirebileceğini kararlaştırın: açık ve serbest bırakılmış emirler mi, yoksa yalnızca açık emirler mi?
- Tarihleri tek sistem yönetsin. Rota adımlarının tarihlerini SkyPlanner yönetmeye başladığında Exact Online’da tarihleri elle değiştirmeyi bırakın.
Exact Globe+
Exact Globe+, Exact’in Exact Globe+ iş ortakları aracılığıyla satılan ve devreye alınan ERP ürünüdür. Exact, ürününü “koppelt eenvoudig en snel met andere systemen” (diğer sistemlerle kolay ve hızlı bağlantı kurar) ifadesiyle tanımlar (Exact Globe+). SkyPlanner, Exact Globe+ üretim emirlerini de aynı şekilde çizelgeler: üretim emirleri, rotalar, kaynaklar ve stok verileri alınır; planlanan tarihler ve kaydedilen saatler geri gönderilir. Exact Globe+ iş ortağınız ile SkyPlanner ekibi, kapsam belirleme aşamasında arayüzü ve geri yazılacak nesneleri kararlaştırır.
Exact Online entegrasyonunu kim yapılandırır, kim destekler?
- SkyPlanner ekibi entegrasyonu devreye alma sırasında yapılandırır ve canlı kullanıma geçildikten sonra destek sağlar.
- Exact iş ortağınız da sürece katılabilir. İş ortağınız, kullandığınız sürümleri, şirketlerinizi ve üretim yapılandırmanızı bilir.
- Kendi geliştiricileriniz entegrasyonu genişletebilir. Bunun için SkyPlanner’ın dokümante edilmiş REST API arayüzünü kullanabilirler. Başlamak için bir API token yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur.
Bağlantı kurulduğunda Arcturus motoru, Exact Online’daki güncel üretim emirlerini çizelgeler ve planlanan tarihler her rota adımına işlenir. 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 teklif verilir; böylece başlamadan önce toplam maliyeti görürsünüz. Fiyatları ve özellikleri inceleyin; Exact Online’ın kendi planlamasıyla karşılaştırma için Exact Online’da üretim çizelgeleme sayfasına bakın. Genel bilgileri Exact Online sayfasında, diğer ERP’leri ise ERP entegrasyonları merkezinde bulabilirsiniz.
Üreticilerin SkyPlanner deneyimleri
Daha az malzeme eksikliği kaynaklı duruş
“SkyPlanner’ın bize kattığı değer, günlük kullanımda, özellikle teslim 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 çizelgelenmesi, teslim tarihlerinin daha doğru belirlenmesini sağlıyor. Malzeme eksikliğinden kaynaklanan üretim duruşları da büyük ölçüde azaldı.
1.000’lerce iş emri otomatik çizelgeleniyor
“Üretimi artık bambaşka bir şekilde kontrol altında tutuyoruz; kapasitemize ilişkin anlayışımız da tamamen farklı bir düzeyde.”
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 kuruluşun tamamı üretimi gerçek zamanlı olarak görebiliyor.
Sık sorulan sorular
Exact Online API, üretim emirlerini ve rota adımlarını kapsıyor mu?
Evet. Üretim hizmetinde ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations ve BOM kaynakları bulunur; bunların tümü okunabilir ve yazılabilir. Süreler TimeTransactions, tamamlanan miktarlar ise ShopOrderReceipts üzerinden işlenir.
Planlanan tarihler Exact Online’a nasıl geri yazılır?
SkyPlanner, çizelgeye yerleştirdiği veya çizelgede taşıdığı her adım için ShopOrderRoutingStepPlans kaynağına PlannedStartDate, PlannedEndDate ve Workcenter bilgilerini içeren bir PUT isteği gönderir. Üretim emrinin PlannedStartDate ve PlannedDate alanları da bu tarihlerle uyumlu olacak şekilde güncellenir.
Exact Online entegrasyonunu kim kurar?
SkyPlanner ekibi, devreye alma sürecinde çift yönlü entegrasyonu Exact Online yapılandırmanıza göre ayarlar ve canlıya geçişten sonra da destek sağlar. Exact iş ortağınız da sürece katılabilir. Kendi geliştiricileriniz de SkyPlanner’ın dokümantasyonu sunulan REST API’sini kullanarak entegrasyon geliştirebilir; başlamak için bir API belirteci yeterlidir.
Exact Online değişiklikleri gerçek zamanlı olarak gönderebilir mi?
Exact Online webhook’ları; ürünler, stok durumları, satın alma siparişleri ve satış siparişlerindeki değişiklikleri gönderir. Üretim emirleri ve rota adımları, filtrelenmiş isteklerle kısa aralıklarla okunur. Ters yönde ise SkyPlanner webhook’ları, çizelgedeki değişiklikleri gerçekleştikleri anda gönderir.
Entegrasyonu kurmadan önce SkyPlanner’ı deneyebilir miyiz?
Evet. 30 günlük ücretsiz deneme, üretim emirlerinizi CSV veya Excel dosyalarından içe aktararak 20 iş merkezine kadar kullanmanıza olanak tanır. Kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
