Panduan Integrasi Epicor Kinetic untuk Penjadwalan Produksi dengan SkyPlanner APS

Epicor menyatakan: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (Semua layanan Kinetic, termasuk objek bisnis, proses, laporan, BAQ, dan Epicor Functions, dapat diakses melalui endpoint REST.) Integrasi penjadwalan dibangun di atas empat teknologi Epicor:

1. Kinetic REST API v2 (OData v4). Objek bisnis tersedia sebagai layanan bernama Erp.BO.<Name>Svc. Jalur yang umum digunakan adalah /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. REST v1 masih tersedia, tetapi merupakan versi lama, jadi gunakan v2 untuk pengembangan. Pastikan kumpulan entitas dan metode yang tersedia untuk rilis Anda melalui REST Help di /api/help/v2/.
2. Business Activity Queries (BAQ) melalui REST. BAQ tersedia di /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. Ini merupakan cara praktis untuk membaca data perencanaan yang menggabungkan JobHead, JobOper, JobMtl, PartWhse, dan PORel dalam satu panggilan (contoh dari komunitas).
3. Epicor Functions (EFx). Fungsi sisi server yang dapat dipanggil di /api/v2/efx/{Company}/{Library}/{Function}. Epicor menyatakan bahwa fungsi ini “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (dapat dipicu dari berbagai titik masuk, termasuk BPM, layanan REST, jadwal, dan peristiwa aplikasi).
4. Direktif BPM. Method dan Data Directives terpicu saat job atau operasi berubah dan dapat memanggil fungsi yang mengirim data keluar.

Untuk pertukaran file, DMT menangani impor data masuk, sedangkan ekspor BAQ menangani ekstraksi data keluar. Epicor juga menawarkan Epicor Automation Studio, yang dideskripsikannya sebagai “a low-code app for integration-led automations” (aplikasi low-code untuk otomatisasi berbasis integrasi). Hindari akses langsung ke basis data: REST, BAQ, dan fungsi bekerja dengan cara yang sama pada instalasi lokal maupun Kinetic Cloud.

Epicor tidak mendokumentasikan API webhook keluar yang bersifat umum. Karena itu, perubahan di Kinetic diteruskan ke SkyPlanner melalui salah satu dari dua cara:

• Berbasis peristiwa. BPM Data Directive pada JobHead atau JobOper memanggil Epicor Function, yang mengirimkan job yang berubah ke REST API SkyPlanner.
• Polling terjadwal. BAQ dengan filter tanggal perubahan dijalankan setiap beberapa menit atau setiap jam. Cara ini lebih mudah dikelola dan dipulihkan jika terjadi gangguan.

Untuk arah sebaliknya, SkyPlanner mengirim perubahan status dan jadwal melalui webhook-nya. Middleware Anda atau endpoint EFx menerima perubahan tersebut lalu menuliskannya ke Kinetic.

1. Pemuatan awal master data. Baca data komponen, kelompok sumber daya produksi, sumber daya produksi, kapabilitas, kalender, dan karyawan. Bentuk stasiun kerja SkyPlanner dari sumber daya produksi Kinetic, serta kelompok stasiun kerja dari kelompok sumber daya produksi. Untuk pembacaan data dalam jumlah besar, gunakan paginasi dengan $top dan $skip, atau tarik data secara massal melalui BAQ.

2. Sinkronisasi pesanan. Kirim job yang sudah dirilis dan ditetapkan sebagai firm, beserta operasi dan materialnya. Tarik struktur job dengan GetDatasetForTree atau BAQ, bukan entitas satu per satu. Biarkan job MRP yang belum firm tetap di Kinetic sampai ditetapkan sebagai firm. Sinkronkan rilis PO yang masih terbuka beserta tanggal jatuh temponya saat membaca stok. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman dan memperbarui stok saat PO ditandai Delivered, sehingga jadwal memeriksa stok sekaligus pembelian yang akan masuk.

3. Penulisan kembali jadwal. Webhook SkyPlanner mengirimkan rencana waktu mulai, waktu selesai, dan stasiun kerja per operasi ke endpoint EFx (/api/v2/efx/{Company}/{Library}/{Function}). Fungsi tersebut menulis data melalui mesin penjadwalan Kinetic, yaitu objek bisnis yang juga digunakan untuk penjadwalan di Job Entry dan papan penjadwalan (contoh dari komunitas):

1. ScheduleEngine.GetNewParamsForJob membentuk dataset mesin penjadwalan untuk job tersebut.
2. Fungsi tersebut menetapkan nomor job, urutan perakitan dan operasi, serta rencana tanggal dan waktu mulai, lalu memanggil ScheduleEngine.MoveJobItem.
3. Jika SkyPlanner menempatkan operasi pada sumber daya produksi lain dalam kelompok tersebut, ScheduleEngine.ChangeResource memindahkannya ke sana. Jika hanya menggunakan MoveJobItem, sumber daya produksi bawaan kelompok tetap digunakan.
4. Fungsi tersebut mengaktifkan kunci jadwal job (JobHead.SchedLocked, opsi Lock di Job Entry), sehingga Global Scheduling mempertahankan tanggal dari SkyPlanner.

