Panduan Integrasi MRPeasy untuk Penjadwalan Produksi dengan SkyPlanner APS

MRPeasy hanya tersedia sebagai produk cloud, tanpa versi lokal, sehingga semua pelanggan menggunakan API yang sama. Ada dua versi:

1. REST API v1 (OpenAPI 1.0, server https://api.mrpeasy.com/rest/v1) adalah API untuk lingkungan produksi. Cakupannya meliputi /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units, serta laporan produksi seperti /report/production/operations.
2. REST API v2 (OpenAPI 2.0.0, server https://api.mrpeasy.com/rest/v2) masih dalam tahap awal pengembangan. Versi ini menambahkan /workstation-groups dengan work_hours dan holidays, /workstations dengan productivity dan idle, /inventory, /stock-movement, serta PATCH. Order produksi tetap menggunakan v1.

Perhatikan perbedaan penamaannya. Workstation group pada antarmuka MRPeasy disebut work-center-types di v1 (type_id). Workstation disebut work-centers (center_id). Operasi dalam routing merujuk ke kelompok melalui type_id, bukan ke mesin.

API tersedia dalam paket Unlimited MRPeasy untuk akun berbayar. MRPeasy juga menyatakan, “Our Support Department cannot help you using the API.” (Tim dukungan kami tidak dapat membantu Anda menggunakan API.) Karena itu, integrasi memerlukan penanggung jawab: SkyPlanner, konsultan MRPeasy Anda, atau pengembang Anda. Tim SkyPlanner menangani pekerjaan ini selama proses onboarding.

Halaman harga MRPeasy mencantumkan “API, webhooks (for paid accounts)” (API dan webhook untuk akun berbayar), tetapi spesifikasi v1 maupun v2 tidak mendokumentasikan event webhook untuk order produksi. Karena itu, integrasi melakukan polling MRPeasy secara inkremental:

• Order produksi difilter berdasarkan status Not scheduled (15), Scheduled (20), In progress (30), dan Paused (35).
• Pesanan pembelian dan persediaan diperiksa secara terjadwal atau sebelum setiap proses penjadwalan.
• Master data diperiksa saat ada perubahan atau setiap malam.

Polling berurutan dengan filter menjaga jumlah permintaan jauh di bawah batas 100 permintaan per 10 detik. Untuk arah sebaliknya, webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi, sehingga penulisan balik dipicu oleh event.

1. Pemuatan awal master data. Tarik item, satuan, BOM, dan routing dari v1, serta kelompok stasiun kerja dan stasiun kerja dari v1 atau v2. Ambil kalender dari /workstation-groups v2 (work_hours, holidays) atau atur sif langsung di SkyPlanner. Petakan setiap kelompok Active processing ke kelompok stasiun kerja SkyPlanner, dengan stasiun kerjanya sebagai anggota.

2. Sinkronisasi order. Baca order produksi yang masih terbuka beserta operasinya, serta pesanan pembelian yang masih terbuka dan persediaan. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered. Pada setiap penjadwalan ulang, sistem memeriksa stok maupun pembelian yang akan masuk.

3. Penulisan balik jadwal. PUT /manufacturing-orders/{id} mendukung code, quantity, due_date, dan assigned_id, serta field kustom dalam bentuk custom_<id>. SkyPlanner menulis rencana selesai ke due_date jika hal itu disepakati. Rencana mulai, rencana selesai, dan progres ditulis ke field kustom MRPeasy. Dengan begitu, tim penjualan dan pembelian yang menggunakan MRPeasy dapat melihat jadwal aktual. Rincian urutan operasi dan stasiun kerja untuk setiap operasi dikelola di SkyPlanner. Tampilannya menjadi acuan pelaksanaan pekerjaan di lantai produksi.

4. Order yang dibuat di luar MRPeasy. Jika ada order yang dibuat melalui API, POST /manufacturing-orders menerima no_scheduling dan no_bookings. Gunakan keduanya agar MRPeasy tidak mengalokasikan stasiun kerja yang sudah dijadwalkan oleh SkyPlanner.

5. Konfirmasi di lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations, Production Timer, atau Quick Log Mode. Catatan waktu tersebut menjaga jadwal tetap mutakhir. Pilih satu saluran pelaporan. Menggunakan Internet-kiosk MRPeasy dan SkyPlanner secara bersamaan untuk operasi yang sama akan menghasilkan dua versi data acuan.

6. Tanggung jawab data dan aturan penanganan konflik. Dokumentasikan keduanya sebelum sistem mulai digunakan:

Alur engineer to order. Dalam satu proyek MRPeasy yang telah diselesaikan, setiap proyek pelanggan menjadi satu produk utama beserta satu hingga tiga produk setengah jadi. Masing-masing memiliki BOM dan routing sendiri di MRPeasy, dan perintah produksi tercatat di kedua sistem. Gunakan pengenal bersama yang tetap pada setiap perintah agar pembaruan tidak pernah membuat duplikat.

• Kolom waktu berbeda menurut antarmuka. Kolom Setup time, Cycle time, dan Capacity pada antarmuka pengguna masing-masing adalah fixed_time, variable_time, dan variable_quantity di API. Capacity di atas 1 berarti pemrosesan batch, seperti pada oven. Petakan sebagai job batch, bukan siklus yang lebih panjang.
• Kelompok Passive processing. Kelompok pengeringan dan pendinginan berjalan 24/7 tanpa batas kapasitas. Petakan sebagai waktu tunggu, bukan stasiun kerja dengan kapasitas terbatas.
• Kalender tidak tersedia di v1. work-centers hanya mengembalikan center_id, type_id, code, dan title. Gunakan v2 atau kelola sif di SkyPlanner.
• Waktu menganggur. Waktu menganggur stasiun kerja mencatat pemeliharaan dan waktu henti. Sinkronkan data ini; jika tidak, SkyPlanner akan merencanakan pekerjaan pada mesin yang sedang tidak beroperasi.
• Routing merujuk ke kelompok. MRPeasy memilih mesin dengan ketersediaan terbaik. Di SkyPlanner, stasiun kerja dalam kelompok tersebut menjadi pilihan alternatif nyata yang dapat dipilih oleh mesin penjadwalan.