Panduan Integrasi Visma L7 dengan APS untuk Penjadwalan Produksi
Panduan integrasi Visma L7 ini menjelaskan kepada mitra dan tim TI cara menghubungkan Visma L7 ke SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan Visma L7 melalui Visma L7 REST API:
- Nomor pekerjaan (työnumero), tahapan pekerjaan (työnvaihe), sumber daya produksi, struktur produk, komponen, material, saldo stok, baris penjualan, dan baris pembelian dikirim ke SkyPlanner.
- Sumber daya produksi, tanggal mulai, prioritas, personel, dan jam kerja per hari untuk setiap kartu kerja dikirim kembali melalui
PUT /manufphases/. - Kapasitas dalam kalender sumber daya produksi disinkronkan melalui
POST /resourceupdates/. - Kejadian produksi yang dicatat dalam antrean kerja L7 dibaca kembali melalui
GET /manufevents/. - Webhook SkyPlanner mengirimkan perubahan jadwal segera saat terjadi.
Tim SkyPlanner mengonfigurasi integrasi sesuai konfigurasi L7 Anda selama proses orientasi dan memberikan dukungan setelah sistem mulai digunakan. Mitra dan pengembang juga dapat mengembangkan integrasi menggunakan REST API SkyPlanner yang terdokumentasi (referensi API).
REST API Visma L7
API yang digunakan adalah Visma L7 – REST API, dengan dokumentasi OpenAPI 3.0.3 beserta catatan perubahan (dokumentasi). API ini berjalan di Visma LTR.
- Path dasar adalah
/ltrws/REST/L7pada host LTR Anda, baik di infrastruktur lokal maupun di layanan hosting aplikasi Visma. - Lisensi. Setiap endpoint memerlukan lisensi tersendiri. Penulisan jadwal memerlukan lisensi L7RMFPP untuk
PUT /manufphases/, sedangkan pembaruan kapasitas memerlukan L7RMCAP. Endpoint baca juga memerlukan lisensinya masing-masing. - Paginasi. Daftar dibagi menjadi halaman menggunakan
pageSizedanrecAfter, serta difilter menggunakanqueryKey1,queryKey2, danqueryString.
Autentikasi
Dua token disertakan dalam setiap panggilan L7:
- hash menentukan basis data dan perusahaan.
- token mengidentifikasi pengguna API.
Administrator LTR Anda membuat pengguna API di Visma LTR, menghubungkannya ke perusahaan L7, memberikan profil akses, dan membuat token pengguna (mulai di sini). Gunakan akun pengguna khusus integrasi dengan hak akses sebatas yang diperlukan integrasi.
Di sisi SkyPlanner, autentikasi REST API menggunakan token API yang dikirim melalui header Authorization-Token. Anda membuatnya di Settings > API. Tutorial integrasi memandu Anda melakukan panggilan pertama.
Deteksi perubahan: modifiedAfter
L7 REST API tidak menyediakan webhook. Perubahan dibaca melalui polling:
- Aktifkan pencatatan perubahan (DBLOG) di pemeliharaan berkas L7 (Tiedostohuolto) untuk tabel yang dibaca oleh integrasi, seperti kartu kerja dan komponen.
- Panggil endpoint baca dengan nilai
modifiedAfterdiatur ke waktu eksekusi terakhir. Rekaman yang dihapus dikembalikan dengan penanda sudah dihapus, sehingga pekerjaan yang dibatalkan dikeluarkan dari jadwal. - Lakukan polling setiap beberapa menit. SkyPlanner mengirimkan webhook saat status atau jadwal berubah, sehingga penulisan balik dipicu oleh kejadian.
Pemetaan data
| Objek Visma L7 (endpoint) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Tuote (GET /products/) | Produk dan material | L7 → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
Komponen untuk suatu nomor pekerjaan (GET /manufcomponents/) | Subproduk | L7 → SkyPlanner | Polling dengan modifiedAfter |
Kebutuhan material (GET /manufmaterials/) | Kebutuhan material per job | L7 → SkyPlanner | Polling dengan modifiedAfter |
Hierarki sumber daya produksi (KRYH) beserta jumlah mesin (GET /manufresources/) | Stasiun kerja dan kelompok stasiun kerja | L7 → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
Kartu kerja (TSUUNR) per tahapan (GET /manufphases/) | Job (langkah proses) per stasiun kerja | L7 → SkyPlanner | Polling setiap beberapa menit |
Saldo stok (GET /stockbalances/) | Stok | L7 → SkyPlanner | Polling |
Baris pembelian (GET /purchaserows/) | Pesanan pembelian beserta tanggal pengiriman | L7 → SkyPlanner | Polling |
Pesanan dan baris penjualan (GET /salesorders/, GET /salesrows/) | Tenggat pengiriman, prioritas pelanggan | L7 → SkyPlanner | Polling |
Kejadian produksi (GET /manufevents/) | Progres per job | L7 → SkyPlanner | Polling |
Field kartu kerja: resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Stasiun kerja, waktu mulai, urutan, dan jam kerja harian yang direncanakan | SkyPlanner → L7 | Saat jadwal berubah, melalui webhook SkyPlanner |
Kapasitas dalam kalender sumber daya produksi (POST /resourceupdates/) | Kapasitas sif | SkyPlanner → L7 | Saat sif berubah |
| Aturan penjadwalan yang ditetapkan di SkyPlanner | Stasiun kerja yang diizinkan, matriks waktu penyiapan, alat, personel | Dikelola di SkyPlanner | Dikonfigurasi selama proses orientasi |
Pola integrasi
1. Pemuatan awal master data. Baca hierarki sumber daya produksi dan petakan setiap mesin ke stasiun kerja tersendiri di SkyPlanner. Jika satu sumber daya produksi L7 memiliki beberapa mesin, buat satu stasiun kerja untuk setiap mesin dan satu kelompok stasiun kerja untuk sumber daya tersebut. Baca produk dan struktur produk beserta tahapan pekerjaannya.
2. Sinkronisasi nomor pekerjaan. Baca kartu kerja yang masih terbuka melalui GET /manufphases/, lalu perbarui datanya menggunakan modifiedAfter. Baca komponen dan kebutuhan material untuk setiap nomor pekerjaan, beserta saldo stok dan baris pembelian, agar tahapan menunggu tanggal pengiriman pada baris pembeliannya.
3. Penulisan balik jadwal. Untuk setiap tahapan yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner memanggil PUT /manufphases/. Isi permintaan memuat satu entri workSheet per kartu kerja yang mencakup:
numberuntuk kartu kerja, danresourceuntuk sumber daya produksi yang dipilihstartDatedanpriority, agar antrean kerja L7 menampilkan urutan dari SkyPlannerperson, jika operator tertentu ditetapkan dalam rencanaschedulingDaysuntuk jam kerja yang direncanakan per tanggal
L7 mempertahankan prioritas yang ditetapkan oleh sistem eksternal tanpa mengubahnya (sumber), sehingga urutan dalam antrean kerja tetap terjaga.
4. Sinkronisasi kapasitas. Ketika sif, hari libur, atau lembur berubah di SkyPlanner, POST /resourceupdates/ menuliskan kapasitas baru ke kalender sumber daya produksi L7. Tampilan beban kerja L7 pun sesuai dengan rencana.
5. Progres di lantai produksi. Operator tetap mencatat aktivitas di antrean kerja L7 dan Visma LTR, lalu SkyPlanner membaca kejadian tersebut melalui GET /manufevents/. Operator juga dapat mengonfirmasi pekerjaan di SkyPlanner Mobile Confirmations. Autopilot menyusun ulang rencana berdasarkan data dari salah satu sumber tersebut, dan penulisan balik berikutnya mengirimkan waktu yang baru.
6. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Produk, struktur, tahapan pekerjaan, kuantitas, status nomor pekerjaan | Visma L7 |
| Urutan tahapan, tanggal mulai, jam kerja harian, pilihan sumber daya produksi | SkyPlanner |
| Stasiun kerja yang diizinkan, matriks waktu penyiapan, alat, personel | SkyPlanner |
| Sif dan ketidakhadiran | SkyPlanner, ditulis ke kalender sumber daya produksi L7 |
| Kejadian produksi dan pencatatan stok | Antrean kerja Visma L7 dan LTR |
Sumber konflik utama adalah fungsi perencanaan L7 sendiri. Perhitungan kebutuhan dan perencanaan terperinci dapat menjadwalkan ulang tahapan yang tidak dikunci. Jalankan keduanya hanya untuk material dan reservasi, dan jangan jadwalkan ulang tahapan yang dikelola SkyPlanner.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam beberapa minggu setelah proses orientasi dimulai. Sebelumnya, uji coba gratis selama 30 hari menggunakan data Anda sendiri dari ekspor Excel yang memuat nomor pekerjaan, tahapan, dan sumber daya produksi.
- Penentuan lingkup. Tetapkan tabel pemetaan, aturan kepemilikan data, dan interval polling.
- Akses dan lisensi. Dapatkan lisensi untuk endpoint REST yang termasuk dalam lingkup. Administrator LTR membuat pengguna API, hash, dan token, idealnya terlebih dahulu di perusahaan uji.
- Pencatatan perubahan. Aktifkan DBLOG untuk tabel yang Anda baca.
- Pemuatan awal. Sumber daya produksi, produk, struktur, dan tahapan pekerjaan.
- Sinkronisasi nomor pekerjaan. Polling dengan modifiedAfter, penanganan penghapusan, dan paginasi.
- Pengaturan batasan di SkyPlanner. Stasiun kerja yang diizinkan, matriks waktu penyiapan, alat, dan personel.
- Penulisan balik.
PUT /manufphases/danPOST /resourceupdates/, diuji di perusahaan uji. - Pengoperasian paralel dan mulai beroperasi. Bandingkan dengan rencana saat ini, perbaiki master data, lalu aktifkan penulisan balik di lingkungan produksi.
Hal yang perlu direncanakan untuk integrasi Visma L7
- Lisensi per endpoint. Daftarkan semua endpoint sejak awal dan pastikan lisensinya tersedia sebelum pengujian.
- Jumlah mesin. Sumber daya produksi yang memiliki beberapa mesin akan membagi pekerjaan di L7 (sumber). Pisahkan menjadi beberapa stasiun kerja di SkyPlanner, lalu tulis kembali sumber daya produksi yang diharapkan L7.
- Jam per hari. L7 menyimpan rencana sebagai jumlah jam per tanggal. SkyPlanner mengirimkan
schedulingDaysyang totalnya sama dengan durasi tahap kerja. - Kalender pabrik. Pastikan kalender terisi lengkap karena tanggal yang kosong akan menggeser tahap kerja ke masa lalu (sumber).
- Pesanan untuk stok.
mainNumber,subNumber,rowNumber, dannewQuantityhanya digunakan untuk mengubah kuantitas pesanan untuk stok. Jangan sertakan field tersebut untuk pekerjaan pesanan pelanggan. - ERP pengganti. Visma telah menghentikan pengembangan baru L7, dan penggunaan produk ini berakhir pada akhir 2028 (pemberitahuan Visma). Simpan aturan penjadwalan di SkyPlanner, bukan di field L7, agar aturan tersebut tetap dapat digunakan saat Anda berganti ERP.
Integrasi Visma L7: siapa yang mengonfigurasi dan memberikan dukungan
Pekerjaan ini mencakup pemetaan sesuai sumber daya produksi, tahap kerja, dan konfigurasi L7 Anda. Cakupannya juga meliputi aturan penjadwalan yang Anda simpan di SkyPlanner: stasiun kerja yang diizinkan, matriks waktu penyiapan, perkakas, dan tenaga kerja.
- Tim SkyPlanner mengonfigurasinya selama proses penerapan awal dan memberikan dukungan setelah sistem mulai digunakan. Setiap pabrik menggunakan L7 dengan cara berbeda, dan pengetahuan tentang cara kerja tersebut diterapkan di sini.
- Mitra Visma Anda dapat ikut terlibat. Mitra memahami konfigurasi L7 dan LTR Anda serta dapat menangani pengguna API, lisensi, dan perusahaan uji. SkyPlanner menyediakan REST API, dokumentasi Swagger/OpenAPI, dan webhook.
- Tim pengembang Anda juga dapat mengembangkannya menggunakan REST API terdokumentasi yang sama dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu saat diperlukan.
Saat Anda mengganti L7, konfigurasi SkyPlanner yang sama dapat dihubungkan ke ERP baru. Lihat halaman Business Central, Visma Net, Lemonsoft, Monitor ERP, dan Odoo.
Harga SkyPlanner mulai dari 199 € per bulan, termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi disampaikan di awal sesuai proses dan kebutuhan Anda, bersama paket langganan Anda, sehingga seluruh biaya sudah jelas sebelum Anda memulai.
Lihat perbandingan dengan kemampuan perencanaan bawaan L7 dalam Apakah Visma L7 mendukung penjadwalan produksi sesuai kapasitas nyata? Gambaran umumnya tersedia di halaman Visma L7, sedangkan sistem lainnya dapat Anda temukan di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
1.000-anperintah kerja dijadwalkan secara otomatis
“Kini kami mengendalikan produksi dengan cara yang berbeda, dan pemahaman kami tentang kapasitas sudah berada di tingkat yang sama sekali berbeda.”
Hannu Ryynänen, CEO
Mamec · Mixer industri, pompa, dan manufaktur kontrak berteknologi tinggi
Ribuan perintah kerja dijadwalkan secara otomatis, dan seluruh organisasi dapat memantau produksi secara real-time.
98%keandalan pengiriman, naik dari sekitar 50%
“SkyPlanner berperan sangat penting dalam menjaga keandalan pengiriman kami.”
Hannu Lahtinen, Direktur Utama
KJH-Comp · Komponen mekanis pelat logam dan manufaktur kontrak
Keandalan pengiriman meningkat dari sekitar 50% hingga mencapai 98%, dan penjadwalan kini hanya memerlukan satu supervisor, bukan dua.
2 jamdihemat setiap minggu
“SkyPlanner telah mengalihkan perencanaan produksi kami dari lembar kerja Excel ke optimalisasi produksi secara real-time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel distribusi 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 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 Visma L7 memiliki API untuk data produksi?
Ya. REST API Visma L7 di Visma LTR menyediakan akses ke tahap kerja, sumber daya produksi, komponen, material, peristiwa produksi, produk, saldo stok, baris penjualan, dan baris pembelian. Setiap endpoint memerlukan lisensi tersendiri, dan administrator LTR membuat pengguna API beserta tokennya.
Bagaimana jadwal ditulis kembali ke Visma L7?
Melalui PUT /manufphases/, yang memperbarui sumber daya produksi, tanggal mulai, prioritas, personel, dan jam yang direncanakan per tanggal untuk setiap kartu kerja. POST /resourceupdates/ menuliskan kapasitas pada kalender sumber daya produksi. L7 mempertahankan prioritas dari sistem eksternal, sehingga antrean kerja mengikuti urutan SkyPlanner.
Apakah Visma L7 mendukung webhook?
Tidak ada webhook yang didokumentasikan. Aktifkan pencatatan perubahan untuk tabel yang termasuk dalam lingkup integrasi, lalu lakukan polling dengan modifiedAfter. Webhook milik SkyPlanner mengirimkan perubahan jadwal begitu perubahan terjadi.
Perangkat lunak penjadwalan apa yang terintegrasi dengan Visma L7?
SkyPlanner APS terintegrasi dua arah dengan Visma L7 melalui REST API L7, dan Visma mencantumkan Skycode beserta SkyPlanner di halaman integrasi L7. Tim SkyPlanner mengonfigurasinya selama proses penerapan awal.
Siapa yang membangun integrasi Visma L7?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai konfigurasi L7 Anda selama proses penerapan awal dan memberikan dukungan setelah sistem mulai digunakan. Mitra Visma atau tim pengembang Anda juga dapat mengembangkannya menggunakan REST API SkyPlanner yang terdokumentasi, dan 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 L7, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
