Integrasi / ERP / Visma Net ERP
Panduan Integrasi Visma Net untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Visma Net ini menjelaskan kepada mitra dan tim TI cara menghubungkan Visma Net (Visma.net ERP) ke SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan Visma Net melalui Visma Net API:
- Data barang stok, Kit specifications, pesanan penjualan, tingkat persediaan, dan pesanan pembelian masuk ke SkyPlanner.
- Job yang dijadwalkan menjadi Kit assemblies, yang dirilis setelah pekerjaan selesai.
- Jam kerja operator dikirim kembali sebagai Employee time cards.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Tim SkyPlanner mengonfigurasi integrasi sesuai konfigurasi Visma Net Anda selama proses orientasi dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin terlibat, atau membangun integrasi sendiri menggunakan REST API SkyPlanner yang terdokumentasi (referensi API).
Antarmuka integrasi Visma Net
- Visma Net ERP API. Menggunakan REST dengan spesifikasi OpenAPI yang masih bernama “Visma.net ERP API v1”, serta path v1 dan v2. URL dasarnya adalah
https://api.finance.visma.net. Akses ke domain lamaintegration.visma.netdibatasi kecepatannya mulai 1 Februari 2026 dan domain tersebut sedang dinonaktifkan (pemberitahuan). - SalesOrder service v3 tersedia di
https://salesorder.visma.net. Endpoint pesanan penjualan v1 dan v2 telah mencapai akhir masa pakai. - Webhook melalui Visma Developer Portal.
- Background API. Header
erp-api-backgroundmemasukkan panggilan yang memerlukan waktu lama ke antrean, mengembalikan 202 beserta ID job, lalu memberi tahu Anda saat hasilnya siap. - Skenario impor dan ekspor di Visma Net, dengan penyedia data CSV, Excel, atau SQL, untuk memuat master data satu kali.
API ini tidak memiliki endpoint untuk perintah produksi, routing, atau work center karena objek tersebut tidak tersedia di Visma Net. Data penjadwalan bersumber dari barang, kit, pesanan, dan persediaan:
GET /v1/inventory: barang stok dan nonstok, termasuk penanda kit dan kelas barangGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: baris komponen untuk setiap revisiGET /v1/kitassembly: data perakitan yang sudah ada, dapat difilter menurut jenis dan status- SalesOrder service v3: permintaan beserta tanggal yang diminta dan baris rinciannya
GET /v1/inventorysummary/{inventoryNumber}: jumlah stok fisik dan stok tersedia di setiap gudangGET /v1/purchaseorderdanGET /v2/PurchaseReceipt: material yang akan masuk dan penerimaan barang
Semua endpoint daftar menerima lastModifiedDateTime dengan lastModifiedDateTimeCondition, serta pageNumber dan pageSize. Dengan demikian, setiap sinkronisasi dapat dilakukan secara inkremental.
Autentikasi dan batas penggunaan
Visma Net menggunakan Visma Connect (OpenID Connect dan OAuth 2.0):
- Daftarkan Service Integration di Visma Developer Portal.
- Administrator tenant menyetujui integrasi di Visma Net milik pelanggan.
- Minta token menggunakan alur client credentials di
https://connect.visma.com/connect/token, dengan menyertakantenant_iddan cakupan API sepertivisma_api:read. Token berlaku selama 3.600 detik.
Batas laju permintaan berlaku dalam jendela waktu tetap per jam untuk setiap perusahaan dan klien. Respons menyertakan X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset. Jika batas terlampaui, API mengembalikan 429 dengan Retry-After (batas laju permintaan). Header ETag dan If-Match melindungi proses pembaruan.
Mitra melakukan pengujian pada perusahaan demo melalui Integrator Programme gratis dari Visma. 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.
Event, webhook, dan polling
Webhook di Visma Developer Portal mencakup event yang penting untuk penjadwalan:
- Inventory Item Created, Updated, dan Changed
- Purchase Order Changed dan Status Changed
- Sales Order Changed dan Status Changed, yang beralih ke penerbit SalesOrderService
Tidak ada event untuk Kit assembly atau Kit specifications. SkyPlanner mengambil data tersebut melalui polling dengan filter lastModifiedDateTime. Saldo persediaan diambil melalui polling saat proses penjadwalan dijalankan. Untuk arah sebaliknya, SkyPlanner mengirim webhook saat status atau jadwal berubah.
Pemetaan data
| Objek Visma Net (endpoint) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Produk dan material | Visma Net → SkyPlanner | Pemuatan awal, lalu webhook |
Kit specifications (/v1/KitSpecifications) | Struktur produk, material per produk | Visma Net → SkyPlanner | Pemuatan awal, lalu polling |
| Pesanan penjualan (SalesOrder service v3) | Pesanan beserta tenggat dan prioritas pelanggan | Visma Net → SkyPlanner | Webhook |
Kit assembly berstatus On hold (/v1/kitassembly), jika data perakitan dibuat di Visma Net | Job | Visma Net → SkyPlanner | Polling |
Inventory summary (/v1/inventorysummary) | Saldo persediaan per gudang | Visma Net → SkyPlanner | Polling saat proses penjadwalan dijalankan |
Pesanan pembelian, penerimaan pembelian (/v1/purchaseorder, /v2/PurchaseReceipt) | Material yang akan masuk beserta tanggal pengirimannya; persediaan diperbarui saat barang pesanan pembelian diterima | Visma Net → SkyPlanner | Webhook, lalu pembacaan data |
| Tidak tersedia di Visma Net | Tahapan proses, stasiun kerja, sif, matriks waktu penyiapan, perkakas, sumber daya alternatif | Dikelola di SkyPlanner | Disiapkan selama proses orientasi |
Pembuatan dan pembaruan Kit assembly (POST/PUT /v1/kitassembly) | Job terjadwal: barang kit, kuantitas, tanggal selesai yang direncanakan | SkyPlanner → Visma Net | Saat jadwal berubah, melalui webhook SkyPlanner |
Rilis Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Job selesai: hasil produksi dan konsumsi komponen | SkyPlanner → Visma Net | Saat selesai |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, rilis) | Hasil produksi dan pemakaian material jika tidak menggunakan kit | SkyPlanner → Visma Net | Saat selesai |
Employee time card (/v1/timeCard) | Jam kerja yang dicatat per operator | SkyPlanner → Visma Net | Mingguan |
Pola integrasi
1. Pemuatan awal master data. Baca data barang stok, kelas barang, dan revisi Kit specification terbaru untuk setiap kit. Petakan setiap baris komponen ke material di SkyPlanner. Lalu siapkan data yang tidak disimpan di Visma Net: stasiun kerja, sif, tahapan proses beserta waktu penyiapan dan pengerjaannya, matriks waktu penyiapan, serta kebutuhan perkakas. Impor data tersebut dalam format CSV atau Excel. Inilah bagian terbesar dari proyek ini.
2. Sinkronisasi pesanan. Pilih satu model permintaan:
- Berbasis pesanan penjualan. Baris pesanan penjualan yang masih terbuka untuk barang kit menjadi pesanan SkyPlanner, dengan tanggal yang diminta sebagai tenggat.
- Berbasis perakitan. Kit assemblies yang dibuat di Visma Net dengan status On hold menjadi job SkyPlanner.
Pesanan pembelian yang masih terbuka masuk beserta tanggalnya. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman pesanan pembelian dan memperbarui persediaan saat pesanan tersebut ditandai Delivered. Dengan data ini dan ringkasan persediaan, proses penjadwalan memeriksa stok yang ada serta pembelian yang akan masuk.
3. Penulisan balik jadwal. Untuk konfigurasi berbasis pesanan penjualan, SkyPlanner membuat Kit assembly bertipe Production untuk setiap job terjadwal. SkyPlanner menetapkan barang kit, revisi, gudang, kuantitas, dan komponen, lalu menautkan data perakitan tersebut ke baris pesanan penjualan. Tanggal perakitan adalah tanggal selesai yang direncanakan. Saat Autopilot memindahkan job, panggilan PUT memperbarui tanggal tersebut sebelum dirilis.
Kit assembly memiliki satu kolom Date. Karena itu, waktu pada tingkat operasi tetap disimpan di SkyPlanner, sementara Visma Net menerima tanggal yang diperlukan untuk penjualan dan persediaan.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui Mobile Confirmations atau Production Timer. Catatan waktu ini menjaga jadwal tetap mutakhir. Setelah tahap terakhir selesai, SkyPlanner memanggil aksi rilis pada Kit assembly. Proses rilis membukukan hasil produksi dan konsumsi komponen, lalu diikuti batch buku besar. Jam kerja direkap ke Employee time cards mingguan, atau ke transaksi proyek untuk pekerjaan berbasis proyek.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum integrasi mulai digunakan:
| Data | Pemilik |
|---|---|
| Item, Kit specifications, pesanan penjualan, pesanan pembelian, stok, biaya | Visma Net |
| Tahapan proses, stasiun kerja, sif, persiapan, perkakas | SkyPlanner |
| Urutan job, waktu mulai dan selesai, penetapan stasiun kerja | SkyPlanner |
| Tanggal Kit assembly sebelum dirilis | SkyPlanner |
| Kit assemblies dan time cards yang sudah dirilis | Visma Net, dibukukan dari SkyPlanner |
Perubahan pada Kit specification menghasilkan revisi baru. Baca ulang revisi terbaru dan petakan kembali, karena hanya revisi terakhir yang dapat digunakan untuk perakitan. Perubahan komponen secara manual pada dokumen perakitan tetap berlaku di Visma Net, sehingga SkyPlanner membaca ulang dokumen tersebut sebelum merilisnya.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu setelah proses orientasi dimulai. Sebelumnya, Anda dapat menjalankan uji coba gratis selama 30 hari dengan data Anda sendiri dari skenario ekspor Visma Net, yang diimpor dalam format CSV atau Excel.
- Penentuan lingkup. Tetapkan model permintaan, tabel pemetaan, aturan kepemilikan data, dan tujuan penulisan balik (Kit assembly atau Inventory receipt).
- Konfigurasi Visma Connect. Daftarkan Service Integration dan dapatkan persetujuan administrator tenant. Lakukan pengujian di perusahaan demo terlebih dahulu.
- Model produksi. Siapkan stasiun kerja, sif, tahapan proses, persiapan, dan perkakas di SkyPlanner.
- Pemuatan data awal. Muat item persediaan, kelas item, Kit specifications, gudang, dan stok.
- Sinkronisasi pesanan dan pesanan pembelian. Gunakan webhook untuk pesanan penjualan, pesanan pembelian, dan item; gunakan polling untuk kit dan stok. Pembaruan token dan penanganan 429 juga diterapkan pada tahap ini.
- Penulisan balik. Pembuatan, pembaruan, dan rilis Kit assembly, serta penulisan balik time cards.
- Pengujian paralel. Jalankan SkyPlanner berdampingan dengan rencana yang digunakan saat ini, lalu bandingkan tanggalnya.
- Mulai digunakan. Aktifkan penulisan balik setelah data cocok.
Hal yang perlu direncanakan dalam integrasi Visma Net
- Tidak ada routing untuk diimpor. Semua tahapan proses, waktu persiapan, dan waktu pengerjaan dibuat di SkyPlanner. Rencanakan pekerjaan yang diperlukan dan tetapkan penanggung jawabnya.
- Advanced logistics. Kit assembly memerlukan grup Advanced logistics. Pada Standard logistics, bukukan hasil produksi dengan Inventory receipt dan Inventory issue.
- Revisi terkunci. Revisi Kit specification yang sudah digunakan tidak dapat diedit, dan hanya revisi terbaru yang dapat digunakan untuk perakitan.
- Satuan ukur. Kit assembly memiliki satuan ukurnya sendiri. Saat mengimpor, sesuaikan satuan tersebut dengan kuantitas di SkyPlanner.
- Polling tanpa event. Kit tidak memiliki webhook. Ambil hanya perubahan berdasarkan
lastModifiedDateTime, bukan memuat ulang seluruh data, agar tidak melampaui batas permintaan per jam. - Endpoint terkini. Bangun integrasi hanya dengan
api.finance.visma.netdan SalesOrder service v3. - Persetujuan tenant. Autentikasi dengan client credentials akan gagal sampai administrator tenant menyetujui aplikasi. Jadwalkan langkah ini sejak awal.
- Kartu waktu mingguan. Kartu waktu memerlukan Advanced financials dan dicatat per minggu. Rekap jam kerja operator per minggu atau bukukan ke transaksi proyek.
Siapa yang mengonfigurasi dan mendukung integrasi Visma Net
- Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah integrasi mulai digunakan. Cakupannya meliputi sisi SkyPlanner, model produksi yang tidak tersedia di Visma Net, dan panggilan API Visma Net yang telah disepakati. Setiap pabrik menggunakan Visma Net dengan cara berbeda, dan pengetahuan tersebut diterapkan di tahap ini.
- Mitra Visma Net Anda dapat ikut terlibat. Visma menyediakan Visma Net bersama mitra bersertifikasi Visma yang memahami konfigurasi Anda dan dapat meninjau pemetaan serta aplikasi Visma Connect. SkyPlanner menyediakan REST API, dokumentasi Swagger/OpenAPI, dan webhook.
- Pengembang internal Anda dapat membangun integrasinya menggunakan REST API terdokumentasi yang sama dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan. Dokumentasi publik tersedia di dokumentasi SkyPlanner.
Setelah terhubung, mesin Arcturus menyusun jadwal berdasarkan pesanan terkini dari Visma Net, dan pekerjaan yang selesai dikirim kembali ke Visma Net sebagai Kit assemblies yang sudah dirilis. Harga 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 terlihat sebelum Anda memulai.
Lihat harga, pelajari alasan Visma Net memerlukan alat penjadwalan di penjadwalan produksi Visma Net yang memperhitungkan kapasitas nyata mesin dan tenaga kerja, baca gambaran umumnya di halaman Visma Net, dan temukan ERP lainnya di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
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 distribusi listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam 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 optimal untuk tiga bulan di seluruh stasiun kerja membutuhkan waktu kurang dari 30 menit.
98%keandalan pengiriman, naik dari sekitar 50%
“SkyPlanner berperan penting dalam menjaga keandalan pengiriman kami.”
Hannu Lahtinen, Direktur Utama
KJH-Comp · Fabrikasi pelat logam dan manufaktur kontrak
Keandalan pengiriman naik dari sekitar 50% hingga mencapai 98%, dan penjadwalan kini hanya membutuhkan satu supervisor, bukan dua.
6 bulanke depan: kapasitas tersedia dapat dilihat tim penjualan
“SkyPlanner menjadi landasan yang andal bagi seluruh perencanaan produksi.”
Anu Järvinen, Manajer Produksi
Fredman Operations · Kertas kemasan yang aman untuk pangan
Tim penjualan dapat melihat kapasitas yang tersedia hingga enam bulan ke depan. Permintaan perubahan jadwal yang sebelumnya membutuhkan satu jam atau lebih kini dijawab dalam hitungan detik.
Pertanyaan umum
Apakah API Visma Net memiliki pesanan produksi?
Tidak. Visma Net tidak memiliki objek pesanan produksi, routing, atau work center, sehingga API-nya juga tidak menyediakannya. Dokumen produksinya adalah Kit assembly di /v1/kitassembly, sedangkan routing dan stasiun kerja disimpan di SkyPlanner.
Autentikasi apa yang digunakan integrasi ini?
Visma Connect dengan alur client credentials OAuth 2.0, yang didaftarkan sebagai Service Integration di Visma Developer Portal. Administrator tenant memberikan persetujuan, dan token berlaku selama satu jam.
Apakah Visma Net dapat mengirim perubahan secara real time?
Untuk item, pesanan penjualan, dan pesanan pembelian, bisa, melalui webhook Visma Developer Portal. Kit assemblies dan Kit specifications tidak memiliki event, sehingga perubahannya diambil melalui polling inkremental. Webhook SkyPlanner sendiri mengirim perubahan jadwal segera saat perubahan terjadi.
Bagaimana hasil produksi yang sudah selesai ditulis kembali ke Visma Net?
SkyPlanner membuat Kit assembly untuk setiap job yang dijadwalkan, memperbarui tanggalnya, dan memanggil tindakan release saat job selesai. Tindakan release membukukan hasil produksi dan pemakaian komponen. Jika tidak menggunakan kit, Inventory receipt dan Inventory issue menjalankan fungsi yang sama.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Bisa. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor CSV atau Excel dari Visma Net, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
