Panduan Integrasi ProShop ERP untuk Penjadwalan Produksi dengan SkyPlanner APS
Panduan integrasi ProShop ini menjelaskan cara menghubungkan ProShop ERP ke SkyPlanner APS bagi administrator, konsultan, dan tim TI. SkyPlanner terintegrasi dua arah dengan ProShop melalui API milik ProShop:
- Work Orders beserta operasinya, Parts, catatan Work Order BOM, Work Cells, Users, Tools, Fixtures, dan Purchase Orders masuk ke SkyPlanner.
- Tanggal mulai dan selesai yang direncanakan dikirim kembali ke work order.
- Waktu kerja operator dapat dikirim kembali ke ProShop Time Tracking jika Anda memilih opsi ini.
- Webhook SkyPlanner mengirim perubahan jadwal begitu perubahan terjadi.
Tim SkyPlanner mengonfigurasi integrasi agar sesuai dengan konfigurasi ProShop Anda selama proses orientasi 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 telah didokumentasikan (referensi API).
Antarmuka integrasi ProShop
ProShop menyediakan dua jalur untuk sistem penjadwalan eksternal, yang dijelaskan dalam dokumentasi pengembang API ProShop:
- ProShop GraphQL API. “ProShop provides a GraphQL API, available via HTTP(S).” (ProShop menyediakan GraphQL API yang dapat diakses melalui HTTP(S).) Hanya ada satu endpoint: setiap panggilan berupa HTTP POST ke
<proshop root>/api/graphqldenganquery,variables, danoperationNamedi dalam body JSON. Setiap modul memiliki kueri tunggal untuk satu catatan dan kueri jamak untuk daftar. Daftar dibagi menjadi halaman menggunakanpageSize(nilai default 20) danpageStart, mengembalikanrecordsdantotalRecords, serta menerima argumenfilterdanqueryyang sesuai dengan Advanced Search di masing-masing modul. Skemanya mendukung introspeksi. (Pengantar API ProShop) - Recently Updated Records API. “A simple REST interface allows external integrations to request information between arbitrary points in time.” (Antarmuka REST sederhana memungkinkan integrasi eksternal meminta informasi dalam rentang waktu yang ditentukan.) Panggil
<proshop root>/recentlyupdatedrecordsdenganstart(ISO 8601), sertaenddanfilterbyyang bersifat opsional, misalnyaworkorders,workcells,purchaseorders,timetracking,deletions. Tim ProShop perlu mengaktifkan indeksnya terlebih dahulu. (Recently Updated Records API)
Penulisan data dilakukan melalui mutasi GraphQL. Time Tracking Login merupakan contoh yang didokumentasikan, dan akses tulis diberikan per modul melalui cakupan izin.
Autentikasi dan cakupan izin
- Token akses pada setiap panggilan. Kirim token sebagai
Authorization: Bearer <token>atau sebagai parameter kueritoken. - OAuth 2.0 Client Credentials (ProShop 5.2.3 dan versi setelahnya). Administrator sistem ProShop membuka System Config > Manage Authorizations, membuat Authorization dengan Name dan Maximum Scope, lalu mencentang Direct Login dan Active. Unique ID dan Shared Secret digunakan sebagai
client_iddanclient_secret. Aplikasi mengirimgrant_type=client_credentialsmelalui POST ke<proshop root>/home/member/oauth/accesstokendan menerima token Bearer besertaexpires_in. Tidak ada token penyegaran, jadi mintalah token baru saat token tersebut kedaluwarsa. (Alur Client Credentials) - OAuth 2.0 Authorization Flow digunakan untuk panggilan yang memerlukan konteks pengguna, seperti Time Tracking Login.
- Cakupan izin. Formatnya adalah
SCOPE_NAME:[{r|w|d|p}], masing-masing untuk membaca, menulis, menghapus, dan preferensi. Sistem penjadwalan biasanya memintaworkorders:rw parts:r purchaseorders:r users:r tools:r, ditambah Time Tracking jika data waktu dikirim kembali. Sejak ProShop 5.1.9, “a scope grant request is now required on all connections to the API.” (Permintaan pemberian cakupan izin kini wajib untuk semua koneksi ke API.) (Cakupan izin otorisasi) - Jejak audit. Panggilan yang menggunakan kredensial klien menampilkan nama aplikasi, bukan pengguna.
Di sisi SkyPlanner, autentikasi REST API menggunakan token API pada header Authorization-Token (SkyPlanner Settings > API), dan dokumentasinya tersedia di Swagger/OpenAPI. Tutorial integrasi memandu Anda melakukan panggilan awal.
Event dan polling
Dokumentasi pengembang ProShop tidak menjelaskan adanya webhook keluar atau langganan GraphQL. Data di sisi ProShop diperiksa melalui polling, dan Recently Updated Records API membuat proses ini ringan: minta semua data yang dibuat, diubah, atau dihapus sejak pemeriksaan terakhir, lalu saring berdasarkan jenis catatan yang diperlukan untuk penjadwalan. Setelah itu, ambil work order yang berubah berdasarkan nomornya melalui GraphQL. Menurut ProShop, cara ini lebih cepat daripada kueri berdasarkan lastModifiedTime.
Interval yang umum dipilih adalah lima menit untuk work order dan pencatatan waktu, serta setiap jam untuk komponen dan pesanan pembelian. SkyPlanner mengirim webhook saat status atau jadwal berubah, sehingga penulisan balik data dipicu oleh peristiwa.
Pemetaan data
| Objek ProShop (API) | Objek SkyPlanner | Arah | Frekuensi |
|---|---|---|---|
Parts, COTS (cakupan izin GraphQL parts) | Produk dan material | ProShop → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Catatan Work Order BOM | Struktur produk, material per pesanan | ProShop → SkyPlanner | Bersama setiap work order |
| Operasi work order: sel kerja, estimasi waktu persiapan dan waktu siklus (waktu target) | Tahapan proses beserta durasi, waktu persiapan, dan waktu pembongkaran | ProShop → SkyPlanner | Bersama setiap work order |
| Work Cells (mesin, meja kerja, peralatan) | Stasiun kerja, kelompok stasiun kerja, tingkat efisiensi | ProShop → SkyPlanner | Pemuatan awal, jarang dilakukan setelahnya |
| Work Cells yang ditetapkan untuk personel, Users | Personel dan penugasan operator | ProShop → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Jadwal sel kerja (jam tersedia, sif) | Sif dan hari nonkerja | ProShop → SkyPlanner | Setiap hari, atau kelola sif di SkyPlanner |
| Work Orders (jumlah, tenggat, status) | Pesanan dan job beserta tenggat dan prioritas | ProShop → SkyPlanner | Polling setiap beberapa menit |
| Tools, Toolpots, Fixtures, RTAs | Perkakas sebagai sumber daya bersama dengan kapasitas terbatas | ProShop → SkyPlanner | Pemuatan awal, lalu setiap ada perubahan |
| Purchase Orders beserta tenggat | Pesanan pembelian, material masuk berdasarkan tanggal pengiriman | ProShop → SkyPlanner | Polling setiap jam atau saat penjadwalan dijalankan |
Waktu mulai dan selesai work order yang direncanakan (mutasi GraphQL, workorders:w) | Waktu mulai dan selesai yang direncanakan per job | SkyPlanner → ProShop | Saat jadwal berubah, melalui webhook SkyPlanner |
| Time Tracking: waktu persiapan dan pengerjaan, komponen yang selesai, per operasi work order | Catatan waktu dan konfirmasi operator | SkyPlanner → ProShop | Setiap konfirmasi atau setiap sif, jika dipilih |
| Tidak ada di ProShop | Matriks waktu persiapan dan pergantian, job dengan beberapa operator, serta mesin dan personel alternatif | Dikelola di SkyPlanner | Dikonfigurasi selama proses orientasi |
Pola integrasi
1. Pemuatan awal master data. Ambil Parts, Work Cells, Users, Tools, dan Fixtures halaman demi halaman menggunakan kueri jamak GraphQL. Tetapkan nilai pageSize yang besar untuk pemuatan pertama dan lakukan perulangan berdasarkan totalRecords. Tentukan pemetaan sel kerja: sel kerja mesin menjadi stasiun kerja, sedangkan sel kerja personel menjadi personel. Dengan begitu, operasi yang sama dapat mengalokasikan mesin beserta operatornya sekaligus.
2. Sinkronisasi work order. Baca work order aktif beserta operasi, waktu target, dan catatan BOM-nya, serta pesanan pembelian yang masih terbuka. SkyPlanner menganggap material yang dipesan tersedia pada tanggal pengiriman PO dan memperbarui stok saat PO ditandai Delivered. Deteksi perubahan dilakukan melalui Recently Updated Records dengan filterby=workorders,purchaseorders,deletions.
3. Penulisan balik jadwal. Saat mesin penjadwalan menempatkan atau memindahkan job, webhook SkyPlanner memicu mutasi GraphQL yang menetapkan tanggal rencana work order menggunakan Authorization dengan workorders:w. Perkiraan ketepatan waktu dan tanggal kebutuhan pembelian di ProShop kemudian mengacu pada tanggal dari SkyPlanner.
4. Konfirmasi dari lantai produksi. Operator mencatat pekerjaan melalui SkyPlanner Mobile Confirmations atau Production Timer, dan catatan waktu tersebut menjaga jadwal tetap mutakhir. Anda menentukan apakah waktu aktual dikirim kembali ke ProShop Time Tracking untuk operasi work order terkait. Jika tidak, operator tetap mencatat waktu di ProShop seperti sebelumnya, lalu SkyPlanner membacanya melalui timetracking.
5. Aturan kepemilikan data dan penanganan konflik. Dokumentasikan aturan ini sebelum sistem mulai digunakan:
| Data | Pemilik |
|---|---|
| Parts, operasi, waktu target, jumlah, status work order | ProShop |
| Urutan operasi, waktu mulai dan selesai, penugasan mesin dan operator | SkyPlanner |
| Matriks waktu persiapan dan pergantian, kebutuhan perkakas dan operator, sumber daya produksi alternatif | SkyPlanner |
| Sif dan hari nonkerja | Satu sistem, dipilih saat penentuan lingkup |
| Time Tracking, persediaan, pembelian, perhitungan biaya job | ProShop, dengan data yang dimasukkan langsung atau dikirim dari catatan waktu SkyPlanner |
Tetapkan satu sistem yang berwenang menulis tanggal work order. Setelah SkyPlanner menjadwalkan suatu sel kerja, perencana tidak lagi mengubah urutan daftar sel kerja tersebut di ProShop, sehingga kedua rencana tidak pernah saling bertentangan.
Tahapan proyek pada umumnya
Implementasi biasanya selesai dalam hitungan minggu setelah proses orientasi dimulai. Sebelumnya, validasi jadwal selama uji coba gratis 30 hari menggunakan data sel kerja, operasi, dan work order terbuka yang diekspor dari ProShop dalam format CSV atau Excel.
- Pemetaan. Tetapkan tabel pemetaan, aturan kepemilikan data, frekuensi sinkronisasi, dan apakah data waktu dikirim kembali.
- Akses ProShop. Administrator membuat Authorization dengan Maximum Scope yang disepakati dan meminta tim ProShop mengaktifkan Recently Updated Records.
- Pemuatan awal. Parts, Work Cells, Users, Tools, Fixtures, dan jadwal sel kerja.
- Sinkronisasi work order dan pesanan pembelian. Polling perubahan dengan paginasi dan percobaan ulang.
- Konfigurasi batasan di SkyPlanner. Matriks waktu persiapan dan pergantian, perkakas, jumlah operator per operasi, serta mesin atau personel alternatif.
- Penulisan balik jadwal. Mutasi yang dipicu webhook SkyPlanner, ditambah Time Tracking jika dipilih.
- Pengujian paralel. Jalankan SkyPlanner berdampingan dengan jadwal ProShop saat ini, bandingkan tanggalnya, lalu perbaiki waktu target.
- Mulai operasional. Aktifkan penulisan balik setelah data cocok.
Hal yang perlu direncanakan dalam integrasi ProShop
- Waktu target menentukan segalanya. ProShop menghitung durasi dari perkiraan waktu persiapan dan waktu siklus. Ambil waktu target terkini, bukan estimasi awal, dan pisahkan waktu persiapan dari waktu proses agar matriks waktu persiapan dan pergantian dapat menggantikan satu nilai waktu persiapan.
- Sel kerja berupa personel. Sel kerja bisa berupa seseorang. Petakan sel seperti ini ke personel di SkyPlanner, bukan ke mesin. Jika tidak, setiap operator akan dianggap sebagai mesin paralel.
- Time Tracking memerlukan pengguna. Sejak April 2026, mutasi Time Tracking Login “requires user context” (memerlukan konteks pengguna) dan tidak diizinkan melalui Client Credentials. Kirim catatan waktu operator melalui OAuth 2.0 Authorization Flow, atau tetap catat waktu di ProShop lalu baca datanya.
- Aktifkan indeks perubahan. Recently Updated Records hanya berfungsi setelah diaktifkan oleh tim ProShop. Ajukan permintaan ini pada minggu pertama.
- Data yang dibatasi ITAR. ProShop memfilter data yang dibatasi ITAR untuk setiap koneksi. Opsi di Developer System Config menentukan apakah data tersebut dikembalikan sebagai null atau tidak disertakan. Sepakati work order mana yang dapat diakses integrasi, dan tangani nilai null pada setiap pembacaan.
- Proses di pihak luar. Operasi di pemasok dihitung sebagai durasi yang berlalu, bukan sebagai beban kapasitas Anda. Modelkan sebagai langkah yang hanya memperhitungkan waktu.
Siapa yang mengonfigurasi dan mendukung integrasi ProShop
- Tim SkyPlanner mengonfigurasi integrasi saat penerapan awal dan memberikan dukungan setelah mulai digunakan, mencakup kueri GraphQL, mutasi, dan pemeriksaan perubahan berkala yang telah disepakati. Setiap pabrik menggunakan ProShop dengan cara berbeda, dan pengalaman tersebut diterapkan di sini.
- Administrator atau konsultan ProShop Anda ikut terlibat. Mereka membuat Authorization, mengatur cakupan akses, meminta pengaktifan indeks perubahan, dan memahami konfigurasi sel kerja Anda.
- Pengembang Anda sendiri dapat mengembangkan integrasi ini lebih lanjut melalui REST API SkyPlanner dengan token API. Token API sudah cukup untuk memulai, dan tim SkyPlanner siap membantu saat dibutuhkan. Dokumentasi tersedia di dokumentasi integrasi SkyPlanner.
Harga SkyPlanner mulai dari 199 € per bulan, sudah termasuk 5 stasiun kerja, dengan tagihan bulanan. Penawaran biaya integrasi diberikan di awal sesuai proses dan kebutuhan Anda, bersama paket yang dipilih. Lihat harga, penjadwalan produksi ProShop sesuai kapasitas mesin dan tenaga kerja, halaman ProShop ERP, fitur SkyPlanner, dan pusat integrasi ERP.
Ulasan SkyPlanner dari perusahaan manufaktur
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 distribusi dan perangkat hubung listrik
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 optimal untuk tiga bulan di seluruh stasiun kerja memerlukan waktu kurang dari 30 menit.
98%keandalan pengiriman, naik dari sekitar 50%
“SkyPlanner berperan menentukan dalam menjaga keandalan pengiriman kami.”
Hannu Lahtinen, Direktur Utama
KJH-Comp · Pengerjaan mekanis pelat logam dan manufaktur kontrak
Keandalan pengiriman naik dari sekitar 50% hingga mencapai 98%, dan penjadwalan kini hanya memerlukan satu supervisor, bukan dua.
1.000-anwork order dijadwalkan secara otomatis
“Kini kami mengendalikan produksi dengan cara yang berbeda, dan pemahaman kami tentang kapasitas sudah berada pada tingkat yang sama sekali berbeda.”
Hannu Ryynänen, CEO
Mamec · Mesin pencampur industri, pompa, dan manufaktur kontrak berteknologi tinggi
Ribuan work order dijadwalkan secara otomatis, dan seluruh organisasi dapat memantau produksi secara real-time.
Pertanyaan umum
Apakah ProShop memiliki API?
Ya. ProShop memiliki GraphQL API di <proshop root>/api/graphql, dengan OAuth 2.0 atau Basic Authentication serta cakupan akses per modul. Endpoint REST Recently Updated Records mengembalikan data yang dibuat, diubah, atau dihapus dalam rentang waktu tertentu.
Apakah ProShop mendukung webhook?
Dokumentasi pengembang ProShop tidak menjelaskan adanya webhook keluar. Integrasi memeriksa Recently Updated Records API secara berkala sesuai jadwal yang ditetapkan untuk setiap pabrik. Webhook SkyPlanner sendiri mengirim perubahan jadwal begitu perubahan terjadi.
Bagaimana tanggal yang direncanakan ditulis kembali ke ProShop?
Melalui mutasi GraphQL pada work order, menggunakan Authorization dengan cakupan akses tulis pada workorders. SkyPlanner memicunya melalui webhook setiap kali jadwal berubah.
Siapa yang membuat kredensial API ProShop?
Administrator sistem ProShop, melalui System Config > Manage Authorizations. Direct Login mengaktifkan alur Client Credentials, sedangkan Maximum Scope membatasi data yang dapat dibaca dan ditulis oleh integrasi.
Sebaiknya konsultan ProShop merekomendasikan penjadwalan ProShop atau SkyPlanner?
SkyPlanner, jika urutan produksi pelanggan menentukan pengiriman. Jadwal ProShop menampilkan prioritas dan perkiraan ketepatan waktu per sel kerja, lalu perencana menyesuaikan prioritas tersebut. SkyPlanner terhubung melalui GraphQL API, mengoptimalkan seluruh rencana secara otomatis, serta merencanakan pergantian produksi, operator, perkakas, dan material. Jumlah penggunanya tidak dibatasi, dengan harga mulai dari 199 € per bulan.
Bisakah kami mencoba SkyPlanner sebelum membangun integrasi?
Ya. Uji coba gratis selama 30 hari mendukung hingga 20 stasiun kerja dengan impor CSV atau Excel dari ProShop, tanpa memerlukan kartu kredit. Mulai uji coba, atau hubungi tim penjualan untuk menentukan lingkup integrasi.
