Entegrasyonlar / ERP / Lemonsoft
SkyPlanner APS ile Üretim Çizelgeleme için Lemonsoft Entegrasyon Rehberi
Bu Lemonsoft entegrasyon rehberi, iş ortaklarına ve BT ekiplerine Lemonsoft ERP ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, Lemonsoft’un REST API’si üzerinden Lemonsoft ile çift yönlü entegre olur:
- İş numaraları (työnumero), iş aşamaları (työvaihe), makineler, ürün yapıları, malzemeler ve planlanan vardiyalar SkyPlanner’a aktarılır.
- Planlanan başlangıç ve bitiş zamanları ile seçilen makine, iş aşamalarına geri yazılır.
- Operatör teyitleri, tamamlama kayıtları olarak geri gönderilir.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
Kaskea Group, SkyPlanner’ı çift yönlü Lemonsoft entegrasyonuyla kullanıyor. SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Lemonsoft yapılandırmanıza göre ayarlar ve canlıya geçişten sonra da destek sağlar. İş ortakları ve geliştiriciler, SkyPlanner’ın dokümante edilmiş REST API’sini kullanarak da geliştirme yapabilir (API referansı).
Lemonsoft’un REST API’si
Lemonsoft’un entegrasyon API’si LemonRest, Swagger 2.0 formatında v1 sürümü olarak dokümante edilmiştir. “LemonRest 2026.10 release-2026.10.2” derlemesinde 422 yol listelenir. (Swagger)
- Temel URL ortama göre değişir. Kullanıcı yönetiminde, ortam yönetimi ve servis adresleri bölümündeki Rest API alanında bulunur. Lemonsoft’un Azure platformunda temel adres
https://rest.lemon.fişeklindedir. - Kullanılabilirlik. Lemonsoft platform hizmeti (Alustapalvelu) müşterileri için REST API’leri önceden kuruludur; yalnızca kullanıcı yetkilerinin tanımlanması gerekir. (kaynak)
- Test ortamı. Son müşteri, test ortamını Lemonsoft Service Desk üzerinden talep eder.
Çizelgeleme için ayrı bir API olan Kellokortti zaman takip API’sine gerek yoktur.
Kimlik doğrulama
LemonRest, oturum tabanlı çalışır:
- UserName, Password, Database ve ApiKey ile yapılan
POST /api/auth/loginçağrısı birsession_iddöndürür. - Bu değeri her çağrıda
Session-Idbaşlığında gönderin. - Oturumu
POST /api/auth/renewile yenileyin. Sağlık kontrolü içinGET /api/auth/alivekullanılır.
POST /api/auth/login/token, kullanıcı adı ve parola yerine Token alır. Entegrasyona özel bir kullanıcı oluşturun; bu kullanıcıya bir API anahtarı ve yalnızca entegrasyonun gerektirdiği yetkileri verin. (kaynak)
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ın nasıl yapılacağını adım adım açıklar.
Değişiklikleri tespit etme: delta sorguları
LemonRest’te webhook veya abonelik uç noktaları yoktur. Değişiklikler delta sorgusuyla okunur:
GET /api/production/main_ws/changed?updated_after=..., son çalıştırmadan bu yana değişen işleri döndürür.optimization=trueekleyin. Bu parametre, günlük kayıtlarına bağımlılığı kaldırmak ve sorguyu hızlandırmak için 2026.6.3 sürümünde eklendi. (sürüm notları)GET /api/log/deletion_events, silinen işleri tespit eder; böylece iptal edilen işler çizelgeden çıkarılır.
Birkaç dakikada bir sorgulama yapın. SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir; dolayısıyla geri yazma işlemleri olay odaklı çalışır.
Veri eşleme
| Lemonsoft nesnesi (uç nokta) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Tuote, product_code (/api/products) | Ürünler ve malzemeler | Lemonsoft → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
Työvaiheet satırlarını içeren Tuoterakenne (/api/products/structure, all_levels) | Ürün yapısı, alt ürünler, hazırlık süreleriyle birlikte işlem adımları | Lemonsoft → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | İş merkezleri, iş merkezi grupları | Lemonsoft → SkyPlanner | İlk yüklemede, sonrasında nadiren |
ProductMainWorkStage olarak Työnumero (/api/production/workstage, main_ws/changed) | Termin tarihleri ve öncelikleriyle birlikte siparişler | Lemonsoft → SkyPlanner | Birkaç dakikada bir delta sorgulaması |
ProductSubWorkStage olarak Työvaihe (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | İş merkezi bazında işler (işlem adımları) | Lemonsoft → SkyPlanner | Birkaç dakikada bir delta sorgulaması |
Bileşen ihtiyacı (main_ws/{worknumber}/materials) | İş bazında malzeme ihtiyaçları | Lemonsoft → SkyPlanner | Her işle birlikte |
Planlanan vardiyalar (/api/persons/plannedshifts) | Vardiyalar, personel | Lemonsoft → SkyPlanner | Günlük aktarım; alternatif olarak vardiyalar SkyPlanner’da tutulur |
İş numarasına bağlı satış siparişi (/api/orders/work/{work_number}) | Müşteri ve öncelik bilgileri | Lemonsoft → SkyPlanner | Her işle birlikte |
Työvaihe alanları: start_time, end_time, machine_id (PUT /api/production/workstage) | Planlanan başlangıç, bitiş ve iş merkezi | SkyPlanner → Lemonsoft | Çizelge değiştiğinde, SkyPlanner webhook’u aracılığıyla |
Tamamlama kaydı (POST main_ws/sub_ws/completion_entry) | Teyitler: tamamlanan ve hatalı miktar, saat, kişi | SkyPlanner → Lemonsoft | Her teyitte |
| SkyPlanner’da tanımlanan çizelgeleme kuralları | Her iş için izin verilen iş merkezleri, hazırlık süresi matrisi, takımlar | SkyPlanner’da yönetilir | Devreye alma sırasında yapılandırılır |
Entegrasyon yöntemleri
1. Ana verilerin ilk yüklemesi. Makineleri ve makine gruplarını, iş aşamalarıyla birlikte ürün yapılarını ve standart iş aşamalarını okuyun. Her bir fiziksel makineyi bir SkyPlanner iş merkeziyle eşleyin. Üst makineler (Isäkone), alt makinelerin kapasitelerini topladığı için bunları yalnızca gruplama amacıyla kullanın.
2. İş numaralarının eşitlenmesi. Açık iş numaralarını aşamalarıyla birlikte /api/production/workstage veya main_ws/sub_ws üzerinden, duruma göre filtreleyerek ve sayfalama kullanarak okuyun. Ardından main_ws/changed ile güncel tutun. Lemonsoft kalan miktara göre çizelgeleme yaptığı için work_amount yerine work_amount_left alanını eşleyin. Satın alma siparişleri, SkyPlanner’ın malzeme odaklı çizelgelemesine veri sağlar; böylece iş aşaması, satın alma siparişinin teslim tarihini bekler.
3. Çizelgenin geri yazılması. SkyPlanner, motorun yerleştirdiği veya taşıdığı her aşama için işi ve ona ait sub_workstages verilerini PUT /api/production/workstage ile gönderir. Her aşamada start_time ve end_time bulunur; aşama alternatif bir makineye taşındıysa machine_id de gönderilir.
4. Üretim sahasından teyitler. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile iş teyidi verir. Her teyit, sub_workstage_id, person_number, done_amount, hours, failed_amount ve job_done alanlarıyla completion_entry uç noktasına gönderilir. Aşamada malzeme tüketiliyorsa teyitle birlikte material_consumptions verisini de gönderin; Lemonsoft normal bir üretim tamamlama kaydı (valmistuskirjaus) oluşturur.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bu kuralları yazılı olarak belirleyin:
| Veri | Sorumlu sistem |
|---|---|
| Ürünler, yapılar, iş aşamaları, miktarlar, iş durumu | Lemonsoft |
| Aşama sırası, başlangıç ve bitiş zamanları, makine seçimi | SkyPlanner |
| Her iş için izin verilen iş merkezleri, hazırlık süresi matrisi, takımlar | SkyPlanner |
| Vardiyalar ve devamsızlıklar | Kapsam belirleme sırasında seçilen tek bir sistem |
| Tamamlama ve stok kayıtları | Lemonsoft; kayıtlar SkyPlanner teyitlerinden oluşturulur |
Çakışmaların başlıca kaynağı, Lemonsoft’un kendi otomatik çizelgelemesi ve yenileme işlemidir: her ikisi de kilitlenmemiş aşamaları yeniden yerleştirir. Çizelgeyi SkyPlanner yönettiği sürece AUTOTIMING değerini 0 olarak tutun. Açık bırakırsanız geri yazılan her iş numarası için çizelge kilidini etkinleştirin; bu kilit, o numaranın tüm aşamalarını sabitler. Koneiden kapasiteetin lukitus tek başına yeterli değildir; otomatik çizelgeleme, kilitlenmemiş işleri kilitli bir günden başka bir güne taşır. (kaynak)
Tipik proje adımları
Uygulama, devreye alma sürecinin başlamasından sonra genellikle birkaç hafta içinde tamamlanır. Öncesindeki 30 günlük ücretsiz denemede, iş numaralarını, aşamaları ve makineleri Excel’e aktararak kendi verilerinizle çalışırsınız.
- Kapsam belirleme. Eşleme tablosunu, veri sahipliği kurallarını ve sorgulama aralığını kesinleştirin.
- Erişim. Son müşteri, Lemonsoft Service Desk üzerinden bir test ortamı talep eder ve entegrasyon kullanıcısını ve API anahtarını oluşturur.
- İlk yükleme. Makineler, gruplar, ürün yapıları ve iş aşamaları.
- İş numaralarının eşitlenmesi. Delta sorgulaması, silme olayları ve oturum yenileme.
- SkyPlanner’da kısıtların tanımlanması. Her iş için kullanılabilecek iş merkezleri, hazırlık süresi matrisi ve takımlar.
- Geri yazma. Aşamaların başlangıç ve bitiş zamanları ile tamamlama kayıtları; test ortamında doğrulanır.
- Paralel çalışma ve canlıya geçiş. Mevcut Gantt çizelgesiyle karşılaştırın, ana verileri düzeltin, ardından canlı ortamda geri yazmayı etkinleştirin.
Lemonsoft entegrasyonunda dikkat edilmesi gerekenler
- Her aşamada bir makine. Lemonsoft’ta her aşamaya bir makine atanır. Her ürün için hangi makinelerin kullanılabileceği, devreye alma sırasında bir listeden veya ürün özelliklerinden alınır. SkyPlanner da bu alternatifler arasından seçim yapar.
- Günlük kapasite. Sabit kapasite günlük miktar olarak tanımlanır; sapmaların saat bilgisi yoktur. Gerçek vardiyaları SkyPlanner’da modelleyin veya planlanmış vardiyaları okuyun.
- Kalan miktar.
work_amount_leftalanını eşleyin. STARTJOB_AUTOTIMENOW ve JOBDONE_AUTOTIMENOW ayarları, Lemonsoft’un kendi kapasite yükünü de zaman içinde kaydırır. - Oturumların süresi dolar. Uzun eşitleme işlemlerinden önce oturumu yenileyin ve zorunlu yeniden giriş durumunu yönetin.
- Teyit kuralları. Her teyidi göndermeden önce aşamanın durumuna göre doğrulayın ve yoğun çağrıları zamana yayın.
- İki istemci. LemonOnline ve Windows sürümü aynı veritabanını kullanır; bu nedenle entegrasyon her ikisine de hizmet verir.
- Büyük ürün yapıları. Büyük hacimli içe aktarımlarda
/api/async/product/structureile/api/async/status/{jobId}uç noktalarını birlikte kullanın.
Lemonsoft entegrasyonunu kim yapılandırır ve desteğini kim sağlar?
Çalışma; makineleriniz, iş aşamalarınız ve Lemonsoft yapılandırmanız için gereken eşlemeleri kapsar. SkyPlanner’da yönettiğiniz çizelgeleme kuralları da buna dahildir: her iş için kullanılabilecek iş merkezleri, hazırlık süresi matrisi ve takımlar.
- SkyPlanner ekibi, entegrasyonu devreye alma sırasında yapılandırır ve canlıya geçişten sonra destek sağlar. Her tesis Lemonsoft’u farklı kullanır; tesise özgü bu bilgi yapılandırmaya yansıtılır.
- Lemonsoft iş ortağınız da sürece katılabilir. İş ortağınız mevcut yapılandırmanızı bilir; API kullanıcısını, yetkileri ve test ortamını yönetebilir. SkyPlanner, REST API, Swagger/OpenAPI dokümantasyonu ve webhook’lar sunar.
- 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; SkyPlanner ekibi gerektiğinde yardımcı olur.
Bağlantı kurulduğunda Arcturus motoru, Lemonsoft’taki güncel iş numaraları üzerinden çizelgeleme yapar ve planlanan zamanlar iş aşamalarına aktarılır. SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlayan fiyatlarla sunulur ve aylık faturalandırılır. Sürecinize ve ihtiyaçlarınıza uygun entegrasyon teklifi, paketinizle birlikte önceden hazırlanır; böylece başlamadan önce toplam maliyeti görürsünüz.
Lemonsoft’un kendi planlama özelliklerinin karşılaştırmasını Lemonsoft üretim çizelgeleme sayfasında inceleyin. Genel bakış için Lemonsoft sayfasına, diğer sistemler için ERP entegrasyonları sayfasına göz atın.
Üreticilerin SkyPlanner yorumları
LemonsoftSkyPlanner ile çift yönlü entegrasyon
Kaskea Group
Fason üretim: CNC işleme, çelik yapılar ve montaj
Üretim, Lemonsoft ile çift yönlü entegrasyon üzerinden SkyPlanner’da planlanıyor.
Malzeme eksikliğine bağlıdaha az duruş
“SkyPlanner’ın bize kattığı değer, günlük kullanımda, özellikle teslimat 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 daha doğru teslimat tarihleri sağlıyor; malzeme eksikliğinden kaynaklanan üretim duruşları da önemli ölçüde azaldı.
2 saathaftalık 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 ekipmanları
Üretim planlamasında her hafta 2 saat çalışma süresinden tasarruf ediliyor ve yeni iş sırası saniyeler içinde üretim hattına ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, BT Yöneticisi
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan üç aylık optimize edilmiş bir plan, 30 dakikadan kısa sürede hazırlanıyor.
Sık sorulan sorular
Lemonsoft’un üretim verileri için bir API’si var mı?
Evet. LemonRest; üretim işlerine, iş aşamalarına, makinelere, ürün yapılarına, malzemelere ve vardiyalara erişim sağlar, tamamlanma kayıtlarının gönderilmesini destekler. Alustapalvelu müşterileri için önceden kuruludur; bir API anahtarı ve kullanıcı yetkileri gerektirir.
Lemonsoft webhook’ları destekliyor mu?
LemonRest’te listelenen bir webhook uç noktası yoktur. Değişiklikler, birkaç dakikada bir yapılan sorgulamayla main_ws/changed delta sorgusu ve silme olayları üzerinden okunur. SkyPlanner’ın kendi webhook’ları ise çizelgedeki değişiklikleri gerçekleştiği anda iletir.
Planlanan zamanlar Lemonsoft’a nasıl geri yazılır?
PUT /api/production/workstage ile işin ve iş aşamalarının başlangıç zamanı, bitiş zamanı ve makine bilgileri güncellenir. Zamanların SkyPlanner’ın belirlediği gibi kalması için çizelgeyi SkyPlanner yönetirken Lemonsoft’un otomatik çizelgelemesini kapalı tutun veya geri yazılan her iş numarasında çizelge kilidini etkinleştirin.
SkyPlanner’daki operatör teyitleri Lemonsoft’a gönderilebilir mi?
Evet. Her teyit; tamamlanan ve hatalı miktar, saat ve kişi bilgileriyle bir tamamlanma kaydı olarak gönderilir. Bu işlem müşteri projelerinde her gün kullanılıyor.
Lemonsoft entegrasyonunu kim kurar?
SkyPlanner ekibi, devreye alma sırasında çift yönlü entegrasyonu Lemonsoft yapılandırmanıza göre ayarlar ve canlıya geçişten sonra destek sağlar. Lemonsoft iş ortağınız veya kendi geliştiricileriniz de SkyPlanner’ın dokümante edilmiş REST API’sini kullanarak geliştirme yapabilir. Başlamak için bir API belirteci yeterlidir.
Entegrasyonu kurmadan önce SkyPlanner’ı deneyebilir miyiz?
Evet. 30 günlük ücretsiz deneme, Lemonsoft’tan Excel veya CSV ile veri aktararak 20 iş merkezine kadar kullanım sağlar; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
