SkyPlanner APS ile Üretim Çizelgeleme için Sylob ERP Entegrasyon Rehberi

Sylob, herkese açık iki REST API’yi dokümante eder: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (Sylob ERP, veri okuma ve yazmaya olanak tanıyan iki tür herkese açık REST API, diğer adıyla web servisi sunar.) (Forterro bilgi tabanı)

1. API REST Système d’information (okuma). “Interroger le système d’information” etkinliğinde oluşturulup kaydedilmiş bir sorguyu (requête) çalıştırır. Sorguya ait çağrı URL’si, “Autres actions” > “Afficher le web service” yolundan alınır ve /rest/query/{identifiantQuery}/resultat biçimindedir. Parametreler; sonuç sınırını, sayı biçimini, sorgu değişkenlerini ve sonuç yapısını belirler. Sonuçlar varsayılan olarak XML biçiminde, Accept: application/json başlığıyla ise JSON biçiminde döner. Bu API, ERP’ye dahildir.
2. API REST Action (okuma ve yazma). Sylob’un eylem kataloğu olan “Gérer les actions web service” etkinliğinde tanımlanmış bir eylemi çalıştırır. İki işlem sunar: GET /rest/v2/action/{code}/describe bir eylemin veri şemasını döndürür; POST /rest/v2/action/{code}/execute ise eylemi JSON gövdesiyle çalıştırır. Eylem türleri şunlardır:

– Modification de données: Sylob’un hızlı düzenleme mekanizmasıyla bir kaydın bir veya daha fazla alanını değiştirir. Describe, düzenlenebilir alanları listeler. – Message EDI: EDI mesajı aracılığıyla kayıt oluşturur, değiştirir veya siler. – Scénario de saisie: bir veri giriş senaryosunu soru soru çalıştırır. Sylob’un kendi örneği olan “Déclarer un début ou une fin”, bir operasyonun başlangıcını veya bitişini bildirir (Sylob_Action_006). – Belgeleri yayımlama, yükleme ve indirme.

1. EDI mesajları. Sylob EDI motoru, dışa ve içe aktarma işlemlerini yürütür. Standart bir mesaj olan Sylob_Recup_Decl_Pro, üretim bildirimlerini getirir. (Forterro)
2. Dosyalar ve ETL. Sylob ERP Cloud şu olanağı sunar: “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Mevcut entegrasyonların kolayca taşınması için SFTP üzerinden dosya entegrasyonu.) (Sylob) Sorgu sonuçları Excel’e de aktarılabilir. Bu, SkyPlanner denemesine başlamanın hızlı yoludur.

Sylob’un herkese açık bilgi tabanında, dışarıya bildirim gönderen bir webhook aboneliği dokümante edilmemiştir. Değişiklikler, açık OF’leri ve son değişiklikleri filtreleyen kayıtlı sorguların belirlediğiniz aralıklarla çalıştırılmasıyla SkyPlanner’a ulaşır.

Sylob, ERP’yi yoğun sorgu yüküne karşı korur. 2025.Q2 sürümünden itibaren “Protection des API” adlı şirket parametresi, kullanıcı bazında istek sınırlamayı ve büyük sonuç kümelerinin sayfalanmasını etkinleştirir. Sylob, bu uygulamanın 2026.Q2 sürümünden itibaren standart hale geleceğini duyurmuştur. Yanıtlar RateLimit başlıklarını içerir. Kotayı aşan bir çağrı, Retry-After değeriyle birlikte HTTP 429 Too Many Requests yanıtını döndürür. (Forterro) Senkronizasyonu buna göre tasarlayın: yalnızca değişen verileri sorgulayın, sayfalama kullanın ve 429 yanıtında yeniden denemeden önce bekleme süresini artırın.

Diğer yönde ise SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Böylece Sylob’a geri yazma işlemi olaylara bağlı olarak gerçekleşir.

1. Ana verilerin ilk yüklemesi. Her nesne (articles, nomenclatures, gammes, iş merkezleri, çalışanlar) için bir kayıtlı sorgu oluşturun ve bunları Système d’information API üzerinden okuyun. Alternatif olarak verileri Excel çıktısından bir defaya mahsus yükleyin. İş merkezlerini dikkatle eşleyin. Sylob’daki centre de charge bir kaynak grubudur. Bu nedenle üç makineli bir merkez, SkyPlanner’da genellikle üç iş merkezinden oluşan bir iş merkezi grubuna karşılık gelir.

2. Sipariş senkronizasyonu. Kesinleşmiş OF’leri operasyonlarıyla birlikte, ayrıca stokları ve açık satın alma siparişlerini okuyun. 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. Böylece çizelgelemede hem mevcut stok hem de gelecek satın almalar kontrol edilir.

