Integrasi Sistem & Perangkat Keras POS Ritel (UNT-RETAIL)

1. Arsitektur Integrasi Periferal Meja Kasir#

Sistem Kasir POS PWA BUMDes berkomunikasi langsung dengan periferal kasir menggunakan standar web modern (Web APIs) tanpa memerlukan instalasi driver perangkat yang rumit:

+-----------------------------------+ +-----------------------------------+
| Barcode Scanner USB/BLE | | Thermal Printer ESC/POS 58/80mm |
| (HID Emulation / WebUSB API) | | (Web Bluetooth / Raw USB) |
+-----------------------------------+ +-----------------------------------+
 | |
 v v
 +-------------------------------------------------------------+
 | Aplikasi Kasir POS PWA (Browser Client) |
 +-------------------------------------------------------------+
 | |
 v v
+-----------------------------------+ +-----------------------------------+
| Payment Gateway QRIS | | API Biller PPOB Desa |
| (QR Dinamis & Webhook Real-time) | | (REST JSON Token & Tagihan) |
+-----------------------------------+ +-----------------------------------+

2. Integrasi Barcode Scanner (Pemindaian Produk Cepat)#

2.1 Mode Emulasi Keyboard HID (Human Interface Device)

• Mekanisme: Barcode scanner membaca kode batang EAN-13, UPC, atau Kode Internal 128 dan mengirimkannya sebagai ketukan tombol keyboard virtual yang diakhiri dengan tombol Enter.
• Handling pada React/Next.js: Sistem memasang event listener global pada jendela browser:

typescript
// Buffer pembacaan barcode berkecepatan tinggi (< 50ms per karakter)
let barcodeBuffer = '';
let lastKeyTime = Date.now();

window.addEventListener('keydown', (e) => {
const currentTime = Date.now();
if (currentTime - lastKeyTime > 100) {
barcodeBuffer = ''; // Reset jika input berasal dari ketikan manusia lambat
}
lastKeyTime = currentTime;

if (e.key === 'Enter') {
if (barcodeBuffer.length >= 4) {
handleBarcodeScanned(barcodeBuffer);
barcodeBuffer = '';
}
} else if (e.key.length === 1) {
barcodeBuffer += e.key;
}
});

3. Integrasi Thermal Printer ESC/POS (Cetak Struk Otomatis)#

1. Protokol Standar: Menggunakan standar industri perintah ESC/POS untuk pencetakan teks, tabel belanja, barcode struk, dan pemotong kertas otomatis (paper auto-cutter).
2. Konektivitas Web Bluetooth API:

• Kasir dapat menghubungkan tablet Android/iPad langsung ke printer thermal mini 58mm tanpa kabel kabel yang berantakan di meja kasir.
• Perintah pembuka laci kasir otomatis (Cash Drawer Kick-Out): Mengirimkan sinyal biner 0x1B, 0x70, 0x00, 0x19, 0xFA sesaat sebelum transaksi tunai diselesaikan.

4. Integrasi Payment Gateway QRIS Dinamis#

1. Pembuatan QRIS Dinamis Per Transaksi:

• Sistem meminta (request) pembuatan string QRIS dinamis ke API payment gateway mitra (BPD / Penyedia Jasa Pembayaran QRIS) sesuai nominal belanja bersih.
• Kode QR ditampilkan di layar kasir kedua yang menghadap pembeli.

2. Notifikasi Pembayaran Instan (Webhook / WebSocket):

• Begitu konsumen berhasil memindai dan membayar melalui aplikasi mobile banking / e-wallet apapun, server perbankan mengirimkan webhook callback.
• Layar kasir otomatis berpindah ke status lunas dan struk langsung tercetak dalam waktu kurang dari 2 detik.

5. Integrasi API Biller Agregator PPOB#

1. Protokol Komunikasi: RESTful API JSON melalui koneksi aman HTTPS dengan enkripsi tanda tangan digital SHA-256 HMAC.
2. Siklus Transaksi 2 Tahap (Inquiry & Payment):

• Tahap 1: Inquiry Tagihan: Kasir menginput nomor pelanggan; sistem menanyakan status tagihan ke server biller untuk menampilkan nama pelanggan dan nominal tagihan asli.
• Tahap 2: Payment Eksekusi: Setelah kasir mengonfirmasi penerimaan uang, sistem mengirimkan instruksi pembayaran; saldo deposit dipotong dan nomor token listrik / struk PDAM diterbitkan seketika.