Integrasi Sistem & Pihak Ketiga Unit Perdagangan B2B (UNT-TRADE)

1. Arsitektur Ekosistem Integrasi Pihak Ketiga#

Untuk mempercepat proses operasional di lapangan, meminimalkan kesalahan manusia (human error), serta menjamin keakuratan penimbangan dan harga pasar, Unit Perdagangan BUMDes terintegrasi dengan 4 sistem eksternal:

+-----------------------------------+ +-----------------------------------+
| Jembatan Timbang Digital | | Feed Harga PIHPS Bank Indonesia |
| (RS-232 / TCP-IP IoT Bridge) | | (REST API / Webhook) |
+-----------------------------------+ +-----------------------------------+
 | |
 v v
 +-------------------------------------------------------------+
 | Sistem ERP BUMDes - Unit Perdagangan (B2B) |
 +-------------------------------------------------------------+
 | |
 v v
+-----------------------------------+ +-----------------------------------+
| WhatsApp Business API | | GPS Tracking Armada Logistik |
| (Notifikasi DO & Tagihan Tempo) | | (Telemetri Truk Ekspedisi) |
+-----------------------------------+ +-----------------------------------+

2. Integrasi Jembatan Timbang Digital (Weighbridge Bridge)#

2.1 Spesifikasi Protokol Komunikasi

• Antarmuka Fisik: Port Serial RS-232 / Konverter RS-232 to Ethernet RJ-45.
• Baud Rate: 9600 bps, Data Bits: 8, Parity: None, Stop Bits: 1.
• Format Data String Serial: =ST,GS,+008500.00kgrn
• ST: Status pembacaan stabil (Stable).
• GS: Gross Weight (Bobot Kotor).
• +008500.00kg: Angka desimal bobot dalam kilogram.

2.2 Middleware Node.js Serial-to-ERP Connector

Sistem desktop/edge di loket timbangan menjalankan daemon lokal yang membaca serial stream dan meneruskannya via WebSockets ke antarmuka web ERP BUMDes, sehingga operator tidak perlu mengetikkan angka berat secara manual (mencegah manipulasi angka timbangan).

3. Sinkronisasi Data Harga Komoditas Harian (PIHPS Nasional)#

1. Sumber Data: Pusat Informasi Harga Pangan Strategis (PIHPS) Nasional Bank Indonesia wilayah regional setempat.
2. Frekuensi Sinkronisasi: Setiap hari kerja pada pukul 06.00 WIB melalui cron job otomatis.
3. Komoditas yang Dipantau:

• Jagung Pipil Kering Tingkat Produsen/Grosir
• Beras Medium & Beras Premium Pasar Tradisional
• Cabai Merah Keriting & Cabai Rawit Merah
• Telur Ayam Ras Rasio Grosir

4. Fungsi pada Sistem: Memberikan batas indikator harga (price alert) bagi Manajer Unit saat menyusun daftar penawaran harga beli ke petani dan harga jual ke buyer B2B.

4. WhatsApp Business Gateway (Notifikasi B2B Otomatis)#

Sistem ERP terhubung dengan API WhatsApp resmi untuk mengirimkan pesan transaksional otomatis:

1. Tiket Timbang Digital Petani: Dikirim ke nomor WhatsApp petani sesaat setelah truk keluar dari jembatan timbang.
2. Surat Jalan & Estimasi Kedatangan (ETA): Dikirim ke bagian logistik buyer saat armada truk berangkat dari gudang BUMDes, memuat tautan unduh PDF Delivery Order (DO) ber-barcode.
3. Pengingat Jatuh Tempo Faktur (Invoice Reminder):

• Notifikasi H-3 sebelum tanggal jatuh tempo pembayaran tempo.
• Notifikasi konfirmasi tanda terima pembayaran saat transfer telah diverifikasi.

5. Telemetri GPS Armada Ekspedisi Pengiriman#

1. Pelacakan Lokasi Nyata (Real-time Tracking): Seluruh armada truk distribusi komoditas dilengkapi perangkat GPS tracker berbasis OBD/hardwire.
2. Geofencing Lokasi Penerima: Sistem otomatis memperbarui status Delivery Order menjadi Arrived at Destination saat armada truk memasuki radius 500 meter dari koordinat gudang buyer.
3. Deteksi Berhenti Tak Terjadwal (Anti-Pencurian): Jika kendaraan pengangkut berhenti lebih dari 30 menit di luar rute perjalanan yang ditentukan tanpa status darurat, sistem mengirimkan sinyal bahaya (theft alert) ke tim keamanan operasional BUMDes.