🔌 Panduan Integrasi Pihak Ketiga & Hardware: Unit Persampahan & TPS3R

Dokumen ini mendokumentasikan spesifikasi integrasi perangkat keras lokal (Hardware APIs), gerbang komunikasi perpesanan, dan antarmuka pelaporan pemerintah untuk modul Unit Pengolahan Sampah & TPS3R Desa (UNT-TPS3R).

1. Integrasi Timbangan Platform Digital (Web Bluetooth API)#

Loket bank sampah menggunakan timbangan platform digital berkapasitas 300 kg - 500 kg yang dilengkapi modul Bluetooth BLE (contoh: seri CAS HDI / Sonic A12E Bluetooth):

• Protokol Koneksi: Menggunakan standard Web Bluetooth API peramban modern (Google Chrome / Edge) tanpa memerlukan instalasi driver lokal:

typescript
// Skema pemanggilan Web Bluetooth GATT Service
const device = await navigator.bluetooth.requestDevice({
filters: [{ namePrefix: 'SCALE_' }],
optionalServices: ['0000ffe0-0000-1000-8000-00805f9b34fb']
});
const server = await device.gatt.connect();
const service = await server.getPrimaryService('0000ffe0-0000-1000-8000-00805f9b34fb');
const characteristic = await service.getCharacteristic('0000ffe1-0000-1000-8000-00805f9b34fb');

• Parsing Data Serial: Data berat dibaca dalam format ASCII stream kontinu, diparsing dengan regex untuk mengekstraksi nilai numerik kg dan status stabilitas timbangan (ST/US).
• Keamanan: Tombol manual input berat di nonaktifkan secara baku saat koneksi timbangan aktif untuk mencegah manipulasi timbangan.

2. Integrasi WhatsApp Gateway (Slip Timbangan Digital)#

• Penyedia Layanan: Fonnte / WhatsApp Cloud API.
• Trigger: Setiap kali transaksi loket bank sampah disimpan dengan status berhasil (SUCCESS).
• Isi Pesan Otomatis:

text
Halo Bpk/Ibu [Nama Nasabah],
Setoran sampah Anda di Bank Sampah BUMDes telah berhasil dicatat:
- Tanggal: [Tgl/Jam]
- No. Bukti: TR-BS-202609-00124
- Rincian:
* Kardus Bekas: 12.5 kg x Rp 1.800 = Rp 22.500
* Botol PET Bening: 4.2 kg x Rp 3.000 = Rp 12.600
- Total Tambahan Saldo: Rp 35.100
- Saldo Tabungan Anda Saat Ini: Rp 142.800

Terima kasih telah berpartisipasi menjaga kebersihan desa dan kelestarian bumi!

3. Integrasi Pelaporan SIPSN Kementerian LHK#

• Standar Format Data: Mengacu pada format data agregat Sistem Informasi Pengelolaan Sampah Nasional (SIPSN) KLHK.
• Ekspor Data Berkala: Sistem ERP BUMDes menyediakan fitur ekspor satu klik (one-click export) dalam format Excel/JSON terstandar yang berisi:

1. Timbulan sampah harian desa (Ton/hari).
2. Komposisi sampah (Organik, Plastik, Kertas, Logam, Kaca, Residu).
3. Capaian Pengurangan Sampah di Sumber (Source Reduction Rate).
4. Capaian Daur Ulang & Pemanfaatan Kembali (Recycling Rate).