Panduan Integrasi JobBOSS² untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi JobBOSS² ini menjelaskan kepada mitra dan tim TI cara menghubungkan JobBOSS² dari ECI dengan SkyPlanner APS. SkyPlanner terintegrasi dua arah dengan JobBOSS² melalui API milik ECI:
- Orders dan Order Line Items, Order Routings, Estimates, Routings dan material, Work Centers, Employees, Company Calendar, Job Requirements, serta baris pesanan pembelian dikirim ke SkyPlanner.
- Tanggal mulai dan selesai yang direncanakan dikirim kembali ke setiap langkah Order Routing.
- Jika Anda memilihnya, catatan waktu operator dapat dikirim kembali sebagai Time Ticket Details.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Tim SkyPlanner mengonfigurasi integrasi sesuai pengaturan JobBOSS² Anda selama proses onboarding dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin terlibat atau mengembangkan integrasi sendiri melalui REST API SkyPlanner yang terdokumentasi (referensi API). Sebuah perusahaan manufaktur berdasarkan pesanan di AS sudah melakukannya:
Antarmuka integrasi JobBOSS²
ECI memublikasikan API manufakturnya beserta spesifikasi OpenAPI di situs Dokumentasi API Manufaktur ECI. Ada dua API yang relevan untuk penjadwalan:
- JobBOSS² API (v1). Menggunakan REST dan JSON, khusus untuk JobBOSS². API ini membaca dan menulis pesanan, Order Line Items, Order Routings, Estimates, Routings, material, Job Requirements, Work Centers, Company Calendar, Employees, pesanan pembelian, Time Tickets, dan Time Ticket Details. ECI menyatakan bahwa API ini “is currently only supported for JobBOSS² hosted (Cloud) customers.” (saat ini hanya didukung untuk pelanggan JobBOSS² yang dihosting di cloud).
- ECI ERP API (v2.1). REST API lintas produk untuk Deacom, M1, dan JobBOSS². Untuk JobBOSS², API ini mencakup job, operasi job, material job, komponen, operasi komponen, work center, baris pesanan pembelian, dan baris catatan waktu. ECI menjelaskan bahwa “the actual ERP database could be a cloud hosted ERP or on premises install,” (basis data ERP dapat dihosting di cloud atau dipasang secara lokal), sehingga API inilah yang digunakan untuk JobBOSS² lokal.
Kedua API menggunakan konvensi yang sama: ekspresi filter seperti lastModDate[gte]=, parameter fields=, sort=, serta paginasi dengan take dan skip. Nilai default take adalah 200. “All dates submitted to the API are assumed to be in UTC.” (Semua tanggal yang dikirim ke API dianggap menggunakan UTC.)
Aturan ECI untuk keduanya: “All APIs must be activated by ECI before use.” (Semua API harus diaktifkan oleh ECI sebelum digunakan.) Hubungi manajer akun ECI Anda sejak awal.
Autentikasi dan akses
- Pengguna API. Integrasi menggunakan akun pengguna API yang dibuat melalui Integration Engine Management Console milik ECI. Akun ini menentukan produk, pelanggan, dan basis data yang diakses oleh panggilan API.
- OAuth 2.0 client credentials. Client ID dan secret digunakan untuk memperoleh token dari endpoint token Authentication API. Setiap panggilan kemudian mengirimkan
Authorization: Bearer [token]. - Lingkup akses. Berikan akses kepada pengguna API hanya ke resource yang diperlukan dalam tabel pemetaan di bawah.
Di sisi SkyPlanner, REST API menggunakan token API untuk autentikasi (SkyPlanner Settings > API) dan dokumentasinya tersedia dalam Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan API pertama.
Event dan polling
Dokumentasi kedua API ECI tidak mencantumkan webhook. Data dari JobBOSS² diambil melalui polling: filter Order Line Items, Order Routings, dan baris pesanan pembelian berdasarkan lastModDate sejak proses terakhir, lalu gunakan take dan skip untuk paginasi. Frekuensinya ditetapkan untuk setiap pabrik, mulai dari beberapa menit sekali untuk job hingga setiap jam untuk stok.
SkyPlanner mengirimkan webhook ketika status atau jadwal berubah, sehingga penulisan balik data dipicu oleh event.
Pemetaan data
| Objek JobBOSS² (resource JobBOSS² API) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Estimates (/estimates), material (/materials) | Produk, material, struktur produk | JobBOSS² → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
Routings (/routings): work center, waktu setup, waktu siklus, jumlah anggota tim, mesin untuk job | Langkah proses beserta durasi dan waktu setup | JobBOSS² → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
Work Centers (/work-centers): jam per shift, beroperasi pada shift 1 hingga 3, hari kerja | Stasiun kerja, kelompok stasiun kerja, efisiensi | JobBOSS² → SkyPlanner | Pemuatan awal, jarang diperbarui setelahnya |
Company Calendar (/company-calendars), Employees (/employees) | Shift, hari libur, personel | JobBOSS² → SkyPlanner | Setiap hari, atau kelola shift di SkyPlanner |
Orders dan Order Line Items (/order-line-items): nomor job, tenggat, prioritas, jumlah yang harus diproduksi | Pesanan beserta tenggat dan prioritas | JobBOSS² → SkyPlanner | Polling setiap beberapa menit |
Order Routings (/order-routings): langkah job, status, sisa jam kerja | Job per langkah proses | JobBOSS² → SkyPlanner | Polling setiap beberapa menit |
Job Requirements (/job-requirements), baris pesanan pembelian (/purchase-order-line-items) | Kebutuhan material, pesanan pembelian berdasarkan tanggal pengiriman | JobBOSS² → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
Order Routing estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | Tanggal mulai dan selesai yang direncanakan, mesin dan operator per langkah | SkyPlanner → JobBOSS² | Saat jadwal berubah, melalui webhook SkyPlanner |
| Time Ticket Details (POST): job, langkah, work center, karyawan, waktu setup, waktu siklus, jumlah produk selesai dan afkir, waktu mulai dan selesai | Catatan waktu dan konfirmasi operator | SkyPlanner → JobBOSS² | Per konfirmasi atau per shift, jika dipilih |
| Tidak tersedia di JobBOSS² | Matriks waktu persiapan dan pergantian, perkakas sebagai sumber daya produksi dengan kapasitas terbatas, mesin dan personel alternatif | Dikelola di SkyPlanner | Diatur selama onboarding |
Untuk JobBOSS² yang dipasang secara lokal, objek yang sama dibaca melalui resource ERP API /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers, dan /purchase-order-lines, sedangkan catatan waktu dikirim ke /timecard-lines.
Pola integrasi
1. Pemuatan awal master data. Baca Estimates, Routings, material, Work Centers, Company Calendar, dan Employees. Petakan work center dengan cermat: work center dengan empat mesin bubut menjadi satu kelompok stasiun kerja atau empat stasiun kerja, agar SkyPlanner mengurutkan pekerjaan di setiap mesin.
2. Sinkronisasi job. Baca Order Line Items yang masih terbuka beserta Order Routings, Job Requirements, dan baris pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok ketika PO ditandai Delivered. Lewati job yang ditangguhkan dan job yang sudah ditutup.
3. Penulisan balik jadwal. Ketika mesin penjadwalan menempatkan atau memindahkan suatu langkah, webhook SkyPlanner memicu PATCH ke /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. Proses ini menetapkan estimatedStartDate dan estimatedEndDate dalam UTC, serta workCenter dan employeeCode jika SkyPlanner memindahkan langkah tersebut ke mesin atau personel lain. Tanggal diperbarui pada langkah job yang sudah ditampilkan di Whiteboard, Planning Board, dan Scheduling Advisor.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer. Catatan waktu tersebut menjaga jadwal tetap mutakhir. Anda menentukan apakah waktu aktual dikirim kembali ke JobBOSS². Jika ya, setiap konfirmasi menjadi Time Ticket Detail yang memuat waktu setup, waktu siklus, dan jumlah produk. Jika tidak, pengumpulan data tetap dilakukan di JobBOSS² dan SkyPlanner membaca progres dari Order Routings.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Estimates, Routings, jumlah, tenggat, status job | JobBOSS² |
| Urutan langkah, waktu mulai dan selesai, mesin dan operator per langkah | SkyPlanner |
| Matriks waktu persiapan dan pergantian, kebutuhan perkakas dan operator, sumber daya produksi alternatif | SkyPlanner |
| Shift dan hari libur | Satu sistem, dipilih saat penentuan lingkup |
| Catatan waktu, pengeluaran material, penerimaan, perhitungan biaya | JobBOSS², diinput langsung di sana atau dikirim dari catatan waktu SkyPlanner |
Tetapkan hanya satu sistem yang boleh mengubah tanggal pada langkah job. Untuk job yang dijadwalkannya, SkyPlanner menggantikan penjadwalan ulang di Whiteboard. Perencana memindahkan pekerjaan di SkyPlanner, lalu tanggalnya dikirim ke JobBOSS².
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam beberapa minggu setelah onboarding dimulai. Sebelum itu, validasi jadwal melalui uji coba gratis 30 hari menggunakan Work Centers, routing, dan job yang masih terbuka yang diekspor dari JobBOSS² dalam format CSV atau Excel.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, dan apakah catatan waktu akan dikirim kembali.
- Akses ECI. Minta ECI mengaktifkan JobBOSS² API atau ERP API dan membuat akun pengguna API. Jika tersedia, lakukan pengujian menggunakan data perusahaan di lingkungan sandbox.
- Pemuatan awal. Estimates, Routings, Work Centers, kalender, dan karyawan.
- Sinkronisasi job dan pesanan pembelian. Lakukan polling dengan filter
lastModDate, paginasi, dan percobaan ulang. - Pengaturan batasan di SkyPlanner. Atur matriks waktu persiapan dan pergantian, alat, jumlah operator per job, serta mesin atau personel alternatif.
- Penulisan balik jadwal. Panggilan PATCH untuk Order Routing dari webhook SkyPlanner, ditambah Time Ticket Details jika dipilih.
- Pengujian paralel. Jalankan SkyPlanner berdampingan dengan papan penjadwalan saat ini, bandingkan tanggal, dan perbaiki master data.
- Mulai operasional. Aktifkan penulisan balik setelah data cocok.
Hal yang perlu direncanakan dalam integrasi JobBOSS²
- Hosted atau on-premise. JobBOSS² API melayani pelanggan hosted. Instalasi on-premise menggunakan ERP API dengan daftar resource yang berbeda. Tentukan jalur integrasi pada langkah 1.
- UTC di seluruh sistem. API membaca dan menulis waktu dalam UTC. Konversikan ke waktu lokal pabrik agar waktu mulai 7:00 tidak tercatat pada jam yang salah.
- Mesin di balik work center. Work center dapat berupa mesin, kelompok mesin, sel kerja, atau tenaga kerja. Jumlah mesin dan ukuran tim pada setiap langkah routing menunjukkan kepada SkyPlanner berapa banyak sumber daya produksi yang dibutuhkan langkah tersebut.
- Jasa pihak luar. Langkah yang menggunakan vendor alih-alih work center dihitung sebagai lead time, bukan kapasitas Anda. Modelkan sebagai langkah yang hanya memperhitungkan waktu.
- Langkah tumpang tindih dan tanpa pengawasan. Langkah routing dapat diberi penanda untuk berjalan tumpang tindih atau tanpa pengawasan. Sertakan kedua penanda tersebut dalam integrasi agar pekerjaan tanpa operator direncanakan dengan benar.
- Satuan waktu. Waktu setup dan waktu siklus memiliki satuan masing-masing, sedangkan waktu antre adalah waktu tunggu, bukan waktu mesin. Konversikan saat impor agar seluruh durasi tidak keliru.
- Paginasi. Secara default, setiap halaman memuat 200 rekaman. Gunakan paginasi pada setiap pembacaan data.
Siapa yang mengonfigurasi dan mendukung integrasi JobBOSS²
- Tim SkyPlanner mengonfigurasi integrasi selama orientasi awal dan memberikan dukungan setelah mulai operasional, sesuai resource dan aturan polling yang disepakati. Setiap pabrik menggunakan JobBOSS² dengan cara berbeda, dan pemahaman tentang perbedaan itulah yang diterapkan di sini.
- Mitra JobBOSS² Anda dapat ikut terlibat. Mitra memahami konfigurasi Anda dan dapat bekerja bersama tim SkyPlanner untuk mengurus aktivasi API serta pembuatan pengguna API dengan ECI.
- Pengembang Anda sendiri dapat mengembangkannya lebih lanjut melalui REST API SkyPlanner dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu bila diperlukan. Dokumentasi integrasi tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, sudah termasuk 5 stasiun kerja, dengan penagihan bulanan. Penawaran harga integrasi diberikan di awal sesuai proses dan kebutuhan Anda, bersama paket yang Anda pilih. Lihat harga, penjadwalan produksi JobBOSS² yang memperhitungkan kapasitas, halaman JobBOSS², fitur SkyPlanner, dan pusat integrasi ERP.
Produsen yang menggunakan SkyPlanner
2 jamdihemat setiap minggu
“SkyPlanner telah membawa perencanaan produksi kami dari lembar kerja Excel ke optimalisasi 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.
+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 seluruh stasiun kerja dengan cakupan tiga bulan membutuhkan waktu kurang dari 30 menit.
1.000-anperintah kerja dijadwalkan 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 · Pengaduk 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 menentukan dalam menjaga keandalan pengiriman kami.”
Hannu Lahtinen, Direktur Utama
KJH-Comp · Fabrikasi komponen mekanis dari pelat logam dan manufaktur kontrak
Keandalan pengiriman naik dari sekitar 50% hingga mencapai 98%, dan penjadwalan kini hanya membutuhkan satu supervisor, bukan dua.
Pertanyaan umum
Apakah JobBOSS² memiliki API?
Ya. ECI menyediakan JobBOSS² API dan ERP API yang tidak terikat pada produk tertentu. Keduanya berbasis REST dengan spesifikasi OpenAPI. JobBOSS² API membaca dan menulis pesanan, Order Routings, Estimates, Work Centers, pesanan pembelian, dan Time Tickets untuk pelanggan hosted.
Bagaimana integrasi melakukan autentikasi ke JobBOSS²?
Dengan OAuth 2.0 client credentials. ECI mengaktifkan API, pengguna API dibuat melalui Integration Engine Management Console, dan setiap panggilan menyertakan token Bearer.
Apakah JobBOSS² mendukung webhook?
Dokumentasi API ECI tidak mencantumkan webhook, sehingga integrasi melakukan polling ke JobBOSS² dengan filter lastModDate sesuai jadwal yang ditetapkan untuk tiap pabrik. Webhook milik SkyPlanner mengirim perubahan jadwal saat perubahan terjadi.
Bagaimana tanggal yang direncanakan ditulis kembali ke JobBOSS²?
Untuk setiap langkah job. SkyPlanner memperbarui setiap Order Routing melalui PATCH dengan estimatedStartDate dan estimatedEndDate, serta workCenter dan employeeCode jika langkah tersebut dialihkan ke mesin atau operator lain.
Sebaiknya mitra JobBOSS² menawarkan ECI APS atau SkyPlanner?
SkyPlanner, jika pelanggan ingin mulai menggunakan penjadwalan produksi yang memperhitungkan kapasitas nyata berbagai sumber daya produksi dalam hitungan minggu. ECI APS adalah add-on terpisah yang didukung LYNQ. SkyPlanner terhubung melalui JobBOSS² API milik ECI, merencanakan pergantian produksi, tim kerja, alat pencekam, dan material, serta menyusun ulang rencana secara otomatis. Harganya mulai dari 199 € per bulan.
Bisakah kami menguji SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor CSV atau Excel dari JobBOSS², tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk penentuan lingkup integrasi.
