Panduan Integrasi Exact Online untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Exact Online ini menjelaskan kepada mitra Exact dan tim TI cara menghubungkan Exact Online Manufacturing dengan SkyPlanner APS. Integrasi SkyPlanner dengan Exact Online berjalan dua arah:
- Perintah produksi, langkah routing, rencana material, work center, operasi, dan daftar kebutuhan material masuk melalui REST API Exact Online.
- Data barang, posisi stok, pesanan pembelian, dan pesanan penjualan masuk, dengan webhook Exact Online yang mengirimkan perubahannya.
- Tanggal mulai dan selesai yang direncanakan dikirim kembali ke setiap langkah routing dan perintah produksi.
- Catatan waktu operator dibukukan sebagai transaksi waktu, sedangkan kuantitas yang selesai dibukukan sebagai penerimaan hasil perintah produksi.
Tim SkyPlanner mengonfigurasi integrasi sesuai pengaturan Exact Online 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). Bagian singkat tentang Exact Globe+ tersedia di akhir panduan.
REST API Exact Online untuk manufaktur
Exact Online menyediakan akses data melalui satu REST API, dengan resource yang dikelompokkan menurut layanan. Path dasarnya adalah /api/v1/{division}/<service>/<resource>, dengan division merujuk pada perusahaan di Exact Online. Referensi REST API mencantumkan resource berikut dalam layanan manufaktur untuk penjadwalan:
| Resource API | Data yang tersedia | Metode |
|---|---|---|
manufacturing/ShopOrders | Nomor perintah produksi, barang, PlannedQuantity, PlannedStartDate, PlannedDate, status, penanda sudah dirilis | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Langkah routing per perintah produksi: operasi, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Baris material per perintah produksi | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Kode, jenis, area produksi, nilai kapasitas, tarif | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Operasi beserta work center tempat masing-masing dijalankan, waktu persiapan dan waktu proses | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Versi BOM, komponen, dan routing | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Jam yang dibukukan per perintah produksi dan langkah routing | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Kuantitas hasil produksi yang diterima dari suatu perintah produksi | GET, POST |
manufacturing/MaterialIssues | Material yang dikeluarkan untuk suatu perintah produksi | GET, POST |
manufacturing/ShopOrderPriorities | Mode prioritas per perintah produksi | GET, PUT |
Dari layanan lainnya:
| Resource API | Data yang tersedia |
|---|---|
logistics/Items | Master data barang |
inventory/ItemWarehouses | Stok per barang dan gudang |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Pesanan pembelian yang belum selesai dan tanggal penerimaan |
salesorder/SalesOrders, SalesOrderLines | Permintaan pelanggan dan tanggal pengiriman |
Autentikasi dan akses
Exact Online menggunakan OAuth 2.0 dengan alur authorization code dan refresh token. Menurut Exact: “Before you can start integration with Exact Online, you must first register your app in the App Store.” (Sebelum memulai integrasi dengan Exact Online, Anda harus mendaftarkan aplikasi di App Store.) (Bantuan Exact Online) Pendaftaran aplikasi memerlukan langganan Exact Online Developer (Exact App Store).
- Integrasi didaftarkan sebagai aplikasi dengan redirect URI.
- Pengguna Exact Online yang memiliki akses ke manufaktur, persediaan, dan pembelian memberikan persetujuan satu kali.
- Setiap permintaan mengirimkan
Authorization: Bearer <access_token>dan menyertakan division dalam path. - Access token diperbarui menggunakan refresh token. Exact membatasi seberapa sering token baru dapat diminta, jadi simpan token dalam cache hingga masa berlakunya habis.
Exact juga membatasi jumlah panggilan per menit dan per hari untuk setiap aplikasi dan perusahaan, serta meminta agar panggilan dilakukan secara berurutan, bukan paralel. Batas yang berlaku saat ini tercantum dalam artikel batas API dari Exact. Integrasi dirancang untuk mengikuti batas tersebut: pembacaan data difilter dengan $filter dan $select, sedangkan Sync API digunakan untuk perubahan massal.
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 panggilan awal.
Webhook dan polling
Webhook Exact Online mengirimkan POST ke URL callback Anda ketika topik yang dilanggan berubah, dengan tanda tangan berupa hash HMAC SHA256 (webhook). Topiknya mencakup Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders, dan SalesOrderLines. Webhook ini mengirimkan perubahan stok, pembelian, dan permintaan ke SkyPlanner saat perubahan terjadi.
Perintah produksi dan langkah routing dibaca secara terjadwal. Filter ShopOrders dan ShopOrderRoutingStepPlans berdasarkan Modified, lalu gunakan Sync API untuk membaca data secara massal (pembatasan API).
SkyPlanner mengirimkan webhook sendiri ketika jadwal berubah, sehingga penulisan balik ke Exact Online dipicu oleh peristiwa.
Pemetaan data
| Resource API Exact Online | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Items | Produk dan material | Exact Online → SkyPlanner | Pemuatan data, lalu webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Struktur produk, subproduk, material per produk | Exact Online → SkyPlanner | Saat ada perubahan |
Workcenters, OperationResources | Stasiun kerja, kelompok stasiun kerja | Exact Online → SkyPlanner | Pemuatan data awal |
Operations, BillOfMaterialRoutings | Langkah proses beserta waktu persiapan dan waktu proses | Exact Online → SkyPlanner | Saat ada perubahan |
ShopOrders | Pesanan beserta kuantitas dan tenggat penyelesaian | Exact Online → SkyPlanner | Setiap beberapa menit |
ShopOrderRoutingStepPlans | Job beserta urutan, work center, jam persiapan dan jam proses | Exact Online → SkyPlanner | Setiap beberapa menit |
ShopOrderMaterialPlans | Material per job | Exact Online → SkyPlanner | Setiap beberapa menit |
ItemWarehouses, StockPosition | Saldo stok | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Pesanan pembelian beserta perkiraan tanggal kedatangan | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Tenggat pengiriman ke pelanggan dan prioritas | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Rencana waktu mulai, waktu selesai, dan stasiun kerja untuk setiap langkah | SkyPlanner → Exact Online | Saat ada perubahan, melalui webhook |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | Waktu mulai dan selesai pesanan | SkyPlanner → Exact Online | Saat ada perubahan, melalui webhook |
TimeTransactions (POST) | Catatan waktu kerja dan konfirmasi operator | SkyPlanner → Exact Online | Setiap konfirmasi atau setiap sif |
ShopOrderReceipts (POST) | Jumlah yang selesai diproduksi pada langkah terakhir | SkyPlanner → Exact Online | Setiap konfirmasi |
| Tidak disimpan di Exact Online | Matriks waktu penyiapan, perkakas sebagai sumber daya produksi dengan kapasitas terbatas, operator per job, stasiun kerja alternatif, sif | Dikelola di SkyPlanner | Penyiapan awal |
Pola integrasi
1. Pemuatan awal master data. Baca Workcenters, Operations, dan OperationResources, lalu item dan versi BOM beserta routing-nya. Work center dengan tiga mesin menjadi tiga stasiun kerja atau satu kelompok stasiun kerja. Sif, ketidakhadiran, dan lembur diatur di SkyPlanner karena work center di Exact hanya memiliki satu nilai kapasitas.
2. Sinkronisasi pesanan. Baca ShopOrders yang masih terbuka beserta ShopOrderRoutingStepPlans dan ShopOrderMaterialPlans, serta stok dan baris pesanan pembelian. Penjadwalan memperhitungkan stok maupun barang pembelian yang akan masuk. MRP tetap memberikan rekomendasi pesanan di Exact Online, sementara SkyPlanner menjadwalkan pesanan produksi yang Anda buat.
3. Penulisan kembali jadwal. Untuk setiap langkah routing yang ditempatkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner mengirim PUT ke ShopOrderRoutingStepPlans dengan PlannedStartDate, PlannedEndDate, dan Workcenter. Nilai PlannedStartDate dan PlannedDate pada pesanan produksi mengikuti langkah pertama dan terakhir. Jumlah, rencana material, dan perhitungan biaya tetap dikelola di Exact Online.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu kerja tersebut menjaga jadwal tetap mutakhir. Jam kerja yang dicatat dikirim sebagai TimeTransactions untuk pesanan produksi dan langkah routing terkait, baik untuk penyiapan maupun proses produksi. Konfirmasi terakhir mengirim catatan ShopOrderReceipts untuk jumlah yang selesai diproduksi. Jika pabrik Anda sudah mencatat waktu di Shop Floor Control, pilih satu saluran pencatatan.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Item, BOM, jumlah pada pesanan produksi, rencana material, biaya | Exact Online |
| Urutan langkah routing, waktu mulai dan selesai, penetapan work center | SkyPlanner |
| Matriks waktu penyiapan, perkakas, operator per job, sumber daya produksi alternatif, sif | SkyPlanner |
| Transaksi waktu kerja dan penerimaan hasil produksi | Exact Online, dengan data dari SkyPlanner |
Sumber konflik utama adalah perubahan tanggal secara manual. Jika perencana terus mengubah tanggal pesanan produksi di Exact Online, tanggal akan dikendalikan oleh dua sistem. Serahkan pengelolaan tanggal langkah routing kepada SkyPlanner. Dengan Autopilot, SkyPlanner menjadwalkan ulang secara otomatis saat terjadi perubahan dalam produksi.
Tahapan umum proyek
Implementasi biasanya selesai dalam hitungan minggu setelah penyiapan awal dimulai. Sebelumnya, validasi jadwal selama uji coba gratis 30 hari menggunakan ekspor CSV atau Excel yang berisi pesanan produksi terbuka dan langkah routing. Setelah itu, proyek berjalan melalui tahapan berikut:
- Penentuan lingkup. Pastikan edisi, divisi, frekuensi sinkronisasi, saluran pencatatan waktu, dan cara pencatatan penerimaan hasil produksi.
- Aplikasi dan persetujuan. Daftarkan aplikasi, lalu pengguna Exact Online memberikan persetujuan OAuth untuk setiap divisi.
- Pemuatan awal. Work center, operasi, item, versi BOM, dan routing.
- Sinkronisasi pesanan. Pesanan produksi, rencana langkah routing, dan rencana material disinkronkan secara terjadwal, sedangkan stok dan pembelian melalui webhook.
- Pengaturan batasan di SkyPlanner. Sif, matriks waktu penyiapan, perkakas, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan kembali jadwal. Kirim tanggal rencana untuk langkah routing ke Exact Online, lalu transaksi waktu kerja dan penerimaan hasil produksi.
- Pengujian paralel dan mulai penggunaan. Bandingkan tanggal dengan rencana saat ini, perbaiki master data, lalu aktifkan penulisan kembali.
Hal yang perlu direncanakan dalam integrasi Exact Online
- Durasi langkah routing.
PlannedSetupHoursdanPlannedRunHoursberasal dari routing BOM. Periksa terlebih dahulu kesesuaiannya dengan durasi produksi aktual. - Pengelompokan work center. Exact menyimpan satu nilai kapasitas untuk setiap work center. Tentukan apakah setiap work center akan menjadi satu stasiun kerja, beberapa stasiun kerja, atau satu kelompok.
- Kalender. Sif, hari libur, dan ketidakhadiran dikelola di SkyPlanner. Atur semuanya sebelum membuat jadwal pertama.
- Kuota panggilan API. Exact membatasi panggilan per aplikasi dan perusahaan serta mengharuskan panggilan dilakukan secara berurutan. Gunakan webhook jika topiknya tersedia,
$filterpadaModified, dan Sync API untuk membaca data secara massal. - Beberapa divisi. Setiap divisi Exact Online merupakan perusahaan dengan path dan persetujuannya sendiri. Petakan setiap pabrik ke divisinya.
- Pesanan produksi yang sudah dirilis. Sepakati status pesanan yang tanggalnya boleh diubah oleh SkyPlanner: pesanan terbuka dan yang sudah dirilis, atau hanya pesanan terbuka.
- Satu pengelola tanggal. Hentikan perubahan tanggal secara manual di Exact Online setelah SkyPlanner mengelola tanggal langkah routing.
Exact Globe+
Exact Globe+ adalah ERP dari Exact yang dijual dan diimplementasikan melalui mitra Exact Globe+. Exact menyatakan bahwa produk ini “koppelt eenvoudig en snel met andere systemen” (mudah dan cepat dihubungkan dengan sistem lain) (Exact Globe+). SkyPlanner menjadwalkan pesanan produksi Exact Globe+ dengan cara yang sama: pesanan produksi, routing, sumber daya produksi, dan stok masuk ke SkyPlanner, sedangkan tanggal rencana dan jam kerja yang dicatat dikirim kembali. Mitra Exact Globe+ Anda dan tim SkyPlanner menyepakati antarmuka serta objek yang akan ditulis kembali pada tahap penentuan lingkup.
Integrasi Exact Online: siapa yang mengonfigurasi dan memberikan dukungan
- Tim SkyPlanner mengonfigurasinya selama penyiapan awal dan memberikan dukungan setelah sistem mulai digunakan.
- Mitra Exact Anda dapat ikut terlibat. Mitra tersebut memahami edisi, divisi, dan konfigurasi manufaktur Anda.
- Pengembang Anda sendiri dapat mengembangkannya lebih lanjut melalui REST API SkyPlanner yang terdokumentasi. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan.
Setelah terhubung, mesin Arcturus menyusun jadwal berdasarkan data terkini pesanan produksi Exact Online, lalu tanggal rencana diterapkan pada setiap langkah routing. 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 yang Anda pilih, sehingga seluruh biaya sudah terlihat sebelum Anda mulai. Lihat harga, fitur, dan perbandingan dengan perencanaan bawaan Exact Online di halaman penjadwalan produksi dengan kapasitas terbatas di Exact Online. Gambaran umumnya tersedia di halaman Exact Online, sedangkan ERP lainnya ada di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
Lebih sedikit penghentian produksi akibat kekurangan material
“Manfaat SkyPlanner bagi kami adalah alat ini bekerja dengan baik untuk kebutuhan sehari-hari, terutama untuk menetapkan tanggal pengiriman.”
Tommi Männistö, Manajer Perencanaan Produksi
Eskomatic · Jasa pemesinan kontrak
Penjadwalan beban kerja otomatis menghasilkan tanggal pengiriman yang lebih akurat, dan penghentian produksi akibat kekurangan material telah berkurang drastis.
1.000-an perintah kerja dijadwalkan secara otomatis
“Kini kami mengendalikan produksi dengan cara yang berbeda, dan pemahaman kami tentang kapasitas sudah berada pada tingkat yang sama sekali berbeda.”
Hannu Ryynänen, CEO
Mamec · Mesin pencampur industri, pompa, dan manufaktur kontrak berteknologi tinggi
Ribuan perintah kerja dijadwalkan secara otomatis, dan seluruh organisasi dapat memantau produksi secara real-time.
Pertanyaan umum
Apakah API Exact Online mencakup pesanan produksi dan langkah routing?
Ya. Layanan manufaktur menyediakan ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations, serta resource API untuk BOM, yang semuanya dapat dibaca dan ditulis. Waktu kerja dicatat melalui TimeTransactions, sedangkan jumlah yang selesai diproduksi dicatat melalui ShopOrderReceipts.
Bagaimana tanggal yang direncanakan ditulis kembali ke Exact Online?
SkyPlanner mengirim permintaan PUT ke ShopOrderRoutingStepPlans yang memuat PlannedStartDate, PlannedEndDate, dan Workcenter untuk setiap langkah yang dijadwalkan atau dipindahkan. Nilai PlannedStartDate dan PlannedDate pada perintah produksi juga diperbarui agar sesuai.
Siapa yang membangun integrasi Exact Online?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai dengan konfigurasi Exact Online Anda selama proses orientasi awal, lalu memberikan dukungan setelah integrasi mulai digunakan. Mitra Exact Anda dapat ikut terlibat. Pengembang internal Anda juga dapat membangun integrasi menggunakan REST API SkyPlanner yang terdokumentasi. Untuk memulai, cukup gunakan token API.
Bisakah Exact Online mengirim perubahan secara real-time?
Webhook Exact Online mengirim perubahan pada item, posisi stok, pesanan pembelian, dan pesanan penjualan. Perintah produksi dan langkah routing dibaca secara berkala dengan interval singkat menggunakan permintaan yang difilter. Sebaliknya, webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Bisakah kami mencoba SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja, dengan impor perintah produksi Anda dari CSV atau Excel, tanpa perlu kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
