Entegrasyonlar / ERP / Visma L7
Üretim çizelgeleme için Visma L7 APS entegrasyon rehberi
Bu Visma L7 entegrasyon rehberi, iş ortaklarına ve BT ekiplerine Visma L7’yi SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, Visma L7 REST API üzerinden Visma L7 ile çift yönlü entegre olur:
- İş numaraları (työnumero), iş aşamaları (työnvaihe), kaynaklar, ürün yapıları, parçalar, malzemeler, stok bakiyeleri, satış satırları ve satın alma satırları SkyPlanner’a aktarılır.
- Her iş kartının kaynağı, başlangıç tarihi, önceliği, atanan kişisi ve günlük çalışma saatleri
PUT /manufphases/ile geri yazılır. - Kaynak takvimindeki kapasite
POST /resourceupdates/ile eşitlenir. - L7 iş kuyruklarına kaydedilen üretim olayları
GET /manufevents/ile geri okunur. - SkyPlanner webhook’ları, çizelge değişikliklerini gerçekleştiği anda iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu L7 kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destek verir. İş ortakları ve geliştiriciler, SkyPlanner’ın belgelenmiş REST API’sini kullanarak da geliştirme yapabilir (API referansı).
Visma L7’nin REST API’si
Kullanılan API, OpenAPI 3.0.3 biçiminde belgelenen ve değişiklik günlüğü sunulan Visma L7 – REST API‘dir (dokümantasyon). Visma LTR üzerinde çalışır.
- Temel yol, kendi LTR sunucunuzda
/ltrws/REST/L7şeklindedir. Sunucu, şirket içinde veya Visma’nın uygulama barındırma hizmetinde olabilir. - Lisanslama. Her uç nokta ayrı lisanslanır. Çizelgeyi yazmak için
PUT /manufphases/uç noktasına ait L7RMFPP lisansı, kapasite güncellemeleri içinse L7RMCAP gerekir. Okuma uç noktalarının da ayrı lisansları vardır. - Sayfalama. Listeler
pageSizeverecAfterile sayfalanır;queryKey1,queryKey2vequeryStringile filtrelenir.
Kimlik doğrulama
Her L7 çağrısında iki token gönderilir:
- hash, veritabanını ve şirketi seçer.
- token, API kullanıcısını tanımlar.
LTR yöneticiniz, Visma LTR’de API kullanıcısını oluşturur, L7 şirketine bağlar, profilleri atar ve kullanıcı token’ını oluşturur (başlangıç rehberi). Yalnızca entegrasyonun ihtiyaç duyduğu yetkilere sahip, entegrasyona özel bir kullanıcı kullanın.
SkyPlanner tarafında REST API, Authorization-Token başlığında gönderilen API token’ı ile kimlik doğrular. Bu token’ı Settings > API bölümünde oluşturabilirsiniz. Entegrasyon eğitimi, ilk çağrıları adım adım açıklar.
Değişiklikleri algılama: modifiedAfter
L7 REST API, webhook sunmaz. Değişiklikler düzenli sorgulamayla okunur:
- L7 dosya bakımı (Tiedostohuolto) bölümünde, iş kartları ve parçalar gibi entegrasyonun okuduğu tablolar için değişiklik kaydını (DBLOG) etkinleştirin.
- Okuma uç noktalarını,
modifiedAfterdeğerini son çalıştırma zamanına ayarlayarak çağırın. Silinen kayıtlar silinmiş olarak işaretlenerek döner; böylece iptal edilen işler çizelgeden çıkarılır. - Birkaç dakikada bir sorgulayın. SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir; bu nedenle geri yazma tarafı olay güdümlü çalışır.
Veri eşleme
| Visma L7 nesnesi (uç nokta) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Tuote (GET /products/) | Ürünler ve malzemeler | L7 → SkyPlanner | İlk yüklemede, ardından değişiklik olduğunda |
İş numarasına ait parçalar (GET /manufcomponents/) | Alt ürünler | L7 → SkyPlanner | modifiedAfter ile düzenli sorgulama |
Malzeme ihtiyaçları (GET /manufmaterials/) | İş bazında malzeme ihtiyaçları | L7 → SkyPlanner | modifiedAfter ile düzenli sorgulama |
Makine sayısını içeren kaynak (KRYH) ağacı (GET /manufresources/) | İş merkezleri ve iş merkezi grupları | L7 → SkyPlanner | İlk yükleme, sonrasında nadiren |
Aşama bazında iş kartı (TSUUNR) (GET /manufphases/) | İş merkezi bazında işler (süreç adımları) | L7 → SkyPlanner | Birkaç dakikada bir sorgulama |
Stok bakiyeleri (GET /stockbalances/) | Stok | L7 → SkyPlanner | Düzenli sorgulama |
Satın alma satırları (GET /purchaserows/) | Teslimat tarihleriyle birlikte satın alma siparişleri | L7 → SkyPlanner | Düzenli sorgulama |
Satış siparişleri ve satırları (GET /salesorders/, GET /salesrows/) | Termin tarihleri, müşteri önceliği | L7 → SkyPlanner | Düzenli sorgulama |
Üretim olayları (GET /manufevents/) | İş bazında ilerleme | L7 → SkyPlanner | Düzenli sorgulama |
İş kartının resource, startDate, priority, person, schedulingDays alanları (PUT /manufphases/) | Planlanan iş merkezi, başlangıç, sıralama ve günlük çalışma saatleri | SkyPlanner → L7 | Çizelge değiştiğinde, SkyPlanner webhook’u üzerinden |
Kaynak takvimindeki kapasite (POST /resourceupdates/) | Vardiya kapasitesi | SkyPlanner → L7 | Vardiyalar değiştiğinde |
| SkyPlanner’da tanımlanan çizelgeleme kuralları | İzin verilen iş merkezleri, hazırlık süresi matrisi, takımlar, personel | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon modelleri
1. Ana verilerin ilk yüklemesi. Kaynak ağacını okuyun ve her makineyi SkyPlanner’da ayrı bir iş merkeziyle eşleyin. Bir L7 kaynağı birden fazla makine içeriyorsa her makine için bir iş merkezi, kaynak için de bir iş merkezi grubu oluşturun. Ürünleri ve ürün yapılarını iş aşamalarıyla birlikte okuyun.
2. İş numaralarının eşitlenmesi. Açık iş kartlarını GET /manufphases/ ile okuyun, ardından modifiedAfter ile güncel tutun. Her iş numarasına ait parçaları ve malzeme ihtiyaçlarını, ayrıca stok bakiyelerini ve satın alma satırlarını okuyun. Böylece her aşama, ilgili satın alma satırının teslimat tarihini bekler.
3. Çizelgenin geri yazılması. SkyPlanner, motorun yerleştirdiği veya taşıdığı her aşama için PUT /manufphases/ çağrısı yapar. İstek gövdesinde her iş kartı için aşağıdaki alanları içeren bir workSheet kaydı bulunur:
- İş kartını belirten
numberve seçilen kaynağı belirtenresource - L7 iş kuyruklarının SkyPlanner’daki sıralamayı göstermesini sağlayan
startDatevepriority - Belirli bir operatör atandığında
person - Her tarih için planlanan çalışma saatlerini içeren
schedulingDays
L7, harici bir sistemin belirlediği önceliği değiştirmeden korur (kaynak); böylece iş kuyruklarındaki sıralama korunur.
4. Kapasitenin eşitlenmesi. SkyPlanner’da vardiyalar, tatiller veya fazla mesailer değiştiğinde POST /resourceupdates/, yeni kapasiteyi L7 kaynak takvimine yazar. Böylece L7’nin yük görünümleri planla uyumlu olur.
5. Üretim sahasındaki ilerleme. Operatörler, L7 iş kuyruklarında ve Visma LTR’de kayıt girmeye devam eder; SkyPlanner ise olayları GET /manufevents/ ile okur. Operatörler işlerini SkyPlanner Mobile Confirmations üzerinden de onaylayabilir. Autopilot, her iki kaynaktan gelen bilgilere göre yeniden planlama yapar ve yeni zamanlar bir sonraki geri yazma işleminde aktarılır.
6. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bu kuralları yazılı hale getirin:
| Veri | Veri sahibi |
|---|---|
| Ürünler, yapılar, iş aşamaları, miktarlar, iş numarasının durumu | Visma L7 |
| Aşama sıralaması, başlangıç tarihleri, günlük çalışma saatleri, kaynak seçimi | SkyPlanner |
| İzin verilen iş merkezleri, hazırlık süresi matrisi, takımlar, personel | SkyPlanner |
| Vardiyalar ve devamsızlıklar | SkyPlanner; L7 kaynak takvimine yazılır |
| Üretim olayları ve stok kayıtları | Visma L7 iş kuyrukları ve LTR |
Çakışmaların başlıca kaynağı, L7’nin kendi planlamasıdır. İhtiyaç hesaplaması ve ayrıntılı planlama, kilitlenmemiş aşamaları yeniden yerleştirebilir. Bunları yalnızca malzeme ve rezervasyonlar için çalıştırın; SkyPlanner’ın yönettiği aşamaları yeniden planlamayın.
Tipik proje adımları
Uygulama genellikle devreye alma süreci başladıktan sonra birkaç hafta içinde tamamlanır. Öncesinde, 30 günlük ücretsiz denemede iş numaralarını, aşamaları ve kaynakları Excel’e aktararak kendi verilerinizle çalışırsınız.
- Kapsam belirleme. Eşleme tablosunu, veri sahipliği kurallarını ve sorgulama aralığını netleştirin.
- Erişim ve lisanslar. Kapsama giren REST uç noktaları için lisans alın. LTR yöneticisi API kullanıcısını, hash ve token’ı oluşturur; tercihen önce bir test şirketinde.
- Değişiklik kaydı. Okuduğunuz tablolar için DBLOG’u etkinleştirin.
- İlk yükleme. Kaynaklar, ürünler, yapılar ve iş aşamaları.
- İş numaralarının eşitlenmesi. modifiedAfter ile düzenli sorgulama, silme işlemleri ve sayfalama.
- SkyPlanner’da kısıtların tanımlanması. İzin verilen iş merkezleri, hazırlık süresi matrisi, takımlar ve personel.
- Geri yazma.
PUT /manufphases/vePOST /resourceupdates/çağrılarının test şirketinde denenmesi. - Paralel çalışma ve canlıya geçiş. Mevcut planla karşılaştırın, ana verileri düzeltin ve ardından canlı ortamda geri yazmayı etkinleştirin.
Visma L7 entegrasyonunda planlanması gerekenler
- Uç nokta bazında lisanslar. Tüm uç noktaları erkenden listeleyin ve testlere başlamadan önce lisanslarını alın.
- Makine sayısı. Birden fazla makine içeren bir kaynak, L7’de işi makineler arasında böler (kaynak). Bu kaynağı SkyPlanner’da ayrı iş merkezlerine bölün ve L7’nin beklediği kaynağı geri yazın.
- Günlük saatler. L7, planı her tarih için saat cinsinden saklar. SkyPlanner, toplamı aşamanın süresine eşit olan
schedulingDaysverilerini gönderir. - Fabrika takvimi. Takvimi eksiksiz tutun; boşluklar aşamaların geçmiş tarihlere kaymasına neden olur (kaynak).
- Stok siparişleri.
mainNumber,subNumber,rowNumbervenewQuantityyalnızca stok siparişinin miktarını değiştirmek için kullanılır. Müşteri işleri için bu alanları göndermeyin. - Bir sonraki ERP. Visma, L7 için yeni geliştirmeleri sonlandırdı; ürünün kullanımı da 2028 sonunda sona erecek (Visma duyurusu). ERP değiştirirken çizelgeleme kurallarınızı taşıyabilmek için bu kuralları L7 alanlarında değil, SkyPlanner’da tutun.
Visma L7 entegrasyonu: yapılandırma ve destekten kim sorumlu?
Çalışma, kaynaklarınıza, iş aşamalarınıza ve L7 yapılandırmanıza uygun eşleştirmeleri kapsar. SkyPlanner’da tuttuğunuz çizelgeleme kuralları da bu kapsamdadır: kullanılabilecek iş merkezleri, hazırlık süresi matrisi, takımlar ve çalışanlar.
- SkyPlanner ekibi, başlangıç sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek sağlar. Her tesis L7’yi farklı kullanır; tesise özgü bu bilgi yapılandırmaya yansıtılır.
- Visma iş ortağınız sürece katılabilir. İş ortağınız L7 ve LTR yapılandırmanızı tanır; API kullanıcısı, lisanslar ve test şirketiyle ilgili işlemleri üstlenebilir. SkyPlanner, REST API, Swagger/OpenAPI belgeleri ve webhook’ları sağlar.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için aynı belgelenmiş REST API’yi bir API belirteciyle kullanabilirler. Başlamak için bir API belirteci yeterlidir; SkyPlanner ekibi gerektiğinde yardımcı olur.
L7’yi değiştirdiğinizde aynı SkyPlanner yapılandırması yeni ERP’ye bağlanır. Business Central, Visma Net, Lemonsoft, Monitor ERP ve Odoo sayfalarını inceleyin.
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 hazırlanan teklif, abonelik planınızla birlikte baştan sunulur. Böylece başlamadan önce toplam maliyeti görürsünüz.
L7’nin kendi planlama özelliklerinin karşılaştırmasını Visma L7, gerçek kapasiteyi dikkate alan üretim çizelgeleme sunuyor mu? sayfasında inceleyin. Genel bilgiler Visma L7 sayfasında, diğer sistemler ise ERP entegrasyonları sayfasında yer alır.
Üreticilerin SkyPlanner yorumları
1.000’lerceotomatik çizelgelenen iş emri
“Üretimi artık bambaşka bir şekilde kontrol altında tutuyoruz ve kapasitemizi çok daha iyi anlıyoruz.”
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.
%98teslimat performansı; önceki oran yaklaşık %50
“SkyPlanner, teslimat performansımızı korumada 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.
2 saather hafta kazanılan zaman
“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 ediliyor ve yeni iş kuyruğu saniyeler içinde üretim hattına 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ı hazırlamak 30 dakikadan az sürüyor.
Sık sorulan sorular
Visma L7’nin üretim verileri için bir API’si var mı?
Evet. Visma LTR üzerindeki Visma L7 REST API; iş aşamalarına, kaynaklara, parçalara, malzemelere, üretim olaylarına, ürünlere, stok bakiyelerine, satış satırlarına ve satın alma satırlarına erişim sağlar. Her uç nokta ayrı lisanslanır; API kullanıcısını ve belirteçleri LTR yöneticisi oluşturur.
Çizelge Visma L7’ye nasıl geri yazılır?
PUT /manufphases/ ile her iş kartının kaynağı, başlangıç tarihi, önceliği, çalışanı ve tarih bazında planlanan saatleri güncellenir. POST /resourceupdates/ kaynak takviminin kapasitesini yazar. L7 dışarıdan gelen önceliği korur; böylece iş kuyrukları SkyPlanner’daki sıralamayı izler.
Visma L7 webhook’ları destekliyor mu?
Belgelerde webhook desteği belirtilmiyor. Kapsam dahilindeki tablolar için değişiklik kaydını etkinleştirin ve modifiedAfter ile düzenli sorgulama yapın. SkyPlanner’ın kendi webhook’ları, çizelge değişikliklerini gerçekleştiği anda iletir.
Hangi çizelgeleme yazılımı Visma L7 ile entegre çalışır?
SkyPlanner APS, L7 REST API üzerinden Visma L7 ile çift yönlü entegre çalışır. Visma da L7 entegrasyonları sayfasında Skycode ve SkyPlanner’a yer verir. SkyPlanner ekibi, başlangıç sürecinde entegrasyonu yapılandırır.
Visma L7 entegrasyonunu kim kurar?
SkyPlanner ekibi, başlangıç sürecinde çift yönlü entegrasyonu L7 yapılandırmanıza göre ayarlar ve canlıya geçişten sonra destek sağlar. Visma iş ortağınız veya kendi geliştiricileriniz de SkyPlanner’ın belgelenmiş REST API’sini kullanarak geliştirme yapabilir. Başlamak için bir API belirteci yeterlidir.
Entegrasyonu kurmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz denemede, L7’den Excel veya CSV ile veri aktararak 20 iş merkezine kadar çalışabilirsiniz. Kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
