Entegrasyonlar / ERP / Visma Net ERP
Visma Net Entegrasyon Kılavuzu: SkyPlanner APS ile Üretim Çizelgeleme
Bu Visma Net entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine Visma Net’i (Visma.net ERP) SkyPlanner APS’ye nasıl bağlayacaklarını gösterir. SkyPlanner, Visma Net API üzerinden Visma Net ile çift yönlü entegre olur:
- Stok kalemleri, Kit specifications, satış siparişleri, stok seviyeleri ve satın alma siparişleri SkyPlanner’a aktarılır.
- Çizelgelenen işler Kit assemblies kayıtlarına dönüşür; iş tamamlandığında bu kayıtlar serbest bırakılır.
- Operatörlerin çalışma saatleri, Employee time cards olarak geri aktarılır.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sırasında entegrasyonu Visma Net kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destek sağlar. Bu kılavuz, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API’sini (API referansı) kullanarak kendileri geliştirme yapmak isteyen iş ortakları ve geliştiriciler içindir.
Visma Net entegrasyon arayüzleri
- Visma Net ERP API. OpenAPI tanımının başlığı hâlâ “Visma.net ERP API v1” olan bu REST API, v1 ve v2 yollarını içerir. Temel URL
https://api.finance.visma.netadresidir. Eskiintegration.visma.netalan adına 1 Şubat 2026’dan itibaren hız sınırı uygulanmaktadır ve bu adres kullanımdan kaldırılmaktadır (duyuru). - SalesOrder service v3,
https://salesorder.visma.netadresinde sunulur. v1 ve v2 satış siparişi uç noktalarının kullanım ömrü sona ermiştir. - Visma Developer Portal üzerinden webhook’lar.
- Background API.
erp-api-backgroundbaşlığı, uzun süren çağrıları kuyruğa alır, bir iş kimliğiyle birlikte 202 döndürür ve sonuç hazır olduğunda bildirim gönderir. - Tek seferlik ana veri yüklemeleri için Visma Net’te CSV, Excel veya SQL veri sağlayıcılarıyla içe ve dışa aktarma senaryoları.
Visma Net’te üretim emri, rota veya iş merkezi nesneleri bulunmadığından API’de bunlara ait uç noktalar yoktur. Çizelgeleme verileri kalemlerden, kitlerden, siparişlerden ve stoklardan alınır:
GET /v1/inventory: kit işareti ve kalem sınıfı dâhil, stoklu ve stoksuz kalemlerGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: revizyon bazında bileşen satırlarıGET /v1/kitassembly: tür ve duruma göre filtrelenebilen mevcut montaj kayıtları- SalesOrder service v3: talep edilen tarihler ve sipariş satırlarıyla birlikte talep verileri
GET /v1/inventorysummary/{inventoryNumber}: depo bazında mevcut ve kullanılabilir stok miktarlarıGET /v1/purchaseorderveGET /v2/PurchaseReceipt: gelecek malzemeler ve mal kabul kayıtları
Tüm listeleme uç noktaları, lastModifiedDateTimeCondition ile birlikte lastModifiedDateTime parametresini ve ayrıca pageNumber ile pageSize parametrelerini kabul eder. Böylece her eşitlemede yalnızca değişen veriler aktarılabilir.
Kimlik doğrulama ve sınırlar
Visma Net, Visma Connect kullanır (OpenID Connect ve OAuth 2.0):
- Visma Developer Portal’da bir Service Integration kaydedin.
- Entegrasyonu müşterinin Visma Net kiracı yöneticisi onaylar.
- Client credentials akışıyla
https://connect.visma.com/connect/tokenadresinden token isteyin; istektetenant_idvevisma_api:readgibi API kapsamlarını iletin. Token’lar 3.600 saniye geçerlidir.
İstek sınırları, şirket ve istemci bazında sabit saatlik zaman aralıkları için uygulanır. Yanıtlar X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını içerir. Sınır aşıldığında Retry-After başlığıyla birlikte 429 döndürülür (istek sınırları). ETag ve If-Match başlıkları güncellemeleri korur.
İş ortakları, Visma’nın ücretsiz Integrator Programme programı üzerinden bir demo şirketinde test yapar. SkyPlanner tarafında REST API, bir API token’ıyla (SkyPlanner Settings > API) kimlik doğrular ve Swagger/OpenAPI belgelerinde açıklanır. Entegrasyon eğitimi, ilk çağrıları adım adım gösterir.
Olaylar, webhook’lar ve periyodik sorgulama
Visma Developer Portal webhook’ları, çizelgeleme açısından önemli olayları kapsar:
- Inventory Item Created, Updated ve Changed
- Purchase Order Changed ve Status Changed
- SalesOrderService yayıncısına taşınmakta olan Sales Order Changed ve Status Changed
Kit assembly veya Kit specifications için olay yoktur. SkyPlanner bu kayıtları lastModifiedDateTime filtreleriyle periyodik olarak sorgular. Stok bakiyeleri çizelgeleme çalıştırıldığında sorgulanır. Ters yönde ise durum veya çizelge değiştiğinde SkyPlanner webhook gönderir.
Veri eşleme
| Visma Net nesnesi (uç nokta) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Ürünler ve malzemeler | Visma Net → SkyPlanner | İlk yükleme, ardından webhook |
Kit specifications (/v1/KitSpecifications) | Ürün yapısı, ürün başına malzemeler | Visma Net → SkyPlanner | İlk yükleme, ardından periyodik sorgulama |
| Satış siparişleri (SalesOrder service v3) | Termin tarihleri ve müşteri öncelikleriyle siparişler | Visma Net → SkyPlanner | Webhook |
Montaj kayıtları Visma Net’te oluşturuluyorsa On hold durumundaki Kit assembly (/v1/kitassembly) | İşler | Visma Net → SkyPlanner | Periyodik sorgulama |
Inventory summary (/v1/inventorysummary) | Depo bazında stok bakiyeleri | Visma Net → SkyPlanner | Çizelgeleme çalıştırıldığında sorgulama |
Satın alma siparişleri, mal kabul kayıtları (/v1/purchaseorder, /v2/PurchaseReceipt) | Teslimat tarihi bilgisiyle birlikte gelecek malzemeler; satın alma siparişi teslim edildiğinde stok güncellemesi | Visma Net → SkyPlanner | Webhook, ardından verilerin okunması |
| Visma Net’te bulunmaz | İşlem adımları, iş merkezleri, vardiyalar, hazırlık süresi matrisi, takımlar, alternatif kaynaklar | SkyPlanner’da yönetilir | Devreye alma sırasında yapılandırılır |
Kit assembly oluşturma ve güncelleme (POST/PUT /v1/kitassembly) | Çizelgelenen iş: kit kalemi, miktar, planlanan bitiş tarihi | SkyPlanner → Visma Net | Çizelge değiştiğinde SkyPlanner webhook’u aracılığıyla |
Kit assembly serbest bırakma (/v1/kitassembly/{type}/{refNo}/action/release) | Tamamlanan iş: üretim çıktısı ve bileşen tüketimi | SkyPlanner → Visma Net | İş tamamlandığında |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, serbest bırakma) | Kit kullanılmayan durumlarda üretim çıktısı ve malzeme tüketimi | SkyPlanner → Visma Net | İş tamamlandığında |
Employee time card (/v1/timeCard) | Operatör bazında kaydedilen çalışma saatleri | SkyPlanner → Visma Net | Haftalık |
Entegrasyon modelleri
1. Ana verilerin ilk yüklemesi. Stok kalemlerini, kalem sınıflarını ve her kitin en güncel Kit specification revizyonunu okuyun. Her bileşen satırını bir SkyPlanner malzemesiyle eşleyin. Ardından Visma Net’te bulunmayan verileri oluşturun: iş merkezleri, vardiyalar, hazırlık ve işlem süreleriyle işlem adımları, hazırlık süresi matrisi ve takım gereksinimleri. Bunları CSV veya Excel olarak içe aktarın. Projenin en büyük bölümünü bu çalışma oluşturur.
2. Sipariş eşitleme. Bir talep modeli seçin:
- Satış siparişine dayalı. Kit kalemlerine ait açık satış siparişi satırları SkyPlanner siparişlerine dönüşür. Talep edilen tarih, termin tarihi olarak kullanılır.
- Montaja dayalı. Visma Net’te On hold durumunda oluşturulan Kit assemblies kayıtları SkyPlanner işlerine dönüşür.
Açık satın alma siparişleri tarihleriyle birlikte aktarılır. 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. Çizelgeleme, stok özetini de kullanarak hem mevcut stoku hem de gelecek satın alımları kontrol eder.
3. Çizelgenin geri yazılması. Satış siparişine dayalı kurulumda SkyPlanner, çizelgelenen her iş için Production türünde bir Kit assembly oluşturur. Kit kalemini, revizyonu, depoyu, miktarı ve bileşenleri belirler; montaj kaydını satış siparişi satırına bağlar. Montaj tarihi, planlanan bitiş tarihidir. Autopilot işi başka bir zamana taşıdığında, serbest bırakma öncesinde bir PUT çağrısı tarihi günceller.
Kit assembly yalnızca bir Date alanı içerir. Bu nedenle operasyon düzeyindeki zaman bilgileri SkyPlanner’da kalır; Visma Net’e ise satış ve stok açısından önemli olan tarih aktarılır.
4. Üretim sahasından gerçekleşme bildirimleri. Operatörler, Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder; bu zaman kayıtları çizelgeyi güncel tutar. Son adım tamamlandığında SkyPlanner, Kit assembly üzerinde serbest bırakma eylemini çağırır. Serbest bırakma, üretim çıktısını ve bileşen tüketimini kayıtlara işler; ardından büyük defter kayıt grubu oluşur. Çalışma saatleri haftalık Employee time cards kayıtlarında, projeye dayalı işlerde ise proje işlemlerinde toplanır.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı olarak belirleyin:
| Veri | Sorumlu sistem |
|---|---|
| Stok kartları, Kit specifications, satış siparişleri, satın alma siparişleri, stok, maliyet | Visma Net |
| İşlem adımları, iş merkezleri, vardiyalar, hazırlıklar, takımlar | SkyPlanner |
| İş sırası, başlangıç ve bitiş zamanları, iş merkezi ataması | SkyPlanner |
| Kesinleştirme öncesindeki Kit assembly tarihi | SkyPlanner |
| Kesinleştirilmiş Kit assemblies ve puantaj kartları | Visma Net; kayıtlar SkyPlanner üzerinden işlenir |
Kit specification üzerinde yapılan bir değişiklik yeni bir revizyon oluşturur. Üretimde yalnızca son revizyon kullanılabildiği için en güncel revizyonu yeniden okuyup eşleyin. Montaj kaydındaki bileşenlerde elle yapılan değişiklikler Visma Net’te geçerliliğini korur. Bu nedenle SkyPlanner, kesinleştirmeden önce montaj kaydını yeniden okur.
Tipik proje adımları
Uygulama, devreye alma sürecinin başlamasından itibaren genellikle birkaç hafta içinde tamamlanır. Bunun öncesinde, Visma Net’in dışa aktarma senaryosundan alınarak CSV veya Excel biçiminde içe aktarılan kendi verilerinizle 30 günlük ücretsiz denemeyi kullanırsınız.
- Kapsam belirleme. Talep modelini, eşleme tablosunu, veri sahipliği kurallarını ve geri yazma hedefini (Kit assembly veya stok girişleri) netleştirin.
- Visma Connect kurulumu. Service Integration kaydını oluşturun ve kiracı yöneticisinin onayını alın. Önce bir demo şirketinde test edin.
- Üretim modeli. SkyPlanner’da iş merkezlerini, vardiyaları, işlem adımlarını, hazırlıkları ve takımları tanımlayın.
- İlk veri yüklemesi. Stok kalemlerini, kalem sınıflarını, Kit specifications kayıtlarını, depoları ve stokları yükleyin.
- Satış ve satın alma siparişlerinin eşitlenmesi. Satış siparişleri, satın alma siparişleri ve stok kartları için webhook, kitler ve stoklar için periyodik sorgulama kullanın. Token yenileme ve 429 yanıtlarının yönetimi de bu aşamada ele alınır.
- Geri yazma. Kit assembly oluşturma, güncelleme ve kesinleştirme işlemleri ile puantaj kartlarını yapılandırın.
- Paralel test. SkyPlanner’ı mevcut planla paralel çalıştırın ve tarihleri karşılaştırın.
- Canlıya geçiş. Veriler eşleştiğinde geri yazmayı etkinleştirin.
Visma Net entegrasyonunda neleri planlamalısınız?
- İçe aktarılabilecek rota yoktur. Tüm işlem adımları, hazırlık ve işlem süreleri SkyPlanner’da tanımlanır. Gereken iş gücünü planlayın ve sorumlusunu belirleyin.
- Advanced logistics. Kit assembly için Advanced logistics grubu gerekir. Standard logistics kullanıyorsanız üretim çıktısını Inventory receipt ve Inventory issue ile kaydedin.
- Kilitli revizyonlar. Kullanılmış bir Kit specification revizyonu düzenlenemez ve üretimde yalnızca en son revizyon kullanılabilir.
- Ölçü birimleri. Kit assembly kaydının kendine ait bir ölçü birimi vardır. İçe aktarırken bu birimi SkyPlanner’daki miktarlarla uyumlu hale getirin.
- Olay bildirimi olmadan periyodik sorgulama. Kitler için webhook yoktur. Saatlik istek sınırını aşmamak için tüm verileri yeniden yüklemek yerine
lastModifiedDateTimeile yalnızca değişen kayıtları alın. - Güncel uç noktalar. Entegrasyonu yalnızca
api.finance.visma.netve SalesOrder service v3 üzerine kurun. - Kiracı onayı. Kiracı yöneticisi uygulamayı onaylayana kadar istemci kimlik bilgileriyle erişim sağlanamaz. Bu adımı erkenden planlayın.
- Haftalık puantaj kartları. Puantaj kartları için Advanced financials gerekir ve kartlar haftalık tutulur. Operatörlerin çalışma saatlerini haftalık olarak toplayın veya proje işlemlerine kaydedin.
Visma Net entegrasyonunu kim yapılandırır ve destekler?
- SkyPlanner ekibi, devreye alma sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek verir. Buna SkyPlanner tarafı, Visma Net’te bulunmayan üretim modeli ve üzerinde anlaşılan Visma Net API çağrıları dahildir. Her tesis Visma Net’i farklı kullanır; tesise özgü bu bilgi birikimi yapılandırmaya yansıtılır.
- Visma Net iş ortağınız da sürece katılabilir. Visma, Visma Net’i Visma sertifikalı iş ortakları aracılığıyla sunar. Bu iş ortakları kurulumunuzu tanır; eşlemeyi ve Visma Connect uygulamasını inceleyebilir. SkyPlanner ise REST API, Swagger/OpenAPI dokümantasyonu ve webhook’ları sağlar.
- Entegrasyonu kendi geliştiricileriniz de oluşturabilir. Bunun için aynı dokümante edilmiş REST API’yi bir API token ile kullanabilirler. Başlamak için bir API token yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Herkese açık dokümantasyona SkyPlanner dokümanları üzerinden ulaşabilirsiniz.
Bağlantı kurulduğunda Arcturus motoru, Visma Net’teki güncel siparişlere göre üretimi çizelgeler. Tamamlanan işler ise kesinleştirilmiş Kit assemblies olarak Visma Net’e geri yazılır. Fiyatlar, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Sürecinize ve ihtiyaçlarınıza uygun entegrasyon teklifi, abonelik planınızla birlikte önceden sunulur. Böylece başlamadan önce toplam maliyeti görürsünüz.
Fiyatları inceleyin. Visma Net’in neden bir çizelgeleme aracına ihtiyaç duyduğunu Visma Net üretim çizelgeleme sayfasında okuyabilir, Visma Net sayfasında genel bilgi alabilir ve ERP entegrasyonları merkezinde diğer ERP sistemlerini inceleyebilirsiniz.
Üreticilerin SkyPlanner yorumları
2 saather hafta kazanılan zaman
“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 saatlik ç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 Müdürü
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan optimize edilmiş üç aylık bir plan, 30 dakikadan kısa sürede hazırlanıyor.
%98teslimat performansı; önceki oran yaklaşık %50
“SkyPlanner, teslimat performansımızı korumamızda 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.
6 aylıkboş kapasiteyi satış ekibi görebiliyor
“SkyPlanner, tüm üretim planlamamıza sağlam bir temel ve güvenilirlik sağlıyor.”
Anu Järvinen, Üretim Müdürü
Fredman Operations · Gıdayla temasa uygun ambalaj kâğıtları
Satış ekibi boş kapasiteyi altı ay önceden görebiliyor. Daha önce yanıtlanması bir saat veya daha uzun süren çizelge değişikliği talepleri artık saniyeler içinde yanıtlanıyor.
Sık sorulan sorular
Visma Net API’sinde üretim emirleri var mı?
Hayır. Visma Net’te üretim emri, rota veya iş merkezi nesneleri bulunmadığından API’de de yoktur. Üretim belgesi, /v1/kitassembly uç noktasındaki Kit assembly kaydıdır. Rotalar ve iş merkezleri ise SkyPlanner’da tutulur.
Entegrasyon hangi kimlik doğrulama yöntemini kullanır?
Entegrasyon, Visma Developer Portal’da Service Integration olarak kaydedilir ve kimlik doğrulama için OAuth 2.0 client credentials akışıyla Visma Connect’i kullanır. Kiracı yöneticisi entegrasyonu onaylar ve token’lar bir saat geçerlidir.
Visma Net değişiklikleri gerçek zamanlı olarak iletebilir mi?
Stok kartları, satış siparişleri ve satın alma siparişleri için evet; Visma Developer Portal webhook’ları kullanılır. Kit assemblies ve Kit specifications için olay bildirimi yoktur. Bu kayıtlardaki değişiklikler artımlı periyodik sorgulamayla alınır. SkyPlanner’ın kendi webhook’ları ise çizelge değişikliklerini anında iletir.
Tamamlanan üretim Visma Net’e nasıl geri yazılır?
SkyPlanner, çizelgelenen her iş için bir Kit assembly oluşturur, tarihini güncel tutar ve iş tamamlandığında release eylemini çağırır. Kesinleştirme işlemi, üretim çıktısını ve bileşen tüketimini kayıtlara işler. Kit kullanılmıyorsa aynı işlemler Inventory receipt ve Inventory issue ile yapılır.
Entegrasyonu oluşturmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, Visma Net’ten CSV veya Excel ile veri aktarımını ve 20 iş merkezine kadar kullanımı destekler; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
