Integrasi / ERP / proALPHA ERP
Panduan Integrasi proALPHA untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi Proalpha ini menjelaskan cara menghubungkan Proalpha ERP ke SkyPlanner APS bagi mitra dan tim TI. Integrasi SkyPlanner dengan Proalpha berjalan dua arah:
- Data komponen, work order beserta operasinya, sumber daya produksi, kalender, stok, dan pesanan pembelian masuk ke SkyPlanner.
- Rencana waktu mulai dan selesai setiap operasi dikirim kembali melalui setWorkOrderOperationDates.
- Perubahan sumber daya produksi dikirim kembali melalui changeWorkOrderOperationResource.
- Konfirmasi operator dikirim kembali melalui operationDataEntry.
- Webhook SkyPlanner mengirimkan perubahan jadwal segera saat terjadi.
Tim SkyPlanner menyesuaikan konfigurasi integrasi dengan sistem Proalpha Anda selama proses penyiapan awal dan memberikan dukungan setelah sistem mulai digunakan. Panduan ini ditujukan bagi mitra dan pengembang yang ingin ikut terlibat atau mengembangkan integrasi sendiri menggunakan REST API SkyPlanner yang terdokumentasi (referensi API).
Antarmuka Proalpha
Proalpha ERP berjalan di Progress OpenEdge, dan sejak Release 9 platform ini menggunakan OpenEdge 12. (Proalpha) Ada empat antarmuka yang penting untuk penjadwalan.
- Proalpha ERP REST APIs. Proalpha API Portal yang terbuka untuk umum mencantumkan 108 spesifikasi OpenAPI 3.0 di bawah
api/web/v1. Antarmuka ini digunakan untuk menulis balik data serta membaca data komponen dan stok. - Integration Workbench (INWB). Menurut Proalpha, INWB “is a central platform which connects different IT systems, machines, sites” (merupakan platform terpusat yang menghubungkan berbagai sistem TI, mesin, dan lokasi) serta “converts the data into the format of the target system.” (mengonversi data ke format sistem tujuan). (Proalpha) INWB menerima pesan pAX melalui
POST /api/web/v1/inwb/message. Gunakan antarmuka ini untuk aliran data work order dari dan ke Proalpha. - Proalpha Integration Platform. Platform yang diumumkan pada April 2026 dan didukung n8n ini “will be available to customers either on-premises or in the cloud.” (akan tersedia bagi pelanggan, baik secara lokal maupun di cloud). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (akan mengandalkan arsitektur referensi yang berpusat pada API dan antarmuka REST). (Proalpha)
- EDI dan ekspor file. INWB menangani format file khusus industri, dan ekspor file sudah memadai untuk uji coba SkyPlanner.
Endpoint produksi
| API Proalpha | Endpoint | Penggunaan dalam integrasi |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Rencana waktu mulai dan selesai setiap operasi (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Sumber daya produksi yang dipilih saat penjadwalan (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Konfirmasi: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Komponen dengan partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Stok per area MRP |
Autentikasi
Spesifikasi Proalpha yang dipublikasikan menggunakan autentikasi HTTP Basic. Endpoint berbeda sesuai lingkungan, {schema}://{host}:{port}/api/web/v1/..., pada server Proalpha Anda atau Proalpha Cloud. Buat akun pengguna teknis khusus dengan hak akses yang terbatas pada objek dalam tabel pemetaan. Rencanakan akses jaringan dari cloud SkyPlanner ke endpoint tersebut bersama tim TI Anda.
Di sisi SkyPlanner, REST API menggunakan token API untuk autentikasi (SkyPlanner Settings > API) dan didokumentasikan dalam Swagger/OpenAPI. Token API saja sudah cukup untuk memulai. Tutorial integrasi memandu Anda melakukan panggilan API pertama.
Peristiwa dan polling
Proalpha API Portal tidak mencantumkan API untuk berlangganan webhook. Perubahan data dari Proalpha dikirim melalui:
- aliran pesan INWB yang mengirim work order baru dan yang diubah beserta operasinya
- alur kerja n8n pada Proalpha Integration Platform
- polling terjadwal pada Material API untuk mengambil data stok
SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan balik ke Proalpha dipicu oleh peristiwa.
Pemetaan data
| Objek atau API Proalpha | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
| Part (Part API) | Produk dan material | Proalpha → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Model proses produk: process, activities; baris BOM pada work order | Struktur produk, subproduk, tahapan proses | Proalpha → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Work order (Fertigungsauftrag) beserta jumlah dan tenggatnya | Pesanan dan job beserta tenggat dan prioritasnya | Proalpha → SkyPlanner | Dikirim langsung melalui INWB atau n8n, atau setiap beberapa menit |
| Operasi work order: targetSetupTime, targetProcessTime, resource | Tahapan proses beserta waktu setup dan durasinya | Proalpha → SkyPlanner | Bersamaan dengan work order |
| Sumber daya produksi, kelompok sumber daya produksi, kelompok sumber daya produksi alternatif | Stasiun kerja, kelompok stasiun kerja, stasiun kerja alternatif | Proalpha → SkyPlanner | Pemuatan awal |
| Blok kalender sumber daya produksi dengan intensity dan overloadIntensity | Shift dan efisiensi stasiun kerja | Proalpha → SkyPlanner | Pemuatan awal; setiap hari atau dikelola di SkyPlanner |
| Stok per area MRP | Stok material | Proalpha → SkyPlanner | Setiap jam atau sebelum setiap proses penjadwalan |
| Pesanan pembelian beserta tanggal pengirimannya | Material masuk pada tanggal pengirimannya | Proalpha → SkyPlanner | Setiap jam atau sebelum setiap proses penjadwalan |
| setWorkOrderOperationDates | Waktu mulai dan selesai terjadwal untuk setiap operasi | SkyPlanner → Proalpha | Saat jadwal berubah, melalui webhook SkyPlanner |
| changeWorkOrderOperationResource | Stasiun kerja yang dipilih oleh mesin penjadwalan | SkyPlanner → Proalpha | Saat jadwal berubah |
| operationDataEntry (setup, process, combined) | Catatan waktu dan jumlah dari Mobile Confirmations | SkyPlanner → Proalpha | Setiap konfirmasi atau setiap shift |
| Aturan penjadwalan SkyPlanner | Matriks waktu penyiapan dan peralihan, perkakas sebagai sumber daya produksi berkapasitas terbatas, jumlah operator | Dikelola di SkyPlanner | Dikonfigurasi selama penyiapan awal |
Pola integrasi
1. Pemuatan awal master data. Baca data komponen melalui Part API dan muat sumber daya produksi, kelompok sumber daya produksi, serta kalender satu kali melalui INWB atau ekspor file. Petakan setiap sumber daya produksi Proalpha ke stasiun kerja SkyPlanner dengan cermat. Kelompok sumber daya produksi alternatif dipetakan menjadi stasiun kerja alternatif.
2. Sinkronisasi pesanan. Alur pesan INWB atau alur kerja n8n mengirim work order yang masih terbuka beserta operasi, target waktu, dan sumber daya produksinya. Data stok diambil dari Material API per area MRP, sedangkan pesanan pembelian yang masih terbuka dikirim melalui INWB. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered.
3. Penulisan kembali jadwal. Untuk setiap operasi yang dijadwalkan atau dipindahkan oleh mesin penjadwalan, integrasi memanggil setWorkOrderOperationDates dengan guid operasi, waktu mulai, dan waktu selesai. Jika mesin penjadwalan memilih sumber daya produksi lain, pemanggilan changeWorkOrderOperationResource menyusul.
4. Konfirmasi di lantai produksi. Operator mencatat pekerjaan dengan SkyPlanner Mobile Confirmations atau Production Timer. Catatan waktu menjaga jadwal tetap mutakhir dan dikirim ke Proalpha melalui operationDataEntry. Jika pabrik Anda sudah melakukan konfirmasi melalui terminal PDC, gunakan satu saluran saja agar pencatatan tidak ganda.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum mulai beroperasi:
| Data | Pemilik |
|---|---|
| Komponen, model proses, kuantitas, status work order | Proalpha |
| Urutan operasi, waktu mulai dan selesai, penetapan sumber daya produksi | SkyPlanner |
| Matriks waktu penyiapan dan pergantian, perkakas, jumlah operator | SkyPlanner |
| Shift dan ketidakhadiran | Satu sistem, dipilih saat penentuan lingkup |
| Konfirmasi dan pencatatan stok | Proalpha, dengan data dari catatan waktu SkyPlanner atau PDC |
Jika Proalpha APS atau Feinplanung aktif, tentukan sistem mana yang berwenang mengatur tanggal operasi. Dua sistem penjadwalan yang menulis tanggal yang sama akan saling menimpa. Dengan Autopilot, SkyPlanner menjadwalkan ulang secara otomatis saat terjadi perubahan produksi.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu sejak proses orientasi dimulai. Sebelum itu, Anda dapat menjalankan uji coba gratis selama 30 hari dengan data sendiri. Ekspor work order yang masih terbuka, operasi, dan sumber daya produksi dari Proalpha ke CSV atau Excel, lalu impor data tersebut dan validasi jadwalnya.
- Lokakarya pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, dan saluran konfirmasi bersama mitra Proalpha Anda.
- Penyiapan antarmuka. Aktifkan REST API dan alur INWB, buat akun pengguna teknis, lalu buka akses jaringan. Lakukan terlebih dahulu di sistem uji, kemudian di sistem produksi.
- Pemuatan awal. Komponen, sumber daya produksi, kelompok sumber daya produksi, dan kalender.
- Sinkronisasi pesanan, stok, dan pesanan pembelian. Kirim work order melalui INWB atau n8n dan ambil data stok secara berkala melalui polling, dengan mekanisme percobaan ulang.
- Pengaturan batasan di SkyPlanner. Matriks waktu penyiapan dan pergantian, perkakas, jumlah operator, dan stasiun kerja alternatif.
- Penulisan kembali jadwal. Gunakan setWorkOrderOperationDates dan changeWorkOrderOperationResource; operationDataEntry ditambahkan pada tahap ini.
- Pengoperasian paralel. Bandingkan tanggal dari SkyPlanner dengan rencana saat ini, lalu perbaiki master data.
- Mulai beroperasi. Aktifkan penulisan kembali setelah data sesuai.
Hal yang perlu disiapkan dalam integrasi Proalpha
- Tidak ada objek routing. Proalpha menyusun rencana berdasarkan model proses produk. Alat yang disalin dari proyek SAP atau Business Central mencari routing sehingga sebagian data terlewat. Pada work order, baca operasi dan baris BOM.
- Intensitas kalender. Blok kalender memuat intensity dan overloadIntensity. Petakan keduanya ke shift dan efisiensi di SkyPlanner, bukan sekadar menyalin jumlah jam mentah.
- Satuan ukur. Periksa quantityUnitCode dan pastikan apakah target waktu setup berlaku per pesanan atau per unit. Satuan yang salah membuat semua durasi meleset.
- Endpoint di server pelanggan. Lapisan REST berjalan di server Proalpha Anda. Pengaturan firewall, port, dan sertifikat menentukan kapan proyek dapat dimulai, jadi siapkan aksesnya sejak awal.
- Versi rilis. Sebelum menetapkan pemetaan, pastikan bersama mitra Anda REST API mana saja yang tersedia pada rilis Proalpha Anda.
- Dokumentasi yang memerlukan login. Bantuan daring Proalpha tersedia melalui Documentation Portal. Pastikan nama field bersama mitra Anda, jangan menebaknya.
Integrasi Proalpha: siapa yang mengonfigurasi dan mendukungnya
- Tim SkyPlanner mengonfigurasinya selama proses orientasi dan memberikan dukungan setelah mulai beroperasi. Setiap instalasi Proalpha memiliki pemodelan yang berbeda, dan di sinilah keahlian tersebut diterapkan.
- Mitra Proalpha Anda dapat ikut terlibat. Mitra memahami model proses, alur INWB, dan versi rilis Anda, serta dapat menyiapkan akses API. SkyPlanner menyediakan REST API, dokumentasi Swagger/OpenAPI, dan webhook.
- Pengembang internal Anda dapat mengembangkan integrasi ini menggunakan REST API yang sama dengan token API. Tim SkyPlanner membantu bila diperlukan. Dokumentasi produk tersedia untuk umum di dokumentasi SkyPlanner.
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 langganan, sehingga Anda mengetahui seluruh biaya sebelum memulai. Pelajari cara Proalpha merencanakan kapasitas di Apakah proALPHA mendukung penjadwalan produksi sesuai kapasitas?, baca gambaran umumnya di halaman proALPHA, dan lihat sistem lain di pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
2 jamdihemat setiap minggu
“SkyPlanner telah membawa perencanaan produksi kami dari lembar kerja Excel ke optimasi produksi secara real-time.”
Kalle Kalliomäki, Spesialis Rantai Pasok
UTU · Panel distribusi listrik dan perangkat hubung bagi
Perencanaan produksi menghemat 2 jam waktu 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 optimal untuk tiga bulan di seluruh stasiun kerja membutuhkan waktu kurang dari 30 menit.
99,2%keandalan pengiriman
“SkyPlanner membuat hambatan produksi lebih mudah dikenali dan pengelolaan produksi lebih jelas.”
Toni Tuori, Manajer Produksi
Piristeel · Perlengkapan keselamatan atap dan sistem air hujan
Keandalan pengiriman mencapai 99,2% tahun ini, dan penjadwalan menghemat hingga empat jam waktu kerja per hari.
Lebih sedikitpenghentian produksi akibat kekurangan material
“Manfaat SkyPlanner bagi kami adalah kegunaannya sebagai alat dalam pekerjaan sehari-hari, terutama untuk menetapkan tanggal pengiriman.”
Tommi Männistö, Manajer Perencanaan Produksi
Eskomatic · Jasa pemesinan berdasarkan kontrak
Penjadwalan beban kerja otomatis menghasilkan tanggal pengiriman yang lebih akurat, dan penghentian produksi akibat kekurangan material telah berkurang tajam.
Pertanyaan umum
Antarmuka Proalpha mana yang digunakan oleh integrasi ini?
REST API Proalpha digunakan untuk komponen, stok, serta penulisan kembali tanggal, sumber daya produksi, dan konfirmasi. Alur pesan INWB atau Integration Platform berbasis n8n mengirim work order beserta operasinya. Ekspor file digunakan untuk uji coba dan pemuatan data massal.
Di mana tanggal yang direncanakan disimpan di Proalpha?
Pada operasi work order, melalui setWorkOrderOperationDates dengan waktu mulai dan selesai. Jika mesin penjadwalan memindahkan job ke mesin lain, changeWorkOrderOperationResource memperbarui sumber daya produksinya.
Apakah Proalpha mendukung webhook?
Proalpha API Portal tidak mencantumkan API untuk berlangganan webhook. Perubahan diteruskan ke SkyPlanner melalui alur pesan INWB, alur kerja n8n, atau polling. Webhook milik SkyPlanner memungkinkan penulisan kembali dipicu oleh peristiwa.
Bisakah konfirmasi operator dikirim ke Proalpha?
Ya. Catatan waktu dari SkyPlanner Mobile Confirmations dikirim melalui operationDataEntry, beserta kuantitas, karyawan, dan waktu penggunaan sumber daya produksi. Gunakan satu saluran konfirmasi saja jika terminal PDC juga digunakan.
Apakah kami memerlukan Proalpha APS, dan bagaimana jika kami sudah menggunakannya?
Anda tidak memerlukannya. SkyPlanner menyusun sendiri jadwal yang sesuai dengan kapasitas mesin dan tenaga kerja berdasarkan work order, operasi, dan sumber daya produksi Anda, sementara Autopilot menjaganya tetap mutakhir. Jika Proalpha APS aktif, tentukan sistem mana yang berwenang mengatur tanggal operasi pada tahap penentuan lingkup. SkyPlanner kemudian hanya menulis tanggal yang menjadi kewenangannya, sehingga kedua rencana tidak pernah saling menimpa.
Bisakah kami mencoba SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan data work order yang diekspor ke CSV atau Excel, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
