Panduan Integrasi Pihak Ketiga & Hardware Kuliner
Updated: Sep 2026Oleh: SystemModul Unit Kuliner & Pujasera
Integrasi Pihak Ketiga (Third-Party APIs): Unit Kuliner
1. Integrasi Perangkat Keras Lokal (Hardware)#
Berbeda dengan unit lain, Unit Kuliner sangat bergantung pada hardware di kasir.
- Printer Thermal Bluetooth: Menggunakan Web Bluetooth API (didukung di Google Chrome Android) agar aplikasi web BUMDes bisa langsung menge-print struk ke printer thermal kasir tanpa perlu instalasi driver.
- Cash Drawer (Laci Uang): Sistem mengirim sinyal
ESC/POSvia koneksi printer Bluetooth untuk otomatis "menendang" laci agar terbuka saat tombol bayar tunai ditekan.
2. API Payment Gateway (QRIS Dinamis)#
- Vendor: Midtrans / Xendit.
- Skenario: Di layar kasir, saat metode "QRIS" dipilih, sistem membangkitkan QR Code Real-Time (Dinamis) yang langsung mencantumkan nominal (misal Rp 45.300). Kasir tidak perlu mengetik nominal lagi, menghindari kesalahan input (Human Error).
- Callback (Webhook): Midtrans akan memanggil endpoint
POST /api/webhooks/qris-paidmilik ERP BUMDes ketika pelanggan sukses scan dan bayar. Aplikasi POS langsung berubah status jadi "Lunas".
3. Integrasi Ojek Online (GoFood / GrabFood) - Opsional Fase 3#
- Jika BUMDes mendaftarkan kafenya ke platform Ojek Online, ERP BUMDes harus bisa mengkonsumsi (menarik) pesanan GrabFood langsung masuk ke layar Kitchen Display agar koki tidak perlu melihat dua tablet yang berbeda.