Panduan Integrasi Sage 200 untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Sage 200 ini menjelaskan kepada mitra bisnis dan tim TI cara menghubungkan Sage 200 Professional beserta add-on manufakturnya ke SkyPlanner APS. Integrasi SkyPlanner dengan Sage 200 berjalan dua arah:
- Data produk, persediaan gudang, pesanan pembelian, dan pesanan penjualan masuk melalui Sage 200 REST API.
- Perintah produksi, operasi, serta sumber daya tenaga kerja dan mesin masuk dari add-on manufaktur Anda.
- Tanggal operasi yang direncanakan dikirim kembali ke perintah produksi.
- Catatan waktu operator dikirim kembali untuk pencatatan waktu kerja pada setiap operasi.
Tim SkyPlanner mengonfigurasi integrasi sesuai dengan konfigurasi Sage 200 Anda selama proses orientasi awal 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).
Dua sumber dalam satu sistem Sage 200
Implementasi Sage 200 di pabrik memiliki dua lapisan, dan integrasi membaca keduanya.
1. Sage 200 REST API untuk data komersial dan persediaan. Menurut Sage, API ini “lets your application read and modify data in a Sage 200 site” (memungkinkan aplikasi Anda membaca dan mengubah data pada instalasi tersebut). Data tersebut mencakup pelanggan, pemasok, produk, pesanan penjualan dan pembelian, serta akun buku besar. Referensi Sage 200 Professional (2025.02) mengelompokkan resource API ke dalam Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP, dan Stock. Berikut resource API yang relevan untuk penjadwalan:
| Resource API | Data yang disimpan |
|---|---|
products | Kode, nama, satuan persediaan, jenis item BOM, biaya standar |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Pesanan pembelian yang masih terbuka, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Permintaan pelanggan, requested_delivery_date, promised_delivery_date |
warehouses, units | Lokasi dan satuan ukur |
2. Add-on manufaktur untuk perintah produksi. Sage 200 API tidak memiliki endpoint untuk perintah produksi, operasi, atau sumber daya produksi. Perintah produksi tersimpan di Sicon Works Order Processing, Cim200, atau modul lama Sage 200 Manufacturing. Integrasi membaca perintah produksi, operasi, dan sumber daya produksi melalui jalur yang didukung add-on tersebut. Jalur ini disepakati bersama Anda dan mitra Sage 200 Anda saat penentuan lingkup.
Autentikasi dan akses
Sage 200 API “uses OAuth 2.0 with OpenID Connect” (menggunakan OAuth dengan OpenID Connect) melalui alur authorization code grant. Proses masuk dilakukan melalui Sage ID.
- Bergabunglah dengan Sage 200 API Developer Programme dan ajukan permintaan kredensial.
- Hubungkan Sage ID dengan pengguna Sage 200 yang memiliki akses ke perusahaan dan fitur yang diperlukan oleh endpoint yang Anda gunakan.
- Minta cakupan akses
offline_access; tanpanya, refresh token tidak akan diterbitkan. - Kirim
Authorization: Bearer <access_token>,X-Site, danX-Companypada setiap permintaan ke basis data. Kedua ID tersebut diperoleh dari/sites.
URL dasar untuk Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Permintaan menggunakan GET, POST, PUT, dan DELETE, serta opsi kueri OData $filter, $select, $top, $skip, $orderby, dan $expand.
Untuk Sage 200 Professional, penyedia dukungan pelangganlah yang mengaktifkan API. Dalam daftar periksa Sage, penyedia tersebut memastikan “the API is enabled” (API sudah diaktifkan) dan “each required user has a Sage ID assigned.” (setiap pengguna yang memerlukan akses sudah diberi Sage ID). Pada Sage 200 Standard, API sudah aktif secara bawaan.
Masa berlaku token menentukan rancangan integrasi. Access token berlaku selama 8 jam. Refresh token berlaku antara 1 hingga 90 hari, dan “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.” (Periode pembaruan dihitung sejak pengguna pertama kali masuk, bukan sejak pembaruan terakhir.) Sage menyatakan bahwa autentikasi ulang “is unavoidable” (tidak dapat dihindari). Siapkan peringatan untuk meminta persetujuan ulang sebelum periode tersebut berakhir.
Di sisi SkyPlanner, REST API menggunakan token API untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan API pertama.
Deteksi perubahan
Referensi Sage 200 API tidak menyediakan resource webhook atau subscription. Perubahan dideteksi melalui polling. Setiap rekaman memiliki date_time_created dan date_time_updated, sehingga setiap polling menggunakan $filter pada date_time_updated untuk menyaring data, serta $top dan $skip untuk mengambil data per halaman.
Lakukan polling perintah produksi setiap beberapa menit, serta persediaan dan baris pesanan pembelian setiap jam. SkyPlanner mengirim webhook saat jadwal berubah, sehingga penulisan balik dipicu oleh peristiwa.
Pemetaan data
| Objek Sage 200 (sumber) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
products, units (API) | Produk dan material | Sage 200 → SkyPlanner | Pemuatan data, lalu polling |
| Komponen BOM (add-on atau modul BOM) | Struktur produk, subproduk, material per produk | Sage 200 → SkyPlanner | Saat ada perubahan |
| Sumber daya tenaga kerja dan mesin, kelompok sumber daya produksi (add-on) | Stasiun kerja, kelompok stasiun kerja, personel | Sage 200 → SkyPlanner | Pemuatan data awal |
| Ketersediaan sumber daya produksi: penghentian operasi, pemeliharaan, hari libur (add-on) | Sif, ketidakhadiran | Sage 200 → SkyPlanner | Setiap hari |
| Perintah produksi beserta operasinya, waktu per operasi (add-on) | Pesanan dan job beserta tahapan, durasi, dan tenggatnya | Sage 200 → SkyPlanner | Setiap beberapa menit |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Tenggat pesanan pelanggan | Sage 200 → SkyPlanner | Polling |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Saldo persediaan | Sage 200 → SkyPlanner | Setiap jam |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Pesanan pembelian beserta perkiraan tanggal pengiriman | Sage 200 → SkyPlanner | Setiap jam |
| Waktu mulai dan selesai yang direncanakan untuk operasi pada perintah produksi, serta sumber daya produksinya | Waktu mulai dan selesai yang direncanakan, serta stasiun kerja untuk setiap operasi | SkyPlanner → Sage 200 | Saat ada perubahan, melalui webhook |
| Pencatatan waktu kerja untuk setiap operasi (add-on) | Catatan waktu dan konfirmasi operator | SkyPlanner → Sage 200 | Setiap konfirmasi atau setiap sif |
| Data kendala SkyPlanner | Matriks waktu penyiapan, perkakas sebagai sumber daya produksi berkapasitas terbatas, mesin dan personel alternatif | Dikelola di SkyPlanner | Orientasi awal |
Pola integrasi
1. Pemuatan master data awal. Ambil data produk dan satuan dari API, lalu sumber daya produksi, kelompoknya, dan operasi BOM dari add-on. Kelompok sumber daya produksi yang terdiri dari tiga mesin identik dapat dijadikan satu kelompok stasiun kerja atau tiga stasiun kerja.
2. Sinkronisasi pesanan. Baca perintah produksi yang masih terbuka beserta operasinya dari add-on, serta pop_order_lines yang masih terbuka dan warehouse_holdings dari API. Penjadwalan memeriksa persediaan maupun pembelian yang akan masuk. MRP tetap mengusulkan perintah produksi di Sage 200, dan SkyPlanner menjadwalkan perintah yang Anda buat.
3. Penulisan balik jadwal. Untuk setiap operasi yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner mengirim kembali waktu mulai dan selesai yang direncanakan serta sumber daya produksinya ke perintah produksi. Add-on tetap mengelola kuantitas, alokasi, dan perhitungan biayanya sendiri.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu tersebut menjaga jadwal tetap mutakhir. Waktu yang tercatat dikirim kembali sebagai waktu kerja untuk operasi pada perintah produksi, sehingga perhitungan biaya di Sage 200 menggunakan jam kerja aktual.
Jika pabrik Anda sudah mencatat waktu kerja di Sicon Shop Floor Data Capture atau Cim200 Shop Floor Data Capture, pilih satu saluran pencatatan.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan tersebut sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Produk, BOM, kuantitas perintah produksi, alokasi, biaya | Sage 200 dan add-on |
| Urutan operasi, waktu mulai dan selesai, penetapan stasiun kerja | SkyPlanner |
| Matriks waktu persiapan, kebutuhan alat dan operator, sumber daya produksi alternatif | SkyPlanner |
| Pencatatan waktu kerja | Sage 200, dengan data dari catatan waktu kerja SkyPlanner |
Sumber konflik utama adalah grafik kapasitas. Jika perencana terus menggeser perintah produksi atau operasi di Sicon Rough Cut Capacity Planning atau Cim200 Graphical Scheduler, dua sistem akan sama-sama mengendalikan tanggal. Jadikan SkyPlanner sebagai pengendali tanggal operasi. Dengan Autopilot, SkyPlanner menjadwalkan ulang secara otomatis saat terjadi perubahan produksi.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam beberapa minggu setelah proses orientasi dimulai. Sebelumnya, validasi jadwal melalui uji coba gratis selama 30 hari menggunakan data perintah produksi yang masih terbuka, yang diekspor dalam format CSV atau Excel. Proyek kemudian berjalan dengan tahapan berikut:
- Penentuan lingkup. Pastikan add-on dan versinya, jalur pembacaan perintah produksi, jalur penulisan balik, frekuensi sinkronisasi, serta saluran pencatatan waktu kerja.
- Akses API. Penyedia dukungan mengaktifkan Sage 200 API, memetakan Sage ID ke pengguna Sage 200, serta mengatur akses ke perusahaan dan fitur.
- Pemuatan data awal. Produk, satuan, sumber daya produksi, kelompok sumber daya produksi, operasi BOM, dan ketersediaan.
- Sinkronisasi pesanan. Perintah produksi, baris pesanan pembelian, dan stok disinkronkan melalui polling, disertai peringatan untuk memberikan persetujuan ulang.
- Pengaturan batasan di SkyPlanner. Matriks waktu persiapan, alat, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan balik jadwal. Tanggal operasi yang direncanakan ditulis ke perintah produksi; pencatatan waktu kerja ditambahkan pada tahap ini.
- Pengujian paralel dan mulai operasional. Bandingkan tanggal dengan rencana saat ini, perbaiki master data, lalu aktifkan penulisan balik.
Hal yang perlu direncanakan dalam integrasi Sage 200
- Modul yang dihentikan pada versi baru. Modul lama Sage 200 Manufacturing tidak dapat digunakan mulai Sage 200 Professional 2025 R2. Sebelum memetakan apa pun, pastikan solusi manufaktur mana yang akan digunakan saat mulai operasional.
- Waktu operasi dari data biaya. Sicon MRP memperkirakan waktu tenaga kerja dan mesin dari item biaya BOM Sage 200. Bandingkan terlebih dahulu dengan waktu proses aktual.
- Ketidaksesuaian kategori biaya. Sage memperingatkan bahwa Nominal, Overhead Nominal dan Overhead Recovery % pada operasi BOM harus sesuai dengan kategori biaya. Jika tidak, “there will be cost discrepancies.” (akan terjadi selisih biaya).
- Periode pembaruan. Batas maksimum 90 hari dihitung sejak pertama kali masuk. Integrasi yang tidak pernah meminta persetujuan ulang akan berhenti pada hari yang sama setiap kuartal.
- Instalasi dengan beberapa perusahaan. Satu instalasi dapat memuat beberapa perusahaan, jadi kirimkan
X-Companyyang tepat pada setiap permintaan.
Integrasi Sage 200: siapa yang mengonfigurasi dan mendukungnya
- Tim SkyPlanner mengonfigurasinya selama proses orientasi dan memberikan dukungan setelah mulai operasional.
- Mitra bisnis Sage 200 Anda dapat ikut terlibat. Mitra tersebut memahami add-on Anda dan mengaktifkan API pada Sage 200 Professional.
- Pengembang internal Anda dapat mengembangkannya lebih lanjut menggunakan 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 perintah produksi terkini dari Sage 200, dan tanggal yang direncanakan ditulis ke operasi pada perintah produksi. Harga SkyPlanner mulai dari 199 € per bulan, termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi diberikan di awal sesuai proses dan kebutuhan Anda, bersama paket pilihan Anda, sehingga seluruh biaya sudah terlihat sebelum Anda memulai. Lihat harga, fitur, dan perbandingan dengan perencanaan bawaan Sage 200 di halaman penjadwalan produksi Sage 200 yang memperhitungkan kapasitas mesin dan tenaga kerja. Gambaran umumnya tersedia di halaman Sage 200, sedangkan ERP lainnya dapat dilihat di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“SkyPlanner telah mengubah perencanaan produksi kami, dari penggunaan lembar kerja Excel menjadi optimasi 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 sampai ke lini produksi dalam hitungan detik.
1.000-anperintah 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 Sage 200 API mencakup perintah produksi?
Tidak. Sage 200 Professional API mencakup produk, stok, pesanan penjualan dan pembelian, keuangan, serta berbagai data lainnya, tetapi tidak menyediakan resource API untuk perintah produksi atau operasi. Perintah produksi diambil dari add-on manufaktur Anda, seperti Sicon Works Order Processing atau Cim200, melalui jalur yang disepakati saat penentuan lingkup.
Siapa yang membangun integrasi Sage 200?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai konfigurasi Sage 200 Anda selama proses orientasi dan memberikan dukungan setelah mulai operasional. Mitra bisnis Sage 200 Anda mengaktifkan API dan dapat ikut terlibat. Pengembang internal Anda juga dapat membangun integrasi menggunakan REST API SkyPlanner yang terdokumentasi; token API sudah cukup untuk memulai.
Bisakah Sage 200 mengirim perubahan secara real-time?
Sage 200 API tidak memiliki webhook. Perubahan stok dan pesanan pembelian diperiksa melalui polling berdasarkan date_time_updated, sedangkan perintah produksi dibaca dari add-on Anda setiap beberapa menit. Untuk arah sebaliknya, webhook bawaan SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor perintah produksi dari CSV atau Excel, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