Membungkus rangkaian panggilan ini dalam satu Epicor Function menjaga penulisan tetap atomik per job dan memungkinkan Anda menambahkan validasi sendiri. Jika suatu lokasi memilih untuk tidak menggunakan fungsi kustom, jalankan urutan yang sama melalui panggilan REST langsung ke Erp.BO.ScheduleEngineSvc. Jangan pernah menulis langsung ke ResourceTimeUsed atau kolom tanggal JobOper: tindakan ini melewati mesin penjadwalan dan membuat alokasi pada papan penjadwalan tidak sinkron.

4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan di SkyPlanner menggunakan Mobile Confirmations, Production Timer, atau Quick Log Mode. Setiap catatan waktu yang ditutup menjadi catatan tenaga kerja di Kinetic melalui Erp.BO.LaborSvc: StartActivity dan EndActivityByEmp untuk aktivitas yang sedang berlangsung, atau Labors dengan Update untuk pencatatan setelah pekerjaan selesai. Jika lokasi Anda mewajibkan persetujuan, sertakan submitForApproval dalam alur dan cakupan akses.

5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:

Job yang dijadwalkan SkyPlanner diberi kunci jadwal sehingga Global Scheduling tidak mengubah tanggalnya. Tetap gunakan penjadwalan Kinetic untuk sumber daya produksi yang tidak dijadwalkan oleh SkyPlanner.

Implementasi biasanya selesai dalam hitungan minggu setelah proses penyiapan awal dimulai. Proyek Kinetic mencakup:

1. Uji coba selama 30 hari menggunakan ekspor data job, operasi, dan sumber daya produksi dalam format CSV atau Excel, sebelum pengembangan apa pun dimulai.
2. Kunci API, cakupan akses, akun khusus integrasi, serta BAQ yang dibaca oleh integrasi.
3. Pemetaan master data: kapabilitas, kelompok sumber daya produksi, sumber daya produksi, kalender, dan karyawan ke stasiun kerja, kelompok, sif, dan personel di SkyPlanner.
4. Pemuatan awal data item, metode produksi (BOM dan operasi), serta sumber daya produksi.
5. Sinkronisasi job dan pesanan pembelian (tanggal jatuh tempo PORel), serta stok PartWhse.
6. Penulisan kembali rencana tanggal operasi melalui ScheduleEngineSvc (MoveJobItem, ChangeResource) dalam Epicor Function, dengan kunci job diaktifkan.
7. Konfirmasi dari lantai produksi dicatat sebagai data tenaga kerja melalui LaborSvc.
8. Pengujian secara paralel dengan jadwal Kinetic yang sedang digunakan, kemudian penerapan secara operasional.

Setiap pabrik menggunakan Kinetic dengan cara yang berbeda. Routing berbasis kapabilitas, kalender kelompok sumber daya produksi, desain BAQ, direktif BPM, dan metode penulisan balik untuk versi tertentu berbeda di setiap lokasi. Ketepatan pengaturan ini menentukan apakah perencana bisa memercayai jadwal atau harus mengerjakannya ulang.

1. Tim SkyPlanner mengonfigurasi integrasi selama proses penyiapan awal dan memberikan dukungan setelah sistem mulai digunakan. Tim memetakan sumber daya produksi, job, dan rilis PO Anda, serta menyiapkan pembacaan BAQ, pemicu BPM, dan fungsi penulisan balik. Tim juga menghubungkan REST API dan webhook SkyPlanner ke Kinetic REST v2. Dukungan tetap berlanjut ketika BAQ, BPM, atau versi Kinetic Anda berubah.
2. Mitra Epicor Anda. Mitra yang sudah membuat BAQ, BPM, dan Epicor Functions dapat menggunakan REST API SkyPlanner terdokumentasi yang sama untuk membaca dan menulis data pesanan, produk, material, tahapan proses, dan catatan waktu.
3. Pengembang internal Anda. Tim internal yang berpengalaman dengan Kinetic REST dapat membangun integrasi secara langsung, atau melalui Automation Studio jika Anda menggunakannya. Cukup dengan kunci API SkyPlanner untuk mulai membangun (tutorial integrasi), dan tim SkyPlanner siap membantu bila diperlukan. Dokumentasi produk tersedia untuk umum di dokumentasi SkyPlanner.

Pola API dan webhook yang sama sudah digunakan secara operasional dengan ERP lain, misalnya di UTU. Di Laboratory & Allied, tim TI internal mengembangkan sebagian besar integrasi SAP Business One secara mandiri dengan bantuan SkyPlanner.

Semua cara dimulai dengan langkah yang sama: jalankan uji coba gratis selama 30 hari menggunakan impor CSV terlebih dahulu, buktikan hasil jadwalnya, lalu bangun integrasi. Harga mulai dari 199 € per bulan mencakup 5 stasiun kerja, ditagih bulanan, dan dapat dibatalkan kapan saja. Penawaran biaya integrasi disampaikan di awal sesuai proses dan kebutuhan Anda, bersama paket langganan, sehingga Anda mengetahui seluruh biayanya sebelum memulai.