Integrasi / ERP / Comarch ERP XL
Panduan Integrasi Comarch ERP XL untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Comarch ERP XL ini menjelaskan kepada mitra dan tim TI cara menghubungkan Comarch ERP XL dengan SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan Comarch ERP XL melalui antarmuka milik Comarch:
- Data yang masuk mencakup perintah produksi (zlecenia produkcyjne) beserta proses dan operasinya, teknologi, work center, sumber daya produksi, item, stok, dan pesanan pembelian.
- Waktu mulai dan selesai yang direncanakan dikirim kembali ke setiap operasi pada perintah produksi melalui XL API.
- Jika Anda memilihnya, catatan waktu operator dikirim kembali sebagai realisasi operasi.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Tim SkyPlanner menyesuaikan konfigurasi integrasi dengan pengaturan Comarch ERP XL Anda selama orientasi awal dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin terlibat atau mengembangkan solusi sendiri menggunakan REST API SkyPlanner yang sudah terdokumentasi (referensi API).
Antarmuka integrasi Comarch ERP XL
Comarch mencantumkan tiga cara untuk berkomunikasi dengan ERP XL: “DCOM, direct database connection (SQL Client), REST API” (DCOM, koneksi langsung ke basis data (SQL Client), REST API) (Comarch, diterjemahkan). Untuk sistem penjadwalan, dua di antaranya menjadi antarmuka utama:
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.” (Fungsi-fungsi ini terkumpul dalam pustaka CDN_API.DLL, yang diinstal bersama seluruh sistem Comarch ERP XL.) (Bantuan Comarch, diterjemahkan) Program eksternal masuk dengan XLLogin, memanggil fungsi-fungsi yang menggunakan sesi yang sama, lalu keluar dengan XLLogout. Setiap struktur memiliki kolom Wersja untuk memilih versi kumpulan parameter yang sesuai dengan rilis ERP XL Anda.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0 menyediakan layanan mikro REST: “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.” (Setiap layanan mikro RestAPI menyediakan dokumentasi interaktifnya sendiri di endpoint /swagger.) (Bantuan Comarch, diterjemahkan)
Koneksi langsung SQL Client menyediakan akses baca ke basis data ERP XL untuk mengambil master data dan data perintah, sesuai kesepakatan dengan tim TI dan mitra Comarch Anda.
Fungsi XL API untuk produksi
Comarch mendokumentasikan fungsi-fungsi produksi berikut (XL128):
| Area | Fungsi | Kegunaan |
|---|---|---|
| Teknologi | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | Membuat teknologi dan operasi baru, menambahkan work center serta material atau produk ke operasi |
| Perintah produksi | XLNoweZlecenieProd | Membuat perintah produksi baru |
| Perintah produksi | XLZamknijZlecenieProd | Merencanakan, merencanakan ulang, menyelesaikan perhitungan, atau menutup perintah produksi sesuai kode tindakan yang dipilih |
| Operasi | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | Menambahkan operasi atau sumber daya produksi ke proses produksi |
| Jadwal | XLDodajTerminDoProcesuProd | Menambahkan rentang tanggal ke operasi: IdCzynnosci, TerminOd, TerminDo |
| Realisasi | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | Menambahkan realisasi operasi ke perintah produksi, mengubah kuantitas yang direalisasikan |
| Dokumen | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | Membuat dokumen RW dan PW untuk objek produksi |
Autentikasi dan akses
- XL API. Integrasi masuk ke basis data sebagai operator ERP XL menggunakan XLLogin dan memperoleh sesi untuk pemanggilan berikutnya. DLL berjalan pada host Windows yang telah dipasangi ERP XL, sehingga layanan penulisan balik berjalan di jaringan Anda, berdampingan dengan ERP XL.
- REST API. Akses diatur untuk setiap instalasi ERP XL Web. Halaman Swagger masing-masing layanan mikro mendokumentasikan pemanggilannya.
- Pembacaan SQL. Akun basis data dengan akses hanya-baca yang disetujui oleh tim TI Anda.
Di sisi SkyPlanner, REST API menggunakan token API pada header Authorization-Token untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan pemanggilan pertama.
Event dan polling
Dokumentasi yang diperiksa tidak mencantumkan webhook keluar untuk Comarch ERP XL. APS milik Comarch mengambil data saat perencana menekan “Aktualizuj dane z ERP” (Bantuan Comarch APS).
Karena itu, data dari ERP XL diambil melalui polling. Data dibaca dengan filter untuk perintah produksi yang masih terbuka dan perubahan terbaru guna mendeteksi pekerjaan baru. Frekuensinya ditetapkan per pabrik, mulai dari setiap beberapa menit untuk perintah produksi hingga setiap jam untuk stok.
SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga proses penulisan balik dipicu oleh event.
Pemetaan data
| Objek Comarch ERP XL (antarmuka) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
| Karty towarów, satuan ukur (REST atau pembacaan SQL) | Produk dan material | ERP XL → SkyPlanner | Pemuatan awal, lalu polling |
| Technologia: operasi, material, barang setengah jadi, produk per operasi | Struktur produk, subproduk, material per tahapan proses | ERP XL → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Operasi Technologia: work center, sumber daya produksi, waktu | Tahapan proses beserta durasi, waktu setup, dan waktu pembongkaran | ERP XL → SkyPlanner | Pemuatan awal, lalu saat ada perubahan |
| Gniazda robocze dan zasoby (mesin, alat, karyawan) | Stasiun kerja, kelompok stasiun kerja, alat, personel | ERP XL → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
| Kalendarze i okresy, przestoje i awarie | Shift, waktu di luar jam kerja, dan waktu henti | ERP XL → SkyPlanner | Setiap hari, atau kelola shift sendiri di SkyPlanner |
| Zlecenia produkcyjne (ZP) beserta proses, operasi, material, tenggat, dan prioritas | Perintah dan job beserta tenggat dan kebutuhan material | ERP XL → SkyPlanner | Polling setiap beberapa menit |
| Stok per gudang | Saldo stok | ERP XL → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Zamówienia zakupu (ZZ) beserta tanggal pengiriman | Pesanan pembelian, material masuk berdasarkan tanggal pengiriman | ERP XL → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
| Waktu operasi: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | Waktu mulai dan selesai yang direncanakan per job | SkyPlanner → ERP XL | Saat jadwal berubah, melalui webhook SkyPlanner |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | Catatan waktu dan konfirmasi operator | SkyPlanner → ERP XL | Setiap konfirmasi atau setiap shift, jika dipilih |
| Tidak ada di ERP XL | Matriks waktu persiapan dan pergantian, alat dengan ketersediaan terbatas, job dengan beberapa operator, mesin dan personel alternatif | Dikelola di SkyPlanner | Dikonfigurasi selama orientasi awal |
Pola integrasi
1. Pemuatan awal master data. Baca data item, teknologi, work center, sumber daya produksi, dan kalender. Tentukan pemetaan work center ke SkyPlanner dengan cermat: work center dengan empat mesin menjadi satu kelompok stasiun kerja atau empat stasiun kerja. Alat dalam sumber daya produksi ERP XL menjadi alat dengan ketersediaan terbatas di SkyPlanner, sedangkan karyawan menjadi personel dengan jadwal shift.
2. Sinkronisasi perintah. Baca perintah produksi beserta operasi dan materialnya, serta pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered.
3. Penulisan kembali jadwal. Saat mesin penjadwalan menempatkan atau memindahkan operasi, webhook SkyPlanner memicu layanan penulisan kembali. Layanan ini memanggil XLDodajTerminDoProcesuProd dengan TerminOd dan TerminDo milik operasi tersebut, sehingga setiap operasi ZP memuat waktu mulai dan selesai yang direncanakan SkyPlanner.
4. Konfirmasi di lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu tersebut menjaga jadwal tetap mutakhir. Anda menentukan apakah waktu aktual dikirim kembali. Jika ya, layanan menambahkan realisasi melalui XLDodajRealizacjeOperacjiProd, sedangkan dokumen RW dan PW mengikuti aturan ERP XL Anda. Jika Anda menggunakan Comarch MES di beberapa stasiun, gunakan hanya satu sumber pelaporan untuk setiap operasi.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Item, teknologi produksi, kuantitas, status ZP, perhitungan biaya | Comarch ERP XL |
| Urutan operasi, waktu mulai dan selesai, penetapan sumber daya produksi | SkyPlanner |
| Matriks waktu persiapan dan pergantian, kebutuhan alat dan operator, sumber daya produksi alternatif | SkyPlanner |
| Shift, kalender, dan waktu henti | Satu sistem, dipilih saat penentuan lingkup |
| Realisasi, dokumen RW dan PW | Comarch ERP XL, dimasukkan langsung di sana atau dikirim dari catatan waktu SkyPlanner |
Tetapkan satu sistem yang berwenang menulis tanggal operasi. Jika perencanaan ulang otomatis ERP XL atau Comarch APS masih menulis jadwal pada perintah produksi yang sama, nonaktifkan fungsi tersebut untuk perintah yang dijadwalkan SkyPlanner.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu setelah proses orientasi dimulai. Sebelumnya, validasi jadwal melalui uji coba gratis selama 30 hari menggunakan work center, teknologi produksi, dan perintah produksi terbuka yang diekspor dari ERP XL dalam format CSV atau Excel.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, dan apakah realisasi dikirim kembali.
- Akses ERP XL. Buat akun operator integrasi, siapkan koneksi pembacaan data, dan tempatkan layanan penulisan kembali pada host yang telah dipasangi ERP XL. Uji terlebih dahulu pada salinan basis data.
- Pemuatan awal. Item, teknologi produksi, work center, sumber daya produksi, dan kalender.
- Sinkronisasi perintah produksi dan pesanan pembelian. Polling dengan filter dan mekanisme percobaan ulang.
- Pengaturan batasan di SkyPlanner. Matriks waktu persiapan dan pergantian, alat, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan kembali jadwal. Pemanggilan XLDodajTerminDoProcesuProd melalui webhook SkyPlanner, beserta realisasi jika opsi ini dipilih.
- Pengujian paralel. Jalankan SkyPlanner berdampingan dengan rencana yang digunakan saat ini, bandingkan tanggalnya, lalu perbaiki master data.
- Mulai penggunaan operasional. Aktifkan penulisan kembali setelah data sesuai.
Hal yang perlu disiapkan untuk integrasi Comarch ERP XL
- Kapasitas yang diinput. Kapasitas work center di ERP XL berupa angka yang ditentukan pengguna dengan % beban yang diizinkan. SkyPlanner menghitung kapasitas berdasarkan shift dan sumber daya produksi yang sebenarnya, jadi atur shift dengan cermat dan jangan gunakan persentase tersebut.
- Sumber daya produksi tanpa batas kapasitas. ERP XL melewati pemeriksaan keterisian untuk sumber daya produksi yang ditandai memiliki kapasitas tak terbatas. Tentukan untuk masing-masing apakah akan menjadi stasiun kerja dengan kapasitas terbatas di SkyPlanner.
- Perintah yang sudah dirilis. ERP XL tidak menyertakan operasi yang sudah dirilis ke produksi dalam perencanaan ulang, kecuali “Przesuń na zwolnionych” dicentang. Sepakati cara menerapkan tanggal dari SkyPlanner pada perintah yang sudah dirilis, lalu gunakan Running Time Lock untuk mengunci jadwal pekerjaan beberapa jam ke depan.
- Versi struktur. Struktur XL API memiliki field Wersja. Atur nilainya agar sesuai dengan rilis ERP XL Anda, lalu uji ulang setelah setiap pembaruan tahunan.
- Satuan dan waktu dalam sistem Polandia. Waktu operasi dan satuan kalender harus dikonversi secara tepat saat impor. Jika tidak, semua durasi akan salah.
Siapa yang mengonfigurasi dan mendukung integrasi Comarch ERP XL
- Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah sistem mulai digunakan, mencakup pembacaan data dan pemanggilan XL API yang disepakati. Setiap pabrik menggunakan Comarch ERP XL dengan cara berbeda, dan pengetahuan khusus itulah yang diterapkan di sini.
- Mitra Comarch Anda dapat ikut terlibat. Mitra memahami konfigurasi, lisensi, dan XL API Anda, serta dapat menyiapkan akun operator, koneksi pembacaan data, dan host penulisan kembali bersama tim SkyPlanner.
- Pengembang internal Anda dapat mengembangkannya lebih lanjut melalui REST API SkyPlanner menggunakan token API. Token API saja sudah cukup untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan. Dokumentasi integrasi tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi diberikan di awal bersama paket Anda, sesuai proses dan kebutuhan Anda. Lihat harga, penjadwalan produksi sesuai kapasitas untuk Comarch ERP XL, halaman Comarch ERP XL, dan pusat informasi integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“SkyPlanner telah membawa perencanaan produksi kami dari lembar kerja Excel ke optimalisasi produksi secara real-time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam kerja setiap minggu, dan antrean kerja baru diterima lini produksi dalam hitungan detik.
+90%efisiensi produksi
“Efisiensi produksi meningkat 90%.”
Abdul Rucyinga, Kepala TI
Laboratory & Allied · Manufaktur farmasi
Efisiensi produksi meningkat 90%, dan penyusunan rencana yang dioptimalkan untuk tiga bulan di seluruh stasiun kerja memerlukan waktu kurang dari 30 menit.
6 bulanke depan, tim penjualan dapat melihat kapasitas yang tersedia
“SkyPlanner menjadi fondasi yang andal bagi seluruh perencanaan produksi.”
Anu Järvinen, Manajer Produksi
Fredman Operations · Kertas kemasan yang aman untuk pangan
Tim penjualan dapat melihat kapasitas tersedia hingga enam bulan ke depan. Permintaan perubahan jadwal yang sebelumnya memerlukan satu jam atau lebih kini dijawab dalam hitungan detik.
100%keandalan pengiriman sejak 2021
“SkyPlanner memberi kami gambaran kapasitas yang jelas dan membuat perencanaan lebih dapat diprediksi.”
Dan Berglund, COO/CFO
Opes Corporation · Manufaktur bahan kimia dan pangan
Keandalan pengiriman mencapai 100% sepanjang penggunaan SkyPlanner, sejak 2021.
Pertanyaan umum
Apakah Comarch ERP XL memiliki API untuk perintah produksi?
Ya. XL API (CDN_API.DLL) membuat perintah produksi, merencanakan dan merencanakan ulang perintah tersebut melalui XLZamknijZlecenieProd, menambahkan tanggal operasi melalui XLDodajTerminDoProcesuProd, serta mencatat realisasi melalui XLDodajRealizacjeOperacjiProd. Comarch ERP XL Web menambahkan layanan mikro REST yang didokumentasikan di Swagger.
Bagaimana tanggal yang direncanakan ditulis kembali ke Comarch ERP XL?
Melalui XLDodajTerminDoProcesuProd, yang menambahkan rentang tanggal (TerminOd, TerminDo) pada setiap operasi dalam perintah produksi. Webhook SkyPlanner memicu pemanggilan ini setiap kali jadwal berubah.
Apakah Comarch ERP XL mendukung webhook?
Tidak ada webhook keluar yang didokumentasikan, sehingga integrasi melakukan polling ke ERP XL sesuai jadwal yang ditetapkan untuk setiap pabrik. Webhook SkyPlanner sendiri langsung mengirimkan perubahan jadwal saat terjadi.
Sebaiknya mitra Comarch menawarkan Comarch APS atau SkyPlanner?
SkyPlanner, jika pelanggan menginginkan jadwal yang memperhitungkan kapasitas nyata, siap dalam hitungan minggu, dan terus diperbarui secara otomatis. Comarch APS merupakan aplikasi terpisah dengan basis data PostgreSQL, integrator, dan kunci lisensinya sendiri. Sinkronisasi dilakukan saat perencana mengeklik, dan waktu setup-nya berupa satu nilai tetap per operasi (bantuan Comarch APS). SkyPlanner adalah perangkat lunak cloud yang melakukan perencanaan ulang secara otomatis serta merencanakan pergantian produksi, alat, tim kerja, dan material, mulai dari 199 € per bulan.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor CSV atau Excel dari ERP XL, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
