API & Integrasi
Temukan di: Manajemen → API & Integrasi (grup Admin): Webhooks, Inbound Webhooks, SAP, Epicor, Dokumentasi API, MCP, Error Events.
Pernah dengar kalimat seperti ini?
- "ERP dan CMMS kami tidak setuju soal suku cadang. Rekonsiliasi manual tak berujung."
- "Kami ingin skrip sendiri bereaksi saat tiket dibuat."
- "Bisakah agen AI menggerakkan OpexMX?"
Sistem pemeliharaan sebaik koneksinya.
Masalahnya
Data pemeliharaan harus mengalir ke dan dari ERP, perkakas monitoring, dan otomasi Anda sendiri. Tanpa integrasi nyata, ini ekspor/impor manual, catatan yang meleset, dan glue code kustom yang tidak ingin dimiliki siapa pun.
Apa yang Dilakukan API & Integrasi OpexMX
Memberi Anda webhook (kedua arah), sinkronisasi dua arah dengan SAP dan Epicor, server MCP untuk agen AI, dan spec OpenAPI yang dibuat otomatis.
Webhook Keluar
Daftarkan webhook untuk kejadian (ticket.created, dll.) dengan secret, header, dan kebijakan retry (maxRetries, backoff). Rotasi secret, picu test manual, dan lacak log pengiriman serta tingkat keberhasilan per webhook.
Webhook Masuk
Setiap sumber masuk mendapat token unik, IP whitelist opsional, dan filter tipe kejadian. Setiap penerimaan dicatat dengan payload, IP sumber, dan waktu pemrosesan — sehingga sistem eksternal push ke OpexMX dengan aman.
SAP & Epicor, Dua Arah
Mesin sinkron nyata untuk SAP dan Epicor: pemetaan field (aset, suku cadang, work order, purchase order), delta sync record berubah, pengujian koneksi, log sinkron per entitas, dan dead-letter queue dengan replay (retry-all dan per-kegagalan). Dua arah — masuk dan keluar.
Server MCP
Ekspos OpexMX ke agen AI (Claude Code, Cursor, klien MCP apa pun). Auth adalah satu API key yang membawa izin pengguna; server berbicara JSON-RPC lewat stdio dan menawarkan perkakas kurasi (aset, suku cadang, tiket, work order) plus perkakas yang dibuat otomatis dan utilitas.
Spec OpenAPI
Spec API dibuat otomatis dari rute — integrasi Anda menulis kode terhadap yang sebenarnya ada, bukan dokumen basi.
Cara Kerjanya
- Keluar: daftarkan webhook untuk kejadian yang Anda pedulikan.
- Masuk: beri sumber tokennya; ia push ke OpexMX.
- Sinkron ERP: konfigurasikan pemetaan SAP/Epicor; jalankan delta sync; replay kegagalan.
- Agen: arahkan klien MCP ke server dengan API key.
- Bangun: kode terhadap spec OpenAPI langsung.
Siapa yang Menggunakan Ini?
| Peran | Yang Mereka Pedulikan |
|---|---|
| IT / Integrasi | Sinkron ERP yang tidak meleset |
| Developer | Webhook dan spec API nyata untuk dibangun |
| Data / BI | Cara bersih mengekstrak dan bereaksi |
| Pembangun AI | MCP untuk menggerakkan OpexMX dari agen |
Tips Pro
- Mulai dengan webhook keluar untuk sedikit kejadian penting; jangan langganan semua.
- Biarkan DLQ menangkap kegagalan ERP dan replay per batch — jangan lawan baris demi baris.
- Cakupkan API key MCP ke least privilege yang agen butuhkan.
- Hasilkan kode klien dari spec OpenAPI agar tetap sinkron.
Integrasi
- Tiket / Aset / Suku Cadang / PM: entitas yang webhook, sinkron, dan MCP ekspos
- Notifikasi: pengiriman dan kegagalan webhook bisa memperingatkan
- Laporan: akses API mengisi BI dan dasbor eksekutif