CBN önerilerini değil, kesinleşmiş OF’leri çizelgeleyin. Öneriler, bir sonraki net ihtiyaç hesaplamasında değişir.

3. Çizelgenin geri yazılması. Entegrasyon, motorun yerleştirdiği veya yerini değiştirdiği her operasyon için OF operasyonu (Opération d’ordre de fabrication) üzerinde bir Modification de données eylemi çağırır. Bu çağrı, planlanan başlangıç, planlanan bitiş ve iş merkezi bilgilerini içerir. Eylem, bir planlamacının operasyonu düzenlemesiyle aynı şekilde, Sylob’un kendi hızlı düzenleme mantığıyla çalışır. Describe, düzenlenebilir alanları döndürür; böylece entegrasyon ilk çağrıdan önce göndereceği verileri doğrular. Bir kullanıcının düzenlemekte olduğu kayıt, öngörülen bir hata yanıtı döndürür; bir sonraki değişiklikte yeniden deneyin.

4. Üretim sahası bildirimleri. Operatörler, çalışmalarını SkyPlanner Mobile Confirmations veya Production Timer ile kaydeder. Başlangıç ve bitiş bilgileri, “Déclarer un début ou une fin” senaryosu üzerinden geri aktarılır. Süre kayıtları ve miktarlar, aynı OF operasyonunda üretim bildirimlerine dönüşür: hazırlık süresi, işlem süresi, üretilen miktar, hurda ve operasyonun tamamlanması. Tesisinizde bildirimler zaten Sylob Apps veya üretim sahası terminalleri üzerinden yapılıyorsa, çift kayıtları önlemek için bildirimleri tek kanaldan yürütün.

5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bu kuralları yazılı olarak belirleyin:

SkyPlanner, CADPLAN’a veya Sylob’un makine ve personel kapasitesini dikkate alan üretim çizelgeleme işlevlerine ihtiyaç duymaz. Operasyon tarihlerinin yönetimini SkyPlanner’a bırakın; aynı tarihleri iki planlama sistemi yazarsa biri diğerinin verilerinin üzerine yazar. Bu tarihler SkyPlanner tarafından yönetilmeye başladığında Autopilot, her önemli değişiklikte çizelgeyi otomatik olarak yeniden oluşturur ve yeni tarihler Sylob’a geri aktarılır.

• Action API lisansı. Kayıtlı sorgular üzerinden okuma dahildir. Eylem kataloğu üzerinden yazma işlemleri için Sylob “Webservice” modülü veya MyForterro üzerinde bir API lisansı gerekir. Geri yazma aşamasından önce bunu Sylob yetkilinizle planlayın.
• Sorgular entegrasyonun sözleşmesidir. Okuma işlemleri kayıtlı sorgulara dayanır. Sorgulara anlaşılır adlar verin, filtreleri çalışma anında değişken öznitelikler olarak iletin ve sorguları entegrasyonla birlikte sürümleyin.
• İş merkezi grupları. Bir Sylob iş merkezi birden fazla makine içerebilir. SkyPlanner’da bunun bir iş merkezi grubu olarak mı yoksa ayrı makineler olarak mı görüneceğine her merkez için karar verin.
• Geriye doğru çizelgeleme ve yük hesaplamaları. Sylob, ihtiyaç tarihlerinden geriye doğru çizelgeleme yapar. Zamanlanmış bir yük hesaplaması da geciken OF’leri yeniden planlayabilir. Operasyon tarihleri SkyPlanner’ın yönetimine geçtikten sonra başka bir faaliyetin bu tarihleri yazmaya devam edip etmeyeceğini, edecekse hangisi olacağını kararlaştırın.
• Hazırlık ve işlem süresi birimleri. İçe aktarmadan önce birimleri ve hazırlık süresinin OF başına mı yoksa parça başına mı tanımlandığını kontrol edin. Yanlış birimler tüm süreleri hatalı hale getirir.
• Takvimler. İş merkezlerinin haftalık çalışma düzenleri ve istisnaları, çizelgeleme döneminin tamamını kapsamalıdır. Aksi halde kapasite planda görünmez.
• Çağrı sınırlaması. Sylob, kullanıcı başına çağrı sayısını sınırlar ve büyük sonuç kümelerini sayfalar. Yalnızca değişiklikleri düzenli olarak sorgulamak, kota sınırının oldukça altında kalmayı sağlar.
• CORS ve tarayıcılar. Sunucular arası çağrılar CORS kısıtlamalarına takılmaz. Tarayıcı istemcileri için Sylob tarafında izin verilen kaynakların yapılandırılması gerekir.