Panduan Integrasi Lemonsoft untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Lemonsoft ini menjelaskan kepada mitra dan tim TI cara menghubungkan Lemonsoft ERP dengan SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan Lemonsoft melalui REST API Lemonsoft:
- Nomor pekerjaan (työnumero), tahap kerja (työvaihe), mesin, struktur produk, material, dan rencana sif dikirim ke SkyPlanner.
- Rencana waktu mulai dan selesai serta mesin yang dipilih dikirim kembali ke tahap kerja.
- Konfirmasi operator dikirim kembali sebagai catatan penyelesaian.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Kaskea Group menggunakan SkyPlanner dengan integrasi Lemonsoft dua arah. Selama proses penyiapan awal, tim SkyPlanner mengonfigurasi integrasi sesuai konfigurasi Lemonsoft Anda dan memberikan dukungan setelah sistem mulai beroperasi. Mitra dan pengembang juga dapat membangun integrasi menggunakan REST API SkyPlanner yang telah didokumentasikan (referensi API).
REST API Lemonsoft
API integrasi Lemonsoft adalah LemonRest, yang didokumentasikan dalam format Swagger 2.0, versi v1. Build “LemonRest 2026.10 release-2026.10.2” mencantumkan 422 path. (Swagger)
- URL dasar berbeda untuk setiap lingkungan. Anda dapat menemukannya di pengelolaan pengguna, pada bagian pengelolaan lingkungan dan alamat layanan, di kolom Rest API. Di platform Azure Lemonsoft, URL dasarnya adalah
https://rest.lemon.fi. - Ketersediaan. Untuk pelanggan layanan platform Lemonsoft (Alustapalvelu), REST API sudah terpasang dan hanya memerlukan hak akses pengguna. (sumber)
- Lingkungan pengujian. Pelanggan akhir memesannya dari Lemonsoft Service Desk.
API pelacakan waktu Kellokortti yang terpisah tidak diperlukan untuk penjadwalan.
Autentikasi
LemonRest menggunakan sesi:
POST /api/auth/logindengan UserName, Password, Database, dan ApiKey mengembalikansession_id.- Kirim nilai tersebut melalui header
Session-Idpada setiap panggilan. - Perbarui sesi dengan
POST /api/auth/renew. GunakanGET /api/auth/aliveuntuk memeriksa kondisi layanan.
POST /api/auth/login/token menerima Token sebagai pengganti nama pengguna dan kata sandi. Buat akun pengguna khusus integrasi dengan kunci API dan berikan hanya hak akses yang dibutuhkan integrasi. (sumber)
Di sisi SkyPlanner, REST API menggunakan token API untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan awal.
Deteksi perubahan: kueri delta
LemonRest tidak menyediakan endpoint webhook atau langganan. Perubahan dibaca menggunakan kueri delta:
GET /api/production/main_ws/changed?updated_after=...mengembalikan job yang berubah sejak proses terakhir dijalankan.- Tambahkan
optimization=true. Parameter ini ditambahkan pada rilis 2026.6.3 untuk menghilangkan ketergantungan pada log dan mempercepat kueri. (catatan rilis) GET /api/log/deletion_eventsmendeteksi job yang dihapus sehingga pekerjaan yang dibatalkan juga dihapus dari jadwal.
Lakukan polling setiap beberapa menit. SkyPlanner mengirim webhook ketika status atau jadwal berubah, sehingga proses penulisan balik dipicu oleh peristiwa tersebut.
Pemetaan data
| Objek Lemonsoft (endpoint) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Tuote, product_code (/api/products) | Produk dan material | Lemonsoft → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
Tuoterakenne beserta baris Työvaiheet (/api/products/structure, all_levels) | Struktur produk, subproduk, tahap proses beserta waktu penyiapannya | Lemonsoft → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Stasiun kerja, kelompok stasiun kerja | Lemonsoft → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
Työnumero sebagai ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Pesanan beserta tenggat dan prioritasnya | Lemonsoft → SkyPlanner | Polling delta setiap beberapa menit |
Työvaihe sebagai ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Job (tahap proses) per stasiun kerja | Lemonsoft → SkyPlanner | Polling delta setiap beberapa menit |
Kebutuhan komponen (main_ws/{worknumber}/materials) | Kebutuhan material per job | Lemonsoft → SkyPlanner | Bersamaan dengan setiap job |
Rencana sif (/api/persons/plannedshifts) | Sif, personel | Lemonsoft → SkyPlanner | Setiap hari, atau sif dikelola di SkyPlanner |
Pesanan penjualan yang terkait dengan nomor pekerjaan (/api/orders/work/{work_number}) | Informasi pelanggan dan prioritas | Lemonsoft → SkyPlanner | Bersamaan dengan setiap job |
start_time, end_time, machine_id pada Työvaihe (PUT /api/production/workstage) | Rencana waktu mulai, waktu selesai, dan stasiun kerja | SkyPlanner → Lemonsoft | Saat jadwal berubah, melalui webhook SkyPlanner |
Catatan penyelesaian (POST main_ws/sub_ws/completion_entry) | Konfirmasi: jumlah selesai dan gagal, jam kerja, personel | SkyPlanner → Lemonsoft | Setiap konfirmasi |
| Aturan penjadwalan yang ditetapkan di SkyPlanner | Stasiun kerja yang diizinkan per job, matriks waktu penyiapan, perkakas | Dikelola di SkyPlanner | Dikonfigurasi selama penyiapan awal |
Pola integrasi
1. Pemuatan awal master data. Baca data mesin dan kelompok mesin, struktur produk beserta tahap kerjanya, serta fase kerja standar. Petakan setiap mesin fisik ke stasiun kerja SkyPlanner. Gunakan mesin induk (Isäkone) hanya untuk pengelompokan karena kapasitasnya merupakan jumlah kapasitas mesin-mesin di bawahnya.
2. Sinkronisasi nomor pekerjaan. Baca nomor pekerjaan yang masih terbuka beserta tahapnya dari /api/production/workstage atau main_ws/sub_ws, dengan filter status dan paginasi. Selanjutnya, perbarui data tersebut menggunakan main_ws/changed. Petakan work_amount_left, bukan work_amount, karena Lemonsoft menjadwalkan berdasarkan jumlah yang tersisa. Data pesanan pembelian digunakan dalam penjadwalan SkyPlanner yang berbasis material, sehingga suatu tahap menunggu tanggal pengiriman pesanan pembelian.
3. Penulisan balik jadwal. Untuk setiap tahap yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner mengirim PUT /api/production/workstage beserta job dan sub_workstages-nya. Setiap tahap memuat start_time dan end_time, serta machine_id jika tahap tersebut dipindahkan ke mesin alternatif.
4. Konfirmasi di lantai produksi. Operator mengonfirmasi pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer. Setiap konfirmasi dikirim ke completion_entry dengan sub_workstage_id, person_number, done_amount, hours, failed_amount, dan job_done. Sertakan material_consumptions jika tahap tersebut menggunakan material. Lemonsoft kemudian membukukan penyelesaian seperti biasa (valmistuskirjaus).
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai beroperasi:
| Data | Pemilik |
|---|---|
| Produk, struktur, tahap kerja, jumlah, status job | Lemonsoft |
| Urutan tahap, waktu mulai dan selesai, pilihan mesin | SkyPlanner |
| Stasiun kerja yang diizinkan per job, matriks waktu penyiapan, perkakas | SkyPlanner |
| Sif dan ketidakhadiran | Satu sistem, dipilih saat penentuan lingkup |
| Pembukuan penyelesaian dan persediaan | Lemonsoft, dibukukan dari konfirmasi SkyPlanner |
Sumber utama konflik adalah penjadwalan otomatis bawaan Lemonsoft dan tindakan penyegaran: keduanya menjadwalkan ulang tahap yang tidak dikunci. Pertahankan AUTOTIMING pada 0 selama SkyPlanner mengendalikan jadwal. Jika Anda tetap mengaktifkannya, terapkan kunci jadwal pada setiap nomor pekerjaan yang ditulis kembali; kunci ini menetapkan seluruh tahap pada nomor tersebut agar tidak bergeser. Koneiden kapasiteetin lukitus saja tidak cukup karena penjadwalan otomatis memindahkan job yang tidak dikunci dari hari yang dikunci. (sumber)
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam beberapa minggu setelah proses penyiapan awal dimulai. Sebelum itu, Anda dapat menjalani uji coba gratis selama 30 hari menggunakan data Anda sendiri dari hasil ekspor Excel yang berisi nomor pekerjaan, tahap kerja, dan mesin.
- Penentuan lingkup. Tetapkan tabel pemetaan, aturan kepemilikan data, dan interval polling.
- Akses. Pelanggan akhir memesan lingkungan pengujian dari Lemonsoft Service Desk serta membuat akun pengguna integrasi dan kunci API.
- Pemuatan awal. Mesin, kelompok mesin, struktur produk, dan tahap kerja.
- Sinkronisasi nomor pekerjaan. Polling delta, peristiwa penghapusan, dan pembaruan sesi.
- Pengaturan batasan di SkyPlanner. Stasiun kerja yang boleh digunakan untuk setiap job, matriks waktu penyiapan, dan perkakas.
- Penulisan balik. Waktu tahapan kerja dan catatan penyelesaian, diuji di lingkungan pengujian.
- Operasi paralel dan pengoperasian resmi. Bandingkan dengan Gantt yang digunakan saat ini, perbaiki master data, lalu aktifkan penulisan balik di lingkungan produksi.
Hal yang perlu direncanakan dalam integrasi Lemonsoft
- Satu mesin per tahapan kerja. Setiap tahapan kerja di Lemonsoft memuat satu mesin. Mesin yang dapat digunakan untuk tiap produk ditentukan dari daftar atau properti produk saat penyiapan awal. SkyPlanner kemudian memilih dari alternatif yang tersedia.
- Kapasitas harian. Kapasitas tetap dinyatakan sebagai jumlah per hari, dan penyimpangannya tidak memiliki waktu spesifik. Modelkan sif yang sebenarnya di SkyPlanner atau baca data sif yang direncanakan.
- Jumlah tersisa. Petakan
work_amount_left. Pengaturan STARTJOB_AUTOTIMENOW dan JOBDONE_AUTOTIMENOW juga menggeser beban kerja di Lemonsoft sendiri. - Sesi memiliki masa berlaku. Perbarui sesi sebelum sinkronisasi yang berlangsung lama dan tangani kondisi saat sistem mewajibkan login ulang.
- Aturan konfirmasi. Validasi setiap konfirmasi terhadap status tahapan kerja sebelum mengirimkannya, dan atur jeda saat mengirim banyak panggilan API sekaligus.
- Dua aplikasi klien. LemonOnline dan versi Windows menggunakan satu basis data yang sama, sehingga integrasi ini melayani keduanya.
- Struktur besar. Gunakan
/api/async/product/structurebersama/api/async/status/{jobId}untuk impor berukuran besar.
Integrasi Lemonsoft: siapa yang mengonfigurasi dan memberikan dukungan
Pekerjaan ini mencakup pemetaan sesuai mesin, tahapan kerja, dan konfigurasi Lemonsoft Anda. Cakupannya juga meliputi aturan penjadwalan yang Anda kelola di SkyPlanner: stasiun kerja yang boleh digunakan untuk setiap job, matriks waktu penyiapan, dan perkakas.
- Tim SkyPlanner mengonfigurasinya saat penyiapan awal dan memberikan dukungan setelah mulai operasional. Setiap pabrik menggunakan Lemonsoft dengan cara berbeda, dan pengetahuan tentang perbedaan itulah yang diterapkan di sini.
- Mitra Lemonsoft Anda dapat ikut terlibat. Mitra memahami konfigurasi Anda dan dapat menangani pengguna API, hak akses, serta lingkungan pengujian. SkyPlanner menyediakan REST API, dokumentasi Swagger/OpenAPI, dan webhook.
- Pengembang internal Anda dapat mengembangkannya lebih lanjut melalui REST API terdokumentasi yang sama dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan.
Setelah terhubung, mesin Arcturus menyusun jadwal berdasarkan data nomor pekerjaan terkini dari Lemonsoft, lalu waktu yang direncanakan dituliskan ke tahapan kerja. Harga SkyPlanner mulai dari 199 € per bulan, termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi disusun di awal sesuai proses dan kebutuhan Anda, bersama paket berlangganan Anda, sehingga seluruh biaya sudah diketahui sebelum Anda mulai.
Lihat perbandingan dengan perencanaan bawaan Lemonsoft di halaman penjadwalan produksi Lemonsoft yang memperhitungkan kapasitas mesin dan tenaga kerja. Gambaran umumnya tersedia di halaman Lemonsoft, sedangkan sistem lainnya dapat Anda temukan di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
Lemonsoftintegrasi dua arah dengan SkyPlanner
Kaskea Group
Manufaktur kontrak: pemesinan CNC, struktur baja, dan perakitan
Produksi direncanakan di SkyPlanner, dengan integrasi dua arah ke Lemonsoft.
Lebih sedikitpenghentian produksi akibat kekurangan material
“Manfaat SkyPlanner bagi kami adalah alat ini benar-benar berguna dalam pekerjaan sehari-hari, terutama untuk menetapkan tanggal pengiriman.”
Tommi Männistö, Manajer Perencanaan Produksi
Eskomatic · Jasa pemesinan kontrak
Penjadwalan beban kerja secara otomatis menghasilkan tanggal pengiriman yang lebih akurat, dan penghentian produksi akibat kekurangan material telah berkurang drastis.
2 jamdihemat setiap minggu
“SkyPlanner telah membawa perencanaan produksi kami dari lembar kerja Excel ke optimasi produksi secara real-time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam waktu kerja setiap minggu, dan antrean kerja baru sampai ke lini produksi dalam hitungan detik.
+90%efisiensi produksi
“Efisiensi produksi telah 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 membutuhkan waktu kurang dari 30 menit.
Pertanyaan umum
Apakah Lemonsoft memiliki API untuk data produksi?
Ya. LemonRest menyediakan akses ke job produksi dan tahapan kerja, mesin, struktur produk, material, sif, serta pencatatan penyelesaian. LemonRest sudah terpasang untuk pelanggan Alustapalvelu dan memerlukan kunci API serta hak akses pengguna.
Apakah Lemonsoft mendukung webhook?
Tidak ada endpoint webhook yang tercantum di LemonRest. Perubahan dibaca melalui kueri delta main_ws/changed dan peristiwa penghapusan, dengan polling setiap beberapa menit. Webhook milik SkyPlanner mengirimkan perubahan jadwal begitu perubahan terjadi.
Bagaimana waktu yang direncanakan ditulis kembali ke Lemonsoft?
Melalui PUT /api/production/workstage, yang memperbarui job beserta tahapan kerjanya dengan waktu mulai, waktu selesai, dan mesin. Nonaktifkan penjadwalan otomatis Lemonsoft selama SkyPlanner mengendalikan jadwal, atau aktifkan penguncian jadwal pada setiap nomor pekerjaan yang diperbarui, agar waktu yang ditetapkan SkyPlanner tidak berubah.
Bisakah konfirmasi operator dari SkyPlanner dikirim ke Lemonsoft?
Ya. Setiap konfirmasi dikirim sebagai catatan penyelesaian yang memuat jumlah selesai dan gagal, jam kerja, serta personel. Proses ini dijalankan setiap hari dalam proyek pelanggan.
Siapa yang membangun integrasi Lemonsoft?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai konfigurasi Lemonsoft Anda saat penyiapan awal dan memberikan dukungan setelah mulai operasional. Mitra Lemonsoft atau pengembang internal Anda juga dapat mengembangkannya melalui REST API SkyPlanner yang terdokumentasi. Token API sudah cukup untuk memulai.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor Excel atau CSV dari Lemonsoft, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
