Panduan Integrasi Sage 100 untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Sage 100 ini menjelaskan kepada mitra Sage dan tim TI cara menghubungkan Sage 100 ke SkyPlanner APS. Panduan ini mencakup kedua produk yang menggunakan nama tersebut: Sage 100 di AS dan Kanada dengan Production Management, serta Sage 100 di Jerman dan Austria dengan Sage 100 Produktion. Integrasi SkyPlanner dengan Sage 100 berjalan dua arah:
- Work ticket atau Fertigungsaufträge dikirim ke SkyPlanner beserta tahapan atau Arbeitsgänge, serta work center, item, stok, dan pesanan pembelian.
- Tanggal yang direncanakan dikirim kembali ke setiap tahapan atau Arbeitsgang.
- Catatan waktu operator dikirim kembali sebagai entri jam kerja (US) atau Rückmeldungen (DE).
Saat penyiapan awal, tim SkyPlanner mengonfigurasi integrasi sesuai dengan konfigurasi Sage 100 Anda dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin ikut terlibat atau membangun integrasi sendiri menggunakan REST API SkyPlanner yang terdokumentasi (referensi API).
Sage 100 versi AS: antarmuka integrasi
Sage 100 versi AS berjalan di lingkungan lokal dengan instalasi Standard, Advanced, atau Premium. Antarmuka integrasinya berada di server Sage 100.
Business Object Interface (BOI).
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).” (Business Objects Interface memungkinkan pengembang pihak ketiga dengan keterampilan yang diperlukan mengakses program dan aplikasi tersebut menggunakan Component Object Model (COM).) (Bantuan Sage 100) Portal pengembang Sage menyebutnya “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.” (Lapisan API internalnya yang memberi Anda akses ke logika yang juga digunakan oleh aplikasi itu sendiri.) (developer.sage.com) BOI merupakan jalur penulisan data: setiap pembuatan atau pembaruan data melewati validasi yang sama seperti saat pengguna melakukannya di Sage 100.
ODBC.
Driver ProvideX ODBC membaca tabel Sage 100 untuk pelaporan dan pembacaan data secara massal. Pada Advanced, tersedia driver ODBC klien/server. Integrasi ini menggunakan ODBC untuk membaca work ticket, item, dan pesanan pembelian secara massal, serta BOI untuk menulis data.
Visual Integrator (VI).
Proses impor dan ekspor VI memindahkan data antara Sage 100 dan file atau sumber ODBC. Menurut Sage: “One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.” (Salah satu fitur unggulan modul Visual Integrator adalah kemampuannya mengimpor data langsung dari dan mengekspor data langsung ke sumber data ODBC.) (sumber) VI termasuk dalam paket Essentials dan cocok untuk pertukaran data berbasis file.
eBusiness Web Services menggunakan SOAP dan mencakup “the Sage 100 sales order, customer, and customer contact entities.” (Entitas pesanan penjualan, pelanggan, dan kontak pelanggan di sistem tersebut.) (sumber) Layanan ini dapat mengirimkan pesanan penjualan, sedangkan data produksi melewati BOI dan ODBC.
Integrasi berjalan berdampingan dengan Sage 100 menggunakan akun pengguna Sage 100 yang memiliki hak akses ke tugas Production Management, Inventory, dan Purchase Order yang digunakan. Lalu lintas keluar dikirim ke REST API SkyPlanner melalui HTTPS.
Sage 100 versi Jerman: antarmuka integrasi
Sage 100 versi Jerman berjalan di Microsoft SQL Server, baik dengan instalasi lokal maupun dalam varian cloud. Menurut Sage, Anda dapat “Partnerlösungen via API-Schnittstelle ergänzen” (menambahkan solusi mitra melalui antarmuka API) (Sage 100). Add-on produksi yang terdaftar di Sage dibangun menggunakan Sage AppDesigner dan objek bisnis Sage 100.
Integrasi menggunakan jalur yang sama dengan solusi mitra Sage. Data Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel, dan Bestellungen dibaca dari database SQL Server Sage 100. Tanggal Arbeitsgang dan Rückmeldungen dikirim kembali melalui jalur penulisan yang ditetapkan oleh mitra Sage Anda dan tim SkyPlanner saat penentuan lingkup, sehingga pencatatan transaksi mengikuti logika Sage 100 sendiri. Mitra Sage Anda mengonfirmasi versi (misalnya 9.0) dan konfigurasi akses.
Autentikasi dan akses
| Sistem | Metode autentikasi |
|---|---|
| Sage 100 versi AS, BOI | Sesi pengguna Sage 100 di server Sage 100, dengan hak akses berbasis peran untuk setiap tugas yang digunakan |
| Sage 100 versi AS, ODBC | DSN pada instalasi Sage 100, dengan akses baca |
| Sage 100 versi Jerman | Akun pengguna Sage 100 untuk penulisan balik dan akses baca SQL Server, sesuai kesepakatan dengan mitra Sage Anda |
| SkyPlanner | Token API dalam header Authorization-Token, dibuat di SkyPlanner Settings > API |
REST API SkyPlanner didokumentasikan dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan pemanggilan awal.
Deteksi perubahan
Perubahan di Sage 100 dideteksi melalui pembacaan terjadwal. Baca work ticket atau Fertigungsaufträge yang masih terbuka dengan interval singkat, serta stok dan pesanan pembelian setiap jam. Gunakan filter status dan tanggal perubahan agar setiap pembacaan hanya mengambil data yang berubah.
SkyPlanner mengirim webhook saat jadwal berubah, sehingga penulisan balik ke Sage 100 dipicu oleh peristiwa.
Pemetaan data
| Sage 100 (US) | Sage 100 (DE) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|---|
| Item | Artikel | Produk dan material | Sage 100 → SkyPlanner | Pemuatan awal, lalu setiap hari |
| Bill of Materials, material pada templat | Stückliste dalam Ressourcenliste | Struktur produk, subproduk, material per produk | Sage 100 → SkyPlanner | Saat ada perubahan |
| Work center: pekerja atau mesin, jam kerja per hari dalam seminggu, waktu tidak beroperasi | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Stasiun kerja, kelompok stasiun kerja, personel, sif | Sage 100 → SkyPlanner | Pemuatan awal |
| Tahapan pada templat work ticket, kode aktivitas | Arbeitsplan, Arbeitsgänge dengan Rüst- dan Stückzeiten | Tahapan proses beserta waktu persiapan dan pengerjaan | Sage 100 → SkyPlanner | Saat ada perubahan |
| Work ticket beserta tahapan dan tenggat | Fertigungsauftrag dengan Arbeitsgänge, Liefertermin | Pesanan dan job beserta tenggat | Sage 100 → SkyPlanner | Pembacaan dengan interval singkat |
| Jumlah persediaan per gudang | Lagerbestand | Saldo stok | Sage 100 → SkyPlanner | Setiap jam |
| Baris pesanan pembelian, tanggal kebutuhan | Bestellungen, Liefertermine | Pesanan pembelian beserta perkiraan tanggal pengiriman | Sage 100 → SkyPlanner | Setiap jam |
| Baris pesanan penjualan, tanggal yang dijanjikan | Kundenaufträge | Tenggat pelanggan, prioritas pelanggan | Sage 100 → SkyPlanner | Pembacaan dengan interval singkat |
| Tanggal tahapan work ticket (BOI) | Arbeitsgang-Termine | Rencana waktu mulai, waktu selesai, dan stasiun kerja untuk setiap tahapan | SkyPlanner → Sage 100 | Saat ada perubahan, melalui webhook |
| Labor Entry, penyelesaian work ticket (BOI) | Rückmeldung: Zeiten, Mengen | Catatan waktu dan konfirmasi operator | SkyPlanner → Sage 100 | Setiap konfirmasi atau setiap sif |
| Tidak disimpan di Sage 100 | Tidak disimpan di Sage 100 | Matriks waktu persiapan, perkakas sebagai sumber daya berkapasitas terbatas, operator per job, stasiun kerja alternatif | Dikelola di SkyPlanner | Penyiapan awal |
Pola integrasi
1. Pemuatan awal master data. Muat item dan work center terlebih dahulu, lalu templat atau Arbeitspläne beserta tahapannya. Work center versi AS yang memiliki tiga mesin dan dua operator menjadi tiga stasiun kerja, satu kelompok stasiun kerja, dan dua orang di SkyPlanner. Masing-masing kemudian memiliki linimasa sendiri.
2. Sinkronisasi pesanan. Baca work ticket atau Fertigungsaufträge yang masih terbuka beserta tahapannya, serta stok dan pesanan pembelian yang masih terbuka. SkyPlanner memeriksa stok dan pengiriman yang akan datang sebelum menempatkan job dalam jadwal. Sage 100 tetap mengusulkan pekerjaan, sedangkan SkyPlanner menjadwalkan pesanan yang Anda rilis.
3. Penulisan balik jadwal. Untuk setiap tahapan yang ditempatkan atau dipindahkan oleh mesin penjadwalan, SkyPlanner mengirimkan rencana waktu mulai, waktu selesai, dan stasiun kerja. Pada Sage 100 versi AS, integrasi memperbarui tanggal tahapan work ticket melalui BOI. Pada Sage 100 versi Jerman, integrasi memperbarui tanggal Arbeitsgang melalui jalur yang ditetapkan saat penentuan lingkup. Kuantitas, alokasi, dan perhitungan biaya tetap dikelola di Sage 100.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan dengan SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu tersebut menjaga jadwal tetap mutakhir. Pada Sage 100 versi AS, waktu yang dicatat menjadi Labor Entry untuk tahapan work ticket terkait, dan konfirmasi terakhir menyelesaikan tiket tersebut. Pada Sage 100 versi Jerman, catatan itu menjadi Rückmeldung yang berisi waktu dan kuantitas. Jika pabrik Anda sudah mencatat waktu di Betriebsdatenerfassung atau aplikasi barcode, pilih satu saluran pencatatan.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum mulai digunakan:
| Data | Pemilik |
|---|---|
| Item, BOM, templat, jumlah pesanan, biaya | Sage 100 |
| Urutan tahapan, waktu mulai dan selesai, penetapan stasiun kerja | SkyPlanner |
| Matriks waktu persiapan, alat, operator per job, sumber daya alternatif | SkyPlanner |
| Data tenaga kerja dan Rückmeldungen | Sage 100, dengan masukan dari catatan waktu SkyPlanner |
Sumber utama konflik adalah penggunaan sistem penjadwalan kedua. Jika perencana tetap menjalankan Enhanced Scheduling di Sage 100 versi AS, atau tetap menggeser tugas pada Plantafel di Sage 100 versi Jerman, tanggal akan dikendalikan oleh dua sistem. Tetapkan SkyPlanner sebagai pengendali tanggal setiap tahapan. Dengan Autopilot, SkyPlanner menjadwalkan ulang secara otomatis saat terjadi perubahan produksi.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu setelah proses orientasi dimulai. Sebelumnya, validasi jadwal selama uji coba gratis 30 hari menggunakan ekspor CSV atau Excel dari work ticket atau Fertigungsaufträge yang masih terbuka. Proyek kemudian berjalan dengan tahapan berikut:
- Penentuan lingkup. Pastikan produk yang digunakan (Sage 100 versi AS atau Jerman), versi dan instalasinya, jalur baca, jalur tulis, frekuensi sinkronisasi, serta saluran pencatatan waktu.
- Akses. Mitra Sage Anda menyiapkan pengguna Sage 100, hak aksesnya, dan akses basis data.
- Pemuatan data awal. Muat item, work center, templat atau Arbeitspläne, BOM, dan sif.
- Sinkronisasi pesanan. Sinkronkan work ticket atau Fertigungsaufträge, pesanan pembelian, dan stok secara terjadwal.
- Pengaturan batasan di SkyPlanner. Atur matriks waktu persiapan, alat, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan kembali jadwal. Tulis tanggal rencana setiap tahapan ke Sage 100, lalu data tenaga kerja dan Rückmeldungen.
- Pengujian paralel dan mulai penggunaan. Bandingkan tanggal dengan rencana saat ini, perbaiki master data, lalu aktifkan penulisan kembali.
Hal yang perlu direncanakan dalam integrasi Sage 100
- Pastikan Sage 100 yang Anda gunakan. Sage 100 versi AS dan Jerman memiliki model data dan antarmuka yang berbeda. Sebutkan produk dan versinya dalam pembicaraan awal untuk penentuan lingkup.
- Work center yang mencakup beberapa mesin. Pada versi AS, work center merupakan satu unit kapasitas yang terdiri dari “one or more persons or machines” (satu atau lebih orang atau mesin). Tentukan apakah setiap work center akan menjadi satu stasiun kerja, beberapa stasiun kerja, atau sebuah grup.
- Waktu persiapan dan proses. Templat dan Arbeitspläne menyimpan data waktu yang digunakan SkyPlanner untuk menyusun jadwal. Cocokkan data tersebut dengan waktu proses aktual sebelum mulai digunakan.
- Kalender. Work center versi AS memuat jam kerja untuk setiap hari dalam seminggu serta periode tidak beroperasi. Muat data tersebut sebagai sif SkyPlanner, lalu tambahkan sif dan ketidakhadiran setiap operator di SkyPlanner.
- Satuan ukur. Tahapan dapat dijalankan per unit, per batch, atau per jam. Petakan satuan untuk setiap tahapan.
- Hak akses BOI. BOI mengikuti pengaturan keamanan berbasis peran di Sage 100. Operasi tulis akan terhenti jika hak akses untuk tugas terkait tidak tersedia. Uji setiap operasi tulis menggunakan akun pengguna integrasi.
- Satu pengendali tanggal. Hentikan penjadwalan paralel atau pemindahan tugas di Plantafel setelah SkyPlanner menjadi pengendali tanggal.
Integrasi Sage 100: siapa yang mengonfigurasi dan memberikan dukungan
- Tim SkyPlanner mengonfigurasi integrasi selama proses orientasi dan memberikan dukungan setelah mulai digunakan.
- Mitra Sage Anda dapat ikut terlibat. Mitra tersebut memahami versi Sage 100 Anda, menyiapkan pengguna beserta hak aksesnya, dan memastikan akses basis data.
- Pengembang internal Anda dapat mengembangkannya lebih lanjut menggunakan REST API SkyPlanner yang terdokumentasi. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu saat diperlukan.
Setelah terhubung, mesin Arcturus menyusun jadwal berdasarkan data pesanan terkini dari Sage 100, dan tanggal rencana dicatat pada setiap tahapan. Harga SkyPlanner mulai dari 199 € per bulan, sudah termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran biaya integrasi disampaikan di awal sesuai proses dan kebutuhan Anda, bersama paket langganan, sehingga Anda mengetahui seluruh biaya sebelum memulai. Lihat harga, fitur, dan perbandingannya dengan perencanaan bawaan Sage 100 di halaman penjadwalan produksi Sage 100 sesuai kapasitas mesin dan tenaga kerja. Gambaran umumnya tersedia di halaman Sage 100. Panduan khusus Sage 200 dan Sage X3 tersedia di halaman Sage 200 dan Sage X3, sedangkan ERP lainnya tercantum di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
6 bulankapasitas tersedia yang 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.
100%keandalan pengiriman sejak 2021
“SkyPlanner memberi kami gambaran kapasitas yang jelas dan membuat hasil perencanaan dapat diprediksi.”
Dan Berglund, COO/CFO
Opes Corporation · Manufaktur bahan kimia dan pangan
Keandalan pengiriman mencapai 100% sepanjang penggunaan SkyPlanner, sejak 2021.
Pertanyaan umum
Apakah Sage 100 memiliki REST API untuk work ticket?
Sage 100 versi AS menyediakan akses ke logika bisnisnya melalui Business Object Interface, dengan ODBC untuk pembacaan dan Visual Integrator untuk pemrosesan berkas. SkyPlanner membaca work ticket melalui ODBC dan BOI, serta menulis tanggal tahapan dan data tenaga kerja melalui BOI. Data Sage 100 versi Jerman dibaca dari basis data SQL Server, sementara jalur penulisan kembali ditentukan bersama mitra Sage Anda saat penentuan lingkup.
Siapa yang membangun integrasi Sage 100?
Tim SkyPlanner mengonfigurasi integrasi dua arah sesuai pengaturan Sage 100 Anda selama proses orientasi dan memberikan dukungan setelah mulai digunakan. Mitra Sage Anda menyiapkan pengguna, hak akses, dan akses basis data, serta dapat ikut terlibat. Pengembang internal Anda juga dapat melakukan pengembangan menggunakan REST API SkyPlanner yang terdokumentasi, dan token API sudah cukup untuk memulai.
Bagaimana tanggal rencana ditulis kembali ke Sage 100?
Pada Sage 100 versi AS, integrasi memperbarui tanggal rencana setiap tahapan work ticket melalui BOI dan mencatat Labor Entry dari catatan waktu operator. Pada Sage 100 versi Jerman, integrasi memperbarui tanggal Arbeitsgang pada setiap Fertigungsauftrag dan mencatat Rückmeldungen melalui jalur tulis yang ditentukan oleh mitra Sage Anda dan tim SkyPlanner saat penentuan lingkup.
Bisakah Sage 100 mengirim perubahan secara real time?
SkyPlanner mengambil perubahan dari Sage 100 melalui pembacaan terjadwal: pesanan yang masih terbuka dibaca dengan interval singkat, sedangkan stok dan pesanan pembelian dibaca setiap jam. Untuk arah sebaliknya, webhook SkyPlanner langsung mengirim perubahan jadwal saat terjadi.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis 30 hari mendukung hingga 20 stasiun kerja dengan impor work ticket atau Fertigungsaufträge melalui CSV atau Excel, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
