Entegrasyonlar / ERP / Acumatica Cloud ERP
SkyPlanner APS ile Üretim Çizelgeleme için Acumatica Entegrasyon Kılavuzu
Bu Acumatica entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine Acumatica Cloud ERP (Manufacturing Edition) ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, Acumatica ile çift yönlü entegre olur:
- Üretim emirleri ve bunlara ait operasyonlar, iş merkezleri, makineler, takımlar, vardiyalar, stok kalemleri ve satın alma siparişleri SkyPlanner’a aktarılır.
- Planlanan başlangıç ve bitiş tarihleri üretim emri operasyonlarına yazılır ve emir kesinleştirilir.
- Operatörlerin süre kayıtları, işçilik ve hareket kayıtları olarak geri aktarılır.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Acumatica yapılandırmanıza göre ayarlar ve canlıya geçişten sonra destek sağlar. Bu kılavuz, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API’sini (API referansı) kullanarak kendi çözümlerini geliştirmek isteyen iş ortakları ve geliştiriciler içindir.
Acumatica’nın entegrasyon arayüzleri
Entegrasyon, Acumatica’nın zaten sunduğu arayüzler üzerinden çalışır. Acumatica ortamına hiçbir şey kurulmaz.
- Sözleşme tabanlı REST API. Uç noktalar sürümlendirilir ve ürün sürümlerini takip eder. Manufacturing uç noktası (örneğin 2026 R2 için 26.200.001),
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryveMaterialEntrynesnelerini sunar. Default uç noktası iseStockItem,PurchaseOrderveSalesOrdernesnelerini kapsar. URL’ler{instance}/entity/{Endpoint}/{version}/{Entity}biçimindedir. - Aynı uç noktadaki eylemler.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryveReleaseMaterialEntry, ekranlardaki düğmelerle aynı mantığı çalıştırır. - OData. Herhangi bir Generic Inquiry (SM208000), OData üzerinden erişime açılabilir. Açık üretim operasyonlarını tarihleriyle birlikte içeren bir Generic Inquiry, toplu okumanın en hızlı yoludur.
- Anlık bildirimler (SM302000). Bir Generic Inquiry veya yerleşik sorgu temelinde çalışır; eklenen ve silinen satırları yapılandırdığınız bir URL’ye gönderir.
- Toplu yüklemeler için CSV ve Excel sağlayıcılarıyla çalışan içe ve dışa aktarma senaryoları.
Nesneler ve eylemler, Web Service Endpoints (SM207000) ekranında ve Acumatica’nın REST istemci deposunda listelenir.
Kimlik doğrulama ve sınırlar
Acumatica, Connected Applications (SM303010) ekranında kaydedilen istemci uygulamaları üzerinden OAuth 2.0 ve OpenID Connect kullanır. Belgelenen akışlar Authorization Code, Implicit, Resource Owner Password Credentials ve Hybrid’dir. Sunucu entegrasyonu için yalnızca gerekli yetkileri içeren rollere sahip, entegrasyona özel bir kullanıcı kaydedin. Yenileme belirteciyle Authorization Code veya Resource Owner Password Credentials kullanın.
Üst sınırı lisansınız belirler: License Monitoring Console (SM604000), dakikada izin verilen API isteği sayısını ve API kullanıcı sayısını gösterir.
SkyPlanner tarafında REST API, API belirteciyle (SkyPlanner Settings > API) kimlik doğrular ve Swagger/OpenAPI ile belgelenmiştir. Entegrasyon öğreticisi, ilk çağrıları adım adım açıklar.
Veri eşleme
| Acumatica nesnesi (uç nokta / form) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Ürünler ve malzemeler | Acumatica → SkyPlanner | İlk yükleme, ardından yalnızca değişiklikler |
BillOfMaterial (AM208000): malzemeler, operasyonlar | Ürün yapısı, alt ürünler, ürün başına malzemeler | Acumatica → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| BOM operasyonları: Setup, Run, Machine, Queue, Finish, Move Time | İşlem adımları ve bunların süreleri, hazırlık ve söküm süreleri | Acumatica → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | İş merkezleri, iş merkezi grupları, verimlilik oranları, alternatif iş merkezleri | Acumatica → SkyPlanner | İlk yükleme, sonrasında nadiren |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Vardiyalar ve personel kapasitesi | Acumatica → SkyPlanner | Günlük veya vardiyalar SkyPlanner’da tutulur |
Tool (AM205500) | Sınırlı kaynak olarak takımlar | Acumatica → SkyPlanner | İlk yükleme |
OrderOperationDetail ile birlikte ProductionOrder (Planned, Released, In Process) | Termin tarihleri, iş sıralama önceliği ve malzeme ihtiyaçlarıyla birlikte emirler ve işler | Acumatica → SkyPlanner | Anlık bildirim veya birkaç dakikada bir sorgulama |
PurchaseOrder satırları (Default) | Beklenen teslimat tarihiyle birlikte satın alma siparişleri | Acumatica → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
| Stok kalemlerinin depolardaki miktarları | Stok bakiyeleri | Acumatica → SkyPlanner | Saatlik veya çizelgeleme çalıştırıldığında sorgulama |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Her operasyon için planlanan başlangıç, bitiş ve iş merkezi | SkyPlanner → Acumatica | Çizelge değiştiğinde SkyPlanner webhook’u aracılığıyla |
FirmProductionOrder eylemi | Yazılan tarihleri Acumatica APS’nin değiştirmesini engeller | SkyPlanner → Acumatica | Her geri yazma işleminden sonra |
Serbest bırakma eylemleriyle birlikte LaborEntry, MoveEntry | Süre kayıtları, tamamlanan miktarlar, operatör bildirimleri | SkyPlanner → Acumatica | Her bildirimde veya her vardiyada |
| Acumatica’da bulunmaz | Hazırlık süresi matrisi, isimleriyle tanımlı operatörler, birden fazla operatör gerektiren işler | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon akışları
1. Ana verilerin ilk yüklemesi. Önce iş merkezlerini, makineleri, takımları, vardiyaları ve takvimleri okuyun. Ardından stok kalemlerini ve ürün ağaçlarını okuyun. Birden fazla makine içeren bir iş merkezinin nasıl eşleneceğine karar verin: makinelerin ayrı iş merkezleri olarak tanımlandığı bir iş merkezi grubu mu, yoksa tek bir iş merkezi mi? Acumatica’daki Basis for Capacity, tesisin hangi yaklaşımı kullandığını gösterir.
2. Emir senkronizasyonu. Üretim emirlerini operasyonlarıyla birlikte okuyun; operasyonları BOM’dan değil, emrin kendisinden alın. Operasyonlar emre kopyalanır ve planlamacılar değişiklikleri orada yapar. Açık emirleri ve operasyonları içeren bir Generic Inquiry için anlık bildirim aboneliği oluşturun veya bu sorguyu düzenli aralıklarla çalıştırın. Açık satın alma siparişi satırlarını da okuyun. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslimat tarihinde kullanılabilir kabul eder ve sipariş Delivered olarak işaretlendiğinde stoğu günceller.
3. Çizelgenin geri yazılması. SkyPlanner, motorun yerleştirdiği veya zamanını değiştirdiği her operasyon için StartDate ve EndDate alanlarını OrderOperationDetail nesnesine yazar. İş alternatif bir iş merkezine taşındıysa iş merkezini de yazar. Ardından FirmProductionOrder eylemini çağırır. Acumatica: “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Üretim emirlerini sınırlı kapasiteye göre çizelgelediğinizde sistem, kesinleştirilmiş üretim emirlerini yeniden çizelgelemez.) (kaynak)
4. Shop floor bildirimleri. Operatörler, SkyPlanner Mobile Confirmations veya Production Timer ile çalışmalarını kaydeder. Süre kayıtları, LaborEntry belgelerine (operasyon başına süre ve tamamlanan miktar) veya MoveEntry belgelerine (yalnızca miktar) dönüştürülür ve ilgili eylemle serbest bırakılır. Shop floor bildirimleriniz zaten Acumatica’da Labor (AM301000) veya Shop Floor Kiosk üzerinden yapılıyorsa ilerleme bilgisi ters yönde akar. Tek bir kanal seçin; asla ikisini birden kullanmayın.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı hale getirin:
| Veri | Sorumlu sistem |
|---|---|
| Stok kalemleri, ürün ağaçları, miktarlar, emir durumu, maliyetlendirme | Acumatica |
| Operasyon sırası, başlangıç ve bitiş zamanları, iş merkezi ataması | SkyPlanner |
| Hazırlık süresi matrisi, takımlar, operatör gereksinimleri, alternatifler | SkyPlanner |
| Vardiyalar ve devamsızlıklar | Kapsam belirleme aşamasında seçilen tek bir sistem |
| İşçilik ve hareket işlemleri | Acumatica; kayıtlar SkyPlanner süre kayıtlarından aktarılır veya shop floor’da girilir |
Çakışmaların başlıca kaynağı, Acumatica’nın kendi APS sistemidir. Rough Cut Planning veya APS Maintenance Process, SkyPlanner’ın çizelgelediği emirlerin tarihlerini yeniden hesaplayabilir. Sisteme yazılan her emri sabitlemek bunu önler. Çizelgelenmiş emirleri APS çalıştırmalarının da dışında tutun.
Tipik proje adımları
Devreye alma çalışmaları başladıktan sonra uygulama genellikle birkaç hafta içinde tamamlanır. Öncesinde, 30 günlük ücretsiz denemede kendi verilerinizi kullanırsınız. İş merkezlerini ve açık üretim emirlerini operasyonlarıyla birlikte bir Generic Inquiry üzerinden Excel’e aktarın, SkyPlanner’a içe aktarın ve çizelgeyi doğrulayın.
- Eşleştirme. Eşleştirme tablosunu, veri sahipliği kurallarını, senkronizasyon sıklıklarını ve işçilik kayıtlarının hangi kanaldan aktarılacağını netleştirin.
- Erişim. Bağlı uygulamayı kaydedin, entegrasyon kullanıcısını ve rollerini oluşturun, Web Service Endpoints ekranında uç nokta sürümünü doğrulayın. Önce test ortamında çalışın.
- İlk veri yüklemesi. İş merkezleri, makineler, takımlar, vardiyalar, stok kalemleri ve ürün ağaçları.
- Emir ve sipariş senkronizasyonu. Üretim emirleri, operasyonlar ve satın alma siparişleri, anlık bildirim veya periyodik sorgulama yoluyla aktarılır.
- SkyPlanner’da kısıtların tanımlanması. Hazırlık süresi matrisi, ismen tanımlı operatörler, birden fazla operatör gerektiren işler ve alternatifler.
- Geri yazma. Operasyon tarihleri, emirlerin sabitlenmesi ve işçilik veya hareket kayıtları.
- Paralel çalışma. SkyPlanner’ın tarihlerini mevcut planla karşılaştırın ve ana verileri düzeltin.
- Canlıya geçiş. Veriler eşleştiğinde geri yazmayı etkinleştirin.
Acumatica entegrasyonunda nelere hazırlıklı olmalısınız?
- Hangi APS motorunun etkin olduğunu bilin. Classic ve Optimized, ayarları ayrı ayrı saklar ve yalnızca biri etkinleştirilebilir. İlk geri yazma işleminden önce Enable/Disable Features (CS100000) ekranını kontrol edin.
- Uç nokta sürümünü sabitleyin. Sürüm, URL’nin bir parçasıdır. Her yazılım yükseltmesi yeni bir sürüm eklediğinden, her yükseltmede yeniden test edin.
- Operasyonların güncellenmesi. Bazı operasyon alanları REST üzerinden salt okunurdur; emrin durumu da önemlidir. Released ve In Process durumundaki emirler için geri yazma sırasını test ortamında sınayın.
- Birimler ve süre alanları. Çalışma süresi Run Units, makine süresi ise Machine Units bazındadır. Kuyruk ve taşıma süreleri “affect the calculated schedule but do not occupy work center capacity.” (hesaplanan çizelgeyi etkiler ancak iş merkezi kapasitesini kullanmaz.) İçe aktarım sırasında dönüşümleri dikkatle yapın.
- Malzeme kullanılabilirliği sonuçları. Classic APS, tüm malzemelerin eksiksiz olarak hazır olmasını gerektirir. SkyPlanner, stokları ve beklenen satın alma siparişlerini tarihleriyle birlikte dikkate alarak planlama yapar. Planlamacıların hangi sonucu esas alacağını kararlaştırın.
- API sınırları. Dakika başına istek sayısı lisansa bağlıdır. Verilerin tamamını yeniden yüklemek yerine yalnızca değişen verileri okuyun ve anlık bildirimleri kullanın.
Acumatica 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. Her tesis Acumatica’yı farklı kullanır; bu deneyim de yapılandırmaya yansır.
- Acumatica iş ortağınız da sürece katılabilir. İş ortağınız özelleştirmelerinizi, Generic Inquiries sorgularınızı ve rollerinizi bilir. SkyPlanner, REST API, Swagger/OpenAPI dokümantasyonu ve webhook’lar sağlar.
- Kendi geliştiricileriniz de entegrasyonu geliştirebilir. Bunun için aynı REST API’yi bir API belirteciyle kullanabilirler. Başlamak için bir API belirteci yeterlidir; SkyPlanner ekibi gerektiğinde yardımcı olur. Laboratory & Allied, SAP Business One üzerinde bu yolu izledi: şirketin kendi BT ekibi, SkyPlanner’ın yardımıyla entegrasyonu büyük ölçüde kendi başına geliştirdi.
SkyPlanner, 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 baştan sunulur. Böylece başlamadan önce toplam maliyeti görürsünüz. Acumatica’nın kendi APS sistemiyle karşılaştırma için Acumatica’da üretim çizelgeleme sayfasına, genel bilgi için Acumatica sayfasına, diğer sistemler için de ERP entegrasyonları merkezine göz atın.
Üreticilerden 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 donanımları
Üretim planlamasında her hafta 2 saatlik çalışma süresi kazanılıyor ve yeni iş kuyruğu üretim hattına saniyeler içinde ulaşıyor.
+%90üretim verimliliği
“Üretimde verimlilik %90 arttı.”
Abdul Rucyinga, BT Direktörü
Laboratory & Allied · İlaç üretimi
Üretim verimliliği %90 arttı. Tüm iş merkezlerini kapsayan üç aylık optimize edilmiş bir planın hazırlanması 30 dakikadan kısa sürüyor.
1.000’lerceotomatik çizelgelenen iş emri
“Üretimi artık farklı bir şekilde kontrol altında tutuyoruz; kapasiteye ilişkin anlayışımız da bambaşka bir düzeye ulaştı.”
Hannu Ryynänen, CEO
Mamec · Endüstriyel mikserler, pompalar ve ileri teknolojiyle fason üretim
Binlerce iş emri otomatik olarak çizelgeleniyor ve tüm kuruluş üretimi gerçek zamanlı olarak izleyebiliyor.
%99,2teslimat performansı
“SkyPlanner, darboğazları tespit etmek için gereken görünürlüğü sağladı ve üretim yönetimini netleştirdi.”
Toni Tuori, Üretim Müdürü
Piristeel · Çatı güvenliği ve yağmur suyu sistemleri
Teslimat performansı bu yıl %99,2’ye ulaştı. Çizelgelemede her gün dört saate kadar çalışma süresi kazanılıyor.
Sık sorulan sorular
Acumatica API’si üretim emirlerini kapsıyor mu?
Evet. Sözleşme tabanlı REST API’nin Manufacturing uç noktası; ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool ile işçilik ve hareket kayıtlarına erişim sağlar. Ayrıca FirmProductionOrder gibi eylemleri de sunar.
Acumatica entegrasyonunu kim geliştirir?
SkyPlanner ekibi, devreye alma sürecinde çift yönlü entegrasyonu Acumatica yapılandırmanıza göre ayarlar ve canlıya geçişten sonra destek sağlar. Acumatica iş ortağınız veya kendi geliştiricileriniz de SkyPlanner’ın dokümante edilmiş REST API’sini kullanarak entegrasyonu geliştirebilir. Başlamak için bir API belirteci yeterlidir.
Bu entegrasyon için Acumatica APS gerekiyor mu?
Hayır. Acumatica’da kapasite sınırlarını dikkate alan çizelgeleme, Rough Cut Planning formuyla çalıştırılır. Classic APS ise bitişi 120 günün ötesinde olan emirleri sınırsız kapasiteyle planlar (kaynak). SkyPlanner, üretim emirleri, operasyonlar, iş merkezleri, makineler ve takımlardan yararlanarak gerçek kapasiteye uygun ayrıntılı çizelgeyi kendisi oluşturur. Bu nedenle entegrasyon, Acumatica’nın “is subject to licensing” (lisansa tabidir) dediği APS etkin olsa da olmasa da çalışır. Autopilot çizelgeyi güncel tutar; operatörler ise yaptıkları işi Mobile Confirmations ile kaydeder.
Acumatica APS’nin SkyPlanner tarihlerini değiştirmesini nasıl önleriz?
SkyPlanner, her üretim emrinin operasyon tarihlerini yazdıktan sonra emri sabitler. Acumatica’nın kapasite sınırlarını dikkate alan çizelgelemesi, sabitlenmiş emirleri yeniden çizelgelemez.
Acumatica değişiklikleri gerçek zamanlı olarak gönderebilir mi?
Evet. Bir Generic Inquiry üzerinde yapılandırılan Push notifications (SM302000), değişen satırları değişiklik gerçekleştiği anda bir URL’ye gönderir. SkyPlanner’ın kendi webhook’ları da çizelge değişikliklerini ters yönde iletir.
Entegrasyonda hangi kimlik doğrulama yöntemi kullanılmalı?
Connected Applications (SM303010) ekranında kayıtlı bir istemci üzerinden OAuth 2.0 kullanılmalıdır. Entegrasyona özel bir kullanıcı ve yalnızca gerekli yetkilere sahip roller tanımlanmalıdır. Ortamınızda kullanılacak akış, kapsam belirleme aşamasında doğrulanır.
Entegrasyonu geliştirmeden önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, Acumatica Generic Inquiry üzerinden alınan Excel veya CSV dosyalarını içe aktararak 20 iş merkezine kadar çalışmayı destekler; kredi kartı gerekmez. Denemeyi başlatın veya entegrasyonun kapsamını belirlemek için satış ekibiyle görüşün.
