Entegrasyonlar / ERP / Comarch ERP XL
SkyPlanner APS ile Üretim Çizelgeleme için Comarch ERP XL Entegrasyon Kılavuzu
Bu Comarch ERP XL entegrasyon kılavuzu, iş ortaklarına ve BT ekiplerine Comarch ERP XL ile SkyPlanner APS arasında nasıl bağlantı kurulacağını gösterir. SkyPlanner, Comarch’ın kendi arayüzlerini kullanarak Comarch ERP XL ile çift yönlü entegrasyon sağlar:
- Üretim emirleri (zlecenia produkcyjne), bunlara ait süreçler ve operasyonlarla birlikte içeri aktarılır. Teknolojiler, iş merkezleri, kaynaklar, stok kartları, stoklar ve satın alma siparişleri de alınır.
- Planlanan başlangıç ve bitiş zamanları, XL API üzerinden her üretim emri operasyonuna geri yazılır.
- Tercih ederseniz operatörlerin süre kayıtları, operasyon gerçekleşmeleri olarak geri aktarılır.
- SkyPlanner webhook’ları, çizelgedeki değişiklikleri anında iletir.
SkyPlanner ekibi, devreye alma sürecinde entegrasyonu Comarch ERP XL kurulumunuza göre yapılandırır ve canlıya geçişten sonra da destek verir. Bu kılavuz, sürece katılmak veya SkyPlanner’ın belgelenmiş REST API arayüzünü (API referansı) kullanarak kendileri geliştirme yapmak isteyen iş ortakları ve geliştiriciler içindir.
Comarch ERP XL entegrasyon arayüzleri
Comarch, ERP XL ile iletişim kurmak için üç yol sıralar: “DCOM, direct database connection (SQL Client), REST API” (DCOM, doğrudan veritabanı bağlantısı (SQL Client), REST API) (Comarch, çeviri). Bir çizelgeleme sistemi için asıl işi bunlardan ikisi üstlenir:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Bu işlevler, Comarch ERP XL sisteminin tamamıyla birlikte kurulan CDN_API.DLL kütüphanesinde toplanır.) (Comarch yardımı, çeviri) Harici bir program XLLogin ile oturum açar, aynı oturumu paylaşan işlevleri çağırır ve XLLogout ile oturumu kapatır. Her yapıda, ERP XL sürümünüze uygun parametre kümesi sürümünü seçen bir Wersja alanı bulunur.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0, REST mikroservisleri sunar: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Her RestAPI mikroservisi, kendi etkileşimli belgelerini /swagger uç noktasında sunar.) (Comarch yardımı, çeviri)
Doğrudan SQL Client bağlantısı, BT ekibiniz ve Comarch iş ortağınızla mutabık kalınan şekilde, ana verileri ve siparişleri okumak için ERP XL veritabanına okuma erişimi sağlar.
Üretim için XL API işlevleri
Comarch, aşağıdaki üretim işlevlerini belgeler (XL128):
| Alan | İşlev | Ne yapar? |
|---|---|---|
| Teknolojiler | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Yeni teknoloji veya operasyon oluşturur; operasyona iş merkezi, malzeme veya ürün ekler |
| Üretim emirleri | XLNoweZlecenieProd | Yeni üretim emri oluşturur |
| Üretim emirleri | XLZamknijZlecenieProd | İşlem koduyla yapılan seçime göre üretim emrini planlar, yeniden planlar, hesaplarını kapatır veya emri kapatır |
| Operasyonlar | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Üretim sürecine operasyon veya kaynak ekler |
| Çizelge | XLDodajTerminDoProcesuProd | Operasyona tarih aralığı ekler: IdCzynnosci, TerminOd, TerminDo |
| Gerçekleşme | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Üretim emrine operasyon gerçekleşmesi ekler, gerçekleşen miktarı değiştirir |
| Belgeler | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Üretim nesneleri için RW ve PW belgeleri oluşturur |
Kimlik doğrulama ve erişim
- XL API. Entegrasyon, XLLogin ile veritabanında bir ERP XL operatörü olarak oturum açar ve sonraki çağrılarda kullanılacak bir oturum alır. DLL, ERP XL kurulu bir Windows makinesinde çalışır. Bu nedenle geri yazma servisi, ağınızda ERP XL ile aynı ortamda çalışır.
- REST API. Erişim, her ERP XL Web kurulumu için ayrı yapılandırılır. Her mikroservisin çağrıları, kendi Swagger sayfasında belgelenir.
- SQL ile okuma. BT ekibinizin onayladığı, yalnızca okuma yetkisi olan bir veritabanı hesabı kullanılır.
SkyPlanner tarafında REST API, Authorization-Token başlığındaki API belirteciyle kimlik doğrular (SkyPlanner Settings > API). API belgeleri Swagger/OpenAPI üzerinden sunulur. Entegrasyon eğitimi, ilk çağrıları adım adım açıklar.
Olaylar ve periyodik sorgulama
İncelenen belgelerde Comarch ERP XL için dışarıya webhook gönderimi tanımlanmamıştır. Comarch’ın kendi APS sistemi, planlamacı “Aktualizuj dane z ERP” düğmesine bastığında verileri çeker (Comarch APS yardımı).
Bu nedenle ERP XL tarafı periyodik olarak sorgulanır. Açık üretim emirleri ve son değişikliklerle sınırlandırılan okuma işlemleriyle yeni işler alınır. Sorgulama sıklığı tesise göre belirlenir; üretim emirleri birkaç dakikada bir, stoklar ise saatte bir sorgulanabilir.
SkyPlanner, durum veya çizelge değiştiğinde webhook gönderir. Böylece geri yazma tarafı olay odaklı çalışır.
Veri eşleme
| Comarch ERP XL nesnesi (arayüz) | SkyPlanner nesnesi | Yön | Sıklık |
|---|---|---|---|
| Karty towarów, ölçü birimleri (REST veya SQL ile okuma) | Ürünler ve malzemeler | ERP XL → SkyPlanner | İlk yükleme, ardından periyodik sorgulama |
| Technologia: operasyonlar ve operasyon başına malzemeler, yarı mamuller, ürünler | Ürün yapısı, alt ürünler, süreç adımı başına malzemeler | ERP XL → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Technologia operasyonları: iş merkezleri, kaynaklar, süreler | Süreleri, hazırlık ve söküm süreleriyle birlikte süreç adımları | ERP XL → SkyPlanner | İlk yükleme, ardından değişiklik olduğunda |
| Gniazda robocze ve zasoby (makineler, takımlar, çalışanlar) | İş merkezleri, iş merkezi grupları, takımlar, personel | ERP XL → SkyPlanner | İlk yükleme, sonrasında nadiren |
| Kalendarze i okresy, przestoje i awarie | Vardiyalar, çalışma dışı süreler ve duruşlar | ERP XL → SkyPlanner | Günlük aktarım veya vardiyaların SkyPlanner’da yönetilmesi |
| Zlecenia produkcyjne (ZP): süreçler, operasyonlar, malzemeler, termin tarihi ve öncelik bilgisiyle birlikte | Termin tarihleri ve malzeme ihtiyaçlarıyla birlikte emirler ve işler | ERP XL → SkyPlanner | Birkaç dakikada bir sorgulama |
| Depo bazında stok | Stok bakiyeleri | ERP XL → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
| Teslimat tarihleriyle birlikte Zamówienia zakupu (ZZ) | Satın alma siparişleri, teslimat tarihine göre gelecek malzemeler | ERP XL → SkyPlanner | Saatte bir veya çizelgeleme çalıştırıldığında sorgulama |
| Operasyon tarihleri: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | İş başına planlanan başlangıç ve bitiş | SkyPlanner → ERP XL | Çizelge değiştiğinde, SkyPlanner webhook’u aracılığıyla |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Süre kayıtları ve operatör teyitleri | SkyPlanner → ERP XL | Tercih edilirse her teyitte veya her vardiyada |
| ERP XL’de bulunmaz | Hazırlık ve geçiş süreleri matrisi, kapasitesi sınırlı kaynak olarak takımlar, birden fazla operatör gerektiren işler, alternatif makineler ve personel | SkyPlanner’da yönetilir | Devreye alma sürecinde yapılandırılır |
Entegrasyon yaklaşımları
1. Ana verilerin ilk yüklemesi. Stok kartlarını, teknolojileri, iş merkezlerini, kaynakları ve takvimleri okuyun. İş merkezlerini SkyPlanner ile eşlerken yapıyı bilinçli seçin: dört makineli bir iş merkezi, bir iş merkezi grubu veya dört iş merkezi olarak modellenir. ERP XL kaynaklarındaki takımlar, SkyPlanner’da kapasitesi sınırlı takımlara; çalışanlar ise vardiyaları tanımlı personele dönüşür.
2. Emir ve siparişlerin senkronizasyonu. Üretim emirlerini operasyonları ve malzemeleriyle birlikte, ayrıca açık satın alma siparişlerini okuyun. SkyPlanner, sipariş edilen malzemeyi satın alma siparişinin teslimat tarihinde kullanılabilir kabul eder. Satın alma siparişi Delivered olarak işaretlendiğinde stoku günceller.
3. Çizelgenin geri yazılması. Motor bir operasyonu çizelgeye yerleştirdiğinde veya taşıdığında, SkyPlanner webhook’u geri yazma servisini tetikler. Servis, operasyonun TerminOd ve TerminDo değerleriyle XLDodajTerminDoProcesuProd çağrısı yapar. Böylece her ZP operasyonunda SkyPlanner’ın planladığı başlangıç ve bitiş bilgileri yer alır.
4. Üretim sahası bildirimleri. Operatörler çalışmalarını SkyPlanner Mobile Confirmations veya Production Timer ile kaydeder; bu süre kayıtları çizelgeyi güncel tutar. Gerçekleşen sürelerin geri aktarılıp aktarılmayacağına siz karar verirsiniz. Aktarılacaksa servis, XLDodajRealizacjeOperacjiProd ile gerçekleşme kayıtlarını ekler; RW ve PW belgeleri ise ERP XL kurallarınıza göre oluşturulur. Bazı iş merkezlerinde Comarch MES kullanıyorsanız her operasyon için tek bir bildirim kaynağı kullanın.
5. Veri sahipliği ve çakışma kuralları. Canlıya geçmeden önce bunları yazılı olarak belirleyin:
| Veri | Sorumlu sistem |
|---|---|
| Stok kartları, üretim teknolojileri, miktarlar, ZP durumu, maliyetlendirme | Comarch ERP XL |
| Operasyon sırası, başlangıç ve bitiş zamanları, kaynak ataması | SkyPlanner |
| Hazırlık ve geçiş süreleri matrisi, takım ve operatör gereksinimleri, alternatif kaynaklar | SkyPlanner |
| Vardiyalar, takvimler ve duruşlar | Kapsam belirleme aşamasında seçilen tek bir sistem |
| Gerçekleşme kayıtları, RW ve PW belgeleri | Comarch ERP XL; kayıtlar doğrudan burada girilir veya SkyPlanner süre kayıtlarından aktarılır |
Operasyon tarihlerini yalnızca tek bir sistem yazsın. ERP XL otomatik yeniden planlama özelliği veya Comarch APS aynı üretim emirlerine hâlâ tarih yazıyorsa SkyPlanner’ın çizelgelediği emirler için bu işlevi kapatın.
Tipik proje adımları
Uygulama, devreye alma süreci başladıktan sonra genellikle haftalar içinde tamamlanır. Öncesinde, ERP XL’den CSV veya Excel olarak dışa aktardığınız iş merkezleri, üretim teknolojileri ve açık üretim emirleriyle 30 günlük ücretsiz deneme sırasında çizelgeyi doğrulayın.
- Eşleştirme. Eşleştirme tablosunu, veri sahipliği kurallarını, eşitleme sıklıklarını ve gerçekleşme kayıtlarının geri aktarılıp aktarılmayacağını netleştirin.
- ERP XL erişimi. Entegrasyon operatörünü oluşturun, okuma bağlantısını kurun ve geri yazma servisini ERP XL’in kurulu olduğu bir makineye kurun. Önce veritabanının bir kopyasında test edin.
- İlk veri yüklemesi. Stok kartları, üretim teknolojileri, iş merkezleri, kaynaklar ve takvimler.
- Üretim emirlerinin ve satın alma siparişlerinin eşitlenmesi. Filtreler ve yeniden deneme mekanizmalarıyla periyodik sorgulama.
- SkyPlanner’da kısıtların ayarlanması. Hazırlık ve geçiş süreleri matrisi, takımlar, iş başına operatör sayıları ve alternatif makineler veya personel.
- Çizelgenin geri yazılması. SkyPlanner webhook’larının tetiklediği XLDodajTerminDoProcesuProd çağrıları ve tercih edilmişse gerçekleşme kayıtlarının aktarılması.
- Paralel test. SkyPlanner’ı mevcut planla paralel çalıştırın, tarihleri karşılaştırın ve ana verileri düzeltin.
- Canlıya geçiş. Veriler birbiriyle örtüştüğünde geri yazmayı etkinleştirin.
Comarch ERP XL entegrasyonunda dikkat edilmesi gerekenler
- Elle girilen kapasite. ERP XL’de iş merkezi kapasitesi, izin verilen yük yüzdesiyle birlikte kullanıcının tanımladığı bir sayıdır. SkyPlanner ise kapasiteyi gerçek vardiyalardan ve kaynaklardan hesaplar. Bu nedenle vardiyaları dikkatle ayarlayın ve yüzde değerini esas almayın.
- Sınırsız kaynaklar. Sınırsız kapasiteli olarak işaretlenen kaynaklar için ERP XL’de doluluk kontrolü yapılmaz. Her birinin SkyPlanner’da sınırlı kapasiteli bir iş merkezi olup olmayacağına karar verin.
- Üretime açılmış emirler. ERP XL, “Przesuń na zwolnionych” işaretli değilse üretime açılmış operasyonları yeniden planlamaya dahil etmez. SkyPlanner tarihlerinin üretime açılmış emirlere nasıl uygulanacağını kararlaştırın. Önümüzdeki saatlerde yapılacak işleri sabitlemek için Running Time Lock kullanın.
- Veri yapısı sürümleri. XL API veri yapılarında Wersja alanı bulunur. Bu alanı ERP XL sürümünüzle eşleşecek şekilde ayarlayın ve her yıllık sürüm yükseltmesinden sonra yeniden test edin.
- Lehçe birimler ve süreler. İçe aktarma sırasında operasyon süreleri ve takvim birimleri eksiksiz ve doğru biçimde dönüştürülmelidir; aksi takdirde tüm süreler yanlış olur.
Comarch ERP XL entegrasyonunu kim yapılandırır ve desteğini kim sağlar?
- SkyPlanner ekibi, devreye alma sürecinde entegrasyonu yapılandırır ve canlıya geçişten sonra destek sağlar; bu hizmet, üzerinde anlaşılan okuma işlemlerini ve XL API çağrılarını kapsar. Her tesis Comarch ERP XL’i farklı kullanır; tesise özgü bu bilgi birikimi yapılandırmaya yansıtılır.
- Comarch iş ortağınız sürece katılabilir. İş ortağınız yapılandırmanızı, lisanslamanızı ve XL API’yi bilir. SkyPlanner ekibiyle birlikte operatörü, okuma bağlantısını ve geri yazma sunucusunu kurabilir.
- Kendi geliştiricileriniz entegrasyonu genişletebilir. Bunun için bir API token kullanarak SkyPlanner’ın REST API’si üzerinden çalışabilirler. Başlamak için bir API token yeterlidir; gerektiğinde SkyPlanner ekibi yardımcı olur. Entegrasyon belgelerine SkyPlanner entegrasyon belgeleri sayfasından ulaşabilirsiniz.
SkyPlanner, 5 iş merkezi dahil aylık 199 €’dan başlar ve aylık faturalandırılır. Entegrasyon için süreçlerinize ve ihtiyaçlarınıza göre, abonelik planınızla birlikte önceden teklif sunulur. Fiyatlandırmayı, Comarch ERP XL ile üretim çizelgeleme sayfasını, Comarch ERP XL sayfasını ve ERP entegrasyonları merkezini inceleyin.
Ü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ş kuyruğu üretim hattına saniyeler içinde 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ın hazırlanması 30 dakikadan az sürüyor.
6 aylıkboş kapasite satış ekibi tarafından görülebiliyor
“SkyPlanner, tüm üretim planlaması için sağlam ve güvenilir bir temel oluşturuyor.”
Anu Järvinen, Üretim Müdürü
Fredman Operations · Gıdayla temasa uygun ambalaj kağı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.
%1002021’den bu yana teslimat performansı
“SkyPlanner, kapasitemizi görmemizi sağlıyor ve planlamayı öngörülebilir hale getiriyor.”
Dan Berglund, COO/CFO
Opes Corporation · Kimyasal ve gıda üretimi
SkyPlanner’ın kullanılmaya başlandığı 2021’den bu yana teslimat performansı kesintisiz olarak %100 seviyesinde.
Sık sorulan sorular
Comarch ERP XL’in üretim emirleri için bir API’si var mı?
Evet. XL API (CDN_API.DLL), üretim emirleri oluşturur, XLZamknijZlecenieProd ile bu emirleri planlar ve yeniden planlar, XLDodajTerminDoProcesuProd ile operasyon tarihlerini ekler ve XLDodajRealizacjeOperacjiProd ile gerçekleşme kayıtlarını aktarır. Comarch ERP XL Web ise Swagger’da belgelenen REST mikroservislerini ekler.
Planlanan tarihler Comarch ERP XL’e nasıl geri yazılır?
Her üretim emri operasyonuna bir tarih aralığı (TerminOd, TerminDo) ekleyen XLDodajTerminDoProcesuProd ile yazılır. Çizelge her değiştiğinde bir SkyPlanner webhook’u bu çağrıyı tetikler.
Comarch ERP XL webhook destekliyor mu?
Dışarıya bildirim gönderen webhook’lara ilişkin bir belge bulunmadığından entegrasyon, ERP XL’i her tesis için belirlenen aralıklarla sorgular. SkyPlanner’ın kendi webhook’ları ise çizelge değişikliklerini anında iletir.
Bir Comarch iş ortağı Comarch APS’yi mi, SkyPlanner’ı mı önermeli?
Müşteri, haftalar içinde devreye alınan, kendini güncel tutan ve gerçek kapasiteyi gözeten bir çizelge istiyorsa SkyPlanner’ı önermeli. Comarch APS; kendi PostgreSQL veritabanı, entegratörü ve lisans anahtarı olan ayrı bir uygulamadır. Planlamacı tıkladığında eşitleme yapar ve her operasyon için tek bir sabit hazırlık süresi kullanır (Comarch APS yardımı). SkyPlanner ise otomatik yeniden planlama yapan; ürün geçişlerini, takımları, ekipleri ve malzemeyi planlayan bir bulut yazılımıdır. Aylık 199 €’dan başlar.
Entegrasyonu kurmadan önce SkyPlanner’ı test edebilir miyiz?
Evet. 30 günlük ücretsiz deneme, ERP XL’den CSV veya Excel 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.
