Artikel ini menjelaskan prosedur lengkap untuk menginstal aplikasi Middleware, menyiapkan mesin penerima uang tunai (cash machine), mengonfigurasi pengaturan komunikasi, mengintegrasikan middleware dengan sistem POS, serta melakukan simulasi alur operasional.
Setiap bagian harus diselesaikan secara berurutan untuk memastikan pengaturan dan fungsi sistem berjalan dengan baik.
I. Menyiapkan Perangkat dan Tools yang Dibutuhkan
Langkah 1. Instal .NET 9 Runtime
Middleware memerlukan .NET 9 Runtime agar dapat berjalan.
Tautan Unduhan:
https://dotnet.microsoft.com/en-us/download/dotnet/9.0
Ikuti instruksi instalasi yang ditampilkan di layar hingga proses selesai.
Langkah 2. Trust Development HTTPS Certificate
Buka Command Prompt (CMD), lalu jalankan perintah berikut:
dotnet dev-certs https --trust
Pastikan proses berjalan dengan sukses, kemudian tutup CMD.
Langkah 3. Unduh Paket Middleware
Unduh installer middleware melalui tautan yang disediakan:
“Coming Soon” — silakan minta tautan kepada administrator.
Setelah selesai diunduh, ekstrak paket tersebut.
Di dalam folder hasil ekstraksi, Anda akan menemukan:
1 file BAT
2 folder
II. Menyiapkan Mesin & Menjalankan Middleware
Langkah 1. Persyaratan Cash Machine
Sebelum menjalankan middleware, pastikan:
Cash machine dalam keadaan menyala.
Mesin terhubung ke komputer melalui USB atau antarmuka yang didukung
Tidak terdapat error atau gangguan perangkat keras pada mesin
Langkah 2. Menjalankan Aplikasi Middleware
Jalankan file BAT dari folder hasil ekstraksi.
Sistem akan otomatis membuka tiga jendela CMD.
⚠️ Jangan menutup jendela-jendela tersebut selama sistem digunakan.
Langkah 3. Validasi Status Runtime
Periksa ketiga jendela CMD dan pastikan:
Tidak ada pesan error
Tidak ada peringatan file hilang
Tidak terjadi kegagalan inisialisasi
Langkah 4. Persyaratan Akun POS
Pastikan Anda memiliki akun DealPOS yang aktif dan berlangganan sebelum melanjutkan.
III. Gambaran Dashboard Middleware
Langkah 1. Mengakses Dashboard
Buka browser dan akses URL berikut:
Setelah halaman dimuat, aplikasi akan otomatis diarahkan ke halaman Home.
Langkah 2. Struktur Dashboard
Dashboard terdiri dari dua menu utama:
Home
All Money in Machine
Withdraw Money
Setup
Pengaturan komunikasi dan konfigurasi mesin
IV. Konfigurasi Middleware
Langkah 1. Konfigurasi COM Port
Masuk ke tab Setup.
Periksa field ComPORT (default: COM3).
Untuk memvalidasi:
Buka Device Manager
Expand Ports (COM & LPT)
Identifikasi COM port yang digunakan oleh cash machine
Jika mesin menggunakan port lain (misalnya COM4), perbarui nilai COM port di dashboard.
Langkah 2. Mengedit appsettings.json (Konfigurasi CORS)
Buka file berikut di folder middleware:
appsettings.json
Cari array allowCORS, lalu tambahkan domain DealPOS Anda, misalnya:
"https://sandbox.dealpos.net"
Tambahkan sebagai item terakhir dan pisahkan dengan koma, lalu simpan file.
Langkah 3. Konfigurasi Routes & Inhibits
Di tab Setup, tersedia dua tabel:
Routes
Menentukan pecahan uang yang dapat diterima oleh mesin.
Inhibits
Menentukan pecahan uang yang dapat dikeluarkan oleh mesin.
Secara default, sistem telah menyediakan denominasi mata uang IDR.
Jika Anda memerlukan mata uang atau pecahan khusus, konfigurasi dapat dilakukan dengan:
Mengedit setiap baris secara manual
Menekan tombol Tambah Nominal
Menggunakan konfigurasi massal melalui file:
/middleware/json/banknotes.json
V. Kustomisasi banknotes.json
Buka file:
banknotes.json
File ini berisi dua array konfigurasi serta metadata mata uang.
Langkah 1. InhibitsConfig
Digunakan untuk konfigurasi pecahan penarikan (withdraw).
Properti yang dapat diedit:
Nominal
Currency
⚠️ Penting:
Nilai nominal harus ditambahkan dua angka nol di belakang.
Contoh:
1.000 IDR →
100000
Set nilai:
"Inhibit": false
Langkah 2. RouteConfig
Digunakan untuk konfigurasi pecahan yang diterima mesin.
Properti:
Nominal
Currency
Route → harus selalu bernilai
"1"
Langkah 3. Primary & Secondary Currency
Di bagian bawah file:
PrimaryCurrency → Mata uang utama POS
SecondaryCurrency → Mata uang tambahan yang didukung mesin
ExchangeRate → Nilai konversi dari primary ke secondary
Calculate:
falsejika nilai primary currency lebih besar dari secondary currencyMengatur logika perhitungan konversi
Contoh:
1 USD = 10.000 IDR
Konfigurasi:
"ExchangeRate": 10000 "PrimaryCurrency": "USD" "SecondaryCurrency": "IDR"
Langkah 4. Terapkan Konfigurasi
Setelah selesai mengedit, simpan file.
⚠️ Restart Diperlukan:
Tutup ketiga jendela CMD
Jalankan kembali file BAT
Muat ulang dashboard
VI. Mengaktifkan Aplikasi Middleware
Langkah 1. Membuka Koneksi
Masuk ke Setup → klik Open Connection.
Notifikasi hijau menandakan koneksi berhasil.
Langkah 2. Menjalankan Perangkat
Klik Start Devices (tombol hijau).
Tunggu hingga muncul notifikasi sukses.
Konfigurasi middleware kini telah selesai.
VII. Pengaturan POS — Metode Pembayaran
Langkah 1. Buka Menu Setup
Masuk ke Setup → Payment.
Langkah 2. Tambah Metode Pembayaran Baru
Klik Add, lalu isi:
Payment Method Name
Type: Cash
Subtype: Machine
⚠️ Catatan:
Metode pembayaran dengan kombinasi type dan subtype yang sama tidak dapat dibuat lebih dari satu.
Klik Save.
VIII. Pengaturan POS — Mata Uang
Langkah 1. Buka Menu Currency
Masuk ke Setup → Currency.
Langkah 2. Membuat atau Menetapkan USD sebagai Mata Uang Utama
Jika USD belum tersedia:
Klik Add
2. Isi:
Currency Name: USD
Symbol: $
Exchange Rate: 1
3. Klik Save
IX. Menghubungkan POS dengan Middleware
Langkah 1. Membuka Koneksi
Masuk ke Sell → More Action → Cash Machine, lalu klik Connect.
Notifikasi hijau menandakan koneksi berhasil.
Jika terjadi error, periksa kembali langkah konfigurasi sebelumnya atau hubungi customer support.
X. Prosedur Simulasi
Langkah 1. Simulasi Mesin melalui Middleware
All Money in Machine
Menampilkan:
Country Code (jenis mata uang)
Value (denominasi uang)
Stored (jumlah per denominasi)
Withdraw Money
Digunakan untuk simulasi penarikan uang dengan mengisi:
Amount (jumlah penarikan)
CountryCode (mata uang)
Contoh:
IDR 50.000 × 2
IDR 20.000 × 1
Total: 120.000 IDR
Isi:
Currency: IDR
Amount: 120000
Klik Get Money
XI. Simulasi Transaksi POS
Langkah 1. Membuat Transaksi Contoh
Buat transaksi senilai USD 20
(≈ IDR 200.000 dengan kurs 1 USD = 10.000 IDR)
Langkah 2. Proses Pembayaran
Klik Pay → pilih Cash Machine.
Langkah 3. Memasukkan Uang Tunai
Masukkan IDR 100.000
Sistem akan mencatat USD 10.
Masukkan kembali IDR 100.000 untuk menyelesaikan pembayaran.
Langkah 4. Pengembalian Otomatis
Jika pecahan kembalian tersedia → mesin akan otomatis mengeluarkan kembalian
Jika tidak tersedia → POS akan menampilkan peringatan untuk memberikan kembalian manual
Catatan:
Pengembalian otomatis sepenuhnya didukung jika hanya menggunakan satu mata uang yang sama.
XII. Penyelesaian
Integrasi Cash Machine Middleware dan POS kini telah berhasil diinstal, dikonfigurasi, dan siap digunakan di lingkungan produksi. Seluruh simulasi membuktikan bahwa konversi mata uang, pengaturan denominasi, dan perilaku mesin berjalan sesuai dengan yang dirancang.
Article Terkait
DealPOS adalah Aplikasi Kasir Online yang dirancang khusus untuk bisnis retail yang berkategori Fashion, Minimarket, Electronic, Fresh Food dan Toko Bangunan.
Dengan DealPOS, kamu dapat mengelola inventory toko online dan offline secara realtime dalam satu platform. Kamu juga bisa berjualan secara omnichannel (offline dan online), karena DealPOS terintegrasi dengan Marketplace (Shopee, Tokopedia, Tiktok Shop, Lazada) dan Webstore Instant (Shopify dan WooCommerce).