API dan Integrasi Sistem
Lokasi Menu: Manajemen → API & Integrasi (menu Admin), mencakup Webhooks, Inbound Webhooks, SAP, Epicor, Dokumentasi API, MCP, dan Error Events.
Masalah Lapangan yang Kerap Terjadi
- "Data inventaris suku cadang di ERP tidak sinkron dengan CMMS, menyebabkan rekonsiliasi manual yang memakan waktu."
- "Tim otomasi memerlukan webhook instan agar sistem internal dapat langsung bereaksi ketika tiket insiden diterbitkan."
- "Bagaimana cara menghubungkan agen AI perusahaan agar dapat mengelola data perawatan secara terstruktur dan aman?"
Keandalan sistem pemeliharaan modern sangat ditentukan oleh kemampuannya terhubung secara mulus dengan ekosistem TI perusahaan.
Tantangan Integrasi Sistem Perusahaan
Data pemeliharaan tidak boleh terisolasi dari ekosistem perangkat lunak lain seperti ERP korporat, platform analitik bisnis (BI), dan skrip otomasi internal. Tanpa antarmuka integrasi yang kokoh, tim terpaksa melakukan ekspor dan impor data secara manual, menghadapi inkonsistensi rekaman transaksi, serta merawat kode integrasi ad-hoc yang rapuh dan rawan galat.
Solusi Integrasi Terbuka OpexMX
OpexMX menyediakan arsitektur integrasi komprehensif yang mencakup webhook dua arah (outbound dan inbound), konektor sinkronisasi bawaan untuk SAP dan Epicor, server Model Context Protocol (MCP) untuk integrasi agen AI, serta spesifikasi OpenAPI yang diperbarui otomatis.
Webhook Keluar (Outbound Webhooks)
Daftarkan endpoint webhook untuk merespons berbagai peristiwa operasional (seperti ticket.created, workorder.completed, atau asset.status_changed). Dilengkapi pengamanan signature secret, kustomisasi header HTTP, serta kebijakan percobaan ulang otomatis (retry backoff) dengan batas maxRetries. Anda dapat merotasi secret key secara mandiri, menguji pengiriman payload uji coba, serta memantau log transmisi dan rasio keberhasilan pengiriman per webhook.
Webhook Masuk (Inbound Webhooks)
Setiap sistem eksternal yang mengirimkan data ke OpexMX dibekali token otentikasi unik, pembatasan daftar putih IP (IP whitelisting) opsional, dan penyaringan tipe peristiwa. Setiap data masuk dicatat lengkap dengan isi payload, alamat IP pengirim, serta durasi pemrosesan, memastikan integrasi eksternal berlangsung aman dan transparan.
Sinkronisasi Dua Arah SAP dan Epicor
Mesin sinkronisasi bawaan untuk ERP kelas industri seperti SAP dan Epicor mendukung:
- Pemetaan atribut data yang fleksibel untuk entitas aset, suku cadang, work order, dan purchase order.
- Mekanisme delta sync yang hanya mentransfer rekaman data yang mengalami perubahan guna menghemat bandwidth.
- Pengujian konektivitas langsung dan pemantauan riwayat log sinkronisasi per entitas.
- Antrean pesan gagal (Dead-Letter Queue / DLQ) yang dilengkapi fitur pemrosesan ulang (replay), baik untuk seluruh antrean maupun per rekaman yang gagal.
- Pertukaran data dua arah secara penuh, baik data masuk maupun keluar.
Server Model Context Protocol (MCP)
Buka akses data OpexMX ke ekosistem agen cerdas berbasis AI (seperti Claude Code, Cursor, atau klien MCP lainnya). Otentikasi menggunakan satu API key yang mengikat hak akses pengguna. Server berkomunikasi melalui protokol JSON-RPC lewat antarmuka stdio serta menyediakan kumpulan alat (tools) kurasi untuk mengelola aset, suku cadang, dan perintah kerja, ditambah generator perkakas otomatis.
Spesifikasi OpenAPI yang Terbarui Otomatis
Spesifikasi dokumentasi API disusun secara dinamis dari skema rute sistem yang aktif. Tim pengembang perangkat lunak membangun integrasi berdasarkan kondisi riil sistem produksi, bukan berdasarkan dokumen statis yang rentan kedaluwarsa.
Alur Implementasi Integrasi
- Konfigurasi Webhook Keluar: Pilih peristiwa penting yang ingin dimonitor dan daftarkan URL endpoint sistem penerima.
- Penerimaan Data Masuk: Berikan token otentikasi unik kepada sistem eksternal untuk mulai mengirimkan payload data ke OpexMX.
- Sinkronisasi ERP: Konfigurasikan pemetaan atribut SAP atau Epicor, aktifkan delta sync, dan tangani kegagalan transmisi melalui DLQ.
- Konektivitas Agen AI: Arahkan klien MCP ke server lokal dengan menyertakan kredensial API key yang relevan.
- Pengembangan Kustom: Bangun kode integrasi menggunakan spesifikasi OpenAPI resmi yang selalu sinkron.
Pengguna dan Fokus Utama
| Peran | Fokus Utama |
|---|---|
| Tim IT dan Sistem Integrasi | Menjamin keandalan sinkronisasi data ERP tanpa ada rekaman yang terlewat atau inkonsisten. |
| Software Engineer | Membangun ekstensi fitur menggunakan antarmuka REST API dan webhook yang terstandarisasi. |
| Data Analyst dan Tim BI | Mengalirkan data operasional pemeliharaan ke gudang data (data warehouse) untuk analitik bisnis. |
| Pengembang AI (AI Engineers) | Menghubungkan agen cerdas ke sistem operasional melalui protokol standar MCP. |
Praktik Terbaik
- Berlangganan Peristiwa yang Relevan: Daftarkan webhook keluar hanya untuk peristiwa operasional yang benar-benar dibutuhkan oleh sistem target guna menghemat beban pemrosesan.
- Manfaatkan Fitur Dead-Letter Queue (DLQ): Saat terjadi kegagalan transmisi ke ERP, biarkan sistem menampungnya di DLQ untuk diproses ulang secara berkelompok, alih-alih melakukan penanganan darurat per baris data.
- Terapkan Prinsip Hak Akses Terendah pada API Key: Batasi cakupan izin API key MCP hanya pada perkakas dan entitas yang benar-benar dibutuhkan oleh agen AI.
- Gunakan Code Generator dari OpenAPI: Hasilkan pustaka klien SDK langsung dari skema OpenAPI resmi agar kode integrasi selalu selaras dengan pembaruan rute API.
Integrasi Antarmodul
- Tiket, Aset, Suku Cadang, dan PM: Seluruh entitas inti sistem dapat diakses melalui webhook, modul sinkronisasi ERP, maupun perkakas MCP.
- Sistem Notifikasi: Kegagalan pengiriman webhook atau sinkronisasi ERP dapat memicu peringatan otomatis ke tim teknis.
- Analitik dan Pelaporan: Akses API memfasilitasi pengisian data ke platform visualisasi bisnis dan dasbor manajemen.