Entegrasyonlar / ERP / Sage 200
SkyPlanner APS ile Üretim Çizelgeleme için Sage 200 Entegrasyon Rehberi
Bu Sage 200 entegrasyon rehberi, iş ortaklarına ve BT ekiplerine Sage 200 Professional ile üretim eklentisini SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, Sage 200 ile çift yönlü entegre olur:
- Ürünler, depo stokları, satın alma siparişleri ve satış siparişleri Sage 200 REST API üzerinden alınır.
- İş emirleri, operasyonlar, iş gücü ve makine kaynakları üretim eklentinizden alınır.
- Planlanan operasyon tarihleri iş emirlerine geri yazılır.
- Operatörlerin süre kayıtları, her operasyona süre işlemek için geri gönderilir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Sage 200 kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destek verir. Bu rehber, sürece katılmak veya SkyPlanner’ın dokümante edilmiş REST API’sini (API referansı) kullanarak kendileri geliştirme yapmak isteyen iş ortakları ve geliştiriciler içindir.
Tek bir Sage 200 sisteminde iki kaynak
Üretimde kullanılan bir Sage 200 kurulumu iki katmandan oluşur; entegrasyon her ikisinden de veri okur.
1. Ticari veriler ve stok verileri için Sage 200 REST API. Sage, API’nin “lets your application read and modify data in a Sage 200 site” (uygulamanızın kurulumdaki verileri okumasını ve değiştirmesini sağlar) işlevini sunduğunu belirtir. Bu kapsamda müşteriler, tedarikçiler, ürünler, satış ve satın alma siparişleri ile muhasebe hesapları yer alır. Sage 200 Professional referansı (2025.02), kaynakları Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP ve Stock başlıkları altında gruplar. Çizelgeleme açısından önemli kaynaklar şunlardır:
| Kaynak | İçerdiği veriler |
|---|---|
products | Kod, ad, stok birimi, BOM kalem türü, standart maliyet |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Açık satın alma siparişleri, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Müşteri talebi, requested_delivery_date, promised_delivery_date |
warehouses, units | Tesisler ve ölçü birimleri |
2. İş emirleri için üretim eklentisi. Sage 200 API’de iş emri, operasyon veya kaynak uç noktaları bulunmaz. İş emirleri Sicon Works Order Processing, Cim200 veya eski Sage 200 Manufacturing modülünde tutulur. Entegrasyon; iş emirlerini, operasyonları ve kaynakları eklentinin desteklediği yöntemle okur. Bu yöntem, kapsam belirleme aşamasında sizinle ve Sage 200 iş ortağınızla birlikte kararlaştırılır.
Kimlik doğrulama ve erişim
Sage 200 API, “uses OAuth 2.0 with OpenID Connect” (OpenID Connect ile OAuth kullanır) ve authorization code grant akışını uygular. Oturum açma işlemi Sage ID üzerinden yürütülür.
- Sage 200 API Developer Programme’a katılın ve erişim bilgilerini talep edin.
- Bir Sage ID’yi, kullandığınız uç noktalar için gerekli şirket ve özellik erişimine sahip bir Sage 200 kullanıcısıyla eşleştirin.
offline_accesskapsamını talep edin; aksi takdirde yenileme belirteci verilmez.- Her veritabanı isteğinde
Authorization: Bearer <access_token>,X-SiteveX-Companygönderin. Her iki kimlik de/sitesüzerinden alınır.
Sage 200 Professional için temel URL: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. İsteklerde GET, POST, PUT ve DELETE yöntemleri ile $filter, $select, $top, $skip, $orderby ve $expand OData sorgu seçenekleri kullanılır.
Sage 200 Professional’da API’yi müşterinin destek sağlayıcısı etkinleştirir. Sage’in kontrol listesine göre destek sağlayıcısı, “the API is enabled” (API’nin etkin olduğunu) ve “each required user has a Sage ID assigned.” (gerekli her kullanıcıya bir Sage ID atandığını) doğrular. Sage 200 Standard’da API varsayılan olarak etkindir.
Belirteçlerin geçerlilik süreleri entegrasyon tasarımını şekillendirir. Erişim belirteçleri 8 saat geçerlidir. Yenileme belirteçlerinin geçerlilik süresi 1 ile 90 gün arasındadır: “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (Yenileme süresi, son yenilemeden değil, kullanıcının ilk oturum açışından itibaren hesaplanır.) Sage, yeniden kimlik doğrulamanın “is unavoidable” (kaçınılmaz olduğunu) belirtir. Süre dolmadan önce yeniden izin alınması için bir uyarı planlayın.
SkyPlanner tarafında REST API, kimlik doğrulama için API belirteci kullanır (SkyPlanner Settings > API) ve Swagger/OpenAPI ile dokümante edilmiştir. Entegrasyon kılavuzu ilk çağrıları adım adım açıklar.
Değişikliklerin tespiti
Sage 200 API referansında webhook veya abonelik kaynağı bulunmaz. Değişiklikler periyodik sorgularla tespit edilir. Kayıtlarda date_time_created ve date_time_updated alanları bulunur. Bu nedenle her sorguda date_time_updated alanına $filter ile filtre uygulanır, $top ve $skip ile sayfalama yapılır.
İş emirlerini birkaç dakikada bir, stok ve satın alma siparişi satırlarını ise saatte bir sorgulayın. SkyPlanner, çizelge değiştiğinde webhook gönderir; böylece geri yazma işlemi olay bazlı çalışır.
Veri eşleme
| Sage 200 nesnesi (kaynak) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
products, units (API) | Ürünler ve malzemeler | Sage 200 → SkyPlanner | İlk yükleme, ardından periyodik sorgulama |
| BOM bileşenleri (eklenti veya BOM modülü) | Ürün yapısı, alt ürünler, ürün başına malzemeler | Sage 200 → SkyPlanner | Değişiklik olduğunda |
| İş gücü ve makine kaynakları, kaynak grupları (eklenti) | İş merkezleri, iş merkezi grupları, personel | Sage 200 → SkyPlanner | İlk yükleme |
| Kaynak kullanılabilirliği: duruş, bakım, tatil (eklenti) | Vardiyalar, devamsızlıklar | Sage 200 → SkyPlanner | Günlük |
| İş emirleri ve operasyonları, operasyon başına süreler (eklenti) | Adımları, süreleri ve termin tarihleriyle birlikte siparişler ve işler | Sage 200 → SkyPlanner | Birkaç dakikada bir |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Müşteri teslim tarihleri | Sage 200 → SkyPlanner | Periyodik sorgulama |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Stok bakiyeleri | Sage 200 → SkyPlanner | Saatte bir |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Beklenen teslim tarihiyle birlikte satın alma siparişleri | Sage 200 → SkyPlanner | Saatte bir |
| İş emri operasyonunun planlanan başlangıcı, bitişi ve kaynağı | Her operasyon için planlanan başlangıç, bitiş ve iş merkezi | SkyPlanner → Sage 200 | Değişiklik olduğunda, webhook üzerinden |
| Operasyona süre işleme (eklenti) | Süre kayıtları ve operatör bildirimleri | SkyPlanner → Sage 200 | Her bildirimde veya vardiya başına |
| SkyPlanner kısıt verileri | Hazırlık süresi matrisi, sınırlı kaynak olarak takımlar, alternatif makineler ve personel | SkyPlanner’da yönetilir | Devreye alma sırasında |
Entegrasyon akışları
1. Ana verilerin ilk yüklemesi. Ürünleri ve birimleri API’den, ardından kaynakları, kaynak gruplarını ve BOM operasyonlarını eklentiden alın. Üç özdeş makineden oluşan bir kaynak grubu, bir iş merkezi grubu veya üç iş merkezi olarak tanımlanabilir.
2. Sipariş senkronizasyonu. Açık iş emirlerini operasyonlarıyla birlikte eklentiden, açık pop_order_lines kayıtlarını ve warehouse_holdings verilerini ise API’den okuyun. Çizelgelemede hem stok hem de teslim alınacak satın alma siparişleri kontrol edilir. MRP, Sage 200’de iş emri önermeye devam eder; SkyPlanner ise oluşturduğunuz iş emirlerini çizelgeler.
3. Çizelgenin geri yazılması. SkyPlanner, motorun çizelgeye yerleştirdiği veya yerini değiştirdiği her operasyon için planlanan başlangıcı, bitişi ve kaynağı iş emrine geri gönderir. Eklenti kendi miktarlarını, tahsislerini ve maliyet hesaplamalarını korur.
4. Shop floor bildirimleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder; bu süre kayıtları çizelgeyi güncel tutar. Kaydedilen süre, iş emri operasyonuna işlenen süre olarak geri gönderilir. Böylece Sage 200’deki maliyet hesaplamaları gerçekleşen çalışma saatlerini kullanır.
Tesisinizde süreler zaten Sicon Shop Floor Data Capture veya Cim200 Shop Floor Data Capture ile kaydediliyorsa tek bir kayıt kanalı seçin.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı olarak belirleyin:
| Veri | Sahibi |
|---|---|
| Ürünler, BOM’lar, iş emri miktarları, tahsisler, maliyetler | Sage 200 ve eklenti |
| Operasyon sırası, başlangıç ve bitiş zamanları, iş merkezi ataması | SkyPlanner |
| Hazırlık süresi matrisi, takım ve operatör gereksinimleri, alternatif kaynaklar | SkyPlanner |
| Süre kaydı | SkyPlanner süre kayıtlarıyla beslenen Sage 200 |
Çakışmaların başlıca kaynağı kapasite grafiğidir. Planlamacılar Sicon Rough Cut Capacity Planning veya Cim200 Graphical Scheduler içinde iş emirlerini ya da operasyonları sürüklemeye devam ederse tarihleri iki sistem birden yönetir. Operasyon tarihlerinin yönetimini SkyPlanner’a bırakın. Autopilot ile SkyPlanner, üretimde değişiklik olduğunda çizelgeyi otomatik olarak yeniden oluşturur.
Tipik proje adımları
Uygulama genellikle devreye alma süreci başladıktan sonra birkaç hafta içinde tamamlanır. Öncesinde, açık iş emirlerinizi CSV veya Excel olarak dışa aktarın ve 30 günlük ücretsiz deneme sırasında çizelgeyi doğrulayın. Ardından proje şu adımlarla ilerler:
- Kapsam belirleme. Eklentiyi ve sürümünü, iş emirlerini okuma yöntemini, geri yazma yöntemini, senkronizasyon sıklıklarını ve süre kayıtlarının hangi kanaldan aktarılacağını netleştirin.
- API erişimi. Destek sağlayıcısı Sage 200 API erişimini etkinleştirir, bir Sage ID’yi bir Sage 200 kullanıcısıyla eşleştirir ve şirketlere ve özelliklere erişim yetkilerini ayarlar.
- İlk veri yüklemesi. Ürünler, birimler, kaynaklar, kaynak grupları, BOM operasyonları ve kullanılabilirlik bilgileri yüklenir.
- Sipariş senkronizasyonu. İş emirleri, satın alma siparişi satırları ve stoklar periyodik sorgulamayla senkronize edilir; yeniden onay uyarısı da bu aşamada eklenir.
- 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 tanımlanır.
- Çizelgenin geri yazılması. Planlanan operasyon tarihleri iş emirlerine yazılır; süre kaydı da bu aşamada eklenir.
- Paralel test ve canlıya geçiş. Tarihleri mevcut planla karşılaştırın, ana verileri düzeltin, ardından geri yazmayı etkinleştirin.
Sage 200 entegrasyonunda nelere hazırlıklı olmalısınız?
- Yeni sürümde kullanımdan kaldırılan modül. Eski Sage 200 Manufacturing modülü, Sage 200 Professional 2025 R2 sürümünden itibaren kullanılamaz. Herhangi bir eşleştirme yapmadan önce canlıya geçişte hangi üretim çözümünün kullanılacağını netleştirin.
- Maliyet verilerinden hesaplanan operasyon süreleri. Sicon MRP, işçilik ve makine sürelerini Sage 200 BOM maliyet kalemlerinden tahmin eder. Önce bu süreleri gerçek çalışma süreleriyle karşılaştırın.
- Maliyet başlıklarındaki uyumsuzluklar. Sage, BOM operasyonları ile maliyet başlıklarındaki Nominal, Overhead Nominal ve Overhead Recovery % değerlerinin eşleşmesi gerektiği konusunda uyarır. Aksi takdirde “there will be cost discrepancies.” (maliyet farklılıkları oluşacaktır).
- Yenileme süresi. En fazla 90 gün olan süre, ilk oturum açıldığı andan itibaren sayılır. Hiç yeniden onay alınmayan bir entegrasyon, her üç aylık dönemde aynı gün durur.
- Birden fazla şirket içeren kurulumlar. Bir kurulumda birden fazla şirket bulunabilir. Bu nedenle her istekte doğru
X-Companydeğerini gönderin.
Sage 200 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.
- Sage 200 iş ortağınız da sürece katılabilir. İş ortağınız kullandığınız eklentiyi tanır ve Sage 200 Professional üzerinde API erişimini etkinleştirir.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için aynı dokümante edilmiş REST API’yi bir API belirteciyle kullanabilirler. Başlamak için bir API belirteci yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur.
Bağlantı kurulduktan sonra Arcturus motoru, Sage 200’deki güncel iş emirlerine göre çizelge oluşturur ve planlanan tarihler iş emri operasyonlarına aktarılır. SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık olarak faturalandırılır. Entegrasyon için sürecinize ve ihtiyaçlarınıza göre hazırlanan fiyat teklifi, abonelik planınızla birlikte önceden sunulur. Böylece başlamadan önce toplam maliyeti görürsünüz. Fiyatlandırmayı ve özellikleri inceleyin; Sage 200’ün kendi planlama araçlarıyla karşılaştırma için Sage 200 ile üretim çizelgeleme sayfasına bakın. Genel bilgileri Sage 200 sayfasında, diğer ERP sistemlerini ise ERP entegrasyonları sayfasında bulabilirsiniz.
Üreticilerin SkyPlanner yorumları
2 saathaftalık zaman tasarrufu
“SkyPlanner sayesinde üretim planlamamızı Excel tablolarından gerçek zamanlı üretim optimizasyonuna taşıdık.”
Kalle Kalliomäki, Tedarik Zinciri Uzmanı
UTU · Elektrik panoları ve şalt ekipmanları
Üretim planlamasında her hafta 2 saatlik çalışma süresinden tasarruf sağlanıyor ve yeni iş sırası saniyeler içinde üretim hattına ulaşıyor.
1.000’lerceiş emri otomatik çizelgeleniyor
“Üretimi artık bambaşka bir şekilde kontrol altında tutuyoruz ve kapasitemize ilişkin bilgimiz 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 tüm kuruluş üretimi gerçek zamanlı olarak görebiliyor.
Sık sorulan sorular
Sage 200 API iş emirlerini kapsıyor mu?
Hayır. Sage 200 Professional API; ürünler, stoklar, satış ve satın alma siparişleri, finans ve daha fazlasını kapsar ancak iş emri veya operasyon kaynakları içermez. İş emirleri, kapsam belirleme aşamasında kararlaştırılan yöntemle Sicon Works Order Processing veya Cim200 gibi üretim eklentinizden alınır.
Sage 200 entegrasyonunu kim kurar?
SkyPlanner ekibi, devreye alma sürecinde çift yönlü entegrasyonu Sage 200 kurulumunuza göre yapılandırır ve canlıya geçişten sonra destek sağlar. Sage 200 iş ortağınız API erişimini etkinleştirir ve sürece katılabilir. Kendi geliştiricileriniz de SkyPlanner’ın dokümante edilmiş REST API’sini kullanarak geliştirme yapabilir; başlamak için bir API belirteci yeterlidir.
Sage 200 değişiklikleri gerçek zamanlı olarak gönderebilir mi?
Sage 200 API webhook desteği sunmaz. Stoklar ve satın alma siparişleri date_time_updated alanına göre periyodik olarak sorgulanır; iş emirleri ise eklentinizden birkaç dakikada bir okunur. Ters yönde, SkyPlanner’ın kendi webhook’ları çizelge değişikliklerini gerçekleştiği anda gönderir.
Entegrasyonu kurmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, iş emirlerinizi CSV veya Excel olarak içe aktararak en fazla 20 iş merkeziyle çalışmanızı sağlar; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